@a5c-ai/genty-platform 5.1.1-staging.00ceebd28cf2

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,8 @@
+/**
+ * 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";
+export { CrossRunMailbox, type CrossRunMessage, type CrossRunMessageType, } from './crossRunComm';
+//# 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;AAGvC,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,gBAAgB,CAAC"}

package/dist/session/index.js

@@ -0,0 +1,73 @@
+"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.CrossRunMailbox = 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; } });
+// Cross-run communication (GAP-AGENT-005)
+var crossRunComm_1 = require("./crossRunComm");
+Object.defineProperty(exports, "CrossRunMailbox", { enumerable: true, get: function () { return crossRunComm_1.CrossRunMailbox; } });

package/dist/session/memoryConsolidation.d.ts

@@ -0,0 +1,31 @@
+/**
+ * GAP-STATE-002: Memory Consolidation.
+ *
+ * Deduplicates, merges, and prunes long-term memory entries to keep
+ * the memory store within size limits while preserving high-value entries.
+ */
+import type { MemoryEntry } from './memoryExtraction';
+export interface ConsolidationResult {
+    /** Entries that survived consolidation (merged + unique). */
+    merged: MemoryEntry[];
+    /** Entries that were dropped during pruning. */
+    dropped: MemoryEntry[];
+    /** Number of duplicate pairs that were merged. */
+    conflictsResolved: number;
+}
+/**
+ * Consolidate memory entries: deduplicate similar entries, merge overlapping
+ * content, and prune to fit within maxEntries.
+ */
+export declare function consolidateMemories(entries: MemoryEntry[], maxEntries?: number): ConsolidationResult;
+/**
+ * Detect pairs of entries with similar content using Jaccard similarity
+ * on word sets.
+ */
+export declare function detectDuplicates(entries: MemoryEntry[]): Array<[MemoryEntry, MemoryEntry]>;
+/**
+ * Merge two similar memory entries into one.
+ * Keeps the longer content and higher confidence.
+ */
+export declare function mergeEntries(a: MemoryEntry, b: MemoryEntry): MemoryEntry;
+//# sourceMappingURL=memoryConsolidation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memoryConsolidation.d.ts","sourceRoot":"","sources":["../../src/session/memoryConsolidation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAoB,MAAM,oBAAoB,CAAC;AAMxE,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,gDAAgD;IAChD,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,kDAAkD;IAClD,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAaD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EAAE,EACtB,UAAU,GAAE,MAA4B,GACvC,mBAAmB,CA6CrB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAa1F;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,WAAW,CAaxE"}

package/dist/session/memoryConsolidation.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * GAP-STATE-002: Memory Consolidation.
+ *
+ * Deduplicates, merges, and prunes long-term memory entries to keep
+ * the memory store within size limits while preserving high-value entries.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.consolidateMemories = consolidateMemories;
+exports.detectDuplicates = detectDuplicates;
+exports.mergeEntries = mergeEntries;
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_MAX_ENTRIES = 200;
+const SIMILARITY_THRESHOLD = 0.4;
+// ---------------------------------------------------------------------------
+// Functions
+// ---------------------------------------------------------------------------
+/**
+ * Consolidate memory entries: deduplicate similar entries, merge overlapping
+ * content, and prune to fit within maxEntries.
+ */
+function consolidateMemories(entries, maxEntries = DEFAULT_MAX_ENTRIES) {
+    if (entries.length === 0) {
+        return { merged: [], dropped: [], conflictsResolved: 0 };
+    }
+    // Step 1: detect and merge duplicates
+    const duplicatePairs = detectDuplicates(entries);
+    let conflictsResolved = 0;
+    const consumed = new Set();
+    const consolidated = [];
+    for (const entry of entries) {
+        if (consumed.has(entry.id))
+            continue;
+        // Find if this entry is part of a duplicate pair
+        const partner = duplicatePairs.find(([a, b]) => (a.id === entry.id || b.id === entry.id) && !consumed.has(a.id) && !consumed.has(b.id));
+        if (partner) {
+            const [a, b] = partner;
+            const merged = mergeEntries(a, b);
+            consolidated.push(merged);
+            consumed.add(a.id);
+            consumed.add(b.id);
+            conflictsResolved++;
+        }
+        else {
+            consolidated.push(entry);
+            consumed.add(entry.id);
+        }
+    }
+    // Step 2: sort by confidence (high > medium > low) then by recency
+    const ranked = consolidated.sort((a, b) => {
+        const confOrder = confidenceRank(b.confidence) - confidenceRank(a.confidence);
+        if (confOrder !== 0)
+            return confOrder;
+        return (b.extractedAt ?? '').localeCompare(a.extractedAt ?? '');
+    });
+    // Step 3: prune to max entries
+    const merged = ranked.slice(0, maxEntries);
+    const dropped = ranked.slice(maxEntries);
+    return { merged, dropped, conflictsResolved };
+}
+/**
+ * Detect pairs of entries with similar content using Jaccard similarity
+ * on word sets.
+ */
+function detectDuplicates(entries) {
+    const pairs = [];
+    for (let i = 0; i < entries.length; i++) {
+        for (let j = i + 1; j < entries.length; j++) {
+            const sim = jaccardSimilarity(entries[i].content, entries[j].content);
+            if (sim >= SIMILARITY_THRESHOLD) {
+                pairs.push([entries[i], entries[j]]);
+            }
+        }
+    }
+    return pairs;
+}
+/**
+ * Merge two similar memory entries into one.
+ * Keeps the longer content and higher confidence.
+ */
+function mergeEntries(a, b) {
+    const keepBase = a.content.length >= b.content.length ? a : b;
+    const other = keepBase === a ? b : a;
+    return {
+        ...keepBase,
+        confidence: higherConfidence(a.confidence, b.confidence),
+        tags: [...new Set([...a.tags, ...b.tags])],
+        extractedAt: a.extractedAt > b.extractedAt ? a.extractedAt : b.extractedAt,
+        lastAccessedAt: laterOf(a.lastAccessedAt, b.lastAccessedAt),
+        sourceRunId: keepBase.sourceRunId ?? other.sourceRunId,
+        sourceSessionId: keepBase.sourceSessionId ?? other.sourceSessionId,
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function tokenize(text) {
+    return new Set(text
+        .toLowerCase()
+        .split(/\W+/)
+        .filter((w) => w.length > 1));
+}
+function jaccardSimilarity(a, b) {
+    const setA = tokenize(a);
+    const setB = tokenize(b);
+    if (setA.size === 0 && setB.size === 0)
+        return 1;
+    let intersection = 0;
+    for (const word of setA) {
+        if (setB.has(word))
+            intersection++;
+    }
+    const union = setA.size + setB.size - intersection;
+    return union === 0 ? 0 : intersection / union;
+}
+const CONFIDENCE_ORDER = {
+    high: 3,
+    medium: 2,
+    low: 1,
+};
+function confidenceRank(c) {
+    return CONFIDENCE_ORDER[c] ?? 0;
+}
+function higherConfidence(a, b) {
+    return confidenceRank(a) >= confidenceRank(b) ? a : b;
+}
+function laterOf(a, b) {
+    if (!a)
+        return b;
+    if (!b)
+        return a;
+    return a > b ? a : b;
+}

package/dist/session/memoryExtraction.d.ts

@@ -0,0 +1,65 @@
+/**
+ * GAP-STATE-001: Long-Term Memory Extraction.
+ *
+ * Extract and persist important facts, decisions, and patterns from
+ * session history into a long-term memory store for cross-session recall.
+ */
+export type MemoryCategory = "fact" | "decision" | "pattern" | "preference" | "architecture" | "other";
+export type MemoryConfidence = "high" | "medium" | "low";
+export interface MemoryEntry {
+    id: string;
+    content: string;
+    category: MemoryCategory;
+    confidence: MemoryConfidence;
+    sourceRunId?: string;
+    sourceSessionId?: string;
+    tags: string[];
+    extractedAt: string;
+    lastAccessedAt?: string;
+}
+export interface LongTermMemoryStore {
+    schemaVersion: string;
+    entries: MemoryEntry[];
+    updatedAt: string;
+}
+export interface MemoryExtractionInput {
+    decisions: Array<{
+        summary: string;
+        rationale?: string;
+        timestamp: string;
+        runId?: string;
+    }>;
+    findings: Array<{
+        content: string;
+        category: string;
+        timestamp: string;
+        runId?: string;
+    }>;
+}
+export declare const LONG_TERM_MEMORY_SCHEMA_VERSION = "2026.01.long-term-memory-v1";
+/**
+ * Extract memory entries from session data. Pure function, no I/O.
+ * Deduplicates by content string.
+ */
+export declare function extractMemoriesFromSession(input: MemoryExtractionInput): MemoryEntry[];
+/**
+ * Read the long-term memory store. Returns empty store on ENOENT or corrupt JSON.
+ */
+export declare function readLongTermMemory(globalStateDir: string): Promise<LongTermMemoryStore>;
+/**
+ * Merge new entries into existing store. Deduplicates by id. Trims to maxEntries.
+ */
+export declare function persistMemories(globalStateDir: string, newEntries: MemoryEntry[], maxEntries?: number): Promise<void>;
+/**
+ * Query memories with optional filters.
+ */
+export declare function queryMemories(globalStateDir: string, options?: {
+    category?: string;
+    tags?: string[];
+    limit?: number;
+}): Promise<MemoryEntry[]>;
+/**
+ * Prune memories beyond keepCount. Returns number pruned.
+ */
+export declare function pruneMemories(globalStateDir: string, keepCount?: number): Promise<number>;
+//# sourceMappingURL=memoryExtraction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memoryExtraction.d.ts","sourceRoot":"","sources":["../../src/session/memoryExtraction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,cAAc,GAAG,OAAO,CAAC;AACvG,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7F,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3F;AAMD,eAAO,MAAM,+BAA+B,gCAAgC,CAAC;AA4B7E;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,qBAAqB,GAAG,WAAW,EAAE,CAoCtF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAkB7F;AAWD;;GAEG;AACH,wBAAsB,eAAe,CACnC,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,WAAW,EAAE,EACzB,UAAU,GAAE,MAA4B,GACvC,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D,OAAO,CAAC,WAAW,EAAE,CAAC,CAuBxB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,cAAc,EAAE,MAAM,EACtB,SAAS,GAAE,MAA4B,GACtC,OAAO,CAAC,MAAM,CAAC,CAYjB"}