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

package/dist/session/cost.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 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;
+    pauseReason?: string;
+}
+export interface RunCostUpdate {
+    runId: string;
+    costUsd: number;
+    inputTokens: number;
+    outputTokens: number;
+}
+export interface SessionBudgetEnforcementResult {
+    costState: SessionCostState;
+    budget: BudgetCheckResult;
+    paused: boolean;
+    pauseReason?: string;
+}
+export declare function setSessionPaused(stateDir: string, sessionId: string, paused: boolean): Promise<SessionCostState>;
+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>;
+export declare function enforceSessionBudgetForRun(stateDir: string, sessionId: string, update: RunCostUpdate): Promise<SessionBudgetEnforcementResult>;
+//# 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;IACrB,WAAW,CAAC,EAAE,MAAM,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;AAED,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAoDD,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,gBAAgB,CAAC,CAO3B;AAMD,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,CA8B1E;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,8BAA8B,CAAC,CAkBzC"}

package/dist/session/cost.js

@@ -0,0 +1,221 @@
+"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.setSessionPaused = setSessionPaused;
+exports.getSessionCostPath = getSessionCostPath;
+exports.getSessionCost = getSessionCost;
+exports.updateSessionCost = updateSessionCost;
+exports.setSessionBudget = setSessionBudget;
+exports.checkBudget = checkBudget;
+exports.markThresholdsTriggered = markThresholdsTriggered;
+exports.enforceSessionBudgetForRun = enforceSessionBudgetForRun;
+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);
+}
+async function setSessionPaused(stateDir, sessionId, paused) {
+    const filePath = getSessionCostPath(stateDir, sessionId);
+    const data = await readRaw(filePath);
+    data.paused = paused;
+    data.lastUpdatedAt = new Date().toISOString();
+    await writeRaw(filePath, data);
+    return data;
+}
+// ---------------------------------------------------------------------------
+// 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,
+        pauseReason: exceeded && autoPause
+            ? `Session cost budget exceeded: $${costState.totalCostUsd.toFixed(4)} / $${maxCostUsd.toFixed(2)}`
+            : undefined,
+    };
+}
+/**
+ * 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);
+}
+async function enforceSessionBudgetForRun(stateDir, sessionId, update) {
+    const updated = await updateSessionCost(stateDir, sessionId, update);
+    const budget = checkBudget(updated);
+    await markThresholdsTriggered(stateDir, sessionId, budget.alerts.map((alert) => alert.thresholdPct));
+    const costState = budget.shouldPause
+        ? await setSessionPaused(stateDir, sessionId, true)
+        : await getSessionCost(stateDir, sessionId);
+    return {
+        costState,
+        budget,
+        paused: budget.shouldPause,
+        pauseReason: budget.pauseReason,
+    };
+}

package/dist/session/discovery.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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 (markers + env vars).
+ *
+ * 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
+ *   3. PID-scoped marker for the given harness (fallback only)
+ *
+ * External harness session discovery is delegated to adapters.
+ */
+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":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAGrD,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO5E"}

package/dist/session/discovery.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HARNESS_ENV_VARS = void 0;
+exports.resolveAmbientSessionId = resolveAmbientSessionId;
+const babysitter_sdk_1 = require("@a5c-ai/babysitter-sdk");
+/**
+ * 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 (markers + env vars).
+ *
+ * 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
+ *   3. PID-scoped marker for the given harness (fallback only)
+ *
+ * External harness session discovery is delegated to adapters.
+ */
+function resolveAmbientSessionId(harness) {
+    if (!harness) {
+        return process.env.AGENT_SESSION_ID;
+    }
+    const envVars = exports.HARNESS_ENV_VARS[harness] || [];
+    return (0, babysitter_sdk_1.resolveSessionIdWithMarker)(harness, {}, envVars);
+}

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,CAczB"}

package/dist/session/history.js

@@ -0,0 +1,144 @@
+"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,
+        worktree: context.worktree,
+        decisions: rawHistory.decisions,
+        runSummaries: rawHistory.runSummaries,
+        contextSnapshots: rawHistory.contextSnapshots,
+    };
+}

package/dist/session/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Re-export shim — canonical implementation lives in @a5c-ai/genty-runtime.
+ * Internal agent-platform consumers continue to import via relative paths
+ * through this barrel file.
+ */
+export { type SessionState, type SessionFile, type SessionContext, type SessionDecision, type SessionRunSummary, type SessionContextSnapshot, type SessionHistory, type SessionInitOptions, type SessionAssociateOptions, type SessionResumeOptions, type SessionStateOptions, type SessionUpdateOptions, type SessionInitResult, type SessionAssociateResult, type SessionResumeResult, type SessionStateResult, type SessionUpdateResult, SessionError, SessionErrorCode, DEFAULT_SESSION_STATE, parseYamlFrontmatter, parseSessionState, readSessionFile, sessionFileExists, validateSessionState, getSessionFilePath, serializeSessionState, createSessionFileContent, writeSessionFile, updateSessionState, getCurrentTimestamp, isoToEpochSeconds, updateIterationTimes, addRunToSession, getSessionRuns, getSessionContextPath, getSessionContext, updateSessionContext, HARNESS_ENV_VARS, resolveAmbientSessionId, getSessionHistoryPath, addDecision, addRunSummary, saveContextSnapshot, getSessionHistory, type SessionFinding, type SessionFileModification, type SessionBreakpointPattern, type SessionPersistentState, SESSION_PERSISTENT_SCHEMA_VERSION, getSessionPersistentStatePath, getSessionPersistentState, addFinding, setPreference, recordFileModification, recordBreakpointInteraction, buildResumeContext, type ContinuityPhase, type ContinuityDecision, type ContinuityWorkingContext, type ContinuityState, CONTINUITY_STATE_SCHEMA_VERSION, getContinuityStatePath, getContinuityState, setCurrentPhase, upsertDecision, updateWorkingContext, buildContinuityResumePrompt, type MemoryCategory, type MemoryConfidence, type MemoryEntry, type LongTermMemoryStore, type MemoryExtractionInput, LONG_TERM_MEMORY_SCHEMA_VERSION, extractMemoriesFromSession, readLongTermMemory, persistMemories, queryMemories, pruneMemories, type SessionBudget, type SessionCostState, type SessionBudgetAlert, type BudgetCheckResult, type RunCostUpdate, getSessionCostPath, getSessionCost, updateSessionCost, setSessionBudget, checkBudget, markThresholdsTriggered, } from "@a5c-ai/genty-runtime/session";
+//# 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;;;;GAIG;AACH,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,YAAY,EACZ,gBAAgB,EAGhB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAGlB,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,cAAc,EAGd,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EAGpB,gBAAgB,EAChB,uBAAuB,EAGvB,qBAAqB,EACrB,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EAGjB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,iCAAiC,EACjC,6BAA6B,EAC7B,yBAAyB,EACzB,UAAU,EACV,aAAa,EACb,sBAAsB,EACtB,2BAA2B,EAC3B,kBAAkB,EAGlB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,+BAA+B,EAC/B,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,2BAA2B,EAG3B,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,+BAA+B,EAC/B,0BAA0B,EAC1B,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,aAAa,EAGb,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,uBAAuB,GACxB,MAAM,+BAA+B,CAAC"}

package/dist/session/index.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSessionCostPath = exports.pruneMemories = exports.queryMemories = exports.persistMemories = exports.readLongTermMemory = exports.extractMemoriesFromSession = exports.LONG_TERM_MEMORY_SCHEMA_VERSION = exports.buildContinuityResumePrompt = exports.updateWorkingContext = exports.upsertDecision = exports.setCurrentPhase = exports.getContinuityState = exports.getContinuityStatePath = exports.CONTINUITY_STATE_SCHEMA_VERSION = exports.buildResumeContext = exports.recordBreakpointInteraction = exports.recordFileModification = exports.setPreference = exports.addFinding = exports.getSessionPersistentState = exports.getSessionPersistentStatePath = exports.SESSION_PERSISTENT_SCHEMA_VERSION = exports.getSessionHistory = exports.saveContextSnapshot = exports.addRunSummary = exports.addDecision = exports.getSessionHistoryPath = exports.resolveAmbientSessionId = exports.HARNESS_ENV_VARS = exports.updateSessionContext = exports.getSessionContext = exports.getSessionContextPath = exports.getSessionRuns = exports.addRunToSession = exports.updateIterationTimes = exports.isoToEpochSeconds = exports.getCurrentTimestamp = exports.updateSessionState = exports.writeSessionFile = exports.createSessionFileContent = exports.serializeSessionState = exports.getSessionFilePath = exports.validateSessionState = exports.sessionFileExists = exports.readSessionFile = exports.parseSessionState = exports.parseYamlFrontmatter = exports.DEFAULT_SESSION_STATE = exports.SessionErrorCode = exports.SessionError = void 0;
+exports.markThresholdsTriggered = exports.checkBudget = exports.setSessionBudget = exports.updateSessionCost = exports.getSessionCost = void 0;
+/**
+ * Re-export shim — canonical implementation lives in @a5c-ai/genty-runtime.
+ * Internal agent-platform consumers continue to import via relative paths
+ * through this barrel file.
+ */
+var session_1 = require("@a5c-ai/genty-runtime/session");
+Object.defineProperty(exports, "SessionError", { enumerable: true, get: function () { return session_1.SessionError; } });
+Object.defineProperty(exports, "SessionErrorCode", { enumerable: true, get: function () { return session_1.SessionErrorCode; } });
+// Parsing utilities
+Object.defineProperty(exports, "DEFAULT_SESSION_STATE", { enumerable: true, get: function () { return session_1.DEFAULT_SESSION_STATE; } });
+Object.defineProperty(exports, "parseYamlFrontmatter", { enumerable: true, get: function () { return session_1.parseYamlFrontmatter; } });
+Object.defineProperty(exports, "parseSessionState", { enumerable: true, get: function () { return session_1.parseSessionState; } });
+Object.defineProperty(exports, "readSessionFile", { enumerable: true, get: function () { return session_1.readSessionFile; } });
+Object.defineProperty(exports, "sessionFileExists", { enumerable: true, get: function () { return session_1.sessionFileExists; } });
+Object.defineProperty(exports, "validateSessionState", { enumerable: true, get: function () { return session_1.validateSessionState; } });
+Object.defineProperty(exports, "getSessionFilePath", { enumerable: true, get: function () { return session_1.getSessionFilePath; } });
+// Writing utilities
+Object.defineProperty(exports, "serializeSessionState", { enumerable: true, get: function () { return session_1.serializeSessionState; } });
+Object.defineProperty(exports, "createSessionFileContent", { enumerable: true, get: function () { return session_1.createSessionFileContent; } });
+Object.defineProperty(exports, "writeSessionFile", { enumerable: true, get: function () { return session_1.writeSessionFile; } });
+Object.defineProperty(exports, "updateSessionState", { enumerable: true, get: function () { return session_1.updateSessionState; } });
+Object.defineProperty(exports, "getCurrentTimestamp", { enumerable: true, get: function () { return session_1.getCurrentTimestamp; } });
+Object.defineProperty(exports, "isoToEpochSeconds", { enumerable: true, get: function () { return session_1.isoToEpochSeconds; } });
+Object.defineProperty(exports, "updateIterationTimes", { enumerable: true, get: function () { return session_1.updateIterationTimes; } });
+Object.defineProperty(exports, "addRunToSession", { enumerable: true, get: function () { return session_1.addRunToSession; } });
+Object.defineProperty(exports, "getSessionRuns", { enumerable: true, get: function () { return session_1.getSessionRuns; } });
+// Context persistence (GAP-SESSION-001)
+Object.defineProperty(exports, "getSessionContextPath", { enumerable: true, get: function () { return session_1.getSessionContextPath; } });
+Object.defineProperty(exports, "getSessionContext", { enumerable: true, get: function () { return session_1.getSessionContext; } });
+Object.defineProperty(exports, "updateSessionContext", { enumerable: true, get: function () { return session_1.updateSessionContext; } });
+// Discovery (autodiscovery from markers + env)
+Object.defineProperty(exports, "HARNESS_ENV_VARS", { enumerable: true, get: function () { return session_1.HARNESS_ENV_VARS; } });
+Object.defineProperty(exports, "resolveAmbientSessionId", { enumerable: true, get: function () { return session_1.resolveAmbientSessionId; } });
+// History persistence (GAP-SESSION-002)
+Object.defineProperty(exports, "getSessionHistoryPath", { enumerable: true, get: function () { return session_1.getSessionHistoryPath; } });
+Object.defineProperty(exports, "addDecision", { enumerable: true, get: function () { return session_1.addDecision; } });
+Object.defineProperty(exports, "addRunSummary", { enumerable: true, get: function () { return session_1.addRunSummary; } });
+Object.defineProperty(exports, "saveContextSnapshot", { enumerable: true, get: function () { return session_1.saveContextSnapshot; } });
+Object.defineProperty(exports, "getSessionHistory", { enumerable: true, get: function () { return session_1.getSessionHistory; } });
+Object.defineProperty(exports, "SESSION_PERSISTENT_SCHEMA_VERSION", { enumerable: true, get: function () { return session_1.SESSION_PERSISTENT_SCHEMA_VERSION; } });
+Object.defineProperty(exports, "getSessionPersistentStatePath", { enumerable: true, get: function () { return session_1.getSessionPersistentStatePath; } });
+Object.defineProperty(exports, "getSessionPersistentState", { enumerable: true, get: function () { return session_1.getSessionPersistentState; } });
+Object.defineProperty(exports, "addFinding", { enumerable: true, get: function () { return session_1.addFinding; } });
+Object.defineProperty(exports, "setPreference", { enumerable: true, get: function () { return session_1.setPreference; } });
+Object.defineProperty(exports, "recordFileModification", { enumerable: true, get: function () { return session_1.recordFileModification; } });
+Object.defineProperty(exports, "recordBreakpointInteraction", { enumerable: true, get: function () { return session_1.recordBreakpointInteraction; } });
+Object.defineProperty(exports, "buildResumeContext", { enumerable: true, get: function () { return session_1.buildResumeContext; } });
+Object.defineProperty(exports, "CONTINUITY_STATE_SCHEMA_VERSION", { enumerable: true, get: function () { return session_1.CONTINUITY_STATE_SCHEMA_VERSION; } });
+Object.defineProperty(exports, "getContinuityStatePath", { enumerable: true, get: function () { return session_1.getContinuityStatePath; } });
+Object.defineProperty(exports, "getContinuityState", { enumerable: true, get: function () { return session_1.getContinuityState; } });
+Object.defineProperty(exports, "setCurrentPhase", { enumerable: true, get: function () { return session_1.setCurrentPhase; } });
+Object.defineProperty(exports, "upsertDecision", { enumerable: true, get: function () { return session_1.upsertDecision; } });
+Object.defineProperty(exports, "updateWorkingContext", { enumerable: true, get: function () { return session_1.updateWorkingContext; } });
+Object.defineProperty(exports, "buildContinuityResumePrompt", { enumerable: true, get: function () { return session_1.buildContinuityResumePrompt; } });
+Object.defineProperty(exports, "LONG_TERM_MEMORY_SCHEMA_VERSION", { enumerable: true, get: function () { return session_1.LONG_TERM_MEMORY_SCHEMA_VERSION; } });
+Object.defineProperty(exports, "extractMemoriesFromSession", { enumerable: true, get: function () { return session_1.extractMemoriesFromSession; } });
+Object.defineProperty(exports, "readLongTermMemory", { enumerable: true, get: function () { return session_1.readLongTermMemory; } });
+Object.defineProperty(exports, "persistMemories", { enumerable: true, get: function () { return session_1.persistMemories; } });
+Object.defineProperty(exports, "queryMemories", { enumerable: true, get: function () { return session_1.queryMemories; } });
+Object.defineProperty(exports, "pruneMemories", { enumerable: true, get: function () { return session_1.pruneMemories; } });
+Object.defineProperty(exports, "getSessionCostPath", { enumerable: true, get: function () { return session_1.getSessionCostPath; } });
+Object.defineProperty(exports, "getSessionCost", { enumerable: true, get: function () { return session_1.getSessionCost; } });
+Object.defineProperty(exports, "updateSessionCost", { enumerable: true, get: function () { return session_1.updateSessionCost; } });
+Object.defineProperty(exports, "setSessionBudget", { enumerable: true, get: function () { return session_1.setSessionBudget; } });
+Object.defineProperty(exports, "checkBudget", { enumerable: true, get: function () { return session_1.checkBudget; } });
+Object.defineProperty(exports, "markThresholdsTriggered", { enumerable: true, get: function () { return session_1.markThresholdsTriggered; } });