@multiplayer-app/agent 0.1.19 → 0.1.20

package/dist/agent/definition.d.ts

@@ -7,16 +7,29 @@ export interface AgentModel {
     provider: ModelProviderConfig;
     attribution: OpenRouterApp;
 }
+/** The agent's own running notes: what compaction carries forward in place of the steps it removes. */
+export interface WorkingNotes {
+    /** Workspace-relative path, named to the agent in the compaction note. */
+    path: string;
+    (workspaceDir: string): Promise<string | undefined>;
+}
 /** Profile-specific behavior. Definitions have no queue, conversation, or checkpoint state. */
 export interface AgentDefinition {
     profile: AgentProfile;
     model: AgentModel;
+    /** Steps per model loop. A turn ends here unless `maxTurnSteps` lets it continue in a new loop. */
     maxSteps: number;
+    /**
+     * Steps a turn may take in all, continuing past `maxSteps` while the model still wants to work.
+     * Unset, a turn is one loop of `maxSteps`. The token budget bounds the spending either way.
+     */
+    maxTurnSteps?: number;
     workspaceDirectories: readonly string[];
     instructions(context: {
         restored: boolean;
         tokenBudget?: number;
     }): string;
     createTools(context: SessionToolContext): Record<string, Tool>;
+    workingNotes?: WorkingNotes;
 }
 //# sourceMappingURL=definition.d.ts.map

package/dist/agent/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/agent/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAA;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,WAAW,EAAE,aAAa,CAAA;CAC3B;AAED,+FAA+F;AAC/F,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,YAAY,CAAA;IACrB,KAAK,EAAE,UAAU,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,YAAY,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAA;IAC1E,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;CAC/D"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/agent/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAA;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,WAAW,EAAE,aAAa,CAAA;CAC3B;AAED,uGAAuG;AACvG,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAA;IACZ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CACpD;AAED,+FAA+F;AAC/F,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,YAAY,CAAA;IACrB,KAAK,EAAE,UAAU,CAAA;IACjB,mGAAmG;IACnG,QAAQ,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,YAAY,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAA;IAC1E,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAC9D,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B"}

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;AAQ9D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,GAAG,eAAe,CAyCrG"}
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../../src/agent/profiles/research.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,eAAe,CAAA;AAElE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AA0B9D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,GAAG,eAAe,CA2CrG"}

package/dist/agent/profiles/research.js

@@ -1,12 +1,32 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createResearchAgent = createResearchAgent;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
 const attribution_1 = require("../../models/attribution");
 const extraction_tool_1 = require("../../research/extraction-tool");
 const filingramp_client_1 = require("../../research/filingramp-client");
 const filingramp_tools_1 = require("../../research/filingramp-tools");
 const prompt_1 = require("../../research/prompt");
 const tools_1 = require("../../session/tools");
+/** Steps per model loop; past it the turn continues in a new loop (see AgentDefinition.maxTurnSteps). */
+const STEPS_PER_LOOP = 80;
+/** A research turn ends on its own or at the budget; this is the guard against a model that never does. */
+const MAX_TURN_STEPS = 480;
+/** The notes file the prompt tells the agent to keep; compaction carries it in place of removed steps. */
+const workingNotes = Object.assign(async (workspaceDir) => {
+    try {
+        return await node_fs_1.promises.readFile(node_path_1.default.join(workspaceDir, prompt_1.RESEARCH_OUTPUT_FILES.notes), 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+}, { path: prompt_1.RESEARCH_OUTPUT_FILES.notes });
 function createResearchAgent(config, workspaceDir) {
     // 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.
@@ -25,8 +45,10 @@ function createResearchAgent(config, workspaceDir) {
     return {
         profile: 'research',
         model: { id: config.model, provider: config.provider, attribution: attribution_1.OPENROUTER_APPS.DEEP_RESEARCH },
-        maxSteps: 80,
+        maxSteps: STEPS_PER_LOOP,
+        maxTurnSteps: MAX_TURN_STEPS,
         workspaceDirectories: prompt_1.RESEARCH_WORKSPACE_DIRS,
+        workingNotes,
         instructions: ({ restored, tokenBudget }) => {
             var _a;
             return (0, prompt_1.buildResearchSystemPrompt)({

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

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

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

@@ -0,0 +1,40 @@
+import type { AssistantModelMessage, ModelMessage, ToolModelMessage, UserModelMessage } from 'ai';
+/** One model step: the assistant message and the tool results it produced, if any. */
+export interface TurnStep {
+    assistant: AssistantModelMessage;
+    tool?: ToolModelMessage;
+}
+export declare function approxChars(message: ModelMessage): number;
+/** Groups a turn's response messages into steps; anything that is not assistant or tool is dropped. */
+export declare function splitSteps(messages: ModelMessage[]): TurnStep[];
+export declare function flattenSteps(steps: TurnStep[]): ModelMessage[];
+/** A deterministic one-paragraph account of steps: tool counts, questions asked, files touched. */
+export declare function describeSteps(steps: TurnStep[]): string;
+/** The text the turn ended with, when it ended on its own (a final step without tool calls). */
+export declare function finalText(steps: TurnStep[]): string | undefined;
+/**
+ * A finished (or interrupted) turn as one assistant message for the turns that follow. The final text is
+ * what the agent told the user; the account says what it did, so it can reuse its files instead of
+ * redoing the work. Tool calls and results are left out: they are paid for again on every later step
+ * and the workspace holds what they produced.
+ */
+export declare function collapseTurn(messages: ModelMessage[]): AssistantModelMessage;
+export interface CompactionOptions {
+    /** Compact once the turn's messages (after result pruning) exceed this many characters. */
+    triggerChars: number;
+    /** Keep the most recent steps up to about this many characters; everything older is replaced by the note. */
+    keepChars: number;
+}
+/** chars ≈ tokens × 4: compact past ~80k tokens of turn, keep ~30k tokens of recent steps. */
+export declare const DEFAULT_COMPACTION: CompactionOptions;
+export interface CompactionState {
+    /** Leading steps of the turn replaced by `note`. */
+    droppedSteps: number;
+    note?: UserModelMessage;
+}
+/** Compaction is monotonic: once steps are dropped they stay dropped, so the cached prefix only changes when more are. */
+export declare function stepsToDrop(steps: TurnStep[], state: CompactionState, options: CompactionOptions): number | undefined;
+export declare function compactionNote(dropped: TurnStep[], notesPath: string | undefined, notes: string | undefined): UserModelMessage;
+/** The turn as the model sees it: the compaction note (if any) followed by the steps not yet dropped. */
+export declare function compactedView(steps: TurnStep[], state: CompactionState): ModelMessage[];
+//# sourceMappingURL=turn-history.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"turn-history.d.ts","sourceRoot":"","sources":["../../src/agent/turn-history.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,IAAI,CAAA;AAGjG,sFAAsF;AACtF,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,qBAAqB,CAAA;IAChC,IAAI,CAAC,EAAE,gBAAgB,CAAA;CACxB;AAOD,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAEzD;AAED,uGAAuG;AACvG,wBAAgB,UAAU,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,QAAQ,EAAE,CAO/D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,YAAY,EAAE,CAE9D;AAuCD,mGAAmG;AACnG,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAiBvD;AAED,gGAAgG;AAChG,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,GAAG,SAAS,CAK/D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,qBAAqB,CAU5E;AAID,MAAM,WAAW,iBAAiB;IAChC,2FAA2F;IAC3F,YAAY,EAAE,MAAM,CAAA;IACpB,6GAA6G;IAC7G,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,8FAA8F;AAC9F,eAAO,MAAM,kBAAkB,EAAE,iBAAiE,CAAA;AAKlG,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,gBAAgB,CAAA;CACxB;AAED,0HAA0H;AAC1H,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAWrH;AAID,wBAAgB,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAW9H;AAED,yGAAyG;AACzG,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,eAAe,GAAG,YAAY,EAAE,CAGvF"}

package/dist/agent/turn-history.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_COMPACTION = void 0;
+exports.approxChars = approxChars;
+exports.splitSteps = splitSteps;
+exports.flattenSteps = flattenSteps;
+exports.describeSteps = describeSteps;
+exports.finalText = finalText;
+exports.collapseTurn = collapseTurn;
+exports.stepsToDrop = stepsToDrop;
+exports.compactionNote = compactionNote;
+exports.compactedView = compactedView;
+const context_pruning_1 = require("../context-pruning");
+function approxChars(message) {
+    return JSON.stringify(message).length;
+}
+/** Groups a turn's response messages into steps; anything that is not assistant or tool is dropped. */
+function splitSteps(messages) {
+    const steps = [];
+    for (const message of messages) {
+        if (message.role === 'assistant')
+            steps.push({ assistant: message });
+        else if (message.role === 'tool' && steps.length && !steps[steps.length - 1].tool)
+            steps[steps.length - 1].tool = message;
+    }
+    return steps;
+}
+function flattenSteps(steps) {
+    return steps.flatMap((step) => (step.tool ? [step.assistant, step.tool] : [step.assistant]));
+}
+function toolCallsOf(step) {
+    if (typeof step.assistant.content === 'string')
+        return [];
+    return step.assistant.content.flatMap((part) => (part.type === 'tool-call' ? [{ toolName: part.toolName, input: part.input }] : []));
+}
+function textOf(message) {
+    if (typeof message.content === 'string')
+        return message.content;
+    return message.content.flatMap((part) => (part.type === 'text' ? [part.text] : [])).join('');
+}
+/** Workspace files a step wrote or asked a tool to write (inputs) or that a tool reported writing (outputs). */
+function filesOf(step) {
+    var _a, _b;
+    const files = [];
+    for (const call of toolCallsOf(step)) {
+        const input = call.input;
+        if (!input || typeof input !== 'object')
+            continue;
+        if (Array.isArray(input.files)) {
+            for (const file of input.files)
+                if (file && typeof file.path === 'string')
+                    files.push(file.path);
+        }
+        if (Array.isArray(input.paths))
+            for (const entry of input.paths)
+                if (typeof entry === 'string')
+                    files.push(entry);
+        files.push(...(0, context_pruning_1.mentionedPaths)(input));
+    }
+    for (const part of (_b = (_a = step.tool) === null || _a === void 0 ? void 0 : _a.content) !== null && _b !== void 0 ? _b : [])
+        if (part.type === 'tool-result')
+            files.push(...(0, context_pruning_1.mentionedPaths)(part.output));
+    return files;
+}
+function questionsOf(step) {
+    return toolCallsOf(step).flatMap((call) => {
+        var _a;
+        if (call.toolName !== 'request_clarification')
+            return [];
+        const question = (_a = call.input) === null || _a === void 0 ? void 0 : _a.question;
+        return typeof question === 'string' ? [question] : [];
+    });
+}
+const MAX_LISTED_FILES = 40;
+const MAX_QUESTION_CHARS = 1500;
+/** A deterministic one-paragraph account of steps: tool counts, questions asked, files touched. */
+function describeSteps(steps) {
+    var _a;
+    const counts = new Map();
+    const files = new Set();
+    const questions = [];
+    for (const step of steps) {
+        for (const call of toolCallsOf(step))
+            counts.set(call.toolName, ((_a = counts.get(call.toolName)) !== null && _a !== void 0 ? _a : 0) + 1);
+        for (const file of filesOf(step))
+            files.add(file);
+        questions.push(...questionsOf(step));
+    }
+    const parts = [`${steps.length} step${steps.length === 1 ? '' : 's'}`];
+    if (counts.size)
+        parts.push(`tool calls: ${[...counts].map(([name, count]) => `${name} ×${count}`).join(', ')}`);
+    if (files.size) {
+        const listed = [...files].slice(0, MAX_LISTED_FILES);
+        parts.push(`files written or saved: ${listed.join(', ')}${files.size > listed.length ? ` and ${files.size - listed.length} more` : ''}`);
+    }
+    for (const question of questions)
+        parts.push(`asked the user: "${question.length > MAX_QUESTION_CHARS ? `${question.slice(0, MAX_QUESTION_CHARS)}…` : question}"`);
+    return parts.join('; ');
+}
+/** The text the turn ended with, when it ended on its own (a final step without tool calls). */
+function finalText(steps) {
+    const last = steps[steps.length - 1];
+    if (!last || last.tool || toolCallsOf(last).length)
+        return undefined;
+    const text = textOf(last.assistant).trim();
+    return text || undefined;
+}
+/**
+ * A finished (or interrupted) turn as one assistant message for the turns that follow. The final text is
+ * what the agent told the user; the account says what it did, so it can reuse its files instead of
+ * redoing the work. Tool calls and results are left out: they are paid for again on every later step
+ * and the workspace holds what they produced.
+ */
+function collapseTurn(messages) {
+    const steps = splitSteps(messages);
+    const text = finalText(steps);
+    if (text === undefined) {
+        const narration = steps.map((step) => textOf(step.assistant).trim()).filter(Boolean).slice(-1)[0];
+        return { role: 'assistant', content: `${narration ? `${narration}\n\n` : ''}[This turn was interrupted before it finished: ${describeSteps(steps)}. Its results are in the workspace files, not in this conversation.]` };
+    }
+    // The final step is the text itself; the account covers the work before it.
+    const work = steps.slice(0, -1);
+    return { role: 'assistant', content: work.length ? `${text}\n\n[Earlier in this turn: ${describeSteps(work)}.]` : text };
+}
+/** chars ≈ tokens × 4: compact past ~80k tokens of turn, keep ~30k tokens of recent steps. */
+exports.DEFAULT_COMPACTION = { triggerChars: 320000, keepChars: 120000 };
+/** Steps the model is working on right now are never compacted away, whatever their size. */
+const MIN_KEPT_STEPS = 2;
+/** Compaction is monotonic: once steps are dropped they stay dropped, so the cached prefix only changes when more are. */
+function stepsToDrop(steps, state, options) {
+    const kept = steps.slice(state.droppedSteps);
+    const stepChars = kept.map((step) => approxChars(step.assistant) + (step.tool ? approxChars(step.tool) : 0));
+    let total = stepChars.reduce((sum, chars) => sum + chars, 0) + (state.note ? approxChars(state.note) : 0);
+    if (total <= options.triggerChars)
+        return undefined;
+    let drop = 0;
+    while (total > options.keepChars && kept.length - drop > MIN_KEPT_STEPS) {
+        total -= stepChars[drop];
+        drop += 1;
+    }
+    return drop ? state.droppedSteps + drop : undefined;
+}
+const MAX_NOTES_CHARS = 12000;
+function compactionNote(dropped, notesPath, notes) {
+    const account = describeSteps(dropped);
+    const memory = (notes === null || notes === void 0 ? void 0 : notes.trim())
+        ? `Your notes file (${notesPath}) as of now:\n\n${notes.length > MAX_NOTES_CHARS ? `[earlier part omitted]\n${notes.slice(-MAX_NOTES_CHARS)}` : notes}`
+        : notesPath
+            ? `There is no notes file (${notesPath}) yet. Write one now with what is done, which files hold what, and what is next: the next compaction will carry it instead of the steps it removes.`
+            : 'Keep your own notes in a workspace file: the next compaction will carry it instead of the steps it removes.';
+    return {
+        role: 'user',
+        content: `(Automatic note, not from the user.) To stay within the context limit, the first ${dropped.length} steps of this turn were removed from the conversation: ${account}. Everything they produced is still in the workspace; the user's messages above and their answers stand. ${memory}\n\nContinue from the steps that follow. If you need something from the removed steps, read it from the workspace files instead of redoing the work.`,
+    };
+}
+/** The turn as the model sees it: the compaction note (if any) followed by the steps not yet dropped. */
+function compactedView(steps, state) {
+    const kept = flattenSteps(steps.slice(state.droppedSteps));
+    return state.note ? [state.note, ...kept] : kept;
+}
+//# sourceMappingURL=turn-history.js.map

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

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

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

@@ -21,6 +21,11 @@ export interface TurnInput {
     wrapUpOnly?: boolean;
     recordUsage(usage: TokenUsage): void;
     emit(event: OutboundEvent): void;
+    /**
+     * The turn's response messages so far, after every finished step. The runtime persists them, so a
+     * turn cut off by a lost VM resumes from its last step instead of from the user's message.
+     */
+    onStep?(messages: ModelMessage[]): void;
 }
 interface TurnOutput {
     /** Messages to append to history, including a safe text-only fallback for an interrupted turn. */
@@ -44,7 +49,15 @@ export type TurnResult = TurnOutput & ({
     error: string;
     userMessage: string;
 });
-/** Executes one turn. It neither mutates conversation history nor checkpoints or schedules work. */
+/**
+ * Executes one turn. It neither mutates conversation history nor checkpoints or schedules work.
+ *
+ * A turn runs as one or more model loops ("segments") of up to `maxSteps` steps each. A profile with
+ * `maxTurnSteps` keeps going in a new segment when a loop ends at the step cap while the model still
+ * wants to call tools, until the model stops on its own, asks the user, wraps up for the budget, or
+ * reaches `maxTurnSteps`. Across segments the turn is one conversation: long turns are compacted (the
+ * oldest steps replaced by a note and the agent's notes file) and bulky old results pruned.
+ */
 export declare class TurnRunner {
     private readonly definition;
     constructor(definition: AgentDefinition);

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,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"}
+{"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;AA0B1D,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;IAChC;;;OAGG;IACH,MAAM,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI,CAAA;CACxC;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;;;;;;;;GAQG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,eAAe;IAElD,GAAG,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;CA4JjD"}

package/dist/agent/turn-runner.js

@@ -8,6 +8,7 @@ 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");
+const turn_history_1 = require("./turn-history");
 /** 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'];
@@ -26,19 +27,31 @@ function stepsSinceProgress(steps) {
     }
     return steps.length;
 }
-/** Executes one turn. It neither mutates conversation history nor checkpoints or schedules work. */
+/**
+ * Executes one turn. It neither mutates conversation history nor checkpoints or schedules work.
+ *
+ * A turn runs as one or more model loops ("segments") of up to `maxSteps` steps each. A profile with
+ * `maxTurnSteps` keeps going in a new segment when a loop ends at the step cap while the model still
+ * wants to call tools, until the model stops on its own, asks the user, wraps up for the budget, or
+ * reaches `maxTurnSteps`. Across segments the turn is one conversation: long turns are compacted (the
+ * oldest steps replaced by a note and the agent's notes file) and bulky old results pruned.
+ */
 class TurnRunner {
     constructor(definition) {
         this.definition = definition;
     }
     async run(input) {
-        var _a, _b, _c;
+        var _a, _b, _c, _d, _e;
         const { messageId, abortSignal, emit } = input;
         let partialText = '';
         let askedUser = false;
-        let wrapUpFrom;
         let saved = false;
-        let responseMessages;
+        let wrappedUp = false;
+        /** Response messages of the segments that finished. */
+        const turn = [];
+        /** Finished steps of the running segment, as of its last prepareStep. */
+        let segmentSteps = [];
+        let compaction = { droppedSteps: 0 };
         const recordUsage = (usage, model) => {
             input.recordUsage(usage);
             emit({ type: 'usage', messageId, usage: { ...usage, model } });
@@ -54,92 +67,137 @@ class TurnRunner {
                 emit({ type: 'question', messageId, toolCallId, question });
             },
         };
+        const history = input.messages;
+        const { model, maxSteps, profile } = this.definition;
+        const maxTurnSteps = (_a = this.definition.maxTurnSteps) !== null && _a !== void 0 ? _a : maxSteps;
+        // The wrap-up needs a research workspace to save into; the coding profile just stops at the budget.
+        const research = profile === 'research';
+        /** The turn so far as the model should see it: compacted when long, bulky old results pruned. */
+        const promptFor = async (turnMessages) => {
+            var _a, _b, _c;
+            const steps = (0, turn_history_1.splitSteps)(turnMessages);
+            const drop = (0, turn_history_1.stepsToDrop)(steps, compaction, turn_history_1.DEFAULT_COMPACTION);
+            if (drop !== undefined) {
+                const notes = await ((_b = (_a = this.definition).workingNotes) === null || _b === void 0 ? void 0 : _b.call(_a, input.workspaceDir).catch(() => undefined));
+                compaction = { droppedSteps: drop, note: (0, turn_history_1.compactionNote)(steps.slice(0, drop), (_c = this.definition.workingNotes) === null || _c === void 0 ? void 0 : _c.path, notes) };
+            }
+            return (0, context_pruning_1.pruneToolResults)([...history, ...(0, turn_history_1.compactedView)(steps, compaction)]);
+        };
         try {
-            abortSignal.throwIfAborted();
-            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,
-                abortSignal,
-                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 };
+            let totalSteps = 0;
+            let text = '';
+            for (;;) {
+                abortSignal.throwIfAborted();
+                const tools = this.definition.createTools(context);
+                let wrapUpFrom;
+                const wrapUpDone = ({ steps }) => wrapUpFrom !== undefined ? steps.length - wrapUpFrom >= WRAP_UP_STEPS : !research && input.budgetExceeded();
+                const segmentBase = [...turn];
+                const segmentPrompt = await promptFor(segmentBase);
+                segmentSteps = [];
+                const result = (0, ai_1.streamText)({
+                    model: (0, resolve_model_1.resolveLanguageModel)(model.provider, model.id, model.attribution),
+                    system: input.instructions,
+                    messages: segmentPrompt,
+                    tools,
+                    abortSignal,
+                    stopWhen: [(0, ai_1.stepCountIs)(maxSteps), () => askedUser, wrapUpDone],
+                    experimental_repairToolCall: tool_call_repair_1.repairStringifiedToolInput,
+                    prepareStep: async ({ stepNumber, steps, messages }) => {
+                        var _a, _b;
+                        // `messages` is the segment's prompt plus the steps finished since; the latter are the
+                        // part of the turn not persisted yet.
+                        segmentSteps = messages.slice(segmentPrompt.length);
+                        if (segmentSteps.length)
+                            (_a = input.onStep) === null || _a === void 0 ? void 0 : _a.call(input, [...segmentBase, ...segmentSteps]);
+                        const prompt = await promptFor([...segmentBase, ...segmentSteps]);
+                        if (wrapUpFrom === undefined && research && (input.wrapUpOnly || ((_b = input.nearBudget) === null || _b === void 0 ? void 0 : _b.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 ? [...prompt, { role: 'user', content: PROGRESS_REMINDER }] : prompt };
+                        }
+                        // 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 ? prompt : [...prompt, { 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) {
+                        case 'text-delta':
+                            partialText += part.text;
+                            emit({ type: 'text_delta', messageId, text: part.text });
+                            break;
+                        case 'reasoning-delta':
+                            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':
+                            emit({ type: 'tool_call_result', messageId, toolCallId: part.toolCallId, output: part.output });
+                            break;
+                        case 'tool-error':
+                            emit({
+                                type: 'tool_call_result', messageId, toolCallId: part.toolCallId,
+                                error: part.error instanceof Error ? part.error.message : String(part.error),
+                            });
+                            break;
+                        case 'finish-step': {
+                            const usage = (0, usage_1.usageOf)(part);
+                            if (usage)
+                                recordUsage(usage, (_c = (_b = part.response) === null || _b === void 0 ? void 0 : _b.modelId) !== null && _c !== void 0 ? _c : model.id);
+                            break;
+                        }
+                        case 'error':
+                            throw part.error;
                     }
-                    // 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) {
-                    case 'text-delta':
-                        partialText += part.text;
-                        emit({ type: 'text_delta', messageId, text: part.text });
-                        break;
-                    case 'reasoning-delta':
-                        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':
-                        emit({ type: 'tool_call_result', messageId, toolCallId: part.toolCallId, output: part.output });
-                        break;
-                    case 'tool-error':
-                        emit({
-                            type: 'tool_call_result', messageId, toolCallId: part.toolCallId,
-                            error: part.error instanceof Error ? part.error.message : String(part.error),
-                        });
-                        break;
-                    case 'finish-step': {
-                        const usage = (0, usage_1.usageOf)(part);
-                        if (usage)
-                            recordUsage(usage, (_b = (_a = part.response) === null || _a === void 0 ? void 0 : _a.modelId) !== null && _b !== void 0 ? _b : model.id);
-                        break;
-                    }
-                    case 'error':
-                        throw part.error;
                 }
+                abortSignal.throwIfAborted();
+                turn.push(...(await result.response).messages);
+                segmentSteps = [];
+                const steps = await result.steps;
+                totalSteps += steps.length;
+                text = await result.text;
+                wrappedUp || (wrappedUp = wrapUpFrom !== undefined);
+                // The loop ended at its step cap with the model mid-work: carry on in a new segment.
+                const atCap = steps.length >= maxSteps && (await result.finishReason) === 'tool-calls' && !askedUser && !wrappedUp;
+                if (!atCap)
+                    break;
+                if (totalSteps >= maxTurnSteps) {
+                    const note = `${partialText ? '\n\n' : ''}I have taken ${totalSteps} steps in this turn, the most one turn allows. My notes and files are saved; reply "continue" and I will carry on from here.`;
+                    partialText += note;
+                    text += note;
+                    emit({ type: 'text_delta', messageId, text: note });
+                    break;
+                }
+                (_d = input.onStep) === null || _d === void 0 ? void 0 : _d.call(input, turn);
             }
-            abortSignal.throwIfAborted();
-            responseMessages = (await result.response).messages;
-            const text = await result.text;
-            return { status: 'completed', messages: responseMessages, text, partialText, askedUser, wrappedUp: wrapUpFrom !== undefined, saved };
+            return { status: 'completed', messages: turn, text, partialText, askedUser, wrappedUp, saved };
         }
         catch (error) {
             const aborted = abortSignal.aborted;
-            // A partial stream may end between a tool call and its result. Persist text only in that case.
-            const messages = responseMessages !== null && responseMessages !== void 0 ? responseMessages : [{
-                    role: 'assistant', content: partialText || (aborted ? '(stopped by the user)' : '(turn failed)'),
-                }];
-            const output = { messages, partialText, askedUser, wrappedUp: wrapUpFrom !== undefined, saved };
+            // A partial stream may end between a tool call and its result, so only the finished steps are
+            // kept, followed by the text streamed since (or a marker), so the turn ends on an assistant message.
+            const messages = [
+                ...turn,
+                ...segmentSteps,
+                { role: 'assistant', content: partialText || (aborted ? '(stopped by the user)' : '(turn failed)') },
+            ];
+            const output = { messages, partialText, askedUser, wrappedUp, saved };
             return aborted
                 ? { ...output, status: 'aborted' }
-                : { ...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) };
+                : { ...output, status: 'failed', error: (0, model_failure_1.describeModelFailure)(error), userMessage: (_e = (0, model_failure_1.userFacingModelFailure)(error)) !== null && _e !== void 0 ? _e : (0, model_failure_1.describeModelFailure)(error) };
         }
     }
 }