@a5c-ai/genty-runtime 5.1.1-staging.0ad6ac75ae4a

package/dist/rpc/server.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RpcServer = void 0;
+const node_readline_1 = require("node:readline");
+class RpcServer {
+    handlers = new Map();
+    running = false;
+    register(method, handler) {
+        this.handlers.set(method, handler);
+    }
+    emit(event, data) {
+        const msg = { event, data, timestamp: new Date().toISOString() };
+        process.stdout.write(JSON.stringify(msg) + '\n');
+    }
+    async start() {
+        this.running = true;
+        const rl = (0, node_readline_1.createInterface)({ input: process.stdin, terminal: false });
+        this.emit('server.ready', { methods: [...this.handlers.keys()] });
+        for await (const line of rl) {
+            if (!this.running)
+                break;
+            if (!line.trim())
+                continue;
+            let request;
+            try {
+                request = JSON.parse(line);
+            }
+            catch {
+                this.sendError('parse-error', -32700, 'Parse error');
+                continue;
+            }
+            if (!request.id || !request.method) {
+                this.sendError(request.id ?? 'unknown', -32600, 'Invalid request: missing id or method');
+                continue;
+            }
+            const handler = this.handlers.get(request.method);
+            if (!handler) {
+                this.sendError(request.id, -32601, `Method not found: ${request.method}`);
+                continue;
+            }
+            try {
+                const result = await handler(request.params ?? {});
+                this.sendResult(request.id, result);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                this.sendError(request.id, -32000, message);
+            }
+        }
+    }
+    stop() {
+        this.running = false;
+        this.emit('server.shutdown', {});
+    }
+    sendResult(id, result) {
+        const response = { id, result };
+        process.stdout.write(JSON.stringify(response) + '\n');
+    }
+    sendError(id, code, message, data) {
+        const response = { id, error: { code, message, data } };
+        process.stdout.write(JSON.stringify(response) + '\n');
+    }
+}
+exports.RpcServer = RpcServer;

package/dist/rpc/server.test.d.ts

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

package/dist/rpc/server.test.d.ts.map

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

package/dist/rpc/server.test.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const server_js_1 = require("./server.js");
+(0, vitest_1.describe)('rpc/server', () => {
+    let stdoutWrites;
+    (0, vitest_1.beforeEach)(() => {
+        stdoutWrites = [];
+        vitest_1.vi.spyOn(process.stdout, 'write').mockImplementation((chunk) => {
+            stdoutWrites.push(typeof chunk === 'string' ? chunk : chunk.toString());
+            return true;
+        });
+    });
+    (0, vitest_1.it)('registers and calls a handler', async () => {
+        const server = new server_js_1.RpcServer();
+        server.register('health', async () => ({ status: 'ok' }));
+        (0, vitest_1.expect)(server['handlers'].has('health')).toBe(true);
+    });
+    (0, vitest_1.it)('emits events as JSONL to stdout', () => {
+        const server = new server_js_1.RpcServer();
+        server.emit('test.event', { key: 'value' });
+        (0, vitest_1.expect)(stdoutWrites).toHaveLength(1);
+        const parsed = JSON.parse(stdoutWrites[0]);
+        (0, vitest_1.expect)(parsed.event).toBe('test.event');
+        (0, vitest_1.expect)(parsed.data.key).toBe('value');
+        (0, vitest_1.expect)(parsed.timestamp).toBeTruthy();
+    });
+    (0, vitest_1.it)('stop emits shutdown event', () => {
+        const server = new server_js_1.RpcServer();
+        server.stop();
+        (0, vitest_1.expect)(stdoutWrites).toHaveLength(1);
+        const parsed = JSON.parse(stdoutWrites[0]);
+        (0, vitest_1.expect)(parsed.event).toBe('server.shutdown');
+    });
+});

package/dist/rpc/types.d.ts

@@ -0,0 +1,23 @@
+export interface RpcRequest {
+    id: string;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface RpcResponse {
+    id: string;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export interface RpcEvent {
+    event: string;
+    data: unknown;
+    timestamp: string;
+}
+export type RpcMessage = RpcRequest | RpcResponse | RpcEvent;
+export declare const RPC_METHODS: readonly ["session.create", "session.send", "session.getHistory", "session.fork", "session.list", "model.switch", "model.list", "tool.call", "tool.list", "extension.list", "extension.activate", "run.create", "run.iterate", "run.status", "health"];
+export type RpcMethod = (typeof RPC_METHODS)[number];
+//# sourceMappingURL=types.d.ts.map

package/dist/rpc/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/rpc/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3D;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE7D,eAAO,MAAM,WAAW,wPAgBd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/rpc/types.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RPC_METHODS = void 0;
+exports.RPC_METHODS = [
+    'session.create',
+    'session.send',
+    'session.getHistory',
+    'session.fork',
+    'session.list',
+    'model.switch',
+    'model.list',
+    'tool.call',
+    'tool.list',
+    'extension.list',
+    'extension.activate',
+    'run.create',
+    'run.iterate',
+    'run.status',
+    'health',
+];

package/dist/session/context.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Session context persistence for cross-run knowledge sharing (GAP-SESSION-001).
+ * Stores accumulated notes and shared knowledge as a JSON file alongside the session state file.
+ */
+import type { SessionContext } from './types';
+/**
+ * Get the file path for a session's context JSON file.
+ */
+export declare function getSessionContextPath(stateDir: string, sessionId: string): string;
+/**
+ * Read session context from disk.
+ * Returns empty context if the file does not exist.
+ * Logs a warning and returns empty context if the file is corrupt.
+ */
+export declare function getSessionContext(stateDir: string, sessionId: string): Promise<SessionContext>;
+/**
+ * Update session context by merging new data with existing context.
+ * Notes are appended; sharedKnowledge keys are merged (newer values win).
+ * Uses atomic temp-file + rename pattern to prevent partial writes.
+ */
+export declare function updateSessionContext(stateDir: string, sessionId: string, updates: Partial<SessionContext>): Promise<SessionContext>;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/session/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjF;AAQD;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA4BpG;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,OAAO,CAAC,cAAc,CAAC,CAoBzB"}

package/dist/session/context.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * Session context persistence for cross-run knowledge sharing (GAP-SESSION-001).
+ * Stores accumulated notes and shared knowledge as a JSON file alongside the session state file.
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSessionContextPath = getSessionContextPath;
+exports.getSessionContext = getSessionContext;
+exports.updateSessionContext = updateSessionContext;
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+/**
+ * Get the file path for a session's context JSON file.
+ */
+function getSessionContextPath(stateDir, sessionId) {
+    return `${stateDir}/${sessionId}.context.json`;
+}
+const EMPTY_CONTEXT = {
+    notes: [],
+    sharedKnowledge: {},
+    worktree: undefined,
+};
+/**
+ * Read session context from disk.
+ * Returns empty context if the file does not exist.
+ * Logs a warning and returns empty context if the file is corrupt.
+ */
+async function getSessionContext(stateDir, sessionId) {
+    const filePath = getSessionContextPath(stateDir, sessionId);
+    let raw;
+    try {
+        raw = await node_fs_1.promises.readFile(filePath, 'utf8');
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            return { ...EMPTY_CONTEXT, sharedKnowledge: {} };
+        }
+        // Unexpected FS error — return empty rather than crash
+        return { ...EMPTY_CONTEXT, sharedKnowledge: {} };
+    }
+    try {
+        const data = JSON.parse(raw);
+        return {
+            notes: Array.isArray(data.notes) ? data.notes : [],
+            sharedKnowledge: data.sharedKnowledge && typeof data.sharedKnowledge === 'object'
+                ? data.sharedKnowledge
+                : {},
+            worktree: data.worktree && typeof data.worktree === 'object'
+                ? data.worktree
+                : undefined,
+        };
+    }
+    catch {
+        // Corrupt JSON — return empty context rather than crash
+        return { ...EMPTY_CONTEXT, sharedKnowledge: {} };
+    }
+}
+/**
+ * Update session context by merging new data with existing context.
+ * Notes are appended; sharedKnowledge keys are merged (newer values win).
+ * Uses atomic temp-file + rename pattern to prevent partial writes.
+ */
+async function updateSessionContext(stateDir, sessionId, updates) {
+    const existing = await getSessionContext(stateDir, sessionId);
+    const merged = {
+        notes: updates.notes ? [...existing.notes, ...updates.notes] : existing.notes,
+        sharedKnowledge: updates.sharedKnowledge
+            ? { ...existing.sharedKnowledge, ...updates.sharedKnowledge }
+            : existing.sharedKnowledge,
+        worktree: updates.worktree ? { ...(existing.worktree ?? {}), ...updates.worktree } : existing.worktree,
+    };
+    const filePath = getSessionContextPath(stateDir, sessionId);
+    const dir = path.dirname(filePath);
+    const tempPath = `${filePath}.tmp.${process.pid}`;
+    await node_fs_1.promises.mkdir(dir, { recursive: true });
+    await node_fs_1.promises.writeFile(tempPath, JSON.stringify(merged), 'utf8');
+    await node_fs_1.promises.rename(tempPath, filePath);
+    return merged;
+}

package/dist/session/continuityState.d.ts

@@ -0,0 +1,39 @@
+/**
+ * GAP-PERF-008: Structured Continuity State.
+ *
+ * Structured state that persists across session compaction. Captures
+ * key decisions, current phase, and working context for seamless
+ * resume after context compression.
+ */
+export interface ContinuityPhase {
+    name: string;
+    startedAt: string;
+    description: string;
+}
+export interface ContinuityDecision {
+    key: string;
+    value: string;
+    rationale?: string;
+    madeAt: string;
+    runId?: string;
+}
+export interface ContinuityWorkingContext {
+    focus: string;
+    blockers: string[];
+    nextSteps: string[];
+}
+export interface ContinuityState {
+    schemaVersion: string;
+    updatedAt: string;
+    currentPhase: ContinuityPhase | null;
+    decisions: ContinuityDecision[];
+    workingContext: ContinuityWorkingContext;
+}
+export declare const CONTINUITY_STATE_SCHEMA_VERSION = "2026.01.continuity-state-v1";
+export declare function getContinuityStatePath(stateDir: string, sessionId: string): string;
+export declare function getContinuityState(stateDir: string, sessionId: string): Promise<ContinuityState>;
+export declare function setCurrentPhase(stateDir: string, sessionId: string, phase: Omit<ContinuityPhase, "startedAt">): Promise<void>;
+export declare function upsertDecision(stateDir: string, sessionId: string, decision: Omit<ContinuityDecision, "madeAt">): Promise<void>;
+export declare function updateWorkingContext(stateDir: string, sessionId: string, updates: Partial<ContinuityWorkingContext>): Promise<void>;
+export declare function buildContinuityResumePrompt(stateDir: string, sessionId: string): Promise<string>;
+//# sourceMappingURL=continuityState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"continuityState.d.ts","sourceRoot":"","sources":["../../src/session/continuityState.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,cAAc,EAAE,wBAAwB,CAAC;CAC1C;AAMD,eAAO,MAAM,+BAA+B,gCAAgC,CAAC;AAiD7E,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAElF;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAEtG;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,CAAC,wBAAwB,CAAC,GACzC,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CA2BjB"}

package/dist/session/continuityState.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * GAP-PERF-008: Structured Continuity State.
+ *
+ * Structured state that persists across session compaction. Captures
+ * key decisions, current phase, and working context for seamless
+ * resume after context compression.
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONTINUITY_STATE_SCHEMA_VERSION = void 0;
+exports.getContinuityStatePath = getContinuityStatePath;
+exports.getContinuityState = getContinuityState;
+exports.setCurrentPhase = setCurrentPhase;
+exports.upsertDecision = upsertDecision;
+exports.updateWorkingContext = updateWorkingContext;
+exports.buildContinuityResumePrompt = buildContinuityResumePrompt;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+exports.CONTINUITY_STATE_SCHEMA_VERSION = "2026.01.continuity-state-v1";
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function emptyContinuityState() {
+    return {
+        schemaVersion: exports.CONTINUITY_STATE_SCHEMA_VERSION,
+        updatedAt: new Date().toISOString(),
+        currentPhase: null,
+        decisions: [],
+        workingContext: { focus: "", blockers: [], nextSteps: [] },
+    };
+}
+async function readRaw(filePath) {
+    let raw;
+    try {
+        raw = await fs.readFile(filePath, "utf8");
+    }
+    catch {
+        return emptyContinuityState();
+    }
+    try {
+        const data = JSON.parse(raw);
+        return {
+            schemaVersion: typeof data.schemaVersion === "string" ? data.schemaVersion : exports.CONTINUITY_STATE_SCHEMA_VERSION,
+            updatedAt: typeof data.updatedAt === "string" ? data.updatedAt : new Date().toISOString(),
+            currentPhase: data.currentPhase ?? null,
+            decisions: Array.isArray(data.decisions) ? data.decisions : [],
+            workingContext: data.workingContext ?? { focus: "", blockers: [], nextSteps: [] },
+        };
+    }
+    catch {
+        return emptyContinuityState();
+    }
+}
+async function writeRaw(filePath, data) {
+    const dir = path.dirname(filePath);
+    const tempPath = `${filePath}.tmp.${process.pid}`;
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(tempPath, JSON.stringify(data, null, 2), "utf8");
+    await fs.rename(tempPath, filePath);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+function getContinuityStatePath(stateDir, sessionId) {
+    return path.join(stateDir, `${sessionId}.continuity.json`);
+}
+async function getContinuityState(stateDir, sessionId) {
+    return readRaw(getContinuityStatePath(stateDir, sessionId));
+}
+async function setCurrentPhase(stateDir, sessionId, phase) {
+    const filePath = getContinuityStatePath(stateDir, sessionId);
+    const state = await readRaw(filePath);
+    state.currentPhase = { ...phase, startedAt: new Date().toISOString() };
+    state.updatedAt = new Date().toISOString();
+    await writeRaw(filePath, state);
+}
+async function upsertDecision(stateDir, sessionId, decision) {
+    const filePath = getContinuityStatePath(stateDir, sessionId);
+    const state = await readRaw(filePath);
+    const existing = state.decisions.findIndex((d) => d.key === decision.key);
+    const entry = { ...decision, madeAt: new Date().toISOString() };
+    if (existing >= 0) {
+        state.decisions[existing] = entry;
+    }
+    else {
+        state.decisions.push(entry);
+    }
+    state.updatedAt = new Date().toISOString();
+    await writeRaw(filePath, state);
+}
+async function updateWorkingContext(stateDir, sessionId, updates) {
+    const filePath = getContinuityStatePath(stateDir, sessionId);
+    const state = await readRaw(filePath);
+    if (updates.focus !== undefined)
+        state.workingContext.focus = updates.focus;
+    if (updates.blockers !== undefined)
+        state.workingContext.blockers = updates.blockers;
+    if (updates.nextSteps !== undefined)
+        state.workingContext.nextSteps = updates.nextSteps;
+    state.updatedAt = new Date().toISOString();
+    await writeRaw(filePath, state);
+}
+async function buildContinuityResumePrompt(stateDir, sessionId) {
+    const state = await getContinuityState(stateDir, sessionId);
+    const sections = [];
+    if (state.currentPhase) {
+        sections.push(`## Current Phase: ${state.currentPhase.name}\n${state.currentPhase.description}`);
+    }
+    if (state.decisions.length > 0) {
+        const items = state.decisions.map((d) => {
+            const rationale = d.rationale ? ` (${d.rationale})` : "";
+            return `- **${d.key}**: ${d.value}${rationale}`;
+        });
+        sections.push(`## Key Decisions\n${items.join("\n")}`);
+    }
+    const wc = state.workingContext;
+    if (wc.focus || wc.blockers.length > 0 || wc.nextSteps.length > 0) {
+        const parts = [];
+        if (wc.focus)
+            parts.push(`**Focus**: ${wc.focus}`);
+        if (wc.blockers.length > 0)
+            parts.push(`**Blockers**: ${wc.blockers.join(", ")}`);
+        if (wc.nextSteps.length > 0)
+            parts.push(`**Next Steps**: ${wc.nextSteps.join(", ")}`);
+        sections.push(`## Working Context\n${parts.join("\n")}`);
+    }
+    return sections.length > 0 ? sections.join("\n\n") : "";
+}

package/dist/session/cost.d.ts

@@ -0,0 +1,63 @@
+/**
+ * GAP-SESSION-004: Session-Level Cost Tracking and Budgets.
+ *
+ * Aggregates cost data from runs within a session. Supports configurable
+ * budgets with threshold alerts and auto-pause.
+ * Uses the same atomic temp-file + rename pattern as context.ts.
+ */
+export interface SessionBudget {
+    /** Maximum cost in USD. 0 = unlimited. */
+    maxCostUsd: number;
+    /** Alert threshold percentages (default: [50, 80, 100]). */
+    alertThresholds: number[];
+    /** Whether to auto-pause orchestration when budget exceeded. */
+    autoPause: boolean;
+}
+export interface SessionCostState {
+    totalCostUsd: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    runCosts: Array<{
+        runId: string;
+        costUsd: number;
+        inputTokens: number;
+        outputTokens: number;
+    }>;
+    budget?: SessionBudget;
+    triggeredThresholds: number[];
+    paused: boolean;
+    lastUpdatedAt: string;
+}
+export interface SessionBudgetAlert {
+    thresholdPct: number;
+    currentCostUsd: number;
+    budgetUsd: number;
+    currentPct: number;
+    message: string;
+}
+export interface BudgetCheckResult {
+    exceeded: boolean;
+    alerts: SessionBudgetAlert[];
+    shouldPause: boolean;
+}
+export interface RunCostUpdate {
+    runId: string;
+    costUsd: number;
+    inputTokens: number;
+    outputTokens: number;
+}
+export declare function getSessionCostPath(stateDir: string, sessionId: string): string;
+export declare function getSessionCost(stateDir: string, sessionId: string): Promise<SessionCostState>;
+export declare function updateSessionCost(stateDir: string, sessionId: string, update: RunCostUpdate): Promise<SessionCostState>;
+export declare function setSessionBudget(stateDir: string, sessionId: string, budget: SessionBudget): Promise<SessionCostState>;
+/**
+ * Pure function: evaluate budget thresholds against current cost.
+ * Returns new alerts (excluding already-triggered thresholds).
+ */
+export declare function checkBudget(costState: SessionCostState): BudgetCheckResult;
+/**
+ * Persist triggered thresholds back to cost state after checkBudget produces alerts.
+ * Call this after processing alerts to prevent re-triggering.
+ */
+export declare function markThresholdsTriggered(stateDir: string, sessionId: string, thresholds: number[]): Promise<void>;
+//# sourceMappingURL=cost.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cost.d.ts","sourceRoot":"","sources":["../../src/session/cost.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gEAAgE;IAChE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/F,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAwDD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEnG;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAiC3B;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAO3B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,gBAAgB,GAAG,iBAAiB,CA2B1E;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC,CASf"}