/// import { describe, it, expect, mock, beforeEach, afterEach } from "bun:test" import { createContextWindowMonitorHook } from "./context-window-monitor" const ANTHROPIC_CONTEXT_ENV_KEY = "ANTHROPIC_1M_CONTEXT" const VERTEX_CONTEXT_ENV_KEY = "VERTEX_ANTHROPIC_1M_CONTEXT" const originalAnthropicContextEnv = process.env[ANTHROPIC_CONTEXT_ENV_KEY] const originalVertexContextEnv = process.env[VERTEX_CONTEXT_ENV_KEY] function resetContextLimitEnv(): void { if (originalAnthropicContextEnv === undefined) { delete process.env[ANTHROPIC_CONTEXT_ENV_KEY] } else { process.env[ANTHROPIC_CONTEXT_ENV_KEY] = originalAnthropicContextEnv } if (originalVertexContextEnv === undefined) { delete process.env[VERTEX_CONTEXT_ENV_KEY] } else { process.env[VERTEX_CONTEXT_ENV_KEY] = originalVertexContextEnv } } function createMockCtx() { return { client: { session: { messages: mock(() => Promise.resolve({ data: [] })), }, }, directory: "/tmp/test", } } describe("context-window-monitor", () => { let ctx: ReturnType beforeEach(() => { ctx = createMockCtx() delete process.env[ANTHROPIC_CONTEXT_ENV_KEY] delete process.env[VERTEX_CONTEXT_ENV_KEY] }) afterEach(() => { resetContextLimitEnv() }) // #given event caches token info from message.updated // #when tool.execute.after is called // #then session.messages() should NOT be called it("should use cached token info instead of fetching session.messages()", async () => { const hook = createContextWindowMonitorHook(ctx as never) const sessionID = "ses_test1" // Simulate message.updated event with token info await hook.event({ event: { type: "message.updated", properties: { info: { role: "assistant", sessionID, providerID: "anthropic", finish: true, tokens: { input: 50000, output: 1000, reasoning: 0, cache: { read: 10000, write: 0 }, }, }, }, }, }) const output = { title: "", output: "test output", metadata: null } await hook["tool.execute.after"]( { tool: "bash", sessionID, callID: "call_1" }, output ) // session.messages() should NOT have been called expect(ctx.client.session.messages).not.toHaveBeenCalled() }) // #given no cached token info exists // #when tool.execute.after is called // #then should skip gracefully without fetching it("should skip gracefully when no cached token info exists", async () => { const hook = createContextWindowMonitorHook(ctx as never) const sessionID = "ses_no_cache" const output = { title: "", output: "test output", metadata: null } await hook["tool.execute.after"]( { tool: "bash", sessionID, callID: "call_1" }, output ) // No fetch, no crash expect(ctx.client.session.messages).not.toHaveBeenCalled() expect(output.output).toBe("test output") }) // #given token usage exceeds 70% threshold // #when tool.execute.after is called // #then context reminder should be appended to output it("should append context reminder with actual token counts when usage exceeds threshold", async () => { const hook = createContextWindowMonitorHook(ctx as never) const sessionID = "ses_high_usage" // 150K input + 10K cache read = 160K, which is 80% of 200K limit await hook.event({ event: { type: "message.updated", properties: { info: { role: "assistant", sessionID, providerID: "anthropic", finish: true, tokens: { input: 150000, output: 1000, reasoning: 0, cache: { read: 10000, write: 0 }, }, }, }, }, }) const output = { title: "", output: "original", metadata: null } await hook["tool.execute.after"]( { tool: "bash", sessionID, callID: "call_1" }, output ) expect(output.output).toContain("context remaining") expect(output.output).toContain("200,000-token context window") expect(output.output).toContain("[Context Status: 80.0% used (160,000/200,000 tokens), 20.0% remaining]") expect(ctx.client.session.messages).not.toHaveBeenCalled() }) // #given total input tokens exceed the resolved actualLimit (e.g. 1M-context // Anthropic model where resolveActualContextLimit falls back to the // 200K default for the model family) // #when tool.execute.after appends the context status block // #then the displayed used% must be clamped to 100 and remaining% must not go // negative. Safety-tuned models flag the >100% / negative-remaining // block as prompt injection (issue #3655). it("should clamp displayed percentages when input exceeds actualLimit (regression #3655)", async () => { const hook = createContextWindowMonitorHook(ctx as never) const sessionID = "ses_overflow" // 289,370 input + 0 cache against a 200K resolved limit -> 144.7% raw, // -44.7% remaining if not clamped. await hook.event({ event: { type: "message.updated", properties: { info: { role: "assistant", sessionID, providerID: "anthropic", finish: true, tokens: { input: 289370, output: 0, reasoning: 0, cache: { read: 0, write: 0 }, }, }, }, }, }) const output = { title: "", output: "original", metadata: null } await hook["tool.execute.after"]( { tool: "bash", sessionID, callID: "call_1" }, output ) // The block must still be emitted (we are above the 70% threshold). expect(output.output).toContain("[Context Status:") // Extract the displayed percentages and assert clamping. const match = output.output.match( /\[Context Status: ([\d.-]+)% used \([\d,]+\/[\d,]+ tokens\), ([\d.-]+)% remaining\]/, ) expect(match).not.toBeNull() const usedPct = Number(match![1]) const remainingPct = Number(match![2]) expect(usedPct).toBeLessThanOrEqual(100) expect(usedPct).toBeGreaterThanOrEqual(0) expect(remainingPct).toBeGreaterThanOrEqual(0) expect(remainingPct).toBeLessThanOrEqual(100) }) it("should append context reminder for google-vertex-anthropic provider", async () => { //#given cached usage for google-vertex-anthropic above threshold const hook = createContextWindowMonitorHook(ctx as never) const sessionID = "ses_vertex_anthropic_high_usage" await hook.event({ event: { type: "message.updated", properties: { info: { role: "assistant", sessionID, providerID: "google-vertex-anthropic", finish: true, tokens: { input: 150000, output: 1000, reasoning: 0, cache: { read: 10000, write: 0 }, }, }, }, }, }) //#when tool.execute.after runs const output = { title: "", output: "original", metadata: null } await hook["tool.execute.after"]( { tool: "bash", sessionID, callID: "call_1" }, output ) //#then context reminder should be appended expect(output.output).toContain("context remaining") }) // #given only a compaction agent summary message update is seen // #when tool.execute.after checks context usage // #then stale pre-compaction tokens should not create a context reminder it("should ignore compaction-agent message updates when caching context usage", async () => { const hook = createContextWindowMonitorHook(ctx as never) const sessionID = "ses_compaction_agent_context" await hook.event({ event: { type: "message.updated", properties: { info: { agent: "compaction", role: "assistant", sessionID, providerID: "anthropic", modelID: "claude-sonnet-4-6", finish: true, tokens: { input: 150000, output: 1000, reasoning: 0, cache: { read: 10000, write: 0 }, }, }, }, }, }) const output = { title: "", output: "original", metadata: null } await hook["tool.execute.after"]( { tool: "bash", sessionID, callID: "call_1" }, output ) expect(output.output).toBe("original") expect(ctx.client.session.messages).not.toHaveBeenCalled() }) // #given session is deleted // #when session.deleted event fires // #then cached data should be cleaned up it("should clean up cache on session.deleted", async () => { const hook = createContextWindowMonitorHook(ctx as never) const sessionID = "ses_deleted" // Cache some data await hook.event({ event: { type: "message.updated", properties: { info: { role: "assistant", sessionID, providerID: "anthropic", finish: true, tokens: { input: 150000, output: 0, reasoning: 0, cache: { read: 10000, write: 0 } }, }, }, }, }) // Delete session await hook.event({ event: { type: "session.deleted", properties: { info: { id: sessionID } }, }, }) // After deletion, no reminder should fire (cache gone, reminded set gone) const output = { title: "", output: "test", metadata: null } await hook["tool.execute.after"]( { tool: "bash", sessionID, callID: "call_1" }, output ) expect(output.output).toBe("test") }) // #given non-anthropic provider // #when message.updated fires // #then should not trigger reminder it("should ignore non-anthropic providers", async () => { const hook = createContextWindowMonitorHook(ctx as never) const sessionID = "ses_openai" await hook.event({ event: { type: "message.updated", properties: { info: { role: "assistant", sessionID, providerID: "openai", finish: true, tokens: { input: 200000, output: 0, reasoning: 0, cache: { read: 0, write: 0 } }, }, }, }, }) const output = { title: "", output: "test", metadata: null } await hook["tool.execute.after"]( { tool: "bash", sessionID, callID: "call_1" }, output ) expect(output.output).toBe("test") }) it("should use 1M limit when model cache flag is enabled", async () => { //#given const hook = createContextWindowMonitorHook(ctx as never, { anthropicContext1MEnabled: true, }) const sessionID = "ses_1m_flag" await hook.event({ event: { type: "message.updated", properties: { info: { role: "assistant", sessionID, providerID: "anthropic", finish: true, tokens: { input: 300000, output: 1000, reasoning: 0, cache: { read: 0, write: 0 }, }, }, }, }, }) //#when const output = { title: "", output: "original", metadata: null } await hook["tool.execute.after"]( { tool: "bash", sessionID, callID: "call_1" }, output ) //#then expect(output.output).toBe("original") }) it("should keep env var fallback when model cache flag is disabled", async () => { //#given process.env[ANTHROPIC_CONTEXT_ENV_KEY] = "true" const hook = createContextWindowMonitorHook(ctx as never, { anthropicContext1MEnabled: false, }) const sessionID = "ses_env_fallback" await hook.event({ event: { type: "message.updated", properties: { info: { role: "assistant", sessionID, providerID: "anthropic", finish: true, tokens: { input: 300000, output: 1000, reasoning: 0, cache: { read: 0, write: 0 }, }, }, }, }, }) //#when const output = { title: "", output: "original", metadata: null } await hook["tool.execute.after"]( { tool: "bash", sessionID, callID: "call_1" }, output ) //#then expect(output.output).toBe("original") }) })