gsd-pi 2.78.1-dev.84a383f51 → 2.78.1

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

@@ -1,231 +0,0 @@
-// @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

@@ -1 +0,0 @@
-{"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/src/providers/anthropic-shared.cache-breakpoint.test.ts

@@ -1,289 +0,0 @@
-// @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";
-import type { Context, Message, Model, Tool } from "../types.js";
-import type { AnthropicApi } 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"] } as unknown as Model<AnthropicApi>;
-const cacheControl = { type: "ephemeral" as const };
-
-function userMsg(text: string, opts: { cacheBreakpoint?: boolean } = {}): Message {
-	return {
-		role: "user",
-		content: text,
-		timestamp: 0,
-		...(opts.cacheBreakpoint ? { cacheBreakpoint: true } : {}),
-	} as Message;
-}
-
-/** Produces a UserMessage whose content is an array of text blocks —
- * the production shape emitted by `convertToLlm()` for compaction summaries. */
-function userMsgArray(text: string, opts: { cacheBreakpoint?: boolean } = {}): Message {
-	return {
-		role: "user",
-		content: [{ type: "text", text }],
-		timestamp: 0,
-		...(opts.cacheBreakpoint ? { cacheBreakpoint: true } : {}),
-	} as Message;
-}
-
-function assistantMsg(text: string): Message {
-	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,
-	} as Message;
-}
-
-/** Returns whether the message at the given index has cache_control on its last block. */
-function hasCacheControl(params: ReturnType<typeof convertMessages>, index: number): boolean {
-	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 as any).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 as any)[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 as any)[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 as any)[0]?.text?.includes("OLD COMPACTION"),
-		);
-		const newIdx = result.findIndex(
-			(p) => p.role === "user" && Array.isArray(p.content) && (p.content as any)[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 as any[]).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: { system?: any; tools?: any[]; messages: any[] }): number {
-	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 as any).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,
-} as unknown as Model<AnthropicApi>;
-
-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: Context = {
-			messages: [userMsg("hello")],
-			systemPrompt: "You are a helpful coding assistant.",
-		} as Context;
-		const params = buildParams(buildParamsModel, ctx, true) as any;
-		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: Context = {
-			messages: [
-				userMsg("[COMPACTION SUMMARY]", { cacheBreakpoint: true }),
-				userMsg("post-compaction turn"),
-			],
-			systemPrompt: "You are a helpful coding assistant.",
-		} as Context;
-		const params = buildParams(buildParamsModel, ctx, true) as any;
-		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: Tool = {
-			name: "Read",
-			description: "Read a file from disk.",
-			parameters: {
-				type: "object" as const,
-				properties: {
-					path: { type: "string" },
-				},
-				required: ["path"],
-			} as any,
-		};
-		const ctx: Context = {
-			messages: [
-				userMsg("[COMPACTION SUMMARY]", { cacheBreakpoint: true }),
-				userMsg("post-compaction turn"),
-			],
-			systemPrompt: "You are a helpful coding assistant.",
-			tools: [tool],
-		} as Context;
-		const params = buildParams(buildParamsModel, ctx, true) as any;
-		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: Context = { messages: [userMsg("hello")] } as Context;
-		const params = buildParams(buildParamsModel, ctx, true) as any;
-		assert.equal(countBreakpoints(params), 2, "header(1) + last user(1) = 2");
-	});
-});

package/packages/pi-coding-agent/dist/core/token-telemetry.d.ts

@@ -1,37 +0,0 @@
-import type { AssistantMessage } from "@gsd/pi-ai";
-/** Schema of one telemetry line. JSON-stable for downstream ingestion. */
-export interface TokenTelemetryRecord {
-    ts: number;
-    model: string;
-    stopReason: string;
-    input: number;
-    output: number;
-    cacheRead: number;
-    cacheWrite: number;
-    /**
-     * `usage.cost.total` from the provider. `0` when the provider's cost
-     * registry has no rates for this model (e.g. unknown third-party providers)
-     * — distinguish from a true zero-cost call by checking your model registry.
-     */
-    costTotal: number;
-    /**
-     * Fraction of new prompt tokens served from cache:
-     * `cacheRead / (cacheRead + input)`. Range [0, 1].
-     * - `0` when neither cacheRead nor input is present (no division by zero).
-     * - `1` on a full cache hit (input = 0, cacheRead > 0).
-     * Note: `input` here is `input_tokens` from the API, which already excludes
-     * cache reads/writes — the denominator is total prompt tokens consumed.
-     */
-    cacheHitRatio: number;
-}
-/** Build a telemetry record from a finished assistant message. */
-export declare function buildTokenTelemetryRecord(msg: AssistantMessage): TokenTelemetryRecord;
-/**
- * Emit a token-telemetry line if `PI_TOKEN_TELEMETRY=1`. No-op otherwise.
- *
- * Writes to stderr so it doesn't interfere with TUI/stdout. One JSON object
- * per line. Errors during emission are swallowed — telemetry must never
- * break the agent loop.
- */
-export declare function emitTokenTelemetry(msg: AssistantMessage): void;
-//# sourceMappingURL=token-telemetry.d.ts.map

package/packages/pi-coding-agent/dist/core/token-telemetry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"token-telemetry.d.ts","sourceRoot":"","sources":["../../src/core/token-telemetry.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;OAOG;IACH,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,kEAAkE;AAClE,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,gBAAgB,GAAG,oBAAoB,CAoBrF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAQ9D"}

package/packages/pi-coding-agent/dist/core/token-telemetry.js

@@ -1,49 +0,0 @@
-// @gsd/pi-coding-agent + token-telemetry — opt-in per-call token observability
-//
-// Emits a single JSON line per assistant message to stderr when
-// `PI_TOKEN_TELEMETRY=1` is set. Captures the cache_read_input_tokens and
-// cache_creation_input_tokens fields the providers already extract — so we
-// can empirically measure prompt-cache effectiveness (e.g. for #5019 and
-// future cache strategy work). Off by default — no behavior change.
-//
-// Capture pattern: `PI_TOKEN_TELEMETRY=1 npm start 2> token-telemetry.jsonl`
-/** Build a telemetry record from a finished assistant message. */
-export function buildTokenTelemetryRecord(msg) {
-    const input = msg.usage?.input ?? 0;
-    const output = msg.usage?.output ?? 0;
-    const cacheRead = msg.usage?.cacheRead ?? 0;
-    const cacheWrite = msg.usage?.cacheWrite ?? 0;
-    const costTotal = msg.usage?.cost?.total ?? 0;
-    const denom = cacheRead + input;
-    const cacheHitRatio = denom > 0 ? cacheRead / denom : 0;
-    return {
-        ts: msg.timestamp,
-        model: msg.model,
-        stopReason: msg.stopReason,
-        input,
-        output,
-        cacheRead,
-        cacheWrite,
-        costTotal,
-        cacheHitRatio,
-    };
-}
-/**
- * Emit a token-telemetry line if `PI_TOKEN_TELEMETRY=1`. No-op otherwise.
- *
- * Writes to stderr so it doesn't interfere with TUI/stdout. One JSON object
- * per line. Errors during emission are swallowed — telemetry must never
- * break the agent loop.
- */
-export function emitTokenTelemetry(msg) {
-    if (process.env.PI_TOKEN_TELEMETRY !== "1")
-        return;
-    try {
-        const record = buildTokenTelemetryRecord(msg);
-        process.stderr.write(`${JSON.stringify(record)}\n`);
-    }
-    catch {
-        // Telemetry must never break the agent loop. Swallow.
-    }
-}
-//# sourceMappingURL=token-telemetry.js.map