@multiplayer-app/agent 0.1.9 → 0.1.11

package/dist/{lifecycle.test.js → runtime/lifecycle.test.js}

@@ -5,7 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const strict_1 = __importDefault(require("node:assert/strict"));
 const node_test_1 = require("node:test");
-const runtime_1 = require("./runtime");
+const index_1 = require("./index");
 (0, node_test_1.describe)('Lambda suspend/terminate checkpoint', () => {
     for (const hook of ['suspend', 'terminate']) {
         (0, node_test_1.it)(`waits for both startup and Git before completing ${hook}`, async () => {
@@ -18,7 +18,7 @@ const runtime_1 = require("./runtime");
             const push = new Promise((resolve) => {
                 pushed = resolve;
             });
-            const request = (0, runtime_1.checkpointBeforeFreeze)(startup, hook).then(() => {
+            const request = (0, index_1.checkpointBeforeFreeze)(startup, hook).then(() => {
                 finished = true;
             });
             await Promise.resolve();
@@ -35,12 +35,12 @@ const runtime_1 = require("./runtime");
         });
     }
     (0, node_test_1.it)('rejects the lifecycle request if startup or the Git push fails', async () => {
-        await strict_1.default.rejects((0, runtime_1.checkpointBeforeFreeze)(undefined, 'suspend'), /has not started/);
-        await strict_1.default.rejects((0, runtime_1.checkpointBeforeFreeze)(Promise.reject(new Error('restore failed')), 'suspend'), /restore failed/);
+        await strict_1.default.rejects((0, index_1.checkpointBeforeFreeze)(undefined, 'suspend'), /has not started/);
+        await strict_1.default.rejects((0, index_1.checkpointBeforeFreeze)(Promise.reject(new Error('restore failed')), 'suspend'), /restore failed/);
         const agent = { session: { checkpoint: async () => {
                     throw new Error('push failed');
                 } } };
-        await strict_1.default.rejects((0, runtime_1.checkpointBeforeFreeze)(Promise.resolve(agent), 'terminate'), /push failed/);
+        await strict_1.default.rejects((0, index_1.checkpointBeforeFreeze)(Promise.resolve(agent), 'terminate'), /push failed/);
     });
 });
 //# sourceMappingURL=lifecycle.test.js.map

package/dist/runtime/lifecycle.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.test.js","sourceRoot":"","sources":["../../src/runtime/lifecycle.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAuC;AACvC,yCAAwC;AACxC,mCAAmE;AAEnE,IAAA,oBAAQ,EAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,KAAK,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,CAAC;QAC5C,IAAA,cAAE,EAAC,oDAAoD,IAAI,EAAE,EAAE,KAAK,IAAI,EAAE;YACxE,IAAI,OAAuC,CAAA;YAC3C,IAAI,MAAmB,CAAA;YACvB,IAAI,QAAQ,GAAG,KAAK,CAAA;YACpB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAe,CAAC,OAAO,EAAE,EAAE;gBACpD,OAAO,GAAG,OAAO,CAAA;YACnB,CAAC,CAAC,CAAA;YACF,MAAM,IAAI,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBACzC,MAAM,GAAG,OAAO,CAAA;YAClB,CAAC,CAAC,CAAA;YACF,MAAM,OAAO,GAAG,IAAA,8BAAsB,EAAC,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC9D,QAAQ,GAAG,IAAI,CAAA;YACjB,CAAC,CAAC,CAAA;YACF,MAAM,OAAO,CAAC,OAAO,EAAE,CAAA;YACvB,gBAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;YAC7B,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,MAAc,EAAE,EAAE;wBACxD,gBAAM,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;wBAC1B,MAAM,IAAI,CAAA;oBACZ,CAAC,EAAE,EAA6B,CAAC,CAAA;YACjC,MAAM,OAAO,CAAC,OAAO,EAAE,CAAA;YACvB,gBAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;YAC7B,MAAM,EAAE,CAAA;YACR,MAAM,OAAO,CAAA;YACb,gBAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QAC9B,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,IAAA,cAAE,EAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,gBAAM,CAAC,OAAO,CAAC,IAAA,8BAAsB,EAAC,SAAS,EAAE,SAAS,CAAC,EAAE,iBAAiB,CAAC,CAAA;QACrF,MAAM,gBAAM,CAAC,OAAO,CAAC,IAAA,8BAAsB,EAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,gBAAgB,CAAC,CAAA;QACtH,MAAM,KAAK,GAAG,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,KAAK,IAAI,EAAE;oBAChD,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAA;gBAChC,CAAC,EAAE,EAA6B,CAAA;QAChC,MAAM,gBAAM,CAAC,OAAO,CAAC,IAAA,8BAAsB,EAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,EAAE,aAAa,CAAC,CAAA;IAClG,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/session/checkpoint-timer.test.d.ts.map

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

package/dist/{checkpoint-timer.test.js → session/checkpoint-timer.test.js}

@@ -9,13 +9,13 @@ const node_os_1 = __importDefault(require("node:os"));
 const node_path_1 = __importDefault(require("node:path"));
 const promises_1 = require("node:timers/promises");
 const node_test_1 = require("node:test");
-const session_1 = require("./session");
-const git_sync_1 = require("./git-sync");
+const index_1 = require("./index");
+const git_sync_1 = require("../persistence/git-sync");
 (0, node_test_1.it)('checkpoints idle sessions every five minutes without overlapping slow pushes, and stops the timer on shutdown', async (t) => {
     const dir = await node_fs_1.promises.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), 'agent-checkpoint-timer-'));
     t.after(() => node_fs_1.promises.rm(dir, { recursive: true, force: true }));
     t.mock.timers.enable({ apis: ['setTimeout', 'Date'], now: 1000000 });
-    const agent = new session_1.SessionAgent({
+    const agent = new index_1.SessionAgent({
         sessionId: 's', mode: 'session', profile: 'coding', workspaceDir: dir,
         model: 'unused', extractionModel: 'unused', mcpConnections: [], provider: {},
     }, { send() { }, onCommand() { }, async ready() { }, async close() { } });
@@ -25,21 +25,21 @@ const git_sync_1 = require("./git-sync");
     });
     const checkpoint = t.mock.method(agent, 'checkpoint', async () => push);
     await agent.start();
-    t.mock.timers.tick(session_1.PERIODIC_CHECKPOINT_MS - 1);
+    t.mock.timers.tick(index_1.PERIODIC_CHECKPOINT_MS - 1);
     strict_1.default.equal(checkpoint.mock.callCount(), 0);
     t.mock.timers.tick(1);
     strict_1.default.equal(checkpoint.mock.callCount(), 1);
     strict_1.default.deepEqual(checkpoint.mock.calls[0].arguments, ['periodic']);
-    t.mock.timers.tick(session_1.PERIODIC_CHECKPOINT_MS * 3);
+    t.mock.timers.tick(index_1.PERIODIC_CHECKPOINT_MS * 3);
     strict_1.default.equal(checkpoint.mock.callCount(), 1);
     release();
     await (0, promises_1.setImmediate)();
-    t.mock.timers.tick(session_1.PERIODIC_CHECKPOINT_MS);
+    t.mock.timers.tick(index_1.PERIODIC_CHECKPOINT_MS);
     strict_1.default.equal(checkpoint.mock.callCount(), 2);
     await (0, promises_1.setImmediate)();
     await agent.stop();
     const count = checkpoint.mock.callCount();
-    t.mock.timers.tick(session_1.PERIODIC_CHECKPOINT_MS * 3);
+    t.mock.timers.tick(index_1.PERIODIC_CHECKPOINT_MS * 3);
     strict_1.default.equal(checkpoint.mock.callCount(), count);
 });
 (0, node_test_1.it)('defers periodic work until five minutes after a successful turn/lifecycle checkpoint', async (t) => {
@@ -49,7 +49,7 @@ const git_sync_1 = require("./git-sync");
     t.mock.method(git_sync_1.GitSync.prototype, 'restore', async () => false);
     const commit = t.mock.method(git_sync_1.GitSync.prototype, 'commit', async () => 'sha');
     let checkpointed;
-    const agent = new session_1.SessionAgent({
+    const agent = new index_1.SessionAgent({
         sessionId: 's', mode: 'session', profile: 'coding', workspaceDir: dir,
         model: 'unused', extractionModel: 'unused', mcpConnections: [], provider: {},
         git: { dir, serverUrl: 'unused', repository: 'unused', branch: 'session/s', token: 'unused' },

package/dist/session/checkpoint-timer.test.js.map

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

package/dist/session/conversation.d.ts

@@ -0,0 +1,15 @@
+import type { ModelMessage } from 'ai';
+export interface PersistedConversation {
+    version: 1;
+    messages: ModelMessage[];
+    usedTokens: number;
+    budget?: number;
+    budgetPaused?: boolean;
+}
+/** Drops the oldest turns (user message + everything up to the next user message) past the cap, keeping the first one. */
+export declare function limitConversation(messages: ModelMessage[], charBudget?: number): ModelMessage[];
+/** Missing conversation means a new session; corrupt state must fail startup. */
+export declare function readConversation(workspaceDir: string): Promise<PersistedConversation | undefined>;
+/** Replace atomically so recovery never reads half of a conversation. The caller serializes writes. */
+export declare function writeConversation(workspaceDir: string, getConversation: () => PersistedConversation): Promise<void>;
+//# sourceMappingURL=conversation.d.ts.map

package/dist/session/conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../src/session/conversation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAA;AAMtC,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,CAAC,CAAA;IACV,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAMD,0HAA0H;AAC1H,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,UAAU,SAAsB,GAAG,YAAY,EAAE,CAa5G;AAED,iFAAiF;AACjF,wBAAsB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAavG;AAED,uGAAuG;AACvG,wBAAsB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzH"}

package/dist/session/conversation.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.limitConversation = limitConversation;
+exports.readConversation = readConversation;
+exports.writeConversation = writeConversation;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const CONVERSATION_FILE = '.builder/conversation.json';
+/** Rough context cap (chars ≈ tokens × 4): older turns are dropped, the first question is kept. */
+const CONTEXT_CHAR_BUDGET = 480000;
+function approxChars(message) {
+    return JSON.stringify(message).length;
+}
+/** Drops the oldest turns (user message + everything up to the next user message) past the cap, keeping the first one. */
+function limitConversation(messages, charBudget = CONTEXT_CHAR_BUDGET) {
+    var _a;
+    let total = messages.reduce((sum, message) => sum + approxChars(message), 0);
+    if (total <= charBudget)
+        return messages;
+    const result = [...messages];
+    while (total > charBudget) {
+        const userIndexes = result.map((m, i) => (m.role === 'user' ? i : -1)).filter((i) => i >= 0);
+        if (userIndexes.length < 2)
+            break;
+        const start = userIndexes[1];
+        const end = (_a = userIndexes[2]) !== null && _a !== void 0 ? _a : result.length;
+        const removed = result.splice(start, end - start);
+        total -= removed.reduce((sum, message) => sum + approxChars(message), 0);
+    }
+    return result;
+}
+/** Missing conversation means a new session; corrupt state must fail startup. */
+async function readConversation(workspaceDir) {
+    let raw;
+    try {
+        raw = await node_fs_1.promises.readFile(node_path_1.default.join(workspaceDir, CONVERSATION_FILE), 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+    const parsed = JSON.parse(raw);
+    if (parsed.version !== 1 || !Array.isArray(parsed.messages)) {
+        throw new Error('Invalid saved session conversation');
+    }
+    return parsed;
+}
+/** Replace atomically so recovery never reads half of a conversation. The caller serializes writes. */
+async function writeConversation(workspaceDir, getConversation) {
+    const target = node_path_1.default.join(workspaceDir, CONVERSATION_FILE);
+    await node_fs_1.promises.mkdir(node_path_1.default.dirname(target), { recursive: true });
+    // Read messages and token counters together after the directory is ready. A model step
+    // may finish during mkdir; capturing counters earlier would pair them with newer messages.
+    await node_fs_1.promises.writeFile(`${target}.tmp`, JSON.stringify(getConversation()));
+    await node_fs_1.promises.rename(`${target}.tmp`, target);
+}
+//# sourceMappingURL=conversation.js.map

package/dist/session/conversation.js.map

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

package/dist/session/conversation.test.d.ts

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

package/dist/session/conversation.test.d.ts.map

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

package/dist/session/conversation.test.js

@@ -0,0 +1,53 @@
+"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_fs_1 = require("node:fs");
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_test_1 = require("node:test");
+const conversation_1 = require("./conversation");
+(0, node_test_1.it)('trims whole turns without mutating history or separating tool calls from their results', () => {
+    const first = { role: 'user', content: 'Original research question' };
+    const latest = { role: 'user', content: 'Continue' };
+    const history = [
+        first,
+        { role: 'user', content: 'An older follow-up' },
+        { role: 'assistant', content: [{ type: 'tool-call', toolCallId: 'call', toolName: 'read_file', input: { path: 'notes' } }] },
+        { role: 'tool', content: [{ type: 'tool-result', toolCallId: 'call', toolName: 'read_file', output: { type: 'text', value: 'Notes' } }] },
+        latest,
+    ];
+    const original = structuredClone(history);
+    const budget = JSON.stringify(first).length + JSON.stringify(latest).length;
+    strict_1.default.deepEqual((0, conversation_1.limitConversation)(history, budget), [first, latest]);
+    strict_1.default.deepEqual(history, original);
+    strict_1.default.equal((0, conversation_1.limitConversation)(history), history);
+    strict_1.default.deepEqual((0, conversation_1.limitConversation)([first], 1), [first], 'the original question survives even if it exceeds the cap');
+});
+(0, node_test_1.it)('persists conversation and budget together and leaves no partial checkpoint behind', async (t) => {
+    const dir = await node_fs_1.promises.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), 'agent-conversation-'));
+    t.after(() => node_fs_1.promises.rm(dir, { recursive: true, force: true }));
+    strict_1.default.equal(await (0, conversation_1.readConversation)(dir), undefined);
+    const saved = {
+        version: 1,
+        messages: [{ role: 'user', content: 'Research' }, { role: 'assistant', content: 'Findings' }],
+        usedTokens: 120,
+        budget: 100,
+        budgetPaused: true,
+    };
+    await (0, conversation_1.writeConversation)(dir, () => saved);
+    strict_1.default.deepEqual(await (0, conversation_1.readConversation)(dir), saved);
+    strict_1.default.deepEqual(await node_fs_1.promises.readdir(node_path_1.default.join(dir, '.builder')), ['conversation.json']);
+});
+(0, node_test_1.it)('rejects corrupt or unsupported saved conversations instead of treating them as new sessions', async (t) => {
+    const dir = await node_fs_1.promises.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), 'agent-conversation-invalid-'));
+    t.after(() => node_fs_1.promises.rm(dir, { recursive: true, force: true }));
+    await node_fs_1.promises.mkdir(node_path_1.default.join(dir, '.builder'));
+    for (const raw of ['{', '{"version":2,"messages":[]}', '{"version":1,"messages":"invalid"}']) {
+        await node_fs_1.promises.writeFile(node_path_1.default.join(dir, '.builder/conversation.json'), raw);
+        await strict_1.default.rejects((0, conversation_1.readConversation)(dir));
+    }
+});
+//# sourceMappingURL=conversation.test.js.map

package/dist/session/conversation.test.js.map

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

package/dist/session/idle-checkpoint.test.d.ts.map

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

package/dist/{idle-checkpoint.test.js → session/idle-checkpoint.test.js}

@@ -5,10 +5,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const strict_1 = __importDefault(require("node:assert/strict"));
 const node_test_1 = require("node:test");
-const session_1 = require("./session");
+const index_1 = require("./index");
 function fixture(withGit = true) {
     const events = [];
-    const agent = new session_1.SessionAgent({
+    const agent = new index_1.SessionAgent({
         sessionId: 'test', workspaceDir: '/unused',
         ...(withGit ? { git: { serverUrl: 'https://example.test', repository: 'sessions', branch: 'session/test', token: 'test', dir: '/unused' } } : {}),
     }, {
@@ -46,10 +46,14 @@ function fixture(withGit = true) {
     });
     (0, node_test_1.it)('rejects a failed push and cancels when a turn starts during the push', async (t) => {
         const { agent, state, events } = fixture();
-        const checkpoint = t.mock.method(agent, 'checkpoint', async () => { throw new Error('Git unavailable'); });
+        const checkpoint = t.mock.method(agent, 'checkpoint', async () => {
+            throw new Error('Git unavailable');
+        });
         await strict_1.default.rejects(agent.checkpointIfIdle(1000, 'request'), /Git unavailable/);
         strict_1.default.equal(events.length, 0);
-        checkpoint.mock.mockImplementation(async () => { state.current = {}; });
+        checkpoint.mock.mockImplementation(async () => {
+            state.current = {};
+        });
         await agent.checkpointIfIdle(1000, 'request');
         strict_1.default.deepEqual(events, [{ type: 'checkpointed', requestId: 'request', skipped: true, idleConfirmed: false }]);
     });

package/dist/session/idle-checkpoint.test.js.map

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

package/dist/session/index.d.ts

@@ -0,0 +1,7 @@
+import type { AgentRuntimeConfig } from '../runtime/config';
+import type { SessionLink } from '../transport/link';
+import { SessionRuntime } from './runtime';
+export { SessionRuntime as SessionAgent, PERIODIC_CHECKPOINT_MS } from './runtime';
+export { limitConversation } from './conversation';
+export declare function runSessionAgent(config: AgentRuntimeConfig, link: SessionLink): Promise<SessionRuntime>;
+//# sourceMappingURL=index.d.ts.map

package/dist/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE1C,OAAO,EAAE,cAAc,IAAI,YAAY,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAElD,wBAAsB,eAAe,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAI5G"}

package/dist/session/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.limitConversation = exports.PERIODIC_CHECKPOINT_MS = exports.SessionAgent = void 0;
+exports.runSessionAgent = runSessionAgent;
+const runtime_1 = require("./runtime");
+var runtime_2 = require("./runtime");
+Object.defineProperty(exports, "SessionAgent", { enumerable: true, get: function () { return runtime_2.SessionRuntime; } });
+Object.defineProperty(exports, "PERIODIC_CHECKPOINT_MS", { enumerable: true, get: function () { return runtime_2.PERIODIC_CHECKPOINT_MS; } });
+var conversation_1 = require("./conversation");
+Object.defineProperty(exports, "limitConversation", { enumerable: true, get: function () { return conversation_1.limitConversation; } });
+async function runSessionAgent(config, link) {
+    const session = new runtime_1.SessionRuntime(config, link);
+    await session.start();
+    return session;
+}
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":";;;AAQA,0CAIC;AATD,uCAA0C;AAE1C,qCAAkF;AAAzE,uGAAA,cAAc,OAAgB;AAAE,iHAAA,sBAAsB,OAAA;AAC/D,+CAAkD;AAAzC,iHAAA,iBAAiB,OAAA;AAEnB,KAAK,UAAU,eAAe,CAAC,MAA0B,EAAE,IAAiB;IACjF,MAAM,OAAO,GAAG,IAAI,wBAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAChD,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;IACrB,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/session/runtime.d.ts

@@ -0,0 +1,58 @@
+import type { AgentDefinition } from '../agent/definition';
+import type { AgentRuntimeConfig } from '../runtime/config';
+import type { SessionLink } from '../transport/link';
+import { TurnRunner } from '../agent/turn-runner';
+import { type WorkspacePersistence } from '../persistence/workspace';
+export declare const PERIODIC_CHECKPOINT_MS: number;
+export interface SessionRuntimeDependencies {
+    definition?: AgentDefinition;
+    persistence?: WorkspacePersistence;
+    turnRunner?: Pick<TurnRunner, 'run'>;
+}
+export declare class SessionRuntime {
+    private readonly config;
+    private readonly link;
+    private messages;
+    private usedTokens;
+    private budget?;
+    private budgetPaused;
+    private current?;
+    private readonly queue;
+    private readonly persistence?;
+    private readonly definition;
+    private readonly turnRunner;
+    private systemPrompt;
+    private periodic?;
+    private stopped;
+    private turnTask?;
+    private checkpointTask;
+    private lastCheckpointAt;
+    private lastActivityAt;
+    constructor(config: AgentRuntimeConfig, link: SessionLink, dependencies?: SessionRuntimeDependencies);
+    private get workspaceDir();
+    start(): Promise<void>;
+    /** Lifecycle hooks (suspend / terminate) call this; it is safe to call repeatedly. */
+    checkpoint(reason: string, requestId?: string): Promise<void>;
+    stop(): Promise<void>;
+    /** Idle policy never aborts a turn, and rechecks after a potentially slow storage push. */
+    checkpointIfIdle(idleForMs: number, requestId?: string): Promise<void>;
+    private scheduleCheckpoint;
+    private handle;
+    /** One task owns the queue, including turns arriving while the previous turn checkpoints. */
+    private startQueuedTurns;
+    private drainQueue;
+    private budgetExceeded;
+    private nearBudget;
+    /**
+     * The budget pause as a question with an answer form, like the agent's own request_clarification:
+     * the platform routes the answer straight back here (answer-research-question.ts) instead of to
+     * the chat's orchestrator, which would otherwise decide for itself whether to resume.
+     */
+    private askBudgetQuestion;
+    private runTurn;
+    /** `detail` is the failure as reported (log only); `message` is what reaches the chat. */
+    private reportTurnError;
+    private loadConversation;
+    private saveConversation;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/session/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/session/runtime.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAIpD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEjD,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAEhG,eAAO,MAAM,sBAAsB,QAAa,CAAA;AAEhD,MAAM,WAAW,0BAA0B;IACzC,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,WAAW,CAAC,EAAE,oBAAoB,CAAA;IAClC,UAAU,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;CACrC;AAeD,qBAAa,cAAc;IAmBvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAnBvB,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,OAAO,CAAC,CAAY;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAgB;IACjC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAe;IAChC,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,gBAAgB,CAAI;IAC5B,OAAO,CAAC,cAAc,CAAa;gBAGhB,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,WAAW,EAClC,YAAY,GAAE,0BAA+B;IAQ/C,OAAO,KAAK,YAAY,GAEvB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B,sFAAsF;IACtF,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBvD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B,2FAA2F;IACrF,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5E,OAAO,CAAC,kBAAkB;YAgBZ,MAAM;IAuBpB,6FAA6F;IAC7F,OAAO,CAAC,gBAAgB;YASV,UAAU;IAOxB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,UAAU;IAIlB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;YAgBX,OAAO;IA2ErB,0FAA0F;IAC1F,OAAO,CAAC,eAAe;YAKT,gBAAgB;IAU9B,OAAO,CAAC,gBAAgB;CASzB"}