@a5c-ai/agent-platform 5.0.1-staging.b436b3b3e611

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,7 @@
+/**
+ * Re-export shim — canonical implementation lives in @a5c-ai/agent-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/agent-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/agent-runtime.
+ * Internal agent-platform consumers continue to import via relative paths
+ * through this barrel file.
+ */
+var session_1 = require("@a5c-ai/agent-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; } });

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

package/dist/session/memoryExtraction.js

@@ -0,0 +1,201 @@
+"use strict";
+/**
+ * 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.
+ */
+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.LONG_TERM_MEMORY_SCHEMA_VERSION = void 0;
+exports.extractMemoriesFromSession = extractMemoriesFromSession;
+exports.readLongTermMemory = readLongTermMemory;
+exports.persistMemories = persistMemories;
+exports.queryMemories = queryMemories;
+exports.pruneMemories = pruneMemories;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+exports.LONG_TERM_MEMORY_SCHEMA_VERSION = "2026.01.long-term-memory-v1";
+const DEFAULT_MAX_ENTRIES = 500;
+const MEMORY_FILENAME = "long-term-memory.json";
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function emptyStore() {
+    return {
+        schemaVersion: exports.LONG_TERM_MEMORY_SCHEMA_VERSION,
+        entries: [],
+        updatedAt: new Date().toISOString(),
+    };
+}
+function generateMemoryId() {
+    return `mem-${crypto.randomUUID()}`;
+}
+function getStorePath(globalStateDir) {
+    return path.join(globalStateDir, MEMORY_FILENAME);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Extract memory entries from session data. Pure function, no I/O.
+ * Deduplicates by content string.
+ */
+function extractMemoriesFromSession(input) {
+    const seen = new Set();
+    const entries = [];
+    const now = new Date().toISOString();
+    for (const decision of input.decisions) {
+        if (seen.has(decision.summary))
+            continue;
+        seen.add(decision.summary);
+        entries.push({
+            id: generateMemoryId(),
+            content: decision.summary,
+            category: "decision",
+            confidence: "high",
+            sourceRunId: decision.runId,
+            tags: [],
+            extractedAt: now,
+        });
+    }
+    for (const finding of input.findings) {
+        if (seen.has(finding.content))
+            continue;
+        seen.add(finding.content);
+        const category = ["fact", "decision", "pattern", "preference", "architecture", "other"]
+            .find((c) => c === finding.category) ?? "other";
+        entries.push({
+            id: generateMemoryId(),
+            content: finding.content,
+            category,
+            confidence: "medium",
+            sourceRunId: finding.runId,
+            tags: [],
+            extractedAt: now,
+        });
+    }
+    return entries;
+}
+/**
+ * Read the long-term memory store. Returns empty store on ENOENT or corrupt JSON.
+ */
+async function readLongTermMemory(globalStateDir) {
+    const filePath = getStorePath(globalStateDir);
+    let raw;
+    try {
+        raw = await fs.readFile(filePath, "utf8");
+    }
+    catch {
+        return emptyStore();
+    }
+    try {
+        const data = JSON.parse(raw);
+        return {
+            schemaVersion: typeof data.schemaVersion === "string" ? data.schemaVersion : exports.LONG_TERM_MEMORY_SCHEMA_VERSION,
+            entries: Array.isArray(data.entries) ? data.entries : [],
+            updatedAt: typeof data.updatedAt === "string" ? data.updatedAt : new Date().toISOString(),
+        };
+    }
+    catch {
+        return emptyStore();
+    }
+}
+async function writeStore(globalStateDir, store) {
+    const filePath = getStorePath(globalStateDir);
+    const dir = path.dirname(filePath);
+    const tempPath = `${filePath}.tmp.${process.pid}`;
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(tempPath, JSON.stringify(store, null, 2), "utf8");
+    await fs.rename(tempPath, filePath);
+}
+/**
+ * Merge new entries into existing store. Deduplicates by id. Trims to maxEntries.
+ */
+async function persistMemories(globalStateDir, newEntries, maxEntries = DEFAULT_MAX_ENTRIES) {
+    const store = await readLongTermMemory(globalStateDir);
+    const existingIds = new Set(store.entries.map((e) => e.id));
+    for (const entry of newEntries) {
+        if (!existingIds.has(entry.id)) {
+            store.entries.push(entry);
+            existingIds.add(entry.id);
+        }
+    }
+    // Sort by extractedAt descending (newest first), trim to maxEntries
+    store.entries.sort((a, b) => b.extractedAt.localeCompare(a.extractedAt));
+    if (store.entries.length > maxEntries) {
+        store.entries = store.entries.slice(0, maxEntries);
+    }
+    store.updatedAt = new Date().toISOString();
+    await writeStore(globalStateDir, store);
+}
+/**
+ * Query memories with optional filters.
+ */
+async function queryMemories(globalStateDir, options) {
+    const store = await readLongTermMemory(globalStateDir);
+    let results = store.entries;
+    if (options?.category) {
+        results = results.filter((e) => e.category === options.category);
+    }
+    if (options?.tags && options.tags.length > 0) {
+        const filterTags = options.tags;
+        results = results.filter((e) => filterTags.some((t) => e.tags.includes(t)));
+    }
+    // Sort by extractedAt descending (newest first)
+    results.sort((a, b) => b.extractedAt.localeCompare(a.extractedAt));
+    if (options?.limit) {
+        results = results.slice(0, options.limit);
+    }
+    return results;
+}
+/**
+ * Prune memories beyond keepCount. Returns number pruned.
+ */
+async function pruneMemories(globalStateDir, keepCount = DEFAULT_MAX_ENTRIES) {
+    const store = await readLongTermMemory(globalStateDir);
+    if (store.entries.length <= keepCount)
+        return 0;
+    // Sort by extractedAt descending, keep newest
+    store.entries.sort((a, b) => b.extractedAt.localeCompare(a.extractedAt));
+    const pruned = store.entries.length - keepCount;
+    store.entries = store.entries.slice(0, keepCount);
+    store.updatedAt = new Date().toISOString();
+    await writeStore(globalStateDir, store);
+    return pruned;
+}

package/dist/session/parse.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Session state file parsing utilities.
+ * Parses markdown files with YAML frontmatter for session state.
+ */
+import type { SessionState, SessionFile } from './types';
+/**
+ * Default session state values.
+ */
+export declare const DEFAULT_SESSION_STATE: SessionState;
+/**
+ * Parse YAML frontmatter from a string.
+ * Expects format:
+ * ```
+ * ---
+ * key: value
+ * ---
+ * content
+ * ```
+ */
+export declare function parseYamlFrontmatter(content: string): {
+    frontmatter: Record<string, string>;
+    body: string;
+};
+/**
+ * Parse session state from YAML frontmatter values.
+ */
+export declare function parseSessionState(frontmatter: Record<string, string>): SessionState;
+/**
+ * Read and parse a session state file.
+ */
+export declare function readSessionFile(filePath: string): Promise<SessionFile>;
+/**
+ * Check if a session state file exists.
+ */
+export declare function sessionFileExists(filePath: string): Promise<boolean>;
+/**
+ * Validate session state values.
+ * Throws SessionError if validation fails.
+ */
+export declare function validateSessionState(state: SessionState): void;
+/**
+ * Get the state file path for a session.
+ */
+export declare function getSessionFilePath(stateDir: string, sessionId: string): string;
+//# sourceMappingURL=parse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/session/parse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGzD;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,YASnC,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAuC3G;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CA0CnF;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA4B5E;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO1E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAgB9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9E"}