gsd-pi 2.78.0 → 2.78.1-dev.8a893322c

package/packages/pi-ai/dist/providers/anthropic-shared.cache-breakpoint.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=anthropic-shared.cache-breakpoint.test.d.ts.map

package/packages/pi-ai/dist/providers/anthropic-shared.cache-breakpoint.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-shared.cache-breakpoint.test.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic-shared.cache-breakpoint.test.ts"],"names":[],"mappings":""}

package/packages/pi-ai/dist/providers/anthropic-shared.cache-breakpoint.test.js

@@ -0,0 +1,231 @@
+// @gsd/pi-ai + anthropic-shared.cache-breakpoint.test — coverage for #5027.
+// `convertMessages` must apply Anthropic `cache_control` to:
+//   - the last message (existing volatile-suffix anchor — preserved)
+//   - the most recent message flagged with `cacheBreakpoint: true`
+//     (new compaction-boundary anchor)
+// And it must NOT exceed the 4-breakpoint limit by treating multiple
+// breakpoints as one — only the most recent earns the marker.
+import { describe, test } from "node:test";
+import assert from "node:assert/strict";
+import { buildParams, convertMessages } from "./anthropic-shared.js";
+// Minimal model stub — convertMessages only reads `input` to decide whether to
+// drop image blocks. Returning ["image"] keeps the conversion paths exercised.
+const model = { input: ["text", "image"] };
+const cacheControl = { type: "ephemeral" };
+function userMsg(text, opts = {}) {
+    return {
+        role: "user",
+        content: text,
+        timestamp: 0,
+        ...(opts.cacheBreakpoint ? { cacheBreakpoint: true } : {}),
+    };
+}
+/** Produces a UserMessage whose content is an array of text blocks —
+ * the production shape emitted by `convertToLlm()` for compaction summaries. */
+function userMsgArray(text, opts = {}) {
+    return {
+        role: "user",
+        content: [{ type: "text", text }],
+        timestamp: 0,
+        ...(opts.cacheBreakpoint ? { cacheBreakpoint: true } : {}),
+    };
+}
+function assistantMsg(text) {
+    return {
+        role: "assistant",
+        content: [{ type: "text", text }],
+        api: "anthropic-messages",
+        provider: "anthropic",
+        model: "claude-sonnet-4-6",
+        usage: {
+            input: 0, output: 0, cacheRead: 0, cacheWrite: 0, totalTokens: 0,
+            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+        },
+        stopReason: "stop",
+        timestamp: 0,
+    };
+}
+/** Returns whether the message at the given index has cache_control on its last block. */
+function hasCacheControl(params, index) {
+    const param = params[index];
+    if (!param || param.role !== "user")
+        return false;
+    if (!Array.isArray(param.content))
+        return false;
+    const lastBlock = param.content[param.content.length - 1];
+    return Boolean(lastBlock && lastBlock.cache_control);
+}
+describe("convertMessages — cache breakpoints (#5027)", () => {
+    test("with no cacheControl option: no breakpoints are placed", () => {
+        const result = convertMessages([userMsg("hello"), assistantMsg("hi"), userMsg("again")], model, false);
+        for (let i = 0; i < result.length; i++) {
+            assert.equal(hasCacheControl(result, i), false, `index ${i} should have no cache_control`);
+        }
+    });
+    test("no cacheBreakpoint anywhere: only the last message gets cache_control (existing behavior preserved)", () => {
+        const result = convertMessages([userMsg("first"), assistantMsg("response"), userMsg("second")], model, false, cacheControl);
+        assert.equal(hasCacheControl(result, 0), false, "first user msg has no breakpoint");
+        assert.equal(hasCacheControl(result, result.length - 1), true, "last msg gets the volatile-suffix anchor");
+    });
+    test("one cacheBreakpoint message: both that message AND the last message get breakpoints", () => {
+        const result = convertMessages([
+            userMsg("ancient"),
+            assistantMsg("ancient response"),
+            userMsg("[COMPACTION SUMMARY]", { cacheBreakpoint: true }),
+            assistantMsg("post-compaction response"),
+            userMsg("new turn"),
+        ], model, false, cacheControl);
+        // Find the compaction-summary index (it's the third user-shaped param)
+        const compactionIdx = result.findIndex((p) => p.role === "user" && Array.isArray(p.content) && p.content[0]?.text?.includes("COMPACTION SUMMARY"));
+        assert.ok(compactionIdx >= 0, "compaction summary should be in the params");
+        assert.equal(hasCacheControl(result, compactionIdx), true, "compaction boundary gets a breakpoint");
+        assert.equal(hasCacheControl(result, result.length - 1), true, "last msg still gets the volatile-suffix anchor");
+    });
+    test("array-content cacheBreakpoint message: breakpoint is applied (production shape for compaction summary)", () => {
+        // convertToLlm() emits compaction summaries as content:[{type:"text",...}];
+        // this exercises the array-backed branch in anthropic-shared.ts.
+        const result = convertMessages([
+            userMsgArray("[COMPACTION SUMMARY]", { cacheBreakpoint: true }),
+            assistantMsg("post-compaction response"),
+            userMsg("post-compaction turn"),
+        ], model, false, cacheControl);
+        const compactionIdx = result.findIndex((p) => p.role === "user" &&
+            Array.isArray(p.content) &&
+            p.content[0]?.text?.includes("COMPACTION SUMMARY"));
+        assert.ok(compactionIdx >= 0, "compaction summary param should be present");
+        assert.equal(hasCacheControl(result, compactionIdx), true, "array-content boundary gets cache_control");
+        assert.equal(hasCacheControl(result, result.length - 1), true, "last msg still gets the volatile-suffix anchor");
+    });
+    test("multiple cacheBreakpoint messages: only the most recent one earns a breakpoint (4-limit safety)", () => {
+        const result = convertMessages([
+            userMsg("[OLD COMPACTION]", { cacheBreakpoint: true }),
+            assistantMsg("post-old response"),
+            userMsg("[NEW COMPACTION]", { cacheBreakpoint: true }),
+            assistantMsg("post-new response"),
+            userMsg("latest turn"),
+        ], model, false, cacheControl);
+        const oldIdx = result.findIndex((p) => p.role === "user" && Array.isArray(p.content) && p.content[0]?.text?.includes("OLD COMPACTION"));
+        const newIdx = result.findIndex((p) => p.role === "user" && Array.isArray(p.content) && p.content[0]?.text?.includes("NEW COMPACTION"));
+        assert.equal(hasCacheControl(result, oldIdx), false, "older boundary should not earn a breakpoint");
+        assert.equal(hasCacheControl(result, newIdx), true, "most recent boundary earns the breakpoint");
+        assert.equal(hasCacheControl(result, result.length - 1), true, "last msg still gets the volatile-suffix anchor");
+    });
+    test("cacheBreakpoint on the LAST message: only one breakpoint applied (deduplication)", () => {
+        // When the boundary message IS the last message, applying twice would be
+        // a no-op overwrite but the deduplication guard avoids the double-call.
+        const result = convertMessages([userMsg("hello"), userMsg("[BOUNDARY AS LAST]", { cacheBreakpoint: true })], model, false, cacheControl);
+        assert.equal(hasCacheControl(result, result.length - 1), true);
+        // Only one user message besides the last, with no breakpoint
+        assert.equal(hasCacheControl(result, 0), false);
+    });
+    test("cacheBreakpoint flag is ignored when no cacheControl option is provided", () => {
+        const result = convertMessages([userMsg("[COMPACTION]", { cacheBreakpoint: true }), userMsg("turn")], model, false);
+        for (let i = 0; i < result.length; i++) {
+            assert.equal(hasCacheControl(result, i), false, `index ${i} should have no cache_control`);
+        }
+    });
+    test("array-content cacheBreakpoint on last message: deduplication guard prevents double application", () => {
+        // The boundary IS the last message — both anchors target the same param,
+        // so cache_control should appear exactly once.
+        const result = convertMessages([userMsg("prior turn"), userMsgArray("[BOUNDARY AS LAST]", { cacheBreakpoint: true })], model, false, cacheControl);
+        const lastParam = result[result.length - 1];
+        assert.ok(lastParam && Array.isArray(lastParam.content), "last param has array content");
+        const cacheBlocks = lastParam.content.filter((b) => b.cache_control);
+        assert.equal(cacheBlocks.length, 1, "cache_control applied exactly once");
+        assert.equal(hasCacheControl(result, 0), false, "prior turn has no cache_control");
+    });
+});
+// ─── 4-breakpoint-limit safety at buildParams level (OAuth path) ──────────
+/** Count cache_control occurrences across system + tools + messages params. */
+function countBreakpoints(params) {
+    let n = 0;
+    if (Array.isArray(params.system)) {
+        for (const block of params.system)
+            if (block.cache_control)
+                n++;
+    }
+    if (Array.isArray(params.tools)) {
+        for (const tool of params.tools)
+            if (tool.cache_control)
+                n++;
+    }
+    for (const m of params.messages) {
+        if (m.role === "user" && Array.isArray(m.content)) {
+            for (const block of m.content)
+                if (block.cache_control)
+                    n++;
+        }
+    }
+    return n;
+}
+const buildParamsModel = {
+    id: "claude-sonnet-4-6",
+    baseUrl: "https://api.anthropic.com",
+    api: "anthropic-messages",
+    input: ["text", "image"],
+    maxTokens: 64000,
+};
+describe("buildParams — 4-breakpoint limit safety in OAuth + boundary scenario (#5027)", () => {
+    test("OAuth + system prompt + last user: ≤2 breakpoints (no boundary, no tools)", () => {
+        const ctx = {
+            messages: [userMsg("hello")],
+            systemPrompt: "You are a helpful coding assistant.",
+        };
+        const params = buildParams(buildParamsModel, ctx, true);
+        assert.ok(countBreakpoints(params) <= 4, `expected ≤4 breakpoints, got ${countBreakpoints(params)}`);
+        // One on user system block, one on last user msg.
+        assert.equal(countBreakpoints(params), 2);
+    });
+    test("OAuth + system prompt + boundary + last user: ≤3 breakpoints (system de-duplicated)", () => {
+        const ctx = {
+            messages: [
+                userMsg("[COMPACTION SUMMARY]", { cacheBreakpoint: true }),
+                userMsg("post-compaction turn"),
+            ],
+            systemPrompt: "You are a helpful coding assistant.",
+        };
+        const params = buildParams(buildParamsModel, ctx, true);
+        const count = countBreakpoints(params);
+        assert.ok(count <= 4, `must stay under Anthropic's 4-breakpoint limit, got ${count}`);
+        // system(1, the user's prompt — Claude Code header skipped) + boundary(1) + last(1) = 3.
+        assert.equal(count, 3);
+    });
+    test("OAuth + system prompt + tools + boundary + last user: exactly 4 breakpoints (ceiling)", () => {
+        // Worst-case breakpoint budget:
+        //   system(user prompt, 1) + last tool(1) + boundary(1) + last user(1) = 4.
+        // The "You are Claude Code" header intentionally carries NO cache_control
+        // when a user systemPrompt is present (#5027), which keeps us at 4 rather than 5.
+        const tool = {
+            name: "Read",
+            description: "Read a file from disk.",
+            parameters: {
+                type: "object",
+                properties: {
+                    path: { type: "string" },
+                },
+                required: ["path"],
+            },
+        };
+        const ctx = {
+            messages: [
+                userMsg("[COMPACTION SUMMARY]", { cacheBreakpoint: true }),
+                userMsg("post-compaction turn"),
+            ],
+            systemPrompt: "You are a helpful coding assistant.",
+            tools: [tool],
+        };
+        const params = buildParams(buildParamsModel, ctx, true);
+        const count = countBreakpoints(params);
+        assert.ok(count <= 4, `must stay under Anthropic's 4-breakpoint limit, got ${count}`);
+        // system(1) + tool(1) + boundary(1) + last-user(1) = 4 exactly.
+        assert.equal(count, 4);
+    });
+    test("OAuth header WITHOUT user systemPrompt still cache-marks the header", () => {
+        // When there's no user systemPrompt, the Claude Code header IS the
+        // last system block, so it correctly carries cache_control.
+        const ctx = { messages: [userMsg("hello")] };
+        const params = buildParams(buildParamsModel, ctx, true);
+        assert.equal(countBreakpoints(params), 2, "header(1) + last user(1) = 2");
+    });
+});
+//# sourceMappingURL=anthropic-shared.cache-breakpoint.test.js.map

package/packages/pi-ai/dist/providers/anthropic-shared.cache-breakpoint.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-shared.cache-breakpoint.test.js","sourceRoot":"","sources":["../../src/providers/anthropic-shared.cache-breakpoint.test.ts"],"names":[],"mappings":"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","sourcesContent":["// @gsd/pi-ai + anthropic-shared.cache-breakpoint.test — coverage for #5027.\n// `convertMessages` must apply Anthropic `cache_control` to:\n//   - the last message (existing volatile-suffix anchor — preserved)\n//   - the most recent message flagged with `cacheBreakpoint: true`\n//     (new compaction-boundary anchor)\n// And it must NOT exceed the 4-breakpoint limit by treating multiple\n// breakpoints as one — only the most recent earns the marker.\n\nimport { describe, test } from \"node:test\";\nimport assert from \"node:assert/strict\";\n\nimport { buildParams, convertMessages } from \"./anthropic-shared.js\";\nimport type { Context, Message, Model, Tool } from \"../types.js\";\nimport type { AnthropicApi } from \"./anthropic-shared.js\";\n\n// Minimal model stub — convertMessages only reads `input` to decide whether to\n// drop image blocks. Returning [\"image\"] keeps the conversion paths exercised.\nconst model = { input: [\"text\", \"image\"] } as unknown as Model<AnthropicApi>;\nconst cacheControl = { type: \"ephemeral\" as const };\n\nfunction userMsg(text: string, opts: { cacheBreakpoint?: boolean } = {}): Message {\n\treturn {\n\t\trole: \"user\",\n\t\tcontent: text,\n\t\ttimestamp: 0,\n\t\t...(opts.cacheBreakpoint ? { cacheBreakpoint: true } : {}),\n\t} as Message;\n}\n\n/** Produces a UserMessage whose content is an array of text blocks —\n * the production shape emitted by `convertToLlm()` for compaction summaries. */\nfunction userMsgArray(text: string, opts: { cacheBreakpoint?: boolean } = {}): Message {\n\treturn {\n\t\trole: \"user\",\n\t\tcontent: [{ type: \"text\", text }],\n\t\ttimestamp: 0,\n\t\t...(opts.cacheBreakpoint ? { cacheBreakpoint: true } : {}),\n\t} as Message;\n}\n\nfunction assistantMsg(text: string): Message {\n\treturn {\n\t\trole: \"assistant\",\n\t\tcontent: [{ type: \"text\", text }],\n\t\tapi: \"anthropic-messages\",\n\t\tprovider: \"anthropic\",\n\t\tmodel: \"claude-sonnet-4-6\",\n\t\tusage: {\n\t\t\tinput: 0, output: 0, cacheRead: 0, cacheWrite: 0, totalTokens: 0,\n\t\t\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },\n\t\t},\n\t\tstopReason: \"stop\",\n\t\ttimestamp: 0,\n\t} as Message;\n}\n\n/** Returns whether the message at the given index has cache_control on its last block. */\nfunction hasCacheControl(params: ReturnType<typeof convertMessages>, index: number): boolean {\n\tconst param = params[index];\n\tif (!param || param.role !== \"user\") return false;\n\tif (!Array.isArray(param.content)) return false;\n\tconst lastBlock = param.content[param.content.length - 1];\n\treturn Boolean(lastBlock && (lastBlock as any).cache_control);\n}\n\ndescribe(\"convertMessages — cache breakpoints (#5027)\", () => {\n\ttest(\"with no cacheControl option: no breakpoints are placed\", () => {\n\t\tconst result = convertMessages([userMsg(\"hello\"), assistantMsg(\"hi\"), userMsg(\"again\")], model, false);\n\t\tfor (let i = 0; i < result.length; i++) {\n\t\t\tassert.equal(hasCacheControl(result, i), false, `index ${i} should have no cache_control`);\n\t\t}\n\t});\n\n\ttest(\"no cacheBreakpoint anywhere: only the last message gets cache_control (existing behavior preserved)\", () => {\n\t\tconst result = convertMessages(\n\t\t\t[userMsg(\"first\"), assistantMsg(\"response\"), userMsg(\"second\")],\n\t\t\tmodel,\n\t\t\tfalse,\n\t\t\tcacheControl,\n\t\t);\n\t\tassert.equal(hasCacheControl(result, 0), false, \"first user msg has no breakpoint\");\n\t\tassert.equal(hasCacheControl(result, result.length - 1), true, \"last msg gets the volatile-suffix anchor\");\n\t});\n\n\ttest(\"one cacheBreakpoint message: both that message AND the last message get breakpoints\", () => {\n\t\tconst result = convertMessages(\n\t\t\t[\n\t\t\t\tuserMsg(\"ancient\"),\n\t\t\t\tassistantMsg(\"ancient response\"),\n\t\t\t\tuserMsg(\"[COMPACTION SUMMARY]\", { cacheBreakpoint: true }),\n\t\t\t\tassistantMsg(\"post-compaction response\"),\n\t\t\t\tuserMsg(\"new turn\"),\n\t\t\t],\n\t\t\tmodel,\n\t\t\tfalse,\n\t\t\tcacheControl,\n\t\t);\n\t\t// Find the compaction-summary index (it's the third user-shaped param)\n\t\tconst compactionIdx = result.findIndex(\n\t\t\t(p) => p.role === \"user\" && Array.isArray(p.content) && (p.content as any)[0]?.text?.includes(\"COMPACTION SUMMARY\"),\n\t\t);\n\t\tassert.ok(compactionIdx >= 0, \"compaction summary should be in the params\");\n\t\tassert.equal(hasCacheControl(result, compactionIdx), true, \"compaction boundary gets a breakpoint\");\n\t\tassert.equal(hasCacheControl(result, result.length - 1), true, \"last msg still gets the volatile-suffix anchor\");\n\t});\n\n\ttest(\"array-content cacheBreakpoint message: breakpoint is applied (production shape for compaction summary)\", () => {\n\t\t// convertToLlm() emits compaction summaries as content:[{type:\"text\",...}];\n\t\t// this exercises the array-backed branch in anthropic-shared.ts.\n\t\tconst result = convertMessages(\n\t\t\t[\n\t\t\t\tuserMsgArray(\"[COMPACTION SUMMARY]\", { cacheBreakpoint: true }),\n\t\t\t\tassistantMsg(\"post-compaction response\"),\n\t\t\t\tuserMsg(\"post-compaction turn\"),\n\t\t\t],\n\t\t\tmodel,\n\t\t\tfalse,\n\t\t\tcacheControl,\n\t\t);\n\t\tconst compactionIdx = result.findIndex(\n\t\t\t(p) =>\n\t\t\t\tp.role === \"user\" &&\n\t\t\t\tArray.isArray(p.content) &&\n\t\t\t\t(p.content as any)[0]?.text?.includes(\"COMPACTION SUMMARY\"),\n\t\t);\n\t\tassert.ok(compactionIdx >= 0, \"compaction summary param should be present\");\n\t\tassert.equal(hasCacheControl(result, compactionIdx), true, \"array-content boundary gets cache_control\");\n\t\tassert.equal(hasCacheControl(result, result.length - 1), true, \"last msg still gets the volatile-suffix anchor\");\n\t});\n\n\ttest(\"multiple cacheBreakpoint messages: only the most recent one earns a breakpoint (4-limit safety)\", () => {\n\t\tconst result = convertMessages(\n\t\t\t[\n\t\t\t\tuserMsg(\"[OLD COMPACTION]\", { cacheBreakpoint: true }),\n\t\t\t\tassistantMsg(\"post-old response\"),\n\t\t\t\tuserMsg(\"[NEW COMPACTION]\", { cacheBreakpoint: true }),\n\t\t\t\tassistantMsg(\"post-new response\"),\n\t\t\t\tuserMsg(\"latest turn\"),\n\t\t\t],\n\t\t\tmodel,\n\t\t\tfalse,\n\t\t\tcacheControl,\n\t\t);\n\t\tconst oldIdx = result.findIndex(\n\t\t\t(p) => p.role === \"user\" && Array.isArray(p.content) && (p.content as any)[0]?.text?.includes(\"OLD COMPACTION\"),\n\t\t);\n\t\tconst newIdx = result.findIndex(\n\t\t\t(p) => p.role === \"user\" && Array.isArray(p.content) && (p.content as any)[0]?.text?.includes(\"NEW COMPACTION\"),\n\t\t);\n\t\tassert.equal(hasCacheControl(result, oldIdx), false, \"older boundary should not earn a breakpoint\");\n\t\tassert.equal(hasCacheControl(result, newIdx), true, \"most recent boundary earns the breakpoint\");\n\t\tassert.equal(hasCacheControl(result, result.length - 1), true, \"last msg still gets the volatile-suffix anchor\");\n\t});\n\n\ttest(\"cacheBreakpoint on the LAST message: only one breakpoint applied (deduplication)\", () => {\n\t\t// When the boundary message IS the last message, applying twice would be\n\t\t// a no-op overwrite but the deduplication guard avoids the double-call.\n\t\tconst result = convertMessages(\n\t\t\t[userMsg(\"hello\"), userMsg(\"[BOUNDARY AS LAST]\", { cacheBreakpoint: true })],\n\t\t\tmodel,\n\t\t\tfalse,\n\t\t\tcacheControl,\n\t\t);\n\t\tassert.equal(hasCacheControl(result, result.length - 1), true);\n\t\t// Only one user message besides the last, with no breakpoint\n\t\tassert.equal(hasCacheControl(result, 0), false);\n\t});\n\n\ttest(\"cacheBreakpoint flag is ignored when no cacheControl option is provided\", () => {\n\t\tconst result = convertMessages(\n\t\t\t[userMsg(\"[COMPACTION]\", { cacheBreakpoint: true }), userMsg(\"turn\")],\n\t\t\tmodel,\n\t\t\tfalse,\n\t\t);\n\t\tfor (let i = 0; i < result.length; i++) {\n\t\t\tassert.equal(hasCacheControl(result, i), false, `index ${i} should have no cache_control`);\n\t\t}\n\t});\n\n\ttest(\"array-content cacheBreakpoint on last message: deduplication guard prevents double application\", () => {\n\t\t// The boundary IS the last message — both anchors target the same param,\n\t\t// so cache_control should appear exactly once.\n\t\tconst result = convertMessages(\n\t\t\t[userMsg(\"prior turn\"), userMsgArray(\"[BOUNDARY AS LAST]\", { cacheBreakpoint: true })],\n\t\t\tmodel,\n\t\t\tfalse,\n\t\t\tcacheControl,\n\t\t);\n\t\tconst lastParam = result[result.length - 1];\n\t\tassert.ok(lastParam && Array.isArray(lastParam.content), \"last param has array content\");\n\t\tconst cacheBlocks = (lastParam!.content as any[]).filter((b) => b.cache_control);\n\t\tassert.equal(cacheBlocks.length, 1, \"cache_control applied exactly once\");\n\t\tassert.equal(hasCacheControl(result, 0), false, \"prior turn has no cache_control\");\n\t});\n});\n\n// ─── 4-breakpoint-limit safety at buildParams level (OAuth path) ──────────\n\n/** Count cache_control occurrences across system + tools + messages params. */\nfunction countBreakpoints(params: { system?: any; tools?: any[]; messages: any[] }): number {\n\tlet n = 0;\n\tif (Array.isArray(params.system)) {\n\t\tfor (const block of params.system) if (block.cache_control) n++;\n\t}\n\tif (Array.isArray(params.tools)) {\n\t\tfor (const tool of params.tools) if ((tool as any).cache_control) n++;\n\t}\n\tfor (const m of params.messages) {\n\t\tif (m.role === \"user\" && Array.isArray(m.content)) {\n\t\t\tfor (const block of m.content) if (block.cache_control) n++;\n\t\t}\n\t}\n\treturn n;\n}\n\nconst buildParamsModel = {\n\tid: \"claude-sonnet-4-6\",\n\tbaseUrl: \"https://api.anthropic.com\",\n\tapi: \"anthropic-messages\",\n\tinput: [\"text\", \"image\"],\n\tmaxTokens: 64000,\n} as unknown as Model<AnthropicApi>;\n\ndescribe(\"buildParams — 4-breakpoint limit safety in OAuth + boundary scenario (#5027)\", () => {\n\ttest(\"OAuth + system prompt + last user: ≤2 breakpoints (no boundary, no tools)\", () => {\n\t\tconst ctx: Context = {\n\t\t\tmessages: [userMsg(\"hello\")],\n\t\t\tsystemPrompt: \"You are a helpful coding assistant.\",\n\t\t} as Context;\n\t\tconst params = buildParams(buildParamsModel, ctx, true) as any;\n\t\tassert.ok(countBreakpoints(params) <= 4, `expected ≤4 breakpoints, got ${countBreakpoints(params)}`);\n\t\t// One on user system block, one on last user msg.\n\t\tassert.equal(countBreakpoints(params), 2);\n\t});\n\n\ttest(\"OAuth + system prompt + boundary + last user: ≤3 breakpoints (system de-duplicated)\", () => {\n\t\tconst ctx: Context = {\n\t\t\tmessages: [\n\t\t\t\tuserMsg(\"[COMPACTION SUMMARY]\", { cacheBreakpoint: true }),\n\t\t\t\tuserMsg(\"post-compaction turn\"),\n\t\t\t],\n\t\t\tsystemPrompt: \"You are a helpful coding assistant.\",\n\t\t} as Context;\n\t\tconst params = buildParams(buildParamsModel, ctx, true) as any;\n\t\tconst count = countBreakpoints(params);\n\t\tassert.ok(count <= 4, `must stay under Anthropic's 4-breakpoint limit, got ${count}`);\n\t\t// system(1, the user's prompt — Claude Code header skipped) + boundary(1) + last(1) = 3.\n\t\tassert.equal(count, 3);\n\t});\n\n\ttest(\"OAuth + system prompt + tools + boundary + last user: exactly 4 breakpoints (ceiling)\", () => {\n\t\t// Worst-case breakpoint budget:\n\t\t//   system(user prompt, 1) + last tool(1) + boundary(1) + last user(1) = 4.\n\t\t// The \"You are Claude Code\" header intentionally carries NO cache_control\n\t\t// when a user systemPrompt is present (#5027), which keeps us at 4 rather than 5.\n\t\tconst tool: Tool = {\n\t\t\tname: \"Read\",\n\t\t\tdescription: \"Read a file from disk.\",\n\t\t\tparameters: {\n\t\t\t\ttype: \"object\" as const,\n\t\t\t\tproperties: {\n\t\t\t\t\tpath: { type: \"string\" },\n\t\t\t\t},\n\t\t\t\trequired: [\"path\"],\n\t\t\t} as any,\n\t\t};\n\t\tconst ctx: Context = {\n\t\t\tmessages: [\n\t\t\t\tuserMsg(\"[COMPACTION SUMMARY]\", { cacheBreakpoint: true }),\n\t\t\t\tuserMsg(\"post-compaction turn\"),\n\t\t\t],\n\t\t\tsystemPrompt: \"You are a helpful coding assistant.\",\n\t\t\ttools: [tool],\n\t\t} as Context;\n\t\tconst params = buildParams(buildParamsModel, ctx, true) as any;\n\t\tconst count = countBreakpoints(params);\n\t\tassert.ok(count <= 4, `must stay under Anthropic's 4-breakpoint limit, got ${count}`);\n\t\t// system(1) + tool(1) + boundary(1) + last-user(1) = 4 exactly.\n\t\tassert.equal(count, 4);\n\t});\n\n\ttest(\"OAuth header WITHOUT user systemPrompt still cache-marks the header\", () => {\n\t\t// When there's no user systemPrompt, the Claude Code header IS the\n\t\t// last system block, so it correctly carries cache_control.\n\t\tconst ctx: Context = { messages: [userMsg(\"hello\")] } as Context;\n\t\tconst params = buildParams(buildParamsModel, ctx, true) as any;\n\t\tassert.equal(countBreakpoints(params), 2, \"header(1) + last user(1) = 2\");\n\t});\n});\n"]}

package/packages/pi-ai/dist/providers/anthropic-shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic-shared.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic-shared.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"anthropic-shared.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic-shared.ts"],"names":[],"mappings":"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"}

package/packages/pi-ai/dist/providers/anthropic-shared.js

@@ -182,6 +182,11 @@ export function normalizeToolCallId(id) {
 /** Convert GSD messages to Anthropic SDK `MessageParam` format, applying cache control to the last user turn. */
 export function convertMessages(messages, model, isOAuthToken, cacheControl) {
     const params = [];
+    // Indices into `params` for messages flagged with `cacheBreakpoint: true` —
+    // e.g. compaction summaries. We apply cache_control to the most recent one
+    // (in addition to the last message) so the stable summary + kept-history
+    // block can earn cache reads on every post-compaction turn. (#5027)
+    const breakpointIndices = [];
     const transformedMessages = transformMessagesWithReport(messages, model, normalizeToolCallId, "anthropic-messages");
     for (let i = 0; i < transformedMessages.length; i++) {
         const msg = transformedMessages[i];
@@ -192,6 +197,8 @@ export function convertMessages(messages, model, isOAuthToken, cacheControl) {
                         role: "user",
                         content: sanitizeSurrogates(msg.content),
                     });
+                    if (msg.cacheBreakpoint)
+                        breakpointIndices.push(params.length - 1);
                 }
             }
             else {
@@ -226,6 +233,8 @@ export function convertMessages(messages, model, isOAuthToken, cacheControl) {
                     role: "user",
                     content: filteredBlocks,
                 });
+                if (msg.cacheBreakpoint)
+                    breakpointIndices.push(params.length - 1);
             }
         }
         else if (msg.role === "assistant") {
@@ -328,28 +337,42 @@ export function convertMessages(messages, model, isOAuthToken, cacheControl) {
         }
     }
     if (cacheControl && params.length > 0) {
-        const lastMessage = params[params.length - 1];
-        if (lastMessage.role === "user") {
-            if (Array.isArray(lastMessage.content)) {
-                const lastBlock = lastMessage.content[lastMessage.content.length - 1];
-                if (lastBlock &&
-                    (lastBlock.type === "text" || lastBlock.type === "image" || lastBlock.type === "tool_result")) {
-                    lastBlock.cache_control = cacheControl;
-                }
-            }
-            else if (typeof lastMessage.content === "string") {
-                lastMessage.content = [
-                    {
-                        type: "text",
-                        text: lastMessage.content,
-                        cache_control: cacheControl,
-                    },
-                ];
-            }
+        // Apply to the volatile suffix anchor (last user message) — existing behavior.
+        applyCacheControlToParam(params, params.length - 1, cacheControl);
+        // Apply to the most recent compaction-boundary message, if any. Capping at
+        // one boundary keeps us safely under Anthropic's 4-breakpoint limit
+        // (system + tools + boundary + last user = 4). If multiple
+        // cacheBreakpoint messages are present, only the most recent one — the
+        // freshest stable boundary — earns the breakpoint. (#5027)
+        const mostRecentBreakpoint = breakpointIndices[breakpointIndices.length - 1];
+        if (mostRecentBreakpoint !== undefined && mostRecentBreakpoint !== params.length - 1) {
+            applyCacheControlToParam(params, mostRecentBreakpoint, cacheControl);
         }
     }
     return params;
 }
+/** Apply `cache_control` to the last cacheable block of the user-role param at `index`. No-op for non-user roles. */
+function applyCacheControlToParam(params, index, cacheControl) {
+    const param = params[index];
+    if (!param || param.role !== "user")
+        return;
+    if (Array.isArray(param.content)) {
+        const lastBlock = param.content[param.content.length - 1];
+        if (lastBlock &&
+            (lastBlock.type === "text" || lastBlock.type === "image" || lastBlock.type === "tool_result")) {
+            lastBlock.cache_control = cacheControl;
+        }
+    }
+    else if (typeof param.content === "string") {
+        param.content = [
+            {
+                type: "text",
+                text: param.content,
+                cache_control: cacheControl,
+            },
+        ];
+    }
+}
 /** Convert GSD tools to Anthropic SDK tool definitions, applying cache control to the last entry. */
 export function convertTools(tools, isOAuthToken, cacheControl) {
     if (!tools)
@@ -383,11 +406,17 @@ export function buildParams(model, context, isOAuthToken, options) {
         stream: true,
     };
     if (isOAuthToken) {
+        // Only the LAST system block carries `cache_control` — the boundary
+        // covers the entire system prefix up to that point. Putting cache_control
+        // on the short "You are Claude Code" header AND the user systemPrompt
+        // would consume two of Anthropic's 4 breakpoint slots for redundant
+        // coverage, leaving no room for a compaction-summary breakpoint. (#5027)
+        const hasUserSystemPrompt = Boolean(context.systemPrompt);
         params.system = [
             {
                 type: "text",
                 text: "You are Claude Code, Anthropic's official CLI for Claude.",
-                ...(cacheControl ? { cache_control: cacheControl } : {}),
+                ...(cacheControl && !hasUserSystemPrompt ? { cache_control: cacheControl } : {}),
             },
         ];
         if (context.systemPrompt) {