@a5c-ai/genty-runtime 5.1.1-staging.0007199a1cb2

package/dist/session/cost.js

@@ -0,0 +1,194 @@
+"use strict";
+/**
+ * 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.
+ */
+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.getSessionCostPath = getSessionCostPath;
+exports.getSessionCost = getSessionCost;
+exports.updateSessionCost = updateSessionCost;
+exports.setSessionBudget = setSessionBudget;
+exports.checkBudget = checkBudget;
+exports.markThresholdsTriggered = markThresholdsTriggered;
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function emptyCostState() {
+    return {
+        totalCostUsd: 0,
+        totalInputTokens: 0,
+        totalOutputTokens: 0,
+        runCosts: [],
+        triggeredThresholds: [],
+        paused: false,
+        lastUpdatedAt: new Date().toISOString(),
+    };
+}
+async function readRaw(filePath) {
+    let raw;
+    try {
+        raw = await node_fs_1.promises.readFile(filePath, "utf8");
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "ENOENT")
+            return emptyCostState();
+        return emptyCostState();
+    }
+    try {
+        const data = JSON.parse(raw);
+        return {
+            totalCostUsd: typeof data.totalCostUsd === "number" ? data.totalCostUsd : 0,
+            totalInputTokens: typeof data.totalInputTokens === "number" ? data.totalInputTokens : 0,
+            totalOutputTokens: typeof data.totalOutputTokens === "number" ? data.totalOutputTokens : 0,
+            runCosts: Array.isArray(data.runCosts) ? data.runCosts : [],
+            budget: data.budget,
+            triggeredThresholds: Array.isArray(data.triggeredThresholds) ? data.triggeredThresholds : [],
+            paused: typeof data.paused === "boolean" ? data.paused : false,
+            lastUpdatedAt: typeof data.lastUpdatedAt === "string" ? data.lastUpdatedAt : new Date().toISOString(),
+        };
+    }
+    catch {
+        return emptyCostState();
+    }
+}
+async function writeRaw(filePath, data) {
+    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(data, null, 2), "utf8");
+    await node_fs_1.promises.rename(tempPath, filePath);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+function getSessionCostPath(stateDir, sessionId) {
+    return path.join(stateDir, `${sessionId}.cost.json`);
+}
+async function getSessionCost(stateDir, sessionId) {
+    return readRaw(getSessionCostPath(stateDir, sessionId));
+}
+async function updateSessionCost(stateDir, sessionId, update) {
+    const filePath = getSessionCostPath(stateDir, sessionId);
+    const data = await readRaw(filePath);
+    // Check for duplicate run cost entry and update or add
+    const existingIdx = data.runCosts.findIndex((r) => r.runId === update.runId);
+    if (existingIdx >= 0) {
+        // Update existing entry (re-aggregation): subtract old, add new
+        const old = data.runCosts[existingIdx];
+        data.totalCostUsd += update.costUsd - old.costUsd;
+        data.totalInputTokens += update.inputTokens - old.inputTokens;
+        data.totalOutputTokens += update.outputTokens - old.outputTokens;
+        data.runCosts[existingIdx] = {
+            runId: update.runId,
+            costUsd: update.costUsd,
+            inputTokens: update.inputTokens,
+            outputTokens: update.outputTokens,
+        };
+    }
+    else {
+        data.totalCostUsd += update.costUsd;
+        data.totalInputTokens += update.inputTokens;
+        data.totalOutputTokens += update.outputTokens;
+        data.runCosts.push({
+            runId: update.runId,
+            costUsd: update.costUsd,
+            inputTokens: update.inputTokens,
+            outputTokens: update.outputTokens,
+        });
+    }
+    data.lastUpdatedAt = new Date().toISOString();
+    await writeRaw(filePath, data);
+    return data;
+}
+async function setSessionBudget(stateDir, sessionId, budget) {
+    const filePath = getSessionCostPath(stateDir, sessionId);
+    const data = await readRaw(filePath);
+    data.budget = budget;
+    data.lastUpdatedAt = new Date().toISOString();
+    await writeRaw(filePath, data);
+    return data;
+}
+/**
+ * Pure function: evaluate budget thresholds against current cost.
+ * Returns new alerts (excluding already-triggered thresholds).
+ */
+function checkBudget(costState) {
+    if (!costState.budget || costState.budget.maxCostUsd <= 0) {
+        return { exceeded: false, alerts: [], shouldPause: false };
+    }
+    const { maxCostUsd, alertThresholds, autoPause } = costState.budget;
+    const currentPct = (costState.totalCostUsd / maxCostUsd) * 100;
+    const exceeded = currentPct >= 100;
+    const alerts = [];
+    for (const threshold of alertThresholds) {
+        if (currentPct >= threshold && !costState.triggeredThresholds.includes(threshold)) {
+            alerts.push({
+                thresholdPct: threshold,
+                currentCostUsd: costState.totalCostUsd,
+                budgetUsd: maxCostUsd,
+                currentPct,
+                message: `Session cost ${currentPct.toFixed(1)}% of budget ($${costState.totalCostUsd.toFixed(4)} / $${maxCostUsd.toFixed(2)})`,
+            });
+        }
+    }
+    return {
+        exceeded,
+        alerts,
+        shouldPause: exceeded && autoPause,
+    };
+}
+/**
+ * Persist triggered thresholds back to cost state after checkBudget produces alerts.
+ * Call this after processing alerts to prevent re-triggering.
+ */
+async function markThresholdsTriggered(stateDir, sessionId, thresholds) {
+    if (thresholds.length === 0)
+        return;
+    const filePath = getSessionCostPath(stateDir, sessionId);
+    const data = await readRaw(filePath);
+    const existing = new Set(data.triggeredThresholds);
+    for (const t of thresholds)
+        existing.add(t);
+    data.triggeredThresholds = [...existing];
+    data.lastUpdatedAt = new Date().toISOString();
+    await writeRaw(filePath, data);
+}

package/dist/session/discovery.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Mapping of harness identifiers to their native session environment variables.
+ *
+ * Only Pi-specific env vars are kept here. External harness session discovery
+ * is handled by adapters session management.
+ */
+export declare const HARNESS_ENV_VARS: Record<string, string[]>;
+/**
+ * Resolve the current session ID from the ambient environment.
+ *
+ * This is used for "autodiscovery" in contexts where no explicit session ID
+ * was provided (e.g. journaling low-level events).
+ *
+ * Precedence:
+ *   1. Harness-native env vars (Pi / oh-my-pi)
+ *   2. AGENT_SESSION_ID
+ *
+ * PID-scoped marker resolution is handled by the SDK session layer if
+ * the SDK is present at runtime. This local implementation covers the
+ * environment-variable path which is sufficient for genty-runtime's
+ * internal needs (cost journaling, health observation).
+ */
+export declare function resolveAmbientSessionId(harness?: string): string | undefined;
+//# sourceMappingURL=discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/session/discovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAGrD,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAc5E"}

package/dist/session/discovery.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HARNESS_ENV_VARS = void 0;
+exports.resolveAmbientSessionId = resolveAmbientSessionId;
+/**
+ * Mapping of harness identifiers to their native session environment variables.
+ *
+ * Only Pi-specific env vars are kept here. External harness session discovery
+ * is handled by adapters session management.
+ */
+exports.HARNESS_ENV_VARS = {
+    "pi": ["PI_SESSION_ID"],
+    "oh-my-pi": ["OMP_SESSION_ID"],
+};
+/**
+ * Resolve the current session ID from the ambient environment.
+ *
+ * This is used for "autodiscovery" in contexts where no explicit session ID
+ * was provided (e.g. journaling low-level events).
+ *
+ * Precedence:
+ *   1. Harness-native env vars (Pi / oh-my-pi)
+ *   2. AGENT_SESSION_ID
+ *
+ * PID-scoped marker resolution is handled by the SDK session layer if
+ * the SDK is present at runtime. This local implementation covers the
+ * environment-variable path which is sufficient for genty-runtime's
+ * internal needs (cost journaling, health observation).
+ */
+function resolveAmbientSessionId(harness) {
+    if (!harness) {
+        return process.env.AGENT_SESSION_ID;
+    }
+    // Check harness-native env vars first.
+    const envVars = exports.HARNESS_ENV_VARS[harness] || [];
+    for (const key of envVars) {
+        const value = process.env[key];
+        if (value)
+            return value;
+    }
+    // Fall back to the generic agent session ID.
+    return process.env.AGENT_SESSION_ID;
+}

package/dist/session/export.d.ts

@@ -0,0 +1,4 @@
+import type { SessionTree } from './tree.js';
+export declare function exportToHtml(tree: SessionTree, branchId?: string): string;
+export declare function exportToMarkdown(tree: SessionTree, branchId?: string): string;
+//# sourceMappingURL=export.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/session/export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAY,MAAM,WAAW,CAAC;AAGvD,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CA6BzE;AAmBD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAM7E"}

package/dist/session/export.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exportToHtml = exportToHtml;
+exports.exportToMarkdown = exportToMarkdown;
+const tree_js_1 = require("./tree.js");
+function exportToHtml(tree, branchId) {
+    const messages = (0, tree_js_1.getMessages)(tree, branchId);
+    const rows = messages.map(renderMessageHtml).join('\n');
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Genty Session Export</title>
+  <style>
+    body { font-family: -apple-system, system-ui, sans-serif; max-width: 800px; margin: 0 auto; padding: 2rem; background: #0d1117; color: #c9d1d9; }
+    .message { margin: 1rem 0; padding: 1rem; border-radius: 8px; border-left: 3px solid; }
+    .user { border-color: #58a6ff; background: #161b22; }
+    .assistant { border-color: #3fb950; background: #161b22; }
+    .system { border-color: #8b949e; background: #0d1117; }
+    .tool { border-color: #d29922; background: #161b22; }
+    .role { font-size: 0.75rem; text-transform: uppercase; letter-spacing: 0.05em; margin-bottom: 0.5rem; opacity: 0.7; }
+    .content { white-space: pre-wrap; }
+    .timestamp { font-size: 0.7rem; opacity: 0.5; margin-top: 0.5rem; }
+    pre { background: #0d1117; padding: 1rem; border-radius: 4px; overflow-x: auto; }
+    code { font-family: 'SF Mono', Menlo, monospace; }
+  </style>
+</head>
+<body>
+  <h1>Genty Session</h1>
+${rows}
+</body>
+</html>`;
+}
+function renderMessageHtml(node) {
+    const escaped = escapeHtml(node.content);
+    return `  <div class="message ${node.role}">
+    <div class="role">${node.role}${node.bookmark ? ` — 🔖 ${escapeHtml(node.bookmark)}` : ''}</div>
+    <div class="content">${escaped}</div>
+    <div class="timestamp">${node.timestamp}</div>
+  </div>`;
+}
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+function exportToMarkdown(tree, branchId) {
+    const messages = (0, tree_js_1.getMessages)(tree, branchId);
+    return messages.map(node => {
+        const header = `### ${node.role.toUpperCase()}${node.bookmark ? ` 🔖 ${node.bookmark}` : ''}`;
+        return `${header}\n\n${node.content}\n\n---\n`;
+    }).join('\n');
+}

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

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

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

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

package/dist/session/export.test.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const tree_js_1 = require("./tree.js");
+const export_js_1 = require("./export.js");
+(0, vitest_1.describe)('session/export', () => {
+    (0, vitest_1.it)('exports to HTML with messages', () => {
+        const tree = (0, tree_js_1.createSessionTree)();
+        (0, tree_js_1.addMessage)(tree, 'user', 'What is 2+2?');
+        (0, tree_js_1.addMessage)(tree, 'assistant', 'The answer is 4.');
+        const html = (0, export_js_1.exportToHtml)(tree);
+        (0, vitest_1.expect)(html).toContain('<!DOCTYPE html>');
+        (0, vitest_1.expect)(html).toContain('What is 2+2?');
+        (0, vitest_1.expect)(html).toContain('The answer is 4.');
+        (0, vitest_1.expect)(html).toContain('class="message user"');
+        (0, vitest_1.expect)(html).toContain('class="message assistant"');
+    });
+    (0, vitest_1.it)('escapes HTML in content', () => {
+        const tree = (0, tree_js_1.createSessionTree)();
+        (0, tree_js_1.addMessage)(tree, 'user', '<script>alert("xss")</script>');
+        const html = (0, export_js_1.exportToHtml)(tree);
+        (0, vitest_1.expect)(html).not.toContain('<script>');
+        (0, vitest_1.expect)(html).toContain('&lt;script&gt;');
+    });
+    (0, vitest_1.it)('includes bookmarks in HTML export', () => {
+        const tree = (0, tree_js_1.createSessionTree)();
+        const m = (0, tree_js_1.addMessage)(tree, 'user', 'Key moment');
+        (0, tree_js_1.bookmarkNode)(tree, m.id, 'important');
+        const html = (0, export_js_1.exportToHtml)(tree);
+        (0, vitest_1.expect)(html).toContain('important');
+    });
+    (0, vitest_1.it)('exports to markdown', () => {
+        const tree = (0, tree_js_1.createSessionTree)();
+        (0, tree_js_1.addMessage)(tree, 'user', 'Hello');
+        (0, tree_js_1.addMessage)(tree, 'assistant', 'World');
+        const md = (0, export_js_1.exportToMarkdown)(tree);
+        (0, vitest_1.expect)(md).toContain('### USER');
+        (0, vitest_1.expect)(md).toContain('### ASSISTANT');
+        (0, vitest_1.expect)(md).toContain('Hello');
+        (0, vitest_1.expect)(md).toContain('World');
+    });
+});

package/dist/session/history.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Session history persistence for GAP-SESSION-002.
+ *
+ * Stores accumulated decisions, run summaries, and context snapshots
+ * in a dedicated <sessionId>.history.json file alongside the session state.
+ * Uses the same atomic temp-file + rename pattern as context.ts.
+ */
+import type { SessionDecision, SessionRunSummary, SessionContextSnapshot, SessionHistory } from "./types";
+/** Get the file path for a session's history JSON file. */
+export declare function getSessionHistoryPath(stateDir: string, sessionId: string): string;
+/**
+ * Append a decision to the session's history.
+ * Automatically adds a timestamp.
+ */
+export declare function addDecision(stateDir: string, sessionId: string, decision: Omit<SessionDecision, "timestamp">): Promise<void>;
+/**
+ * Append a run summary to the session's history.
+ */
+export declare function addRunSummary(stateDir: string, sessionId: string, summary: SessionRunSummary): Promise<void>;
+/**
+ * Save a context snapshot to the session's history.
+ * Automatically adds a timestamp.
+ */
+export declare function saveContextSnapshot(stateDir: string, sessionId: string, snapshot: Omit<SessionContextSnapshot, "timestamp">): Promise<void>;
+/**
+ * Get the full session history: SessionContext fields + history arrays.
+ * Returns empty defaults when files do not exist.
+ */
+export declare function getSessionHistory(stateDir: string, sessionId: string): Promise<SessionHistory>;
+//# sourceMappingURL=history.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/session/history.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACf,MAAM,SAAS,CAAC;AAOjB,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjF;AAuDD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,IAAI,CAAC,sBAAsB,EAAE,WAAW,CAAC,GAClD,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,CAAC,CAazB"}

package/dist/session/history.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * Session history persistence for GAP-SESSION-002.
+ *
+ * Stores accumulated decisions, run summaries, and context snapshots
+ * in a dedicated <sessionId>.history.json file alongside the session state.
+ * Uses the same atomic temp-file + rename pattern as context.ts.
+ */
+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.getSessionHistoryPath = getSessionHistoryPath;
+exports.addDecision = addDecision;
+exports.addRunSummary = addRunSummary;
+exports.saveContextSnapshot = saveContextSnapshot;
+exports.getSessionHistory = getSessionHistory;
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+const context_1 = require("./context");
+// ---------------------------------------------------------------------------
+// Path helper
+// ---------------------------------------------------------------------------
+/** Get the file path for a session's history JSON file. */
+function getSessionHistoryPath(stateDir, sessionId) {
+    return path.join(stateDir, `${sessionId}.history.json`);
+}
+function emptyHistoryData() {
+    return { decisions: [], runSummaries: [], contextSnapshots: [] };
+}
+async function readRawHistory(filePath) {
+    let raw;
+    try {
+        raw = await node_fs_1.promises.readFile(filePath, "utf8");
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "ENOENT") {
+            return emptyHistoryData();
+        }
+        return emptyHistoryData();
+    }
+    try {
+        const data = JSON.parse(raw);
+        return {
+            decisions: Array.isArray(data.decisions) ? data.decisions : [],
+            runSummaries: Array.isArray(data.runSummaries) ? data.runSummaries : [],
+            contextSnapshots: Array.isArray(data.contextSnapshots) ? data.contextSnapshots : [],
+        };
+    }
+    catch {
+        return emptyHistoryData();
+    }
+}
+async function writeRawHistory(filePath, data) {
+    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(data, null, 2), "utf8");
+    await node_fs_1.promises.rename(tempPath, filePath);
+}
+function nowTimestamp() {
+    return new Date().toISOString();
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Append a decision to the session's history.
+ * Automatically adds a timestamp.
+ */
+async function addDecision(stateDir, sessionId, decision) {
+    const filePath = getSessionHistoryPath(stateDir, sessionId);
+    const data = await readRawHistory(filePath);
+    data.decisions.push({ ...decision, timestamp: nowTimestamp() });
+    await writeRawHistory(filePath, data);
+}
+/**
+ * Append a run summary to the session's history.
+ */
+async function addRunSummary(stateDir, sessionId, summary) {
+    const filePath = getSessionHistoryPath(stateDir, sessionId);
+    const data = await readRawHistory(filePath);
+    data.runSummaries.push(summary);
+    await writeRawHistory(filePath, data);
+}
+/**
+ * Save a context snapshot to the session's history.
+ * Automatically adds a timestamp.
+ */
+async function saveContextSnapshot(stateDir, sessionId, snapshot) {
+    const filePath = getSessionHistoryPath(stateDir, sessionId);
+    const data = await readRawHistory(filePath);
+    data.contextSnapshots.push({ ...snapshot, timestamp: nowTimestamp() });
+    await writeRawHistory(filePath, data);
+}
+/**
+ * Get the full session history: SessionContext fields + history arrays.
+ * Returns empty defaults when files do not exist.
+ */
+async function getSessionHistory(stateDir, sessionId) {
+    const [context, rawHistory] = await Promise.all([
+        (0, context_1.getSessionContext)(stateDir, sessionId),
+        readRawHistory(getSessionHistoryPath(stateDir, sessionId)),
+    ]);
+    return {
+        notes: context.notes,
+        sharedKnowledge: context.sharedKnowledge,
+        decisions: rawHistory.decisions,
+        runSummaries: rawHistory.runSummaries,
+        contextSnapshots: rawHistory.contextSnapshots,
+    };
+}

package/dist/session/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Session state management module.
+ * Provides utilities for managing babysitter orchestration session state.
+ */
+export type { SessionState, SessionFile, SessionContext, SessionDecision, SessionRunSummary, SessionContextSnapshot, SessionHistory, SessionInitOptions, SessionAssociateOptions, SessionResumeOptions, SessionStateOptions, SessionUpdateOptions, SessionInitResult, SessionAssociateResult, SessionResumeResult, SessionStateResult, SessionUpdateResult, } from './types';
+export { SessionError, SessionErrorCode } from './types';
+export { DEFAULT_SESSION_STATE, parseYamlFrontmatter, parseSessionState, readSessionFile, sessionFileExists, validateSessionState, getSessionFilePath, } from './parse';
+export { serializeSessionState, createSessionFileContent, writeSessionFile, updateSessionState, getCurrentTimestamp, isoToEpochSeconds, updateIterationTimes, addRunToSession, getSessionRuns, } from './write';
+export { getSessionContextPath, getSessionContext, updateSessionContext, } from './context';
+export { HARNESS_ENV_VARS, resolveAmbientSessionId, } from './discovery';
+export { getSessionHistoryPath, addDecision, addRunSummary, saveContextSnapshot, getSessionHistory, } from './history';
+export type { SessionFinding, SessionFileModification, SessionBreakpointPattern, SessionPersistentState, } from './persistence';
+export { SESSION_PERSISTENT_SCHEMA_VERSION, getSessionPersistentStatePath, getSessionPersistentState, addFinding, setPreference, recordFileModification, recordBreakpointInteraction, buildResumeContext, } from './persistence';
+export type { ContinuityPhase, ContinuityDecision, ContinuityWorkingContext, ContinuityState, } from './continuityState';
+export { CONTINUITY_STATE_SCHEMA_VERSION, getContinuityStatePath, getContinuityState, setCurrentPhase, upsertDecision, updateWorkingContext, buildContinuityResumePrompt, } from './continuityState';
+export type { MemoryCategory, MemoryConfidence, MemoryEntry, LongTermMemoryStore, MemoryExtractionInput, } from './memoryExtraction';
+export { LONG_TERM_MEMORY_SCHEMA_VERSION, extractMemoriesFromSession, readLongTermMemory, persistMemories, queryMemories, pruneMemories, } from './memoryExtraction';
+export type { SessionBudget, SessionCostState, SessionBudgetAlert, BudgetCheckResult, RunCostUpdate, } from './cost';
+export { getSessionCostPath, getSessionCost, updateSessionCost, setSessionBudget, checkBudget, markThresholdsTriggered, } from './cost';
+//# 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":"AAAA;;;GAGG;AAGH,YAAY,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGzD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,qBAAqB,EACrB,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAGnB,YAAY,EACV,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,iCAAiC,EACjC,6BAA6B,EAC7B,yBAAyB,EACzB,UAAU,EACV,aAAa,EACb,sBAAsB,EACtB,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,+BAA+B,EAC/B,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,+BAA+B,EAC/B,0BAA0B,EAC1B,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,GACd,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,uBAAuB,GACxB,MAAM,QAAQ,CAAC"}