@multiplayer-app/agent 0.1.10 → 0.1.12

package/dist/agent/model-failure.d.ts

@@ -0,0 +1,10 @@
+/** The failure as the provider reported it, for the log: the message plus the response body it hides. */
+export declare function describeModelFailure(error: unknown): string;
+/**
+ * What the user reads when a model call fails for good: the cause in one sentence and what to
+ * do about it. The provider's own text goes to the log instead, since it carries API key ids,
+ * spend figures and request internals that an end user cannot act on and should not see.
+ * Undefined for failures that are not the provider's (storage, workspace), whose message stands.
+ */
+export declare function userFacingModelFailure(error: unknown): string | undefined;
+//# sourceMappingURL=model-failure.d.ts.map

package/dist/agent/model-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-failure.d.ts","sourceRoot":"","sources":["../../src/agent/model-failure.ts"],"names":[],"mappings":"AAEA,yGAAyG;AACzG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM3D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAwBzE"}

package/dist/agent/model-failure.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeModelFailure = describeModelFailure;
+exports.userFacingModelFailure = userFacingModelFailure;
+const ai_1 = require("ai");
+/** The failure as the provider reported it, for the log: the message plus the response body it hides. */
+function describeModelFailure(error) {
+    const cause = unwrap(error);
+    const message = cause instanceof Error ? cause.message : String(cause);
+    const body = cause === null || cause === void 0 ? void 0 : cause.responseBody;
+    if (typeof body !== 'string' || !body.trim() || message.includes(body.trim()))
+        return message;
+    return `${message} body=${body.trim().slice(0, 600)}`;
+}
+/**
+ * What the user reads when a model call fails for good: the cause in one sentence and what to
+ * do about it. The provider's own text goes to the log instead, since it carries API key ids,
+ * spend figures and request internals that an end user cannot act on and should not see.
+ * Undefined for failures that are not the provider's (storage, workspace), whose message stands.
+ */
+function userFacingModelFailure(error) {
+    const cause = unwrap(error);
+    const statusCode = cause === null || cause === void 0 ? void 0 : cause.statusCode;
+    const status = typeof statusCode === 'number' ? statusCode : undefined;
+    const text = describeModelFailure(cause).toLowerCase();
+    if (status === 402 || /key limit|spending limit|insufficient credits|insufficient_quota|quota|billing/.test(text)) {
+        return 'The AI provider has reached the spending limit for this workspace. Ask an administrator to raise it, then send the request again.';
+    }
+    if (status === 401 || status === 403 || /invalid api key|unauthorized|forbidden|authentication/.test(text)) {
+        return "The AI provider rejected this workspace's API key. Ask an administrator to check the provider settings.";
+    }
+    if (/context length|context window|too many tokens|maximum context|prompt is too long|input is too long/.test(text)) {
+        return 'The conversation is too long for the selected model. Start a new session or choose a model with a larger context window.';
+    }
+    if (status === 404 || /model .*not found|no endpoints found|not a valid model/.test(text)) {
+        return 'The selected model is not available from the AI provider. Choose another model and try again.';
+    }
+    if (status === 429 || /rate.?limit|too many requests|overloaded/.test(text)) {
+        return 'The AI provider is busy right now. Try again in a moment.';
+    }
+    if ((status !== undefined && status >= 500) || /econnreset|etimedout|fetch failed|socket hang up|timed out/.test(text)) {
+        return 'The AI provider did not respond. Try again in a moment.';
+    }
+    return ai_1.APICallError.isInstance(cause) || status !== undefined ? 'The AI provider returned an error. Try again in a moment.' : undefined;
+}
+/** The ai SDK wraps the last provider error in a RetryError once its own retries run out. */
+function unwrap(error) {
+    return ai_1.RetryError.isInstance(error) ? error.lastError : error;
+}
+//# sourceMappingURL=model-failure.js.map

package/dist/agent/model-failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-failure.js","sourceRoot":"","sources":["../../src/agent/model-failure.ts"],"names":[],"mappings":";;AAGA,oDAMC;AAQD,wDAwBC;AAzCD,2BAA6C;AAE7C,yGAAyG;AACzG,SAAgB,oBAAoB,CAAC,KAAc;IACjD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC3B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACtE,MAAM,IAAI,GAAI,KAA2C,aAA3C,KAAK,uBAAL,KAAK,CAAwC,YAAY,CAAA;IACvE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAAE,OAAO,OAAO,CAAA;IAC7F,OAAO,GAAG,OAAO,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAA;AACvD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAC,KAAc;IACnD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC3B,MAAM,UAAU,GAAI,KAAyC,aAAzC,KAAK,uBAAL,KAAK,CAAsC,UAAU,CAAA;IACzE,MAAM,MAAM,GAAG,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAA;IACtE,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;IACtD,IAAI,MAAM,KAAK,GAAG,IAAI,gFAAgF,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAClH,OAAO,mIAAmI,CAAA;IAC5I,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,IAAI,uDAAuD,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3G,OAAO,yGAAyG,CAAA;IAClH,CAAC;IACD,IAAI,oGAAoG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpH,OAAO,0HAA0H,CAAA;IACnI,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,IAAI,wDAAwD,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1F,OAAO,+FAA+F,CAAA;IACxG,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,IAAI,0CAA0C,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5E,OAAO,2DAA2D,CAAA;IACpE,CAAC;IACD,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,IAAI,GAAG,CAAC,IAAI,4DAA4D,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvH,OAAO,yDAAyD,CAAA;IAClE,CAAC;IACD,OAAO,iBAAY,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,2DAA2D,CAAC,CAAC,CAAC,SAAS,CAAA;AACzI,CAAC;AAED,6FAA6F;AAC7F,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,eAAU,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAA;AAC/D,CAAC"}

package/dist/agent/profiles/research.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../../src/agent/profiles/research.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAO9D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,GAAG,eAAe,CA8BrG"}
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../../src/agent/profiles/research.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAQ9D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,GAAG,eAAe,CAyCrG"}

package/dist/agent/profiles/research.js

@@ -8,9 +8,16 @@ const filingramp_tools_1 = require("../../research/filingramp-tools");
 const prompt_1 = require("../../research/prompt");
 const tools_1 = require("../../session/tools");
 function createResearchAgent(config, workspaceDir) {
-    // Keep authentication and resolved scope labels across turns. These tools do not own turn state.
+    // Keep authentication and resolved scope labels across turns. These tools do not own turn state:
+    // bulk progress goes to whichever turn is running, through the slot createTools fills each turn.
+    let reportProgress;
     const filingTools = config.filingRamp
-        ? (0, filingramp_tools_1.createFilingRampTools)({ client: new filingramp_client_1.FilingRampClient(config.filingRamp), workspaceDir, scope: config.researchScope })
+        ? (0, filingramp_tools_1.createFilingRampTools)({
+            client: new filingramp_client_1.FilingRampClient(config.filingRamp),
+            workspaceDir,
+            scope: config.researchScope,
+            onProgress: (toolCallId, done, total, label) => reportProgress === null || reportProgress === void 0 ? void 0 : reportProgress([{ key: 'bulk', label, status: done < total ? 'active' : 'done', detail: `${done}/${total}` }], toolCallId),
+        })
         : {};
     if (!config.filingRamp) {
         console.warn('[session] research profile without FilingRamp credentials — filing tools disabled');
@@ -29,15 +36,18 @@ function createResearchAgent(config, workspaceDir) {
                 restored,
             });
         },
-        createTools: (context) => ({
-            ...(0, tools_1.createSessionTools)(context, config.mcpConnections),
-            ...filingTools,
-            extract_from_texts: (0, extraction_tool_1.createExtractionTool)(context, {
-                id: config.extractionModel,
-                provider: config.provider,
-                attribution: attribution_1.OPENROUTER_APPS.DEEP_RESEARCH,
-            }),
-        }),
+        createTools: (context) => {
+            reportProgress = (steps, toolCallId) => context.reportProgress(steps, toolCallId);
+            return {
+                ...(0, tools_1.createSessionTools)(context, config.mcpConnections),
+                ...filingTools,
+                extract_from_texts: (0, extraction_tool_1.createExtractionTool)(context, {
+                    id: config.extractionModel,
+                    provider: config.provider,
+                    attribution: attribution_1.OPENROUTER_APPS.DEEP_RESEARCH,
+                }),
+            };
+        },
     };
 }
 //# sourceMappingURL=research.js.map

package/dist/agent/profiles/research.js.map

@@ -1 +1 @@
-{"version":3,"file":"research.js","sourceRoot":"","sources":["../../../src/agent/profiles/research.ts"],"names":[],"mappings":";;AASA,kDA8BC;AAtCD,0DAA0D;AAE1D,oEAAqE;AACrE,wEAAmE;AACnE,sEAAuE;AACvE,kDAA0F;AAC1F,+CAAwD;AAExD,SAAgB,mBAAmB,CAAC,MAA0B,EAAE,YAAoB;IAClF,iGAAiG;IACjG,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU;QACnC,CAAC,CAAC,IAAA,wCAAqB,EAAC,EAAE,MAAM,EAAE,IAAI,oCAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC;QACvH,CAAC,CAAC,EAAE,CAAA;IACN,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,mFAAmF,CAAC,CAAA;IACnG,CAAC;IAED,OAAO;QACL,OAAO,EAAE,UAAU;QACnB,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,6BAAe,CAAC,aAAa,EAAE;QAClG,QAAQ,EAAE,EAAE;QACZ,oBAAoB,EAAE,gCAAuB;QAC7C,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE;;YAAC,OAAA,IAAA,kCAAyB,EAAC;gBACrE,KAAK,EAAE,MAAM,CAAC,aAAa;gBAC3B,YAAY,EAAE,OAAO,CAAC,MAAA,MAAM,CAAC,UAAU,0CAAE,YAAY,CAAC;gBACtD,WAAW;gBACX,QAAQ;aACT,CAAC,CAAA;SAAA;QACF,WAAW,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACzB,GAAG,IAAA,0BAAkB,EAAC,OAAO,EAAE,MAAM,CAAC,cAAc,CAAC;YACrD,GAAG,WAAW;YACd,kBAAkB,EAAE,IAAA,sCAAoB,EAAC,OAAO,EAAE;gBAChD,EAAE,EAAE,MAAM,CAAC,eAAe;gBAC1B,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,WAAW,EAAE,6BAAe,CAAC,aAAa;aAC3C,CAAC;SACH,CAAC;KACH,CAAA;AACH,CAAC"}
+{"version":3,"file":"research.js","sourceRoot":"","sources":["../../../src/agent/profiles/research.ts"],"names":[],"mappings":";;AAUA,kDAyCC;AAlDD,0DAA0D;AAE1D,oEAAqE;AACrE,wEAAmE;AACnE,sEAAuE;AACvE,kDAA0F;AAC1F,+CAAwD;AAGxD,SAAgB,mBAAmB,CAAC,MAA0B,EAAE,YAAoB;IAClF,iGAAiG;IACjG,iGAAiG;IACjG,IAAI,cAAgE,CAAA;IACpE,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU;QACnC,CAAC,CAAC,IAAA,wCAAqB,EAAC;YACpB,MAAM,EAAE,IAAI,oCAAgB,CAAC,MAAM,CAAC,UAAU,CAAC;YAC/C,YAAY;YACZ,KAAK,EAAE,MAAM,CAAC,aAAa;YAC3B,UAAU,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAC7C,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAG,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC,EAAE,UAAU,CAAC;SAC/H,CAAC;QACJ,CAAC,CAAC,EAAE,CAAA;IACN,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,mFAAmF,CAAC,CAAA;IACnG,CAAC;IAED,OAAO;QACL,OAAO,EAAE,UAAU;QACnB,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,6BAAe,CAAC,aAAa,EAAE;QAClG,QAAQ,EAAE,EAAE;QACZ,oBAAoB,EAAE,gCAAuB;QAC7C,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE;;YAAC,OAAA,IAAA,kCAAyB,EAAC;gBACrE,KAAK,EAAE,MAAM,CAAC,aAAa;gBAC3B,YAAY,EAAE,OAAO,CAAC,MAAA,MAAM,CAAC,UAAU,0CAAE,YAAY,CAAC;gBACtD,WAAW;gBACX,QAAQ;aACT,CAAC,CAAA;SAAA;QACF,WAAW,EAAE,CAAC,OAAO,EAAE,EAAE;YACvB,cAAc,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;YACjF,OAAO;gBACL,GAAG,IAAA,0BAAkB,EAAC,OAAO,EAAE,MAAM,CAAC,cAAc,CAAC;gBACrD,GAAG,WAAW;gBACd,kBAAkB,EAAE,IAAA,sCAAoB,EAAC,OAAO,EAAE;oBAChD,EAAE,EAAE,MAAM,CAAC,eAAe;oBAC1B,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,WAAW,EAAE,6BAAe,CAAC,aAAa;iBAC3C,CAAC;aACH,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/agent/progress-reminder.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=progress-reminder.test.d.ts.map

package/dist/agent/progress-reminder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-reminder.test.d.ts","sourceRoot":"","sources":["../../src/agent/progress-reminder.test.ts"],"names":[],"mappings":""}

package/dist/agent/progress-reminder.test.js

@@ -0,0 +1,20 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_test_1 = require("node:test");
+const turn_runner_1 = require("./turn-runner");
+const step = (...names) => ({ toolCalls: names.map((toolName) => ({ toolName })) });
+(0, node_test_1.describe)('stepsSinceProgress', () => {
+    (0, node_test_1.it)('counts steps after the last report_progress call', () => {
+        strict_1.default.equal((0, turn_runner_1.stepsSinceProgress)([step('report_progress'), step('get_filing'), step('run_command')]), 2);
+        strict_1.default.equal((0, turn_runner_1.stepsSinceProgress)([step('get_filing'), step('report_progress', 'run_command')]), 0);
+    });
+    (0, node_test_1.it)('counts every step when the agent never reported', () => {
+        strict_1.default.equal((0, turn_runner_1.stepsSinceProgress)([step('get_filing'), step('run_command')]), 2);
+        strict_1.default.equal((0, turn_runner_1.stepsSinceProgress)([]), 0);
+    });
+});
+//# sourceMappingURL=progress-reminder.test.js.map

package/dist/agent/progress-reminder.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-reminder.test.js","sourceRoot":"","sources":["../../src/agent/progress-reminder.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAuC;AACvC,yCAAwC;AACxC,+CAAkD;AAElD,MAAM,IAAI,GAAG,CAAC,GAAG,KAAe,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;AAE7F,IAAA,oBAAQ,EAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,IAAA,cAAE,EAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,gBAAM,CAAC,KAAK,CAAC,IAAA,gCAAkB,EAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACvG,gBAAM,CAAC,KAAK,CAAC,IAAA,gCAAkB,EAAC,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACnG,CAAC,CAAC,CAAA;IAEF,IAAA,cAAE,EAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,gBAAM,CAAC,KAAK,CAAC,IAAA,gCAAkB,EAAC,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAC9E,gBAAM,CAAC,KAAK,CAAC,IAAA,gCAAkB,EAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/agent/turn-runner.d.ts

@@ -2,6 +2,12 @@ import { type ModelMessage } from 'ai';
 import type { AgentDefinition } from './definition';
 import type { OutboundEvent } from '../transport/link';
 import { type TokenUsage } from '../models/usage';
+/** Steps since the agent last called report_progress in this turn (all of them when it never did). */
+export declare function stepsSinceProgress(steps: Array<{
+    toolCalls: Array<{
+        toolName: string;
+    }>;
+}>): number;
 export interface TurnInput {
     messageId: string;
     messages: ModelMessage[];
@@ -9,6 +15,10 @@ export interface TurnInput {
     workspaceDir: string;
     abortSignal: AbortSignal;
     budgetExceeded(): boolean;
+    /** Past the share of the budget where a research turn stops and saves what it has. */
+    nearBudget?(): boolean;
+    /** The user chose "wrap up" at the budget pause: this turn only saves what there is. */
+    wrapUpOnly?: boolean;
     recordUsage(usage: TokenUsage): void;
     emit(event: OutboundEvent): void;
 }
@@ -17,15 +27,22 @@ interface TurnOutput {
     messages: ModelMessage[];
     partialText: string;
     askedUser: boolean;
+    /** The turn ran the budget wrap-up. */
+    wrappedUp?: boolean;
+    /** The wrap-up wrote or published files, so the pause notice may say the work is saved. */
+    saved?: boolean;
 }
 export type TurnResult = TurnOutput & ({
     status: 'completed';
     text: string;
 } | {
     status: 'aborted';
-} | {
+}
+/** `error` is the failure as the provider reported it (for the log); `userMessage` is what the user reads. */
+ | {
     status: 'failed';
     error: string;
+    userMessage: string;
 });
 /** Executes one turn. It neither mutates conversation history nor checkpoints or schedules work. */
 export declare class TurnRunner {

package/dist/agent/turn-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"turn-runner.d.ts","sourceRoot":"","sources":["../../src/agent/turn-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,IAAI,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAGtD,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE1D,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,WAAW,CAAA;IACxB,cAAc,IAAI,OAAO,CAAA;IACzB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IACpC,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAA;CACjC;AAED,UAAU,UAAU;IAClB,kGAAkG;IAClG,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,CAClC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CACtC,CAAA;AAED,oGAAoG;AACpG,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,eAAe;IAElD,GAAG,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;CAgFjD"}
+{"version":3,"file":"turn-runner.d.ts","sourceRoot":"","sources":["../../src/agent/turn-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,YAAY,EAAiC,MAAM,IAAI,CAAA;AAC9F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAGtD,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAkB1D,sGAAsG;AACtG,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC;IAAE,SAAS,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,GAAG,MAAM,CAKnG;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,WAAW,CAAA;IACxB,cAAc,IAAI,OAAO,CAAA;IACzB,sFAAsF;IACtF,UAAU,CAAC,IAAI,OAAO,CAAA;IACtB,wFAAwF;IACxF,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IACpC,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAA;CACjC;AAED,UAAU,UAAU;IAClB,kGAAkG;IAClG,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;IAClB,uCAAuC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,2FAA2F;IAC3F,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,CAClC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE;AACvB,8GAA8G;GAC5G;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAC3D,CAAA;AAED,oGAAoG;AACpG,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,eAAe;IAElD,GAAG,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;CA6GjD"}

package/dist/agent/turn-runner.js

@@ -1,19 +1,43 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TurnRunner = void 0;
+exports.stepsSinceProgress = stepsSinceProgress;
 const ai_1 = require("ai");
 const resolve_model_1 = require("../models/resolve-model");
 const usage_1 = require("../models/usage");
+const context_pruning_1 = require("../context-pruning");
+const tool_call_repair_1 = require("../tool-call-repair");
+const model_failure_1 = require("./model-failure");
+/** Steps the budget wrap-up may take (write notes and findings, publish, summarize) before the turn stops. */
+const WRAP_UP_STEPS = 4;
+const WRAP_UP_TOOLS = ['write_files', 'read_file', 'run_command', 'publish_results'];
+const WRAP_UP_INSTRUCTIONS = `(Automatic note, not from the user.) The token budget for this session is nearly used up. Stop researching now: no new searches, downloads or extraction. In the next few steps only:
+1. Update research/notes.md: what is done, what is not, and the exact next step.
+2. Write research/findings.md as a draft marked PARTIAL at the top, with what you found so far and its coverage (documents read vs not yet read).
+3. Call publish_results with those files, then end with a short summary saying the findings are partial and the user can reply "continue".`;
+/** Steps without a report_progress call after which the agent is reminded to update the checklist. */
+const PROGRESS_REMINDER_STEPS = 6;
+const PROGRESS_REMINDER = '(Automatic check, not from the user: the pinned "Research progress" checklist still shows the phases as you last reported them. If a phase has started or finished since, call report_progress with the full updated list now, alongside your next action. If nothing changed, ignore this note.)';
+/** Steps since the agent last called report_progress in this turn (all of them when it never did). */
+function stepsSinceProgress(steps) {
+    for (let index = steps.length - 1; index >= 0; index -= 1) {
+        if (steps[index].toolCalls.some((call) => call.toolName === 'report_progress'))
+            return steps.length - 1 - index;
+    }
+    return steps.length;
+}
 /** Executes one turn. It neither mutates conversation history nor checkpoints or schedules work. */
 class TurnRunner {
     constructor(definition) {
         this.definition = definition;
     }
     async run(input) {
-        var _a, _b;
+        var _a, _b, _c;
         const { messageId, abortSignal, emit } = input;
         let partialText = '';
         let askedUser = false;
+        let wrapUpFrom;
+        let saved = false;
         let responseMessages;
         const recordUsage = (usage, model) => {
             input.recordUsage(usage);
@@ -32,14 +56,41 @@ class TurnRunner {
         };
         try {
             abortSignal.throwIfAborted();
-            const { model, maxSteps } = this.definition;
+            const { model, maxSteps, profile } = this.definition;
+            const tools = this.definition.createTools(context);
+            // The wrap-up needs a research workspace to save into; the coding profile just stops at the budget.
+            const research = profile === 'research';
+            const wrapUpDone = ({ steps }) => wrapUpFrom !== undefined ? steps.length - wrapUpFrom >= WRAP_UP_STEPS : !research && input.budgetExceeded();
             const result = (0, ai_1.streamText)({
                 model: (0, resolve_model_1.resolveLanguageModel)(model.provider, model.id, model.attribution),
                 system: input.instructions,
                 messages: input.messages,
-                tools: this.definition.createTools(context),
+                tools,
                 abortSignal,
-                stopWhen: [(0, ai_1.stepCountIs)(maxSteps), () => askedUser || input.budgetExceeded()],
+                stopWhen: [(0, ai_1.stepCountIs)(maxSteps), () => askedUser, wrapUpDone],
+                experimental_repairToolCall: tool_call_repair_1.repairStringifiedToolInput,
+                prepareStep: ({ stepNumber, steps, messages }) => {
+                    var _a;
+                    const pruned = (0, context_pruning_1.pruneToolResults)(messages);
+                    if (wrapUpFrom === undefined && research && (input.wrapUpOnly || ((_a = input.nearBudget) === null || _a === void 0 ? void 0 : _a.call(input))))
+                        wrapUpFrom = stepNumber;
+                    if (wrapUpFrom === undefined) {
+                        // The chat pins the checklist; a stale one tells the user nothing is moving. The note is
+                        // appended for this step only, after the cached prefix, and is never saved. Once every
+                        // PROGRESS_REMINDER_STEPS quiet steps, so an agent whose phase has not changed is not nagged.
+                        const since = stepsSinceProgress(steps);
+                        const stale = research && 'report_progress' in tools && since > 0 && since % PROGRESS_REMINDER_STEPS === 0;
+                        return { messages: stale ? [...pruned, { role: 'user', content: PROGRESS_REMINDER }] : pruned };
+                    }
+                    // The instructions go last, as a note, rather than into the system prompt: the model acts on
+                    // the newest message (in one run it ignored a system-only switch and ended on leftover
+                    // text), and the cached prefix stays intact. A forced tool call (toolChoice "required") is
+                    // not an option: Anthropic rejects it while extended thinking is on.
+                    return {
+                        messages: saved ? pruned : [...pruned, { role: 'user', content: WRAP_UP_INSTRUCTIONS }],
+                        activeTools: WRAP_UP_TOOLS.filter((name) => name in tools),
+                    };
+                },
             });
             for await (const part of result.fullStream) {
                 switch (part.type) {
@@ -51,6 +102,8 @@ class TurnRunner {
                         emit({ type: 'reasoning_delta', messageId, text: part.text });
                         break;
                     case 'tool-call':
+                        if (wrapUpFrom !== undefined && (part.toolName === 'publish_results' || part.toolName === 'write_files'))
+                            saved = true;
                         emit({ type: 'tool_call_start', messageId, toolCallId: part.toolCallId, toolName: part.toolName, input: part.input });
                         break;
                     case 'tool-result':
@@ -75,7 +128,7 @@ class TurnRunner {
             abortSignal.throwIfAborted();
             responseMessages = (await result.response).messages;
             const text = await result.text;
-            return { status: 'completed', messages: responseMessages, text, partialText, askedUser };
+            return { status: 'completed', messages: responseMessages, text, partialText, askedUser, wrappedUp: wrapUpFrom !== undefined, saved };
         }
         catch (error) {
             const aborted = abortSignal.aborted;
@@ -83,10 +136,10 @@ class TurnRunner {
             const messages = responseMessages !== null && responseMessages !== void 0 ? responseMessages : [{
                     role: 'assistant', content: partialText || (aborted ? '(stopped by the user)' : '(turn failed)'),
                 }];
-            const output = { messages, partialText, askedUser };
+            const output = { messages, partialText, askedUser, wrappedUp: wrapUpFrom !== undefined, saved };
             return aborted
                 ? { ...output, status: 'aborted' }
-                : { ...output, status: 'failed', error: error instanceof Error ? error.message : String(error) };
+                : { ...output, status: 'failed', error: (0, model_failure_1.describeModelFailure)(error), userMessage: (_c = (0, model_failure_1.userFacingModelFailure)(error)) !== null && _c !== void 0 ? _c : (0, model_failure_1.describeModelFailure)(error) };
         }
     }
 }

package/dist/agent/turn-runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"turn-runner.js","sourceRoot":"","sources":["../../src/agent/turn-runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"turn-runner.js","sourceRoot":"","sources":["../../src/agent/turn-runner.ts"],"names":[],"mappings":"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"}

package/dist/context-pruning.d.ts

@@ -0,0 +1,13 @@
+import type { ModelMessage } from 'ai';
+export interface PruneOptions {
+    /** Messages at the end of the conversation that are never pruned (the steps the agent is working on). */
+    keepRecent: number;
+    /** Results smaller than this are kept: they cost little and often carry the answer. */
+    minChars: number;
+    /** Prune only once the prunable results together exceed this many characters. */
+    triggerChars: number;
+}
+export declare const DEFAULT_PRUNE_OPTIONS: PruneOptions;
+/** Returns `messages` unchanged until old bulky tool results pass `triggerChars`, then a copy with them stubbed. */
+export declare function pruneToolResults(messages: ModelMessage[], options?: PruneOptions): ModelMessage[];
+//# sourceMappingURL=context-pruning.d.ts.map

package/dist/context-pruning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pruning.d.ts","sourceRoot":"","sources":["../src/context-pruning.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAA;AAEtC,MAAM,WAAW,YAAY;IAC3B,yGAAyG;IACzG,UAAU,EAAE,MAAM,CAAA;IAClB,uFAAuF;IACvF,QAAQ,EAAE,MAAM,CAAA;IAChB,iFAAiF;IACjF,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,eAAO,MAAM,qBAAqB,EAAE,YAAwE,CAAA;AA6B5G,oHAAoH;AACpH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,OAAO,GAAE,YAAoC,GAAG,YAAY,EAAE,CAuBxH"}

package/dist/context-pruning.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PRUNE_OPTIONS = void 0;
+exports.pruneToolResults = pruneToolResults;
+exports.DEFAULT_PRUNE_OPTIONS = { keepRecent: 6, minChars: 2000, triggerChars: 120000 };
+const PATH_KEYS = ['path', 'textPath', 'saved', 'manifest', 'outputManifest', 'outputPath', 'saveHits'];
+function isToolResult(part) {
+    return !!part && typeof part === 'object' && part.type === 'tool-result';
+}
+/** Workspace paths a tool result mentions at its top level (or one level down, e.g. `saved.path`). */
+function mentionedPaths(output) {
+    const value = output && typeof output === 'object' && 'value' in output ? output.value : output;
+    if (!value || typeof value !== 'object')
+        return [];
+    const found = [];
+    for (const key of PATH_KEYS) {
+        const entry = value[key];
+        if (typeof entry === 'string')
+            found.push(entry);
+        else if (entry && typeof entry === 'object' && typeof entry.path === 'string')
+            found.push(entry.path);
+    }
+    return [...new Set(found)];
+}
+function stub(part, chars) {
+    const paths = mentionedPaths(part.output);
+    const where = paths.length ? ` Its data is on disk: ${paths.join(', ')}.` : ' Re-run the tool or read the workspace files if you need it again.';
+    return { ...part, output: { type: 'text', value: `[${part.toolName} result removed from the conversation to save tokens (${chars.toLocaleString()} chars).${where}]` } };
+}
+/** Returns `messages` unchanged until old bulky tool results pass `triggerChars`, then a copy with them stubbed. */
+function pruneToolResults(messages, options = exports.DEFAULT_PRUNE_OPTIONS) {
+    const cutoff = Math.max(0, messages.length - options.keepRecent);
+    let prunable = 0;
+    for (const message of messages.slice(0, cutoff)) {
+        if (message.role !== 'tool')
+            continue;
+        for (const part of message.content) {
+            if (!isToolResult(part))
+                continue;
+            const chars = JSON.stringify(part.output).length;
+            if (chars >= options.minChars)
+                prunable += chars;
+        }
+    }
+    if (prunable < options.triggerChars)
+        return messages;
+    return messages.map((message, index) => {
+        if (index >= cutoff || message.role !== 'tool')
+            return message;
+        return {
+            ...message,
+            content: message.content.map((part) => {
+                if (!isToolResult(part))
+                    return part;
+                const chars = JSON.stringify(part.output).length;
+                return chars >= options.minChars ? stub(part, chars) : part;
+            }),
+        };
+    });
+}
+//# sourceMappingURL=context-pruning.js.map

package/dist/context-pruning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pruning.js","sourceRoot":"","sources":["../src/context-pruning.ts"],"names":[],"mappings":"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"}

package/dist/context-pruning.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context-pruning.test.d.ts.map

package/dist/context-pruning.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pruning.test.d.ts","sourceRoot":"","sources":["../src/context-pruning.test.ts"],"names":[],"mappings":""}

package/dist/context-pruning.test.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_test_1 = require("node:test");
+const context_pruning_1 = require("./context-pruning");
+function call(id) {
+    return { role: 'assistant', content: [{ type: 'tool-call', toolCallId: id, toolName: 'get_filing', input: {} }] };
+}
+function result(id, value) {
+    return { role: 'tool', content: [{ type: 'tool-result', toolCallId: id, toolName: 'get_filing', output: { type: 'json', value: value } }] };
+}
+const options = { keepRecent: 2, minChars: 100, triggerChars: 1000 };
+(0, node_test_1.describe)('pruneToolResults', () => {
+    (0, node_test_1.it)('keeps everything while old bulky results stay under the trigger', () => {
+        const messages = [{ role: 'user', content: 'q' }, call('1'), result('1', { data: 'x'.repeat(500) }), call('2'), result('2', { ok: true })];
+        strict_1.default.equal((0, context_pruning_1.pruneToolResults)(messages, options), messages);
+    });
+    (0, node_test_1.it)('stubs old bulky results with the paths they pointed to, and keeps recent and small ones', () => {
+        const messages = [
+            { role: 'user', content: 'q' },
+            call('1'),
+            result('1', { data: 'x'.repeat(1200), saved: { path: 'data/filings/T1.json', bytes: 9 }, manifest: { path: 'data/manifests/T1-attachments.jsonl' } }),
+            call('2'),
+            result('2', { ok: true }),
+            call('3'),
+            result('3', { data: 'y'.repeat(1200) }),
+        ];
+        const pruned = (0, context_pruning_1.pruneToolResults)(messages, options);
+        const output = (index) => pruned[index].content[0].output;
+        strict_1.default.equal(output(2).type, 'text');
+        strict_1.default.match(String(output(2).value), /get_filing result removed.*data\/filings\/T1\.json, data\/manifests\/T1-attachments\.jsonl/);
+        strict_1.default.deepEqual(output(4), { type: 'json', value: { ok: true } });
+        strict_1.default.equal(output(6).type, 'json');
+        strict_1.default.equal(messages[2], messages[2], 'input is not mutated');
+        strict_1.default.equal(messages[2].content[0].output.type, 'json');
+    });
+    (0, node_test_1.it)('is monotonic: a result pruned at one step stays pruned when more steps follow', () => {
+        const base = [{ role: 'user', content: 'q' }, call('1'), result('1', { data: 'x'.repeat(1200) }), call('2'), result('2', { data: 'y'.repeat(150) })];
+        const later = [...base, call('3'), result('3', { data: 'z'.repeat(150) })];
+        const first = (0, context_pruning_1.pruneToolResults)(base, options);
+        const second = (0, context_pruning_1.pruneToolResults)(later, options);
+        strict_1.default.deepEqual(second.slice(0, 3), first.slice(0, 3));
+    });
+});
+//# sourceMappingURL=context-pruning.test.js.map

package/dist/context-pruning.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pruning.test.js","sourceRoot":"","sources":["../src/context-pruning.test.ts"],"names":[],"mappings":"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"}

package/dist/models/resolve-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-model.d.ts","sourceRoot":"","sources":["../../src/models/resolve-model.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAA;AACvC,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAE5D,oGAAoG;AACpG,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,aAAa,CAWtH"}
+{"version":3,"file":"resolve-model.d.ts","sourceRoot":"","sources":["../../src/models/resolve-model.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAA;AACvC,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAE5D,oGAAoG;AACpG,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,aAAa,CAatH"}

package/dist/models/resolve-model.js

@@ -10,7 +10,9 @@ const attribution_1 = require("./attribution");
 function resolveLanguageModel(provider, modelId, app) {
     if (provider.openrouterApiKey) {
         const openrouter = (0, ai_sdk_provider_1.createOpenRouter)({ apiKey: provider.openrouterApiKey, headers: (0, attribution_1.openRouterAppHeaders)(app) });
-        return openrouter.chat(modelId);
+        // Anthropic prompt caching: every step of a turn re-sends the whole conversation, and the
+        // cached prefix is what keeps a long research turn affordable.
+        return openrouter.chat(modelId, modelId.startsWith('anthropic/') ? { cache_control: { type: 'ephemeral' } } : {});
     }
     if (provider.anthropicApiKey || process.env.ANTHROPIC_API_KEY) {
         const anthropic = (0, anthropic_1.createAnthropic)({ apiKey: provider.anthropicApiKey });

package/dist/models/resolve-model.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-model.js","sourceRoot":"","sources":["../../src/models/resolve-model.ts"],"names":[],"mappings":";;AASA,oDAWC;AApBD,8FAA8F;AAC9F,8FAA8F;AAC9F,iDAAmD;AACnD,iEAA8D;AAE9D,+CAAwE;AAGxE,oGAAoG;AACpG,SAAgB,oBAAoB,CAAC,QAA6B,EAAE,OAAe,EAAE,GAAkB;IACrG,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,IAAA,kCAAgB,EAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,EAAE,IAAA,kCAAoB,EAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC9G,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACjC,CAAC;IACD,IAAI,QAAQ,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAC9D,MAAM,SAAS,GAAG,IAAA,2BAAe,EAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAA;QACvE,8EAA8E;QAC9E,OAAO,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAA;IACvD,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAA;AAC9F,CAAC"}
+{"version":3,"file":"resolve-model.js","sourceRoot":"","sources":["../../src/models/resolve-model.ts"],"names":[],"mappings":";;AASA,oDAaC;AAtBD,8FAA8F;AAC9F,8FAA8F;AAC9F,iDAAmD;AACnD,iEAA8D;AAE9D,+CAAwE;AAGxE,oGAAoG;AACpG,SAAgB,oBAAoB,CAAC,QAA6B,EAAE,OAAe,EAAE,GAAkB;IACrG,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,IAAA,kCAAgB,EAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,EAAE,IAAA,kCAAoB,EAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC9G,0FAA0F;QAC1F,+DAA+D;QAC/D,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IACnH,CAAC;IACD,IAAI,QAAQ,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAC9D,MAAM,SAAS,GAAG,IAAA,2BAAe,EAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAA;QACvE,8EAA8E;QAC9E,OAAO,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAA;IACvD,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAA;AAC9F,CAAC"}

package/dist/models/usage.d.ts

@@ -2,6 +2,10 @@ export interface TokenUsage {
     inputTokens: number;
     outputTokens: number;
     totalTokens: number;
+    /** Part of inputTokens served from the provider's prompt cache. */
+    cacheReadTokens?: number;
+    /** Part of inputTokens written to the prompt cache. */
+    cacheWriteTokens?: number;
 }
 export declare function usageOf(part: unknown): TokenUsage | undefined;
 //# sourceMappingURL=usage.d.ts.map

package/dist/models/usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/models/usage.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAM7D"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/models/usage.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAc7D"}

package/dist/models/usage.js

@@ -2,12 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.usageOf = usageOf;
 function usageOf(part) {
-    var _a, _b, _c;
+    var _a, _b, _c, _d, _e;
     const usage = part.usage;
     if (!usage)
         return undefined;
     const inputTokens = (_a = usage.inputTokens) !== null && _a !== void 0 ? _a : 0;
     const outputTokens = (_b = usage.outputTokens) !== null && _b !== void 0 ? _b : 0;
-    return { inputTokens, outputTokens, totalTokens: (_c = usage.totalTokens) !== null && _c !== void 0 ? _c : inputTokens + outputTokens };
+    return {
+        inputTokens,
+        outputTokens,
+        totalTokens: (_c = usage.totalTokens) !== null && _c !== void 0 ? _c : inputTokens + outputTokens,
+        cacheReadTokens: (_d = usage.inputTokenDetails) === null || _d === void 0 ? void 0 : _d.cacheReadTokens,
+        cacheWriteTokens: (_e = usage.inputTokenDetails) === null || _e === void 0 ? void 0 : _e.cacheWriteTokens,
+    };
 }
 //# sourceMappingURL=usage.js.map

package/dist/models/usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/models/usage.ts"],"names":[],"mappings":";;AAMA,0BAMC;AAND,SAAgB,OAAO,CAAC,IAAa;;IACnC,MAAM,KAAK,GAAI,IAA0F,CAAC,KAAK,CAAA;IAC/G,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAA;IAC5B,MAAM,WAAW,GAAG,MAAA,KAAK,CAAC,WAAW,mCAAI,CAAC,CAAA;IAC1C,MAAM,YAAY,GAAG,MAAA,KAAK,CAAC,YAAY,mCAAI,CAAC,CAAA;IAC5C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAA,KAAK,CAAC,WAAW,mCAAI,WAAW,GAAG,YAAY,EAAE,CAAA;AACpG,CAAC"}
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/models/usage.ts"],"names":[],"mappings":";;AAUA,0BAcC;AAdD,SAAgB,OAAO,CAAC,IAAa;;IACnC,MAAM,KAAK,GAAI,IAEb,CAAC,KAAK,CAAA;IACR,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAA;IAC5B,MAAM,WAAW,GAAG,MAAA,KAAK,CAAC,WAAW,mCAAI,CAAC,CAAA;IAC1C,MAAM,YAAY,GAAG,MAAA,KAAK,CAAC,YAAY,mCAAI,CAAC,CAAA;IAC5C,OAAO;QACL,WAAW;QACX,YAAY;QACZ,WAAW,EAAE,MAAA,KAAK,CAAC,WAAW,mCAAI,WAAW,GAAG,YAAY;QAC5D,eAAe,EAAE,MAAA,KAAK,CAAC,iBAAiB,0CAAE,eAAe;QACzD,gBAAgB,EAAE,MAAA,KAAK,CAAC,iBAAiB,0CAAE,gBAAgB;KAC5D,CAAA;AACH,CAAC"}