@multiplayer-app/agent 0.0.7 → 0.1.1

package/dist/cli.js

@@ -2,27 +2,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 // Generic entrypoint — reads its whole config from real process.env (already materialized by
-// the time this runs: QEMU's init script exports ENV_B64 before launching the entrypoint, so
-// this is the right entrypoint for that engine). Lambda MicroVM's own entrypoint
+// the time this runs: QEMU's init script exports ENV_B64 before launching the entrypoint, and
+// Docker/Fargate pass env directly). Lambda MicroVM's own entrypoint
 // (lambda-microvm-entrypoint.ts) has to materialize env from the /run lifecycle hook payload
-// first, then calls the same runAgentLoop — this file's job is intentionally just "trust
+// first, then calls the same startAgent — this file's job is intentionally just "trust
 // process.env and go".
-const config_1 = require("./config");
-const loop_1 = require("./loop");
-const report_1 = require("./report");
+const runtime_1 = require("./runtime");
 async function main() {
-    const config = (0, config_1.loadConfigFromEnv)();
-    const reporter = (0, report_1.createReporter)(config.socketUrl, config.socketToken, config.sessionId);
-    try {
-        await (0, loop_1.runAgentLoop)(config, reporter);
-    }
-    finally {
-        await reporter.close();
+    const running = await (0, runtime_1.startAgent)();
+    if (!running.session) {
+        process.exit(0);
     }
+    const shutdown = async (signal) => {
+        console.log(`[agent] ${signal} received, checkpointing`);
+        await running.close();
+        process.exit(0);
+    };
+    process.on('SIGTERM', () => void shutdown('SIGTERM'));
+    process.on('SIGINT', () => void shutdown('SIGINT'));
 }
-main()
-    .then(() => process.exit(0))
-    .catch((error) => {
+main().catch((error) => {
     console.error(error instanceof Error ? error.message : error);
     process.exit(1);
 });

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AACA,6FAA6F;AAC7F,6FAA6F;AAC7F,iFAAiF;AACjF,6FAA6F;AAC7F,yFAAyF;AACzF,uBAAuB;AACvB,qCAA4C;AAC5C,iCAAqC;AACrC,qCAAyC;AAEzC,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAA,0BAAiB,GAAE,CAAA;IAClC,MAAM,QAAQ,GAAG,IAAA,uBAAc,EAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAA;IACvF,IAAI,CAAC;QACH,MAAM,IAAA,mBAAY,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACtC,CAAC;YAAS,CAAC;QACT,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAA;IACxB,CAAC;AACH,CAAC;AAED,IAAI,EAAE;KACH,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KAC3B,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACf,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AACA,6FAA6F;AAC7F,8FAA8F;AAC9F,qEAAqE;AACrE,6FAA6F;AAC7F,uFAAuF;AACvF,uBAAuB;AACvB,uCAAsC;AAEtC,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,MAAM,IAAA,oBAAU,GAAE,CAAA;IAClC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;QACxC,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,0BAA0B,CAAC,CAAA;QACxD,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAA;IACD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAA;IACrD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;AACrD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/config.d.ts

@@ -1,14 +1,55 @@
 import type { McpConnectionRecord } from './mcp/mcp-connection';
+export type AgentMode = 'task' | 'session';
+export type AgentProfile = 'coding' | 'research';
+export interface FilingRampConfig {
+    baseUrl: string;
+    clientId: string;
+    clientSecret: string;
+    /** The account may also query industry (public) filings. */
+    industryData: boolean;
+}
+/** What the research session was created for; every FilingRamp tool call is narrowed to it. */
+export interface ResearchScope {
+    dataSource?: 'account' | 'industry';
+    states?: string[];
+    /** Type-of-insurance codes or names ("17.0001", "Homeowners"). */
+    lines?: string[];
+    dateFrom?: string;
+    dateTo?: string;
+}
+export interface GitSyncConfig {
+    serverUrl: string;
+    repository: string;
+    /** Where the repository is checked out — the session workspace itself. */
+    dir: string;
+    branch: string;
+    token: string;
+}
+export interface ModelProviderConfig {
+    openrouterApiKey?: string;
+    anthropicApiKey?: string;
+}
 export interface AgentRuntimeConfig {
     sessionId: string;
-    task: string;
+    mode: AgentMode;
+    profile: AgentProfile;
+    /** One-shot task (mode 'task' only). */
+    task?: string;
     model: string;
+    /** Cheaper model for bulk extraction; defaults to `model`. */
+    extractionModel: string;
+    /** Total tokens the session may spend before asking the user whether to continue. */
+    tokenBudget?: number;
     workspaceDir: string;
     mcpConnections: McpConnectionRecord[];
     /** Gateway's agent-socket-server endpoint (ws(s)://.../agent-sessions/ws), not the api directly. */
     socketUrl?: string;
     socketToken?: string;
+    provider: ModelProviderConfig;
+    filingRamp?: FilingRampConfig;
+    researchScope?: ResearchScope;
+    git?: GitSyncConfig;
 }
-/** Reads the full run config from process.env — the guest's own contract, documented on VmCreateRequest.env. */
+/** Reads the full run config from process.env — the guest's own contract, see AGENT_ENV in protocol.ts. */
 export declare function loadConfigFromEnv(env?: NodeJS.ProcessEnv): AgentRuntimeConfig;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAE/D,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,mBAAmB,EAAE,CAAA;IACrC,oGAAoG;IACpG,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAgBD,gHAAgH;AAChH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,kBAAkB,CAe1F"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAG/D,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,CAAA;AAC1C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,CAAA;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,4DAA4D;IAC5D,YAAY,EAAE,OAAO,CAAA;CACtB;AAED,+FAA+F;AAC/F,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,SAAS,GAAG,UAAU,CAAA;IACnC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,0EAA0E;IAC1E,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,YAAY,CAAA;IACrB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,eAAe,EAAE,MAAM,CAAA;IACvB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,mBAAmB,EAAE,CAAA;IACrC,oGAAoG;IACpG,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAC7B,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,GAAG,CAAC,EAAE,aAAa,CAAA;CACpB;AA4DD,2GAA2G;AAC3G,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,kBAAkB,CAgC1F"}

package/dist/config.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadConfigFromEnv = loadConfigFromEnv;
-const DEFAULT_MODEL = 'claude-sonnet-4-5';
+const protocol_1 = require("./protocol");
+const DEFAULT_MODEL = 'anthropic/claude-sonnet-5.5';
 const DEFAULT_WORKSPACE_DIR = '/workspace';
 function decodeMcpConnections(raw) {
     if (!raw)
@@ -15,22 +16,83 @@ function decodeMcpConnections(raw) {
         throw new Error(`MCP_SERVERS_JSON is not valid base64-encoded JSON: ${error.message}`);
     }
 }
-/** Reads the full run config from process.env — the guest's own contract, documented on VmCreateRequest.env. */
+function parseScope(raw) {
+    if (!raw)
+        return undefined;
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === 'object' ? parsed : undefined;
+    }
+    catch (error) {
+        throw new Error(`RESEARCH_SCOPE_JSON is not valid JSON: ${error.message}`);
+    }
+}
+function parsePositiveInt(raw) {
+    if (!raw)
+        return undefined;
+    const value = Number.parseInt(raw, 10);
+    return Number.isFinite(value) && value > 0 ? value : undefined;
+}
+function filingRampFromEnv(env) {
+    const baseUrl = env[protocol_1.AGENT_ENV.FILINGRAMP_API_BASE_URL];
+    const clientId = env[protocol_1.AGENT_ENV.FILINGRAMP_CLIENT_ID];
+    const clientSecret = env[protocol_1.AGENT_ENV.FILINGRAMP_CLIENT_SECRET];
+    if (!baseUrl || !clientId || !clientSecret)
+        return undefined;
+    return {
+        baseUrl: baseUrl.replace(/\/+$/, ''),
+        clientId,
+        clientSecret,
+        industryData: env[protocol_1.AGENT_ENV.FILINGRAMP_INDUSTRY_DATA] === 'true',
+    };
+}
+function gitFromEnv(env, sessionId, workspaceDir) {
+    const serverUrl = env[protocol_1.AGENT_ENV.GIT_SERVER_URL];
+    const repository = env[protocol_1.AGENT_ENV.GIT_REPOSITORY];
+    const token = env[protocol_1.AGENT_ENV.GIT_ACCESS_TOKEN];
+    if (!repository)
+        return undefined;
+    if (!serverUrl || !token)
+        throw new Error('Git settings are incomplete (GIT_SERVER_URL / GIT_ACCESS_TOKEN)');
+    return {
+        serverUrl: serverUrl.replace(/\/+$/, ''),
+        repository,
+        dir: env[protocol_1.AGENT_ENV.GIT_REPOSITORY_DIR] || workspaceDir,
+        branch: env[protocol_1.AGENT_ENV.GIT_BRANCH] || `session/${sessionId}`,
+        token,
+    };
+}
+/** Reads the full run config from process.env — the guest's own contract, see AGENT_ENV in protocol.ts. */
 function loadConfigFromEnv(env = process.env) {
-    const sessionId = env.SESSION_ID;
-    const task = env.AGENT_TASK;
+    const sessionId = env[protocol_1.AGENT_ENV.SESSION_ID];
     if (!sessionId)
         throw new Error('SESSION_ID is required');
-    if (!task)
-        throw new Error('AGENT_TASK is required');
+    const mode = env[protocol_1.AGENT_ENV.AGENT_MODE] === 'session' ? 'session' : 'task';
+    const profile = env[protocol_1.AGENT_ENV.AGENT_PROFILE] === 'research' ? 'research' : 'coding';
+    const task = env[protocol_1.AGENT_ENV.AGENT_TASK];
+    if (mode === 'task' && !task)
+        throw new Error('AGENT_TASK is required in task mode');
+    const workspaceDir = env[protocol_1.AGENT_ENV.AGENT_WORKSPACE_DIR] || DEFAULT_WORKSPACE_DIR;
+    const model = env[protocol_1.AGENT_ENV.AGENT_MODEL] || DEFAULT_MODEL;
     return {
         sessionId,
+        mode,
+        profile,
         task,
-        model: env.AGENT_MODEL || DEFAULT_MODEL,
-        workspaceDir: env.AGENT_WORKSPACE_DIR || DEFAULT_WORKSPACE_DIR,
-        mcpConnections: decodeMcpConnections(env.MCP_SERVERS_JSON),
-        socketUrl: env.AGENT_SOCKET_URL,
-        socketToken: env.AGENT_SOCKET_TOKEN,
+        model,
+        extractionModel: env[protocol_1.AGENT_ENV.AGENT_EXTRACTION_MODEL] || model,
+        tokenBudget: parsePositiveInt(env[protocol_1.AGENT_ENV.AGENT_TOKEN_BUDGET]),
+        workspaceDir,
+        mcpConnections: decodeMcpConnections(env[protocol_1.AGENT_ENV.MCP_SERVERS_JSON]),
+        socketUrl: env[protocol_1.AGENT_ENV.AGENT_SOCKET_URL],
+        socketToken: env[protocol_1.AGENT_ENV.AGENT_SOCKET_TOKEN],
+        provider: {
+            openrouterApiKey: env[protocol_1.AGENT_ENV.OPENROUTER_API_KEY],
+            anthropicApiKey: env[protocol_1.AGENT_ENV.ANTHROPIC_API_KEY],
+        },
+        filingRamp: filingRampFromEnv(env),
+        researchScope: parseScope(env[protocol_1.AGENT_ENV.RESEARCH_SCOPE_JSON]),
+        git: gitFromEnv(env, sessionId, workspaceDir),
     };
 }
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;AA4BA,8CAeC;AA9BD,MAAM,aAAa,GAAG,mBAAmB,CAAA;AACzC,MAAM,qBAAqB,GAAG,YAAY,CAAA;AAE1C,SAAS,oBAAoB,CAAC,GAAuB;IACnD,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAgC,CAAC,CAAC,CAAC,EAAE,CAAA;IACvE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,sDAAuD,KAAe,CAAC,OAAO,EAAE,CAAC,CAAA;IACnG,CAAC;AACH,CAAC;AAED,gHAAgH;AAChH,SAAgB,iBAAiB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACpE,MAAM,SAAS,GAAG,GAAG,CAAC,UAAU,CAAA;IAChC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAA;IAC3B,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IACzD,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IAEpD,OAAO;QACL,SAAS;QACT,IAAI;QACJ,KAAK,EAAE,GAAG,CAAC,WAAW,IAAI,aAAa;QACvC,YAAY,EAAE,GAAG,CAAC,mBAAmB,IAAI,qBAAqB;QAC9D,cAAc,EAAE,oBAAoB,CAAC,GAAG,CAAC,gBAAgB,CAAC;QAC1D,SAAS,EAAE,GAAG,CAAC,gBAAgB;QAC/B,WAAW,EAAE,GAAG,CAAC,kBAAkB;KACpC,CAAA;AACH,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/git-sync.d.ts

@@ -0,0 +1,22 @@
+import type { GitSyncConfig } from './config';
+export declare const WORKSPACE_GITIGNORE: string;
+export declare class GitSync {
+    private readonly config;
+    private readonly remote;
+    private readonly env;
+    private busy;
+    constructor(config: GitSyncConfig);
+    get dir(): string;
+    private git;
+    /** Serializes git operations: a periodic checkpoint must never race a suspend checkpoint. */
+    private serialize;
+    /**
+     * Clone the session branch into the workspace, or pull it when a checkout already exists.
+     * A brand-new session has no branch yet: start an empty repository on it so the first
+     * checkpoint can push. Returns true when previous work was restored.
+     */
+    restore(): Promise<boolean>;
+    /** Commit everything and push the branch. Resolves with the commit sha, or undefined when nothing changed. */
+    commit(message: string): Promise<string | undefined>;
+}
+//# sourceMappingURL=git-sync.d.ts.map

package/dist/git-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-sync.d.ts","sourceRoot":"","sources":["../src/git-sync.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAI7C,eAAO,MAAM,mBAAmB,QAAkG,CAAA;AAWlI,qBAAa,OAAO;IAKN,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAmB;IACvC,OAAO,CAAC,IAAI,CAAsC;gBAErB,MAAM,EAAE,aAAa;IAiBlD,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,OAAO,CAAC,GAAG;IAIX,6FAA6F;IAC7F,OAAO,CAAC,SAAS;IAMjB;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IA0B3B,8GAA8G;IAC9G,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAcrD"}

package/dist/git-sync.js

@@ -0,0 +1,107 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitSync = exports.WORKSPACE_GITIGNORE = void 0;
+// Durability for a session VM whose disk can vanish (Lambda terminates a long-suspended
+// MicroVM): the workspace is a checkout of branch `session/<id>` on the platform's git
+// server. restore() runs at boot, commit() at every checkpoint. Bulk downloads stay out of
+// git (see WORKSPACE_GITIGNORE) — the extracted text and the research outputs are what a
+// restored VM needs; attachments can be fetched again.
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const util_1 = require("util");
+const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
+exports.WORKSPACE_GITIGNORE = ['data/attachments/', 'node_modules/', '.venv/', '*.sqlite', '*.sqlite-journal', ''].join('\n');
+async function pathExists(target) {
+    try {
+        await fs_1.promises.access(target);
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+}
+class GitSync {
+    constructor(config) {
+        this.config = config;
+        this.busy = Promise.resolve();
+        this.remote = `${config.serverUrl}/git/${config.repository}.git`;
+        // The token travels as a per-process http.extraheader, never on the remote URL or in
+        // .git/config, so a `git remote -v` inside the workspace cannot leak it.
+        this.env = {
+            ...process.env,
+            GIT_TERMINAL_PROMPT: '0',
+            GIT_CONFIG_COUNT: '3',
+            GIT_CONFIG_KEY_0: 'http.extraheader',
+            GIT_CONFIG_VALUE_0: `Authorization: Bearer ${config.token}`,
+            GIT_CONFIG_KEY_1: 'user.name',
+            GIT_CONFIG_VALUE_1: 'session-agent',
+            GIT_CONFIG_KEY_2: 'user.email',
+            GIT_CONFIG_VALUE_2: 'agent@builder.local',
+        };
+    }
+    get dir() {
+        return this.config.dir;
+    }
+    git(args, cwd = this.config.dir) {
+        return execFileAsync('git', args, { cwd, env: this.env, maxBuffer: 8 * 1024 * 1024 });
+    }
+    /** Serializes git operations: a periodic checkpoint must never race a suspend checkpoint. */
+    serialize(work) {
+        const next = this.busy.then(work, work);
+        this.busy = next.catch(() => undefined);
+        return next;
+    }
+    /**
+     * Clone the session branch into the workspace, or pull it when a checkout already exists.
+     * A brand-new session has no branch yet: start an empty repository on it so the first
+     * checkpoint can push. Returns true when previous work was restored.
+     */
+    restore() {
+        return this.serialize(async () => {
+            const { dir, branch } = this.config;
+            await fs_1.promises.mkdir(dir, { recursive: true });
+            if (await pathExists(path_1.default.join(dir, '.git'))) {
+                try {
+                    await this.git(['fetch', 'origin', branch]);
+                    await this.git(['reset', '--hard', `origin/${branch}`]);
+                    return true;
+                }
+                catch (error) {
+                    console.warn('[git] pull failed, keeping the local checkout:', error.message);
+                    return false;
+                }
+            }
+            const remoteBranches = (await this.git(['ls-remote', '--heads', this.remote, branch], process.cwd())).stdout.trim();
+            if (remoteBranches) {
+                await this.git(['clone', '--branch', branch, '--single-branch', this.remote, dir], process.cwd());
+                return true;
+            }
+            await this.git(['init', '--initial-branch', branch]);
+            await this.git(['remote', 'add', 'origin', this.remote]);
+            await fs_1.promises.writeFile(path_1.default.join(dir, '.gitignore'), exports.WORKSPACE_GITIGNORE);
+            return false;
+        });
+    }
+    /** Commit everything and push the branch. Resolves with the commit sha, or undefined when nothing changed. */
+    commit(message) {
+        return this.serialize(async () => {
+            if (!(await pathExists(path_1.default.join(this.config.dir, '.gitignore')))) {
+                await fs_1.promises.writeFile(path_1.default.join(this.config.dir, '.gitignore'), exports.WORKSPACE_GITIGNORE);
+            }
+            await this.git(['add', '-A']);
+            const status = (await this.git(['status', '--porcelain'])).stdout.trim();
+            if (!status)
+                return undefined;
+            await this.git(['commit', '-q', '-m', message]);
+            const sha = (await this.git(['rev-parse', 'HEAD'])).stdout.trim();
+            await this.git(['push', '-u', 'origin', `HEAD:${this.config.branch}`]);
+            return sha;
+        });
+    }
+}
+exports.GitSync = GitSync;
+//# sourceMappingURL=git-sync.js.map

package/dist/git-sync.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,10 @@
-export { loadConfigFromEnv, type AgentRuntimeConfig } from './config';
+export { loadConfigFromEnv, type AgentRuntimeConfig, type AgentMode, type AgentProfile, type ResearchScope } from './config';
 export { runAgentLoop } from './loop';
 export { createReporter, type AgentEvent, type Reporter } from './report';
+export { createSessionLink, type SessionLink } from './link';
+export { SessionAgent, runSessionAgent, limitConversation } from './session';
+export { startAgent, type RunningAgent } from './runtime';
+export { GitSync } from './git-sync';
+export * from './protocol';
 export type { McpConnectionRecord, McpConnectionSummary, McpOAuthTokens, McpToolSummary } from './mcp/mcp-connection';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAA;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AACzE,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAA;AAC5H,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AACzE,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC5E,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAA;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,cAAc,YAAY,CAAA;AAC1B,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/index.js

@@ -1,10 +1,35 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createReporter = exports.runAgentLoop = exports.loadConfigFromEnv = void 0;
+exports.GitSync = exports.startAgent = exports.limitConversation = exports.runSessionAgent = exports.SessionAgent = exports.createSessionLink = exports.createReporter = exports.runAgentLoop = exports.loadConfigFromEnv = void 0;
 var config_1 = require("./config");
 Object.defineProperty(exports, "loadConfigFromEnv", { enumerable: true, get: function () { return config_1.loadConfigFromEnv; } });
 var loop_1 = require("./loop");
 Object.defineProperty(exports, "runAgentLoop", { enumerable: true, get: function () { return loop_1.runAgentLoop; } });
 var report_1 = require("./report");
 Object.defineProperty(exports, "createReporter", { enumerable: true, get: function () { return report_1.createReporter; } });
+var link_1 = require("./link");
+Object.defineProperty(exports, "createSessionLink", { enumerable: true, get: function () { return link_1.createSessionLink; } });
+var session_1 = require("./session");
+Object.defineProperty(exports, "SessionAgent", { enumerable: true, get: function () { return session_1.SessionAgent; } });
+Object.defineProperty(exports, "runSessionAgent", { enumerable: true, get: function () { return session_1.runSessionAgent; } });
+Object.defineProperty(exports, "limitConversation", { enumerable: true, get: function () { return session_1.limitConversation; } });
+var runtime_1 = require("./runtime");
+Object.defineProperty(exports, "startAgent", { enumerable: true, get: function () { return runtime_1.startAgent; } });
+var git_sync_1 = require("./git-sync");
+Object.defineProperty(exports, "GitSync", { enumerable: true, get: function () { return git_sync_1.GitSync; } });
+__exportStar(require("./protocol"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAqE;AAA5D,2GAAA,iBAAiB,OAAA;AAC1B,+BAAqC;AAA5B,oGAAA,YAAY,OAAA;AACrB,mCAAyE;AAAhE,wGAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mCAA4H;AAAnH,2GAAA,iBAAiB,OAAA;AAC1B,+BAAqC;AAA5B,oGAAA,YAAY,OAAA;AACrB,mCAAyE;AAAhE,wGAAA,cAAc,OAAA;AACvB,+BAA4D;AAAnD,yGAAA,iBAAiB,OAAA;AAC1B,qCAA4E;AAAnE,uGAAA,YAAY,OAAA;AAAE,0GAAA,eAAe,OAAA;AAAE,4GAAA,iBAAiB,OAAA;AACzD,qCAAyD;AAAhD,qGAAA,UAAU,OAAA;AACnB,uCAAoC;AAA3B,mGAAA,OAAO,OAAA;AAChB,6CAA0B"}

package/dist/lambda-microvm-entrypoint.js

@@ -7,22 +7,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 // Lambda MicroVM-specific bootstrap. AWS's platform calls the lifecycle hooks
 // (/aws/lambda-microvms/runtime/v1/{run,resume,suspend,terminate}) on port 8080 and expects a
 // response before it considers the instance up (createMicrovmImages registers every image with
-// hooks: { run/resume/suspend/terminate: 'ENABLED' } — libs/sandbox/src/microvm-images.ts:58-62
-// — this isn't optional). Per-run config (env vars) arrives as the /run hook's runHookPayload,
-// not as real process env vars — mirrors the existing plain node/python guest agent
-// (microvm-guest-agents.ts's NODE_APP) exactly for that part.
+// hooks: { run/resume/suspend/terminate: 'ENABLED' } — libs/sandbox/src/microvm-images.ts —
+// this isn't optional). Per-run config (env vars) arrives as the /run hook's runHookPayload,
+// not as real process env vars.
 //
-// Once /run is handled, this closes the hook server and runs the agent loop in-process — if
-// the task starts a dev server, it binds the now-free $PORT (8080) itself. Matches the existing
-// release-deployment guest agent's own tradeoff: once port 8080 is handed over, later
-// suspend/resume/terminate hooks have nowhere to land until proper lifecycle support lands
-// (tracked alongside EFS persistence — see the plan's deferred section).
+// The hook server stays up for the whole life of the VM: `suspend` and `terminate` checkpoint
+// the session (conversation + workspace to the git server), `resume` re-announces the agent.
+// Research VMs never need port 8080 for an app, so nothing competes for it. Engines without a
+// hook caller (Docker, Fargate) set SESSION_ID in the real env at boot, which starts the agent
+// directly.
 const http_1 = __importDefault(require("http"));
-const config_1 = require("./config");
-const loop_1 = require("./loop");
-const report_1 = require("./report");
+const runtime_1 = require("./runtime");
 const HOOK_PREFIX = '/aws/lambda-microvms/runtime/v1/';
 const PORT = 8080;
+let running;
+let starting;
 function materializeEnv(runHookPayload) {
     var _a;
     if (!runHookPayload)
@@ -33,56 +32,92 @@ function materializeEnv(runHookPayload) {
             if (typeof value === 'string')
                 process.env[key] = value;
         }
+        if (!process.env.SESSION_ID && typeof session.sessionId === 'string')
+            process.env.SESSION_ID = session.sessionId;
     }
     catch (_b) {
         // payload is optional / best-effort, matching the plain node/python guest agent
     }
 }
-async function runTask() {
-    let reporter;
-    try {
-        const config = (0, config_1.loadConfigFromEnv)();
-        reporter = (0, report_1.createReporter)(config.socketUrl, config.socketToken, config.sessionId);
-        await (0, loop_1.runAgentLoop)(config, reporter);
-    }
-    catch (error) {
-        console.error('agent run failed:', error);
+function start() {
+    if (!starting) {
+        starting = (0, runtime_1.startAgent)()
+            .then((agent) => {
+            running = agent;
+        })
+            .catch((error) => {
+            console.error('agent run failed:', error instanceof Error ? error.message : error);
+        });
     }
-    finally {
-        await (reporter === null || reporter === void 0 ? void 0 : reporter.close());
+    return starting;
+}
+async function onHook(hook, body) {
+    var _a;
+    switch (hook) {
+        case 'run': {
+            try {
+                const parsed = JSON.parse(body);
+                materializeEnv(parsed.runHookPayload);
+            }
+            catch (_b) {
+                /* payload is optional */
+            }
+            void start();
+            return;
+        }
+        case 'suspend':
+        case 'terminate':
+            await ((_a = running === null || running === void 0 ? void 0 : running.session) === null || _a === void 0 ? void 0 : _a.checkpoint(hook));
+            return;
+        case 'resume':
+            // Memory and disk survived; the socket reconnects on its own. Nothing to restore.
+            return;
+        default:
+            return;
     }
 }
 const server = http_1.default.createServer((req, res) => {
-    var _a;
+    var _a, _b;
     if (((_a = req.url) === null || _a === void 0 ? void 0 : _a.startsWith(HOOK_PREFIX)) && req.method === 'POST') {
         const hook = req.url.slice(HOOK_PREFIX.length);
         const chunks = [];
         req.on('data', (chunk) => chunks.push(chunk));
         req.on('end', () => {
             const body = Buffer.concat(chunks).toString();
-            // Runtime env may contain MCP tokens or a callback bearer token; never log the body.
+            // Runtime env may contain API client secrets or a socket token; never log the body.
             console.log(`lifecycle hook: ${hook}`);
-            res.writeHead(200, { 'Content-Type': 'application/json' });
-            res.end('{}');
-            if (hook === 'run') {
-                try {
-                    const parsed = JSON.parse(body);
-                    materializeEnv(parsed.runHookPayload);
-                }
-                catch (_a) {
-                    /* payload is optional */
-                }
-                server.close(() => {
-                    void runTask();
-                });
+            // suspend/terminate must finish the checkpoint before AWS freezes or kills the VM, so
+            // the response waits for it; `run` answers right away and starts the agent in the background.
+            const work = onHook(hook, body);
+            const reply = () => {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end('{}');
+            };
+            if (hook === 'suspend' || hook === 'terminate') {
+                work.then(reply, reply);
+            }
+            else {
+                reply();
             }
         });
         return;
     }
     res.writeHead(200, { 'Content-Type': 'application/json' });
-    res.end(JSON.stringify({ status: 'ok', path: req.url }));
+    res.end(JSON.stringify({ status: 'ok', path: req.url, session: (_b = running === null || running === void 0 ? void 0 : running.config.sessionId) !== null && _b !== void 0 ? _b : null }));
 });
 server.listen(PORT, () => {
     console.log(`agent lifecycle hook server listening on ${PORT}`);
+    // Docker / Fargate: no lifecycle hook caller, so a SESSION_ID already in the env drives startup.
+    if (process.env.SESSION_ID)
+        setImmediate(() => void start());
 });
+for (const signal of ['SIGTERM', 'SIGINT']) {
+    process.on(signal, () => {
+        void (async () => {
+            await (running === null || running === void 0 ? void 0 : running.close());
+            server.close();
+            process.exit(0);
+        })();
+    });
+}
 //# sourceMappingURL=lambda-microvm-entrypoint.js.map

package/dist/lambda-microvm-entrypoint.js.map

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