@multiplayer-app/agent 0.1.19 → 0.1.21

package/README.md

@@ -7,7 +7,7 @@ configuration, chooses a mode, and connects the agent to the gateway.
 
 | Area | Files | Responsibility |
 | --- | --- | --- |
-| Startup | `src/runtime/cli.ts`, `src/runtime/index.ts`, `src/runtime/lambda-microvm.ts` | Process startup, shutdown, Lambda suspend/terminate hooks |
+| Startup | `src/runtime/cli.ts`, `src/runtime/index.ts`, `src/runtime/guest-server.ts` | Process startup, shutdown, Lambda suspend/terminate hooks |
 | Configuration and wire contract | `src/runtime/config.ts`, `src/transport/protocol.ts` | Environment variables, commands, events, secret keys |
 | One-shot tasks | `src/task/loop.ts`, `src/transport/reporter.ts` | Run `AGENT_TASK`, report results, exit |
 | Agent definitions | `src/agent/definition.ts`, `src/agent/profiles/` | Coding/research prompts, model selection, workspace directories, tool composition |
@@ -19,6 +19,9 @@ configuration, chooses a mode, and connects the agent to the gateway.
 | Models and usage | `src/models/resolve-model.ts`, `src/models/usage.ts` | Resolve a definition's model and normalize token usage |
 | Workspace persistence | `src/persistence/workspace.ts`, `src/persistence/git-sync.ts`, `src/persistence/snapshot-sync.ts` | Common restore/checkpoint interface backed by project Git or standalone session snapshots |
 | Gateway connection | `src/transport/link.ts` | Send sequenced events and acknowledge commands |
+| Workspace live sync | `src/workspace-sync/` | Mirror every workspace text file into the session as it changes (`file_*` events), stream `write_files` drafts while the model writes, merge people's edits (`file_state`) back into the files |
+| Live preview | `src/runtime/preview-proxy.ts`, `src/runtime/listening-ports.ts` | Forward the gateway's `<vmId>-<port>.apps.<domain>` and session URL (`<sessionId>[-<port>].apps.<domain>`) traffic (HTTP and WebSocket) from the guest's port 8080 to the app on localhost; report listening ports (`ports` event) |
+| App (builder.json) | `src/app/`, `src/runtime/app-mode.ts` | Run the workspace's app as `.builder/builder.json` says ([docs](../../docs/architecture/builder-json.md)): a session VM writes the file from the services it detects as Vercel does, with the routes between them, and the file then decides; installs, services on their own `$PORT`, daemons, restarts; after every turn and on boot; route the session URL to it (`app` event, `run_app` tool); in `AGENT_MODE=app` a deployment of it, built and served on port 8080 |
 | Local and MCP tools | `src/tools/`, `src/mcp/` | Filesystem, shell, external tool discovery and execution |
 | Research tools | `src/research/filingramp-tools.ts`, `src/research/filingramp/` | Register FilingRamp tools and implement searches, filing details, downloads |
 | Research contracts | `src/research/filingramp-contract.ts`, `src/research/scope.ts` | Normalize API-specific filters and apply the session scope |
@@ -45,8 +48,8 @@ returned messages, and decides when completion can be announced. Its constructor
 optional definition, runner, and persistence dependencies so these boundaries can be tested
 without a model provider or storage server.
 
-`WorkspacePersistence` adapts the existing Git/snapshot sync classes. Its checkpoint result
-distinguishes a Git commit from a snapshot hash; neither leaks into the other's wire contract.
+`WorkspacePersistence` adapts the existing Git and session-folder sync classes. Its checkpoint
+result distinguishes a Git commit from a folder hash; neither leaks into the other's wire contract.
 A successful no-op is still durable. A failed restore or upload rejects the operation.
 
 ## Session flow and invariants
@@ -70,11 +73,15 @@ and an in-flight model/tool step are process-local; this is not an execution jou
 replays interrupted tool calls. Client event replay is a separate platform concern handled
 outside this runtime. The refactor does not change the persisted conversation format.
 
-Standalone sessions use the authenticated storage service to save workspace snapshots
-under `accounts/<accountId>/sessions/<sessionId>/`; they do not create `.git`.
+Standalone sessions keep their workspace as files in the session's folder,
+`accounts/<accountId>/sessions/<sessionId>/`, through the authenticated storage service; they do
+not create `.git`. A checkpoint uploads only what changed. A new VM downloads the folder.
 Project sessions use Git under `accounts/<accountId>/projects/<projectId>/`.
-`publish_results` separately sends selected text files to the platform for display;
-it does not replace workspace checkpoints.
+Workspace live sync mirrors every text file of the workspace into the session while the agent
+works, both ways (services/api's workspace-sync.service.ts holds the session's side); with it,
+`publish_results` only makes the files it names current at once. Mirrored text belongs to live
+sync, and a checkpoint uploads it only while the session has not confirmed that version; everything
+else (binaries, large files, build output, the agent's conversation) is the checkpoint's.
 
 ## Adding a research tool
 

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/definition.test.js

@@ -7,7 +7,7 @@ const strict_1 = __importDefault(require("node:assert/strict"));
 const node_test_1 = require("node:test");
 const profiles_1 = require("./profiles");
 (0, node_test_1.it)('keeps profile instructions, workspace setup, models, and tools together', () => {
-    var _a;
+    var _a, _b;
     const config = {
         sessionId: 'test', mode: 'session', profile: 'coding', workspaceDir: '/unused',
         model: 'main-model', extractionModel: 'extraction-model', provider: {}, mcpConnections: [],
@@ -23,8 +23,13 @@ const profiles_1 = require("./profiles");
     strict_1.default.equal(coding.model.id, 'main-model');
     strict_1.default.deepEqual(coding.workspaceDirectories, []);
     strict_1.default.match(coding.instructions({ restored: false }), /coding agent/);
-    strict_1.default.equal(coding.createTools(context).search_filings, undefined);
+    // An app can show the account's data: the FilingRamp tools, but not research's bulk extraction.
+    strict_1.default.match(coding.instructions({ restored: false }), /FilingRamp tools/);
+    strict_1.default.equal(typeof ((_a = coding.createTools(context).search_filings) === null || _a === void 0 ? void 0 : _a.execute), 'function');
     strict_1.default.equal(coding.createTools(context).extract_from_texts, undefined);
+    const withoutFilingRamp = (0, profiles_1.createAgentDefinition)({ ...config, filingRamp: undefined }, context.workspaceDir);
+    strict_1.default.equal(withoutFilingRamp.createTools(context).search_filings, undefined);
+    strict_1.default.doesNotMatch(withoutFilingRamp.instructions({ restored: false }), /FilingRamp/);
     const research = (0, profiles_1.createAgentDefinition)({ ...config, profile: 'research' }, context.workspaceDir);
     strict_1.default.deepEqual(research.workspaceDirectories, ['research', 'data', 'data/text']);
     strict_1.default.match(research.instructions({ restored: false }), /fresh session/);
@@ -33,7 +38,7 @@ const profiles_1 = require("./profiles");
     strict_1.default.match(research.instructions({ restored: false }), /TX/);
     const tools = research.createTools(context);
     for (const name of ['search_filings', 'count_filings', 'summarize_filings', 'get_filing', 'search_documents', 'download_attachment', 'search_objections', 'read_text', 'extract_from_texts']) {
-        strict_1.default.equal(typeof ((_a = tools[name]) === null || _a === void 0 ? void 0 : _a.execute), 'function', name);
+        strict_1.default.equal(typeof ((_b = tools[name]) === null || _b === void 0 ? void 0 : _b.execute), 'function', name);
     }
     strict_1.default.equal(research.createTools(context).search_documents, tools.search_documents, 'scope lookup cache survives between turns');
 });

package/dist/agent/definition.test.js.map

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

package/dist/agent/profiles/coding.d.ts

@@ -1,4 +1,4 @@
 import type { AgentDefinition } from '../definition';
 import type { AgentRuntimeConfig } from '../../runtime/config';
-export declare function createCodingAgent(config: AgentRuntimeConfig): AgentDefinition;
+export declare function createCodingAgent(config: AgentRuntimeConfig, workspaceDir: string): AgentDefinition;
 //# sourceMappingURL=coding.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"coding.d.ts","sourceRoot":"","sources":["../../../src/agent/profiles/coding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAK9D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,CAS7E"}
+{"version":3,"file":"coding.d.ts","sourceRoot":"","sources":["../../../src/agent/profiles/coding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAW9D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,GAAG,eAAe,CAuBnG"}

package/dist/agent/profiles/coding.js

@@ -2,16 +2,33 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCodingAgent = createCodingAgent;
 const attribution_1 = require("../../models/attribution");
+const filingramp_client_1 = require("../../research/filingramp-client");
+const filingramp_tools_1 = require("../../research/filingramp-tools");
 const tools_1 = require("../../session/tools");
-const SYSTEM_PROMPT = `You are a coding agent running inside an isolated session workspace VM with a persistent disk. You have direct tools to read/write files and run shell commands in the workspace, plus (if any MCP servers are configured) search_tools/get_tool_details/call_mcp_tool to use them. Work efficiently, verify with cheap commands (build, lint), report progress with report_progress, publish deliverables with publish_results, and finish each turn with a concise summary.`;
-function createCodingAgent(config) {
+const exec_tools_1 = require("../../tools/exec-tools");
+const SYSTEM_PROMPT = `You are a coding agent running inside an isolated session workspace VM with a persistent disk. You build what the user asks for — apps, dashboards, sites, APIs, scripts — as a real project in the workspace. You have direct tools to read/write files and run shell commands in the workspace, plus (if any MCP servers are configured) search_tools/get_tool_details/call_mcp_tool to use them. Every file you write appears in the user's session as you write it, so there is nothing to copy or publish. Work efficiently, verify with cheap commands (build, lint, a curl of the running app), report progress with report_progress, and finish each turn with a concise summary of what you built and how to use it. ${exec_tools_1.LIVE_PREVIEW_GUIDANCE}`;
+const FILINGRAMP_DATA = ` Data from the user's FilingRamp account comes from the FilingRamp tools (count_filings, summarize_filings, search_filings, …): save what the app shows into the data/ folder of the service that shows it (packages/web/data/filings.json) with them and have the app load those files. Never put credentials in the app.`;
+function createCodingAgent(config, workspaceDir) {
+    // Same FilingRamp access as the research profile, so an app can show the account's real data.
+    let reportProgress;
+    const filingTools = config.filingRamp
+        ? (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),
+        })
+        : {};
     return {
         profile: 'coding',
         model: { id: config.model, provider: config.provider, attribution: attribution_1.OPENROUTER_APPS.SESSION_AGENT },
         maxSteps: 80,
         workspaceDirectories: [],
-        instructions: () => SYSTEM_PROMPT,
-        createTools: (context) => (0, tools_1.createSessionTools)(context, config.mcpConnections),
+        instructions: () => SYSTEM_PROMPT + (config.filingRamp ? FILINGRAMP_DATA : ''),
+        createTools: (context) => {
+            reportProgress = (steps, toolCallId) => context.reportProgress(steps, toolCallId);
+            return { ...(0, tools_1.createSessionTools)(context, config.mcpConnections), ...filingTools };
+        },
     };
 }
 //# sourceMappingURL=coding.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"coding.js","sourceRoot":"","sources":["../../../src/agent/profiles/coding.ts"],"names":[],"mappings":";;AAOA,8CASC;AAfD,0DAA0D;AAE1D,+CAAwD;AAExD,MAAM,aAAa,GAAG,+cAA+c,CAAA;AAEre,SAAgB,iBAAiB,CAAC,MAA0B;IAC1D,OAAO;QACL,OAAO,EAAE,QAAQ;QACjB,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,EAAE;QACxB,YAAY,EAAE,GAAG,EAAE,CAAC,aAAa;QACjC,WAAW,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAA,0BAAkB,EAAC,OAAO,EAAE,MAAM,CAAC,cAAc,CAAC;KAC7E,CAAA;AACH,CAAC"}
+{"version":3,"file":"coding.js","sourceRoot":"","sources":["../../../src/agent/profiles/coding.ts"],"names":[],"mappings":";;AAaA,8CAuBC;AAnCD,0DAA0D;AAE1D,wEAAmE;AACnE,sEAAuE;AACvE,+CAAwD;AAExD,uDAA8D;AAE9D,MAAM,aAAa,GAAG,isBAAisB,kCAAqB,EAAE,CAAA;AAE9uB,MAAM,eAAe,GAAG,4TAA4T,CAAA;AAEpV,SAAgB,iBAAiB,CAAC,MAA0B,EAAE,YAAoB;IAChF,8FAA8F;IAC9F,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,OAAO;QACL,OAAO,EAAE,QAAQ;QACjB,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,EAAE;QACxB,YAAY,EAAE,GAAG,EAAE,CAAC,aAAa,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,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,EAAE,GAAG,IAAA,0BAAkB,EAAC,OAAO,EAAE,MAAM,CAAC,cAAc,CAAC,EAAE,GAAG,WAAW,EAAE,CAAA;QAClF,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/agent/profiles/index.js

@@ -4,6 +4,6 @@ exports.createAgentDefinition = createAgentDefinition;
 const coding_1 = require("./coding");
 const research_1 = require("./research");
 function createAgentDefinition(config, workspaceDir) {
-    return config.profile === 'research' ? (0, research_1.createResearchAgent)(config, workspaceDir) : (0, coding_1.createCodingAgent)(config);
+    return config.profile === 'research' ? (0, research_1.createResearchAgent)(config, workspaceDir) : (0, coding_1.createCodingAgent)(config, workspaceDir);
 }
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/profiles/index.ts"],"names":[],"mappings":";;AAKA,sDAEC;AALD,qCAA4C;AAC5C,yCAAgD;AAEhD,SAAgB,qBAAqB,CAAC,MAA0B,EAAE,YAAoB;IACpF,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,IAAA,8BAAmB,EAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,IAAA,0BAAiB,EAAC,MAAM,CAAC,CAAA;AAC9G,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/profiles/index.ts"],"names":[],"mappings":";;AAKA,sDAEC;AALD,qCAA4C;AAC5C,yCAAgD;AAEhD,SAAgB,qBAAqB,CAAC,MAA0B,EAAE,YAAoB;IACpF,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,IAAA,8BAAmB,EAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,IAAA,0BAAiB,EAAC,MAAM,EAAE,YAAY,CAAC,CAAA;AAC5H,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;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;AA2B9D,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_path_1 = __importDefault(require("node:path"));
 const attribution_1 = require("../../models/attribution");
+const workload_1 = require("../../runtime/workload");
 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 (0, workload_1.readInside)(workspaceDir, node_path_1.default.join(workspaceDir, prompt_1.RESEARCH_OUTPUT_FILES.notes))).toString('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,CAgB5E;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,167 @@
+"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];
+        const lead = narration ? `${narration}\n\n` : '';
+        // A turn that ends on request_clarification ended on purpose: the next user message is the answer.
+        const last = steps[steps.length - 1];
+        if (last && toolCallsOf(last).some((call) => call.toolName === 'request_clarification')) {
+            return { role: 'assistant', content: `${lead}[This turn paused for the user's answer: ${describeSteps(steps)}.]` };
+        }
+        return { role: 'assistant', content: `${lead}[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

@@ -2,6 +2,7 @@ import { type ModelMessage } from 'ai';
 import type { AgentDefinition } from './definition';
 import type { OutboundEvent } from '../transport/link';
 import { type TokenUsage } from '../models/usage';
+import { type DraftSink } from '../workspace-sync/write-drafts';
 /** 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<{
@@ -21,6 +22,18 @@ 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;
+    /**
+     * Workspace live sync (workspace-sync/workspace-sync.ts): write_files drafts stream into it, and
+     * publish_results mirrors its files through it. Without it, publish_results sends a `files` event.
+     */
+    files?: DraftSink & {
+        flush(paths: string[]): Promise<void>;
+    };
 }
 interface TurnOutput {
     /** Messages to append to history, including a safe text-only fallback for an interrupted turn. */
@@ -44,7 +57,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;AAY1D,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAelF,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;IACvC;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,GAAG;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAA;CAC9D;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;CAgLjD"}