@greppleai/grip 0.0.0-stage → 0.1.3

package/dist/core/session/context.js

@@ -0,0 +1,117 @@
+import { createBranchSummaryMessage, createCompactionSummaryMessage, createCustomMessage, normalizeMessageContent, } from "../messages.js";
+export function getLatestCompactionEntry(entries) {
+    for (let i = entries.length - 1; i >= 0; i--) {
+        if (entries[i].type === "compaction") {
+            return entries[i];
+        }
+    }
+    return null;
+}
+/** Project one persisted session entry into runtime context messages. */
+export function sessionEntryToContextMessages(entry) {
+    if (entry.type === "message") {
+        return [normalizeMessageContent(entry.message)];
+    }
+    if (entry.type === "custom_message") {
+        return [createCustomMessage(entry.customType, entry.content, entry.display, entry.details, entry.timestamp)];
+    }
+    if (entry.type === "branch_summary" && entry.summary) {
+        return [createBranchSummaryMessage(entry.summary, entry.fromId, entry.timestamp)];
+    }
+    if (entry.type === "compaction" && entry.summary) {
+        return [createCompactionSummaryMessage(entry.summary, entry.tokensBefore, entry.timestamp)];
+    }
+    return [];
+}
+function traceSessionPath(leaf, byId) {
+    const path = [];
+    let current = leaf;
+    while (current) {
+        path.unshift(current);
+        current = current.parentId ? byId.get(current.parentId) : undefined;
+    }
+    return path;
+}
+function inspectSessionPath(path) {
+    let thinkingLevel = "off";
+    let model = null;
+    for (const entry of path) {
+        switch (entry.type) {
+            case "thinking_level_change":
+                thinkingLevel = entry.thinkingLevel;
+                break;
+            case "model_change":
+                model = { provider: entry.provider, modelId: entry.modelId };
+                break;
+            case "message":
+                if (entry.message.role === "assistant") {
+                    model = { provider: entry.message.provider, modelId: entry.message.model };
+                }
+                break;
+        }
+    }
+    return { thinkingLevel, model };
+}
+function applyCompressionReplacement(visible, entry) {
+    if (entry.type !== "custom_message" || entry.customType !== "compress_context")
+        return false;
+    const details = entry.details;
+    if (!details ||
+        typeof details !== "object" ||
+        !("replacementVersion" in details) ||
+        details.replacementVersion !== 1)
+        return false;
+    const startEntryId = "startEntryId" in details ? details.startEntryId : undefined;
+    const endEntryId = "endEntryId" in details ? details.endEntryId : undefined;
+    if (typeof startEntryId !== "string" || typeof endEntryId !== "string")
+        return false;
+    const startIndex = visible.findIndex((candidate) => candidate.id === startEntryId);
+    const endIndex = visible.findIndex((candidate) => candidate.id === endEntryId);
+    if (startIndex < 0 || endIndex < startIndex)
+        return false;
+    visible.splice(startIndex, endIndex - startIndex + 1, entry);
+    return true;
+}
+/** Return entries in model-visible order, applying append-only range replacements at their declared positions. */
+export function projectSessionContextEntries(path) {
+    const compaction = getLatestCompactionEntry(path);
+    const compactionIndex = compaction ? path.findIndex((entry) => entry.id === compaction.id) : -1;
+    const firstKeptIndex = compaction
+        ? path.findIndex((entry, index) => index < compactionIndex && entry.id === compaction.firstKeptEntryId)
+        : -1;
+    const ordered = compaction
+        ? [
+            compaction,
+            ...(firstKeptIndex < 0 ? [] : path.slice(firstKeptIndex, compactionIndex)),
+            ...path.slice(compactionIndex + 1),
+        ]
+        : path;
+    const visible = [];
+    for (const entry of ordered) {
+        if (entry.type === "compaction" && entry.id !== compaction?.id)
+            continue;
+        if (applyCompressionReplacement(visible, entry))
+            continue;
+        visible.push(entry);
+    }
+    return visible;
+}
+/**
+ * Build the session context from entries using tree traversal.
+ * If leafId is provided, walks from that entry to root.
+ * Handles compaction and branch summaries along the path.
+ */
+export function buildSessionContext(entries, leafId, byId) {
+    if (leafId === null)
+        return { messages: [], thinkingLevel: "off", model: null };
+    const entriesById = byId ?? new Map(entries.map((entry) => [entry.id, entry]));
+    const requestedLeaf = leafId ? entriesById.get(leafId) : undefined;
+    const leaf = requestedLeaf ?? entries[entries.length - 1];
+    if (!leaf)
+        return { messages: [], thinkingLevel: "off", model: null };
+    const path = traceSessionPath(leaf, entriesById);
+    const { thinkingLevel, model } = inspectSessionPath(path);
+    const messages = projectSessionContextEntries(path).flatMap(sessionEntryToContextMessages);
+    return { messages, thinkingLevel, model };
+}
+//# sourceMappingURL=context.js.map

package/dist/core/session/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/core/session/context.ts"],"names":[],"mappings":"AACA,OAAO,EACN,0BAA0B,EAC1B,8BAA8B,EAC9B,mBAAmB,EACnB,uBAAuB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,MAAM,UAAU,wBAAwB,CAAC,OAAuB,EAA0B;IACzF,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACtC,OAAO,OAAO,CAAC,CAAC,CAAoB,CAAC;QACtC,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AAAA,CACZ;AAED,yEAAyE;AACzE,MAAM,UAAU,6BAA6B,CAAC,KAAmB,EAAkB;IAClF,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,CAAC,uBAAuB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACrC,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9G,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACtD,OAAO,CAAC,0BAA0B,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClD,OAAO,CAAC,8BAA8B,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,EAAE,CAAC;AAAA,CACV;AAQD,SAAS,gBAAgB,CAAC,IAAkB,EAAE,IAA+B,EAAkB;IAC9F,MAAM,IAAI,GAAmB,EAAE,CAAC;IAChC,IAAI,OAAO,GAA6B,IAAI,CAAC;IAC7C,OAAO,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACtB,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrE,CAAC;IACD,OAAO,IAAI,CAAC;AAAA,CACZ;AAED,SAAS,kBAAkB,CAAC,IAAoB,EAAoB;IACnE,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,IAAI,KAAK,GAA4B,IAAI,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;QAC1B,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,uBAAuB;gBAC3B,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;gBACpC,MAAM;YACP,KAAK,cAAc;gBAClB,KAAK,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC7D,MAAM;YACP,KAAK,SAAS;gBACb,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;oBACxC,KAAK,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBAC5E,CAAC;gBACD,MAAM;QACR,CAAC;IACF,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAAA,CAChC;AACD,SAAS,2BAA2B,CAAC,OAAuB,EAAE,KAAmB,EAAW;IAC3F,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,IAAI,KAAK,CAAC,UAAU,KAAK,kBAAkB;QAAE,OAAO,KAAK,CAAC;IAC7F,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,IACC,CAAC,OAAO;QACR,OAAO,OAAO,KAAK,QAAQ;QAC3B,CAAC,CAAC,oBAAoB,IAAI,OAAO,CAAC;QAClC,OAAO,CAAC,kBAAkB,KAAK,CAAC;QAEhC,OAAO,KAAK,CAAC;IACd,MAAM,YAAY,GAAG,cAAc,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IAClF,MAAM,UAAU,GAAG,YAAY,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,OAAO,UAAU,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACrF,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,YAAY,CAAC,CAAC;IACnF,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;IAC/E,IAAI,UAAU,GAAG,CAAC,IAAI,QAAQ,GAAG,UAAU;QAAE,OAAO,KAAK,CAAC;IAC1D,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,GAAG,UAAU,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC;AAAA,CACZ;AAED,kHAAkH;AAClH,MAAM,UAAU,4BAA4B,CAAC,IAAoB,EAAkB;IAClF,MAAM,UAAU,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,eAAe,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChG,MAAM,cAAc,GAAG,UAAU;QAChC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,eAAe,IAAI,KAAK,CAAC,EAAE,KAAK,UAAU,CAAC,gBAAgB,CAAC;QACvG,CAAC,CAAC,CAAC,CAAC,CAAC;IACN,MAAM,OAAO,GAAG,UAAU;QACzB,CAAC,CAAC;YACA,UAAU;YACV,GAAG,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;YAC1E,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,CAAC,CAAC;SAClC;QACF,CAAC,CAAC,IAAI,CAAC;IACR,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,EAAE,KAAK,UAAU,EAAE,EAAE;YAAE,SAAS;QACzE,IAAI,2BAA2B,CAAC,OAAO,EAAE,KAAK,CAAC;YAAE,SAAS;QAC1D,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC;AAAA,CACf;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAClC,OAAuB,EACvB,MAAsB,EACtB,IAAgC,EACf;IACjB,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAEhF,MAAM,WAAW,GAAG,IAAI,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/E,MAAM,aAAa,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACnE,MAAM,IAAI,GAAG,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC1D,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAEtE,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACjD,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,4BAA4B,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAC3F,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAAA,CAC1C","sourcesContent":["import type { AgentMessage } from \"@greppleai/grip-agent-core\";\nimport {\n\tcreateBranchSummaryMessage,\n\tcreateCompactionSummaryMessage,\n\tcreateCustomMessage,\n\tnormalizeMessageContent,\n} from \"../messages.ts\";\nimport type { CompactionEntry, SessionContext, SessionEntry } from \"./types.ts\";\n\nexport function getLatestCompactionEntry(entries: SessionEntry[]): CompactionEntry | null {\n\tfor (let i = entries.length - 1; i >= 0; i--) {\n\t\tif (entries[i].type === \"compaction\") {\n\t\t\treturn entries[i] as CompactionEntry;\n\t\t}\n\t}\n\treturn null;\n}\n\n/** Project one persisted session entry into runtime context messages. */\nexport function sessionEntryToContextMessages(entry: SessionEntry): AgentMessage[] {\n\tif (entry.type === \"message\") {\n\t\treturn [normalizeMessageContent(entry.message)];\n\t}\n\tif (entry.type === \"custom_message\") {\n\t\treturn [createCustomMessage(entry.customType, entry.content, entry.display, entry.details, entry.timestamp)];\n\t}\n\tif (entry.type === \"branch_summary\" && entry.summary) {\n\t\treturn [createBranchSummaryMessage(entry.summary, entry.fromId, entry.timestamp)];\n\t}\n\tif (entry.type === \"compaction\" && entry.summary) {\n\t\treturn [createCompactionSummaryMessage(entry.summary, entry.tokensBefore, entry.timestamp)];\n\t}\n\treturn [];\n}\n\n// grip-ignore noNearIdenticalDataStructures: Coding-agent persisted entries and agent harness storage entries use package-owned context pipelines that evolve independently.\ninterface SessionPathState {\n\tthinkingLevel: string;\n\tmodel: SessionContext[\"model\"];\n}\n\nfunction traceSessionPath(leaf: SessionEntry, byId: Map<string, SessionEntry>): SessionEntry[] {\n\tconst path: SessionEntry[] = [];\n\tlet current: SessionEntry | undefined = leaf;\n\twhile (current) {\n\t\tpath.unshift(current);\n\t\tcurrent = current.parentId ? byId.get(current.parentId) : undefined;\n\t}\n\treturn path;\n}\n\nfunction inspectSessionPath(path: SessionEntry[]): SessionPathState {\n\tlet thinkingLevel = \"off\";\n\tlet model: SessionContext[\"model\"] = null;\n\tfor (const entry of path) {\n\t\tswitch (entry.type) {\n\t\t\tcase \"thinking_level_change\":\n\t\t\t\tthinkingLevel = entry.thinkingLevel;\n\t\t\t\tbreak;\n\t\t\tcase \"model_change\":\n\t\t\t\tmodel = { provider: entry.provider, modelId: entry.modelId };\n\t\t\t\tbreak;\n\t\t\tcase \"message\":\n\t\t\t\tif (entry.message.role === \"assistant\") {\n\t\t\t\t\tmodel = { provider: entry.message.provider, modelId: entry.message.model };\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t}\n\t}\n\treturn { thinkingLevel, model };\n}\nfunction applyCompressionReplacement(visible: SessionEntry[], entry: SessionEntry): boolean {\n\tif (entry.type !== \"custom_message\" || entry.customType !== \"compress_context\") return false;\n\tconst details = entry.details;\n\tif (\n\t\t!details ||\n\t\ttypeof details !== \"object\" ||\n\t\t!(\"replacementVersion\" in details) ||\n\t\tdetails.replacementVersion !== 1\n\t)\n\t\treturn false;\n\tconst startEntryId = \"startEntryId\" in details ? details.startEntryId : undefined;\n\tconst endEntryId = \"endEntryId\" in details ? details.endEntryId : undefined;\n\tif (typeof startEntryId !== \"string\" || typeof endEntryId !== \"string\") return false;\n\tconst startIndex = visible.findIndex((candidate) => candidate.id === startEntryId);\n\tconst endIndex = visible.findIndex((candidate) => candidate.id === endEntryId);\n\tif (startIndex < 0 || endIndex < startIndex) return false;\n\tvisible.splice(startIndex, endIndex - startIndex + 1, entry);\n\treturn true;\n}\n\n/** Return entries in model-visible order, applying append-only range replacements at their declared positions. */\nexport function projectSessionContextEntries(path: SessionEntry[]): SessionEntry[] {\n\tconst compaction = getLatestCompactionEntry(path);\n\tconst compactionIndex = compaction ? path.findIndex((entry) => entry.id === compaction.id) : -1;\n\tconst firstKeptIndex = compaction\n\t\t? path.findIndex((entry, index) => index < compactionIndex && entry.id === compaction.firstKeptEntryId)\n\t\t: -1;\n\tconst ordered = compaction\n\t\t? [\n\t\t\t\tcompaction,\n\t\t\t\t...(firstKeptIndex < 0 ? [] : path.slice(firstKeptIndex, compactionIndex)),\n\t\t\t\t...path.slice(compactionIndex + 1),\n\t\t\t]\n\t\t: path;\n\tconst visible: SessionEntry[] = [];\n\tfor (const entry of ordered) {\n\t\tif (entry.type === \"compaction\" && entry.id !== compaction?.id) continue;\n\t\tif (applyCompressionReplacement(visible, entry)) continue;\n\t\tvisible.push(entry);\n\t}\n\treturn visible;\n}\n\n/**\n * Build the session context from entries using tree traversal.\n * If leafId is provided, walks from that entry to root.\n * Handles compaction and branch summaries along the path.\n */\nexport function buildSessionContext(\n\tentries: SessionEntry[],\n\tleafId?: string | null,\n\tbyId?: Map<string, SessionEntry>,\n): SessionContext {\n\tif (leafId === null) return { messages: [], thinkingLevel: \"off\", model: null };\n\n\tconst entriesById = byId ?? new Map(entries.map((entry) => [entry.id, entry]));\n\tconst requestedLeaf = leafId ? entriesById.get(leafId) : undefined;\n\tconst leaf = requestedLeaf ?? entries[entries.length - 1];\n\tif (!leaf) return { messages: [], thinkingLevel: \"off\", model: null };\n\n\tconst path = traceSessionPath(leaf, entriesById);\n\tconst { thinkingLevel, model } = inspectSessionPath(path);\n\tconst messages = projectSessionContextEntries(path).flatMap(sessionEntryToContextMessages);\n\treturn { messages, thinkingLevel, model };\n}\n"]}

package/dist/core/session/ids.d.ts

@@ -0,0 +1,9 @@
+interface SessionEntryIdLookup {
+    has(id: string): boolean;
+}
+export declare function validateSessionId(id: string): void;
+export declare function createSessionId(): string;
+/** Generate a unique short ID (8 hex chars, collision-checked). */
+export declare function generateId(byId: SessionEntryIdLookup): string;
+export {};
+//# sourceMappingURL=ids.d.ts.map

package/dist/core/session/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../../src/core/session/ids.ts"],"names":[],"mappings":"AAKA,UAAU,oBAAoB;IAC7B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAMlD;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAM7D","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { uuidv7 } from \"@greppleai/grip-agent-core\";\n\nconst SESSION_ID_PATTERN = /^[A-Za-z0-9](?:[A-Za-z0-9._-]*[A-Za-z0-9])?$/;\n\ninterface SessionEntryIdLookup {\n\thas(id: string): boolean;\n}\n\nexport function validateSessionId(id: string): void {\n\tif (!SESSION_ID_PATTERN.test(id)) {\n\t\tthrow new Error(\n\t\t\t\"Session id must be non-empty, contain only alphanumeric characters, '-', '_', and '.', and start and end with an alphanumeric character\",\n\t\t);\n\t}\n}\n\nexport function createSessionId(): string {\n\treturn uuidv7();\n}\n\n/** Generate a unique short ID (8 hex chars, collision-checked). */\nexport function generateId(byId: SessionEntryIdLookup): string {\n\tfor (let i = 0; i < 100; i++) {\n\t\tconst id = randomUUID().slice(0, 8);\n\t\tif (!byId.has(id)) return id;\n\t}\n\treturn randomUUID();\n}\n"]}

package/dist/core/session/ids.js

@@ -0,0 +1,21 @@
+import { randomUUID } from "node:crypto";
+import { uuidv7 } from "@greppleai/grip-agent-core";
+const SESSION_ID_PATTERN = /^[A-Za-z0-9](?:[A-Za-z0-9._-]*[A-Za-z0-9])?$/;
+export function validateSessionId(id) {
+    if (!SESSION_ID_PATTERN.test(id)) {
+        throw new Error("Session id must be non-empty, contain only alphanumeric characters, '-', '_', and '.', and start and end with an alphanumeric character");
+    }
+}
+export function createSessionId() {
+    return uuidv7();
+}
+/** Generate a unique short ID (8 hex chars, collision-checked). */
+export function generateId(byId) {
+    for (let i = 0; i < 100; i++) {
+        const id = randomUUID().slice(0, 8);
+        if (!byId.has(id))
+            return id;
+    }
+    return randomUUID();
+}
+//# sourceMappingURL=ids.js.map

package/dist/core/session/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../../src/core/session/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEpD,MAAM,kBAAkB,GAAG,8CAA8C,CAAC;AAM1E,MAAM,UAAU,iBAAiB,CAAC,EAAU,EAAQ;IACnD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACd,yIAAyI,CACzI,CAAC;IACH,CAAC;AAAA,CACD;AAED,MAAM,UAAU,eAAe,GAAW;IACzC,OAAO,MAAM,EAAE,CAAC;AAAA,CAChB;AAED,mEAAmE;AACnE,MAAM,UAAU,UAAU,CAAC,IAA0B,EAAU;IAC9D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,UAAU,EAAE,CAAC;AAAA,CACpB","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { uuidv7 } from \"@greppleai/grip-agent-core\";\n\nconst SESSION_ID_PATTERN = /^[A-Za-z0-9](?:[A-Za-z0-9._-]*[A-Za-z0-9])?$/;\n\ninterface SessionEntryIdLookup {\n\thas(id: string): boolean;\n}\n\nexport function validateSessionId(id: string): void {\n\tif (!SESSION_ID_PATTERN.test(id)) {\n\t\tthrow new Error(\n\t\t\t\"Session id must be non-empty, contain only alphanumeric characters, '-', '_', and '.', and start and end with an alphanumeric character\",\n\t\t);\n\t}\n}\n\nexport function createSessionId(): string {\n\treturn uuidv7();\n}\n\n/** Generate a unique short ID (8 hex chars, collision-checked). */\nexport function generateId(byId: SessionEntryIdLookup): string {\n\tfor (let i = 0; i < 100; i++) {\n\t\tconst id = randomUUID().slice(0, 8);\n\t\tif (!byId.has(id)) return id;\n\t}\n\treturn randomUUID();\n}\n"]}

package/dist/core/session/in-memory-session-manager.d.ts

@@ -0,0 +1,17 @@
+import { InMemorySession } from "./in-memory-session.ts";
+import type { Session } from "./session.ts";
+import type { OpenSessionOptions, SessionManager } from "./session-manager.ts";
+import type { NewSessionOptions, SessionInfo, SessionListProgress } from "./types.ts";
+export declare class InMemorySessionManager implements SessionManager {
+    private readonly cwd;
+    constructor(cwd?: string);
+    create(options?: NewSessionOptions): InMemorySession;
+    openReference(_reference: string, _options?: OpenSessionOptions): InMemorySession;
+    continueRecent(): InMemorySession;
+    forkFrom(_reference: string): InMemorySession;
+    forkSession(source: Session, targetLeafId: string | null): Session;
+    importJsonl(_inputPath: string, _options?: OpenSessionOptions): InMemorySession;
+    list(_onProgress?: SessionListProgress): Promise<SessionInfo[]>;
+    listAll(_onProgress?: SessionListProgress): Promise<SessionInfo[]>;
+}
+//# sourceMappingURL=in-memory-session-manager.d.ts.map

package/dist/core/session/in-memory-session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-session-manager.d.ts","sourceRoot":"","sources":["../../../src/core/session/in-memory-session-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtF,qBAAa,sBAAuB,YAAW,cAAc;IAC5D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAE7B,YAAY,GAAG,GAAE,MAAsB,EAEtC;IAED,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,eAAe,CAMnD;IAED,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,eAAe,CAEhF;IAED,cAAc,IAAI,eAAe,CAEhC;IAED,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAE5C;IAED,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAMjE;IAED,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,eAAe,CAE9E;IAEK,IAAI,CAAC,WAAW,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAEpE;IAEK,OAAO,CAAC,WAAW,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAEvE;CACD","sourcesContent":["import { InMemorySession } from \"./in-memory-session.ts\";\nimport type { Session } from \"./session.ts\";\nimport type { OpenSessionOptions, SessionManager } from \"./session-manager.ts\";\nimport type { NewSessionOptions, SessionInfo, SessionListProgress } from \"./types.ts\";\n\nexport class InMemorySessionManager implements SessionManager {\n\tprivate readonly cwd: string;\n\n\tconstructor(cwd: string = process.cwd()) {\n\t\tthis.cwd = cwd;\n\t}\n\n\tcreate(options?: NewSessionOptions): InMemorySession {\n\t\tconst session = new InMemorySession(this.cwd, this);\n\t\tif (options?.id || options?.parentSession) {\n\t\t\tsession.newSession(options);\n\t\t}\n\t\treturn session;\n\t}\n\n\topenReference(_reference: string, _options?: OpenSessionOptions): InMemorySession {\n\t\treturn this.create();\n\t}\n\n\tcontinueRecent(): InMemorySession {\n\t\treturn this.create();\n\t}\n\n\tforkFrom(_reference: string): InMemorySession {\n\t\treturn this.create();\n\t}\n\n\tforkSession(source: Session, targetLeafId: string | null): Session {\n\t\tconst session = this.create({ parentSession: source.getSessionReference() });\n\t\tif (targetLeafId) {\n\t\t\tsession.copyBranchFrom(source, targetLeafId, source.getSessionReference());\n\t\t}\n\t\treturn session;\n\t}\n\n\timportJsonl(_inputPath: string, _options?: OpenSessionOptions): InMemorySession {\n\t\tthrow new Error(\"Importing JSONL sessions is not supported by in-memory sessions\");\n\t}\n\n\tasync list(_onProgress?: SessionListProgress): Promise<SessionInfo[]> {\n\t\treturn [];\n\t}\n\n\tasync listAll(_onProgress?: SessionListProgress): Promise<SessionInfo[]> {\n\t\treturn [];\n\t}\n}\n"]}

package/dist/core/session/in-memory-session-manager.js

@@ -0,0 +1,40 @@
+import { InMemorySession } from "./in-memory-session.js";
+export class InMemorySessionManager {
+    cwd;
+    constructor(cwd = process.cwd()) {
+        this.cwd = cwd;
+    }
+    create(options) {
+        const session = new InMemorySession(this.cwd, this);
+        if (options?.id || options?.parentSession) {
+            session.newSession(options);
+        }
+        return session;
+    }
+    openReference(_reference, _options) {
+        return this.create();
+    }
+    continueRecent() {
+        return this.create();
+    }
+    forkFrom(_reference) {
+        return this.create();
+    }
+    forkSession(source, targetLeafId) {
+        const session = this.create({ parentSession: source.getSessionReference() });
+        if (targetLeafId) {
+            session.copyBranchFrom(source, targetLeafId, source.getSessionReference());
+        }
+        return session;
+    }
+    importJsonl(_inputPath, _options) {
+        throw new Error("Importing JSONL sessions is not supported by in-memory sessions");
+    }
+    async list(_onProgress) {
+        return [];
+    }
+    async listAll(_onProgress) {
+        return [];
+    }
+}
+//# sourceMappingURL=in-memory-session-manager.js.map

package/dist/core/session/in-memory-session-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-session-manager.js","sourceRoot":"","sources":["../../../src/core/session/in-memory-session-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAKzD,MAAM,OAAO,sBAAsB;IACjB,GAAG,CAAS;IAE7B,YAAY,GAAG,GAAW,OAAO,CAAC,GAAG,EAAE,EAAE;QACxC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IAAA,CACf;IAED,MAAM,CAAC,OAA2B,EAAmB;QACpD,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACpD,IAAI,OAAO,EAAE,EAAE,IAAI,OAAO,EAAE,aAAa,EAAE,CAAC;YAC3C,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,OAAO,CAAC;IAAA,CACf;IAED,aAAa,CAAC,UAAkB,EAAE,QAA6B,EAAmB;QACjF,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IAAA,CACrB;IAED,cAAc,GAAoB;QACjC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IAAA,CACrB;IAED,QAAQ,CAAC,UAAkB,EAAmB;QAC7C,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IAAA,CACrB;IAED,WAAW,CAAC,MAAe,EAAE,YAA2B,EAAW;QAClE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;QAC7E,IAAI,YAAY,EAAE,CAAC;YAClB,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,OAAO,CAAC;IAAA,CACf;IAED,WAAW,CAAC,UAAkB,EAAE,QAA6B,EAAmB;QAC/E,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IAAA,CACnF;IAED,KAAK,CAAC,IAAI,CAAC,WAAiC,EAA0B;QACrE,OAAO,EAAE,CAAC;IAAA,CACV;IAED,KAAK,CAAC,OAAO,CAAC,WAAiC,EAA0B;QACxE,OAAO,EAAE,CAAC;IAAA,CACV;CACD","sourcesContent":["import { InMemorySession } from \"./in-memory-session.ts\";\nimport type { Session } from \"./session.ts\";\nimport type { OpenSessionOptions, SessionManager } from \"./session-manager.ts\";\nimport type { NewSessionOptions, SessionInfo, SessionListProgress } from \"./types.ts\";\n\nexport class InMemorySessionManager implements SessionManager {\n\tprivate readonly cwd: string;\n\n\tconstructor(cwd: string = process.cwd()) {\n\t\tthis.cwd = cwd;\n\t}\n\n\tcreate(options?: NewSessionOptions): InMemorySession {\n\t\tconst session = new InMemorySession(this.cwd, this);\n\t\tif (options?.id || options?.parentSession) {\n\t\t\tsession.newSession(options);\n\t\t}\n\t\treturn session;\n\t}\n\n\topenReference(_reference: string, _options?: OpenSessionOptions): InMemorySession {\n\t\treturn this.create();\n\t}\n\n\tcontinueRecent(): InMemorySession {\n\t\treturn this.create();\n\t}\n\n\tforkFrom(_reference: string): InMemorySession {\n\t\treturn this.create();\n\t}\n\n\tforkSession(source: Session, targetLeafId: string | null): Session {\n\t\tconst session = this.create({ parentSession: source.getSessionReference() });\n\t\tif (targetLeafId) {\n\t\t\tsession.copyBranchFrom(source, targetLeafId, source.getSessionReference());\n\t\t}\n\t\treturn session;\n\t}\n\n\timportJsonl(_inputPath: string, _options?: OpenSessionOptions): InMemorySession {\n\t\tthrow new Error(\"Importing JSONL sessions is not supported by in-memory sessions\");\n\t}\n\n\tasync list(_onProgress?: SessionListProgress): Promise<SessionInfo[]> {\n\t\treturn [];\n\t}\n\n\tasync listAll(_onProgress?: SessionListProgress): Promise<SessionInfo[]> {\n\t\treturn [];\n\t}\n}\n"]}

package/dist/core/session/in-memory-session.d.ts

@@ -0,0 +1,7 @@
+import { Session } from "./session.ts";
+import type { SessionManager } from "./session-manager.ts";
+export declare class InMemorySession extends Session {
+    constructor(cwd?: string, sessionManager?: SessionManager);
+    protected prepareNewSessionReference(_sessionDir: string, sessionId: string, _timestamp: string): string | undefined;
+}
+//# sourceMappingURL=in-memory-session.d.ts.map

package/dist/core/session/in-memory-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-session.d.ts","sourceRoot":"","sources":["../../../src/core/session/in-memory-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,qBAAa,eAAgB,SAAQ,OAAO;IAC3C,YAAY,GAAG,GAAE,MAAsB,EAAE,cAAc,CAAC,EAAE,cAAc,EAEvE;IAED,SAAS,CAAC,0BAA0B,CACnC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAEpB;CACD","sourcesContent":["import { Session } from \"./session.ts\";\nimport type { SessionManager } from \"./session-manager.ts\";\nimport { InMemorySessionStore } from \"./stores/in-memory-session-store.ts\";\n\nexport class InMemorySession extends Session {\n\tconstructor(cwd: string = process.cwd(), sessionManager?: SessionManager) {\n\t\tsuper(cwd, \"\", undefined, new InMemorySessionStore(), sessionManager);\n\t}\n\n\tprotected prepareNewSessionReference(\n\t\t_sessionDir: string,\n\t\tsessionId: string,\n\t\t_timestamp: string,\n\t): string | undefined {\n\t\treturn `memory:${sessionId}`;\n\t}\n}\n"]}

package/dist/core/session/in-memory-session.js

@@ -0,0 +1,11 @@
+import { Session } from "./session.js";
+import { InMemorySessionStore } from "./stores/in-memory-session-store.js";
+export class InMemorySession extends Session {
+    constructor(cwd = process.cwd(), sessionManager) {
+        super(cwd, "", undefined, new InMemorySessionStore(), sessionManager);
+    }
+    prepareNewSessionReference(_sessionDir, sessionId, _timestamp) {
+        return `memory:${sessionId}`;
+    }
+}
+//# sourceMappingURL=in-memory-session.js.map

package/dist/core/session/in-memory-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-session.js","sourceRoot":"","sources":["../../../src/core/session/in-memory-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAE3E,MAAM,OAAO,eAAgB,SAAQ,OAAO;IAC3C,YAAY,GAAG,GAAW,OAAO,CAAC,GAAG,EAAE,EAAE,cAA+B,EAAE;QACzE,KAAK,CAAC,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,oBAAoB,EAAE,EAAE,cAAc,CAAC,CAAC;IAAA,CACtE;IAES,0BAA0B,CACnC,WAAmB,EACnB,SAAiB,EACjB,UAAkB,EACG;QACrB,OAAO,UAAU,SAAS,EAAE,CAAC;IAAA,CAC7B;CACD","sourcesContent":["import { Session } from \"./session.ts\";\nimport type { SessionManager } from \"./session-manager.ts\";\nimport { InMemorySessionStore } from \"./stores/in-memory-session-store.ts\";\n\nexport class InMemorySession extends Session {\n\tconstructor(cwd: string = process.cwd(), sessionManager?: SessionManager) {\n\t\tsuper(cwd, \"\", undefined, new InMemorySessionStore(), sessionManager);\n\t}\n\n\tprotected prepareNewSessionReference(\n\t\t_sessionDir: string,\n\t\tsessionId: string,\n\t\t_timestamp: string,\n\t): string | undefined {\n\t\treturn `memory:${sessionId}`;\n\t}\n}\n"]}

package/dist/core/session/jsonl-errors.d.ts

@@ -0,0 +1,36 @@
+export type JsonlDecodeKind = "utf8" | "syntax" | "schema" | "state";
+export type JsonlErrorPhase = "create" | "append" | "fork" | "open" | "repair" | "migrate" | "list" | "import" | "replace" | "sync";
+export type JsonlWriteOutcome = "not_written" | "unknown" | "published";
+/** Path-independent JSONL decoding failure. Storage boundaries attach location and operation context. */
+export declare class JsonlDecodeError extends Error {
+    readonly decodeKind: JsonlDecodeKind;
+    /** Compatibility alias for path-independent codec consumers. */
+    readonly kind: JsonlDecodeKind;
+    constructor(decodeKind: JsonlDecodeKind, message: string, cause?: Error);
+}
+export type JsonlSessionErrorCode = "invalid_jsonl" | "storage" | "fenced";
+export interface JsonlSessionErrorOptions {
+    code: JsonlSessionErrorCode;
+    reference: string;
+    phase: JsonlErrorPhase;
+    message: string;
+    line?: number;
+    byteOffset?: number;
+    decodeKind?: JsonlDecodeKind;
+    outcome?: JsonlWriteOutcome;
+    cause?: Error;
+}
+/** Actionable local JSONL error with location, phase, decoding, and write-outcome context. */
+export declare class JsonlSessionError extends Error {
+    readonly code: JsonlSessionErrorCode;
+    readonly reference: string;
+    readonly path: string;
+    readonly phase: JsonlErrorPhase;
+    readonly line?: number;
+    readonly byteOffset?: number;
+    readonly decodeKind?: JsonlDecodeKind;
+    readonly outcome?: JsonlWriteOutcome;
+    constructor(options: JsonlSessionErrorOptions);
+}
+export declare function createJsonlSessionDecodeError(reference: string, phase: JsonlErrorPhase, decodeKind: JsonlDecodeKind, message: string, line?: number, byteOffset?: number): JsonlSessionError;
+//# sourceMappingURL=jsonl-errors.d.ts.map

package/dist/core/session/jsonl-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-errors.d.ts","sourceRoot":"","sources":["../../../src/core/session/jsonl-errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErE,MAAM,MAAM,eAAe,GACxB,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,MAAM,GACN,QAAQ,GACR,SAAS,GACT,MAAM,GACN,QAAQ,GACR,SAAS,GACT,MAAM,CAAC;AAEV,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,SAAS,GAAG,WAAW,CAAC;AAExE,yGAAyG;AACzG,qBAAa,gBAAiB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAE/B,YAAY,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAKtE;CACD;AAED,MAAM,MAAM,qBAAqB,GAAG,eAAe,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE3E,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,KAAK,CAAC,EAAE,KAAK,CAAC;CACd;AAED,8FAA8F;AAC9F,qBAAa,iBAAkB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAErC,YAAY,OAAO,EAAE,wBAAwB,EAW5C;CACD;AAED,wBAAgB,6BAA6B,CAC5C,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,eAAe,EAC3B,OAAO,EAAE,MAAM,EACf,IAAI,SAAI,EACR,UAAU,SAAI,GACZ,iBAAiB,CAYnB","sourcesContent":["export type JsonlDecodeKind = \"utf8\" | \"syntax\" | \"schema\" | \"state\";\n\nexport type JsonlErrorPhase =\n\t| \"create\"\n\t| \"append\"\n\t| \"fork\"\n\t| \"open\"\n\t| \"repair\"\n\t| \"migrate\"\n\t| \"list\"\n\t| \"import\"\n\t| \"replace\"\n\t| \"sync\";\n\nexport type JsonlWriteOutcome = \"not_written\" | \"unknown\" | \"published\";\n\n/** Path-independent JSONL decoding failure. Storage boundaries attach location and operation context. */\nexport class JsonlDecodeError extends Error {\n\treadonly decodeKind: JsonlDecodeKind;\n\t/** Compatibility alias for path-independent codec consumers. */\n\treadonly kind: JsonlDecodeKind;\n\n\tconstructor(decodeKind: JsonlDecodeKind, message: string, cause?: Error) {\n\t\tsuper(message, cause === undefined ? undefined : { cause });\n\t\tthis.name = \"JsonlDecodeError\";\n\t\tthis.decodeKind = decodeKind;\n\t\tthis.kind = decodeKind;\n\t}\n}\n\nexport type JsonlSessionErrorCode = \"invalid_jsonl\" | \"storage\" | \"fenced\";\n\nexport interface JsonlSessionErrorOptions {\n\tcode: JsonlSessionErrorCode;\n\treference: string;\n\tphase: JsonlErrorPhase;\n\tmessage: string;\n\tline?: number;\n\tbyteOffset?: number;\n\tdecodeKind?: JsonlDecodeKind;\n\toutcome?: JsonlWriteOutcome;\n\tcause?: Error;\n}\n\n/** Actionable local JSONL error with location, phase, decoding, and write-outcome context. */\nexport class JsonlSessionError extends Error {\n\treadonly code: JsonlSessionErrorCode;\n\treadonly reference: string;\n\treadonly path: string;\n\treadonly phase: JsonlErrorPhase;\n\treadonly line?: number;\n\treadonly byteOffset?: number;\n\treadonly decodeKind?: JsonlDecodeKind;\n\treadonly outcome?: JsonlWriteOutcome;\n\n\tconstructor(options: JsonlSessionErrorOptions) {\n\t\tsuper(options.message, options.cause === undefined ? undefined : { cause: options.cause });\n\t\tthis.name = \"JsonlSessionError\";\n\t\tthis.code = options.code;\n\t\tthis.reference = options.reference;\n\t\tthis.path = options.reference;\n\t\tthis.phase = options.phase;\n\t\tthis.line = options.line;\n\t\tthis.byteOffset = options.byteOffset;\n\t\tthis.decodeKind = options.decodeKind;\n\t\tthis.outcome = options.outcome;\n\t}\n}\n\nexport function createJsonlSessionDecodeError(\n\treference: string,\n\tphase: JsonlErrorPhase,\n\tdecodeKind: JsonlDecodeKind,\n\tmessage: string,\n\tline = 1,\n\tbyteOffset = 0,\n): JsonlSessionError {\n\tconst cause = new JsonlDecodeError(decodeKind, message);\n\treturn new JsonlSessionError({\n\t\tcode: \"invalid_jsonl\",\n\t\treference,\n\t\tphase,\n\t\tline,\n\t\tbyteOffset,\n\t\tdecodeKind,\n\t\tmessage,\n\t\tcause,\n\t});\n}\n"]}

package/dist/core/session/jsonl-errors.js

@@ -0,0 +1,49 @@
+/** Path-independent JSONL decoding failure. Storage boundaries attach location and operation context. */
+export class JsonlDecodeError extends Error {
+    decodeKind;
+    /** Compatibility alias for path-independent codec consumers. */
+    kind;
+    constructor(decodeKind, message, cause) {
+        super(message, cause === undefined ? undefined : { cause });
+        this.name = "JsonlDecodeError";
+        this.decodeKind = decodeKind;
+        this.kind = decodeKind;
+    }
+}
+/** Actionable local JSONL error with location, phase, decoding, and write-outcome context. */
+export class JsonlSessionError extends Error {
+    code;
+    reference;
+    path;
+    phase;
+    line;
+    byteOffset;
+    decodeKind;
+    outcome;
+    constructor(options) {
+        super(options.message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = "JsonlSessionError";
+        this.code = options.code;
+        this.reference = options.reference;
+        this.path = options.reference;
+        this.phase = options.phase;
+        this.line = options.line;
+        this.byteOffset = options.byteOffset;
+        this.decodeKind = options.decodeKind;
+        this.outcome = options.outcome;
+    }
+}
+export function createJsonlSessionDecodeError(reference, phase, decodeKind, message, line = 1, byteOffset = 0) {
+    const cause = new JsonlDecodeError(decodeKind, message);
+    return new JsonlSessionError({
+        code: "invalid_jsonl",
+        reference,
+        phase,
+        line,
+        byteOffset,
+        decodeKind,
+        message,
+        cause,
+    });
+}
+//# sourceMappingURL=jsonl-errors.js.map

package/dist/core/session/jsonl-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-errors.js","sourceRoot":"","sources":["../../../src/core/session/jsonl-errors.ts"],"names":[],"mappings":"AAgBA,yGAAyG;AACzG,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACjC,UAAU,CAAkB;IACrC,gEAAgE;IACvD,IAAI,CAAkB;IAE/B,YAAY,UAA2B,EAAE,OAAe,EAAE,KAAa,EAAE;QACxE,KAAK,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IAAA,CACvB;CACD;AAgBD,8FAA8F;AAC9F,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAClC,IAAI,CAAwB;IAC5B,SAAS,CAAS;IAClB,IAAI,CAAS;IACb,KAAK,CAAkB;IACvB,IAAI,CAAU;IACd,UAAU,CAAU;IACpB,UAAU,CAAmB;IAC7B,OAAO,CAAqB;IAErC,YAAY,OAAiC,EAAE;QAC9C,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3F,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAAA,CAC/B;CACD;AAED,MAAM,UAAU,6BAA6B,CAC5C,SAAiB,EACjB,KAAsB,EACtB,UAA2B,EAC3B,OAAe,EACf,IAAI,GAAG,CAAC,EACR,UAAU,GAAG,CAAC,EACM;IACpB,MAAM,KAAK,GAAG,IAAI,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACxD,OAAO,IAAI,iBAAiB,CAAC;QAC5B,IAAI,EAAE,eAAe;QACrB,SAAS;QACT,KAAK;QACL,IAAI;QACJ,UAAU;QACV,UAAU;QACV,OAAO;QACP,KAAK;KACL,CAAC,CAAC;AAAA,CACH","sourcesContent":["export type JsonlDecodeKind = \"utf8\" | \"syntax\" | \"schema\" | \"state\";\n\nexport type JsonlErrorPhase =\n\t| \"create\"\n\t| \"append\"\n\t| \"fork\"\n\t| \"open\"\n\t| \"repair\"\n\t| \"migrate\"\n\t| \"list\"\n\t| \"import\"\n\t| \"replace\"\n\t| \"sync\";\n\nexport type JsonlWriteOutcome = \"not_written\" | \"unknown\" | \"published\";\n\n/** Path-independent JSONL decoding failure. Storage boundaries attach location and operation context. */\nexport class JsonlDecodeError extends Error {\n\treadonly decodeKind: JsonlDecodeKind;\n\t/** Compatibility alias for path-independent codec consumers. */\n\treadonly kind: JsonlDecodeKind;\n\n\tconstructor(decodeKind: JsonlDecodeKind, message: string, cause?: Error) {\n\t\tsuper(message, cause === undefined ? undefined : { cause });\n\t\tthis.name = \"JsonlDecodeError\";\n\t\tthis.decodeKind = decodeKind;\n\t\tthis.kind = decodeKind;\n\t}\n}\n\nexport type JsonlSessionErrorCode = \"invalid_jsonl\" | \"storage\" | \"fenced\";\n\nexport interface JsonlSessionErrorOptions {\n\tcode: JsonlSessionErrorCode;\n\treference: string;\n\tphase: JsonlErrorPhase;\n\tmessage: string;\n\tline?: number;\n\tbyteOffset?: number;\n\tdecodeKind?: JsonlDecodeKind;\n\toutcome?: JsonlWriteOutcome;\n\tcause?: Error;\n}\n\n/** Actionable local JSONL error with location, phase, decoding, and write-outcome context. */\nexport class JsonlSessionError extends Error {\n\treadonly code: JsonlSessionErrorCode;\n\treadonly reference: string;\n\treadonly path: string;\n\treadonly phase: JsonlErrorPhase;\n\treadonly line?: number;\n\treadonly byteOffset?: number;\n\treadonly decodeKind?: JsonlDecodeKind;\n\treadonly outcome?: JsonlWriteOutcome;\n\n\tconstructor(options: JsonlSessionErrorOptions) {\n\t\tsuper(options.message, options.cause === undefined ? undefined : { cause: options.cause });\n\t\tthis.name = \"JsonlSessionError\";\n\t\tthis.code = options.code;\n\t\tthis.reference = options.reference;\n\t\tthis.path = options.reference;\n\t\tthis.phase = options.phase;\n\t\tthis.line = options.line;\n\t\tthis.byteOffset = options.byteOffset;\n\t\tthis.decodeKind = options.decodeKind;\n\t\tthis.outcome = options.outcome;\n\t}\n}\n\nexport function createJsonlSessionDecodeError(\n\treference: string,\n\tphase: JsonlErrorPhase,\n\tdecodeKind: JsonlDecodeKind,\n\tmessage: string,\n\tline = 1,\n\tbyteOffset = 0,\n): JsonlSessionError {\n\tconst cause = new JsonlDecodeError(decodeKind, message);\n\treturn new JsonlSessionError({\n\t\tcode: \"invalid_jsonl\",\n\t\treference,\n\t\tphase,\n\t\tline,\n\t\tbyteOffset,\n\t\tdecodeKind,\n\t\tmessage,\n\t\tcause,\n\t});\n}\n"]}

package/dist/core/session/jsonl-helpers.d.ts

@@ -0,0 +1,20 @@
+import { JsonlSessionStore } from "./stores/jsonl-session-store.ts";
+import type { FileEntry } from "./types.ts";
+export declare const jsonlSessionStore: JsonlSessionStore;
+/**
+ * Compute the default session directory for a cwd.
+ * Encodes cwd into a safe directory name under ~/.grip/agent/sessions/.
+ */
+export declare function getDefaultSessionDir(cwd: string, agentDir?: string): string;
+type JsonlSessionEntryLoadPhase = "fork" | "open" | "import" | "migrate";
+interface LoadSessionEntriesOptions {
+    repair?: boolean;
+    phase?: JsonlSessionEntryLoadPhase;
+}
+/** Exported for testing. */
+export declare function loadEntriesFromFile(filePath: string, options?: LoadSessionEntriesOptions): FileEntry[];
+export declare function getDefaultSessionDirPath(cwd: string, agentDir?: string): string;
+/** Exported for testing. */
+export declare function findMostRecentSession(sessionDir: string, cwd?: string): string | null;
+export {};
+//# sourceMappingURL=jsonl-helpers.d.ts.map

package/dist/core/session/jsonl-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-helpers.d.ts","sourceRoot":"","sources":["../../../src/core/session/jsonl-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,iBAAiB,EAEjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,eAAO,MAAM,iBAAiB,mBAA0B,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,KAAK,0BAA0B,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzE,UAAU,yBAAyB;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,0BAA0B,CAAC;CACnC;AAED,4BAA4B;AAC5B,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,yBAA8B,GAAG,SAAS,EAAE,CAE1G;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED,4BAA4B;AAC5B,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAErF","sourcesContent":["import {\n\tfindMostRecent,\n\tgetDefaultSessionDir as getDefaultJsonlSessionDir,\n\tgetDefaultSessionDirPath as getDefaultJsonlSessionDirPath,\n\tJsonlSessionStore,\n\tload,\n} from \"./stores/jsonl-session-store.ts\";\nimport type { FileEntry } from \"./types.ts\";\n\nexport const jsonlSessionStore = new JsonlSessionStore();\n\n/**\n * Compute the default session directory for a cwd.\n * Encodes cwd into a safe directory name under ~/.grip/agent/sessions/.\n */\nexport function getDefaultSessionDir(cwd: string, agentDir?: string): string {\n\treturn getDefaultJsonlSessionDir(cwd, agentDir);\n}\n\ntype JsonlSessionEntryLoadPhase = \"fork\" | \"open\" | \"import\" | \"migrate\";\n\ninterface LoadSessionEntriesOptions {\n\trepair?: boolean;\n\tphase?: JsonlSessionEntryLoadPhase;\n}\n\n/** Exported for testing. */\nexport function loadEntriesFromFile(filePath: string, options: LoadSessionEntriesOptions = {}): FileEntry[] {\n\treturn load(filePath, {}, options.repair ?? true, options.phase ?? \"open\");\n}\n\nexport function getDefaultSessionDirPath(cwd: string, agentDir?: string): string {\n\treturn getDefaultJsonlSessionDirPath(cwd, agentDir);\n}\n\n/** Exported for testing. */\nexport function findMostRecentSession(sessionDir: string, cwd?: string): string | null {\n\treturn findMostRecent(sessionDir, cwd);\n}\n"]}

package/dist/core/session/jsonl-helpers.js

@@ -0,0 +1,21 @@
+import { findMostRecent, getDefaultSessionDir as getDefaultJsonlSessionDir, getDefaultSessionDirPath as getDefaultJsonlSessionDirPath, JsonlSessionStore, load, } from "./stores/jsonl-session-store.js";
+export const jsonlSessionStore = new JsonlSessionStore();
+/**
+ * Compute the default session directory for a cwd.
+ * Encodes cwd into a safe directory name under ~/.grip/agent/sessions/.
+ */
+export function getDefaultSessionDir(cwd, agentDir) {
+    return getDefaultJsonlSessionDir(cwd, agentDir);
+}
+/** Exported for testing. */
+export function loadEntriesFromFile(filePath, options = {}) {
+    return load(filePath, {}, options.repair ?? true, options.phase ?? "open");
+}
+export function getDefaultSessionDirPath(cwd, agentDir) {
+    return getDefaultJsonlSessionDirPath(cwd, agentDir);
+}
+/** Exported for testing. */
+export function findMostRecentSession(sessionDir, cwd) {
+    return findMostRecent(sessionDir, cwd);
+}
+//# sourceMappingURL=jsonl-helpers.js.map

package/dist/core/session/jsonl-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-helpers.js","sourceRoot":"","sources":["../../../src/core/session/jsonl-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,cAAc,EACd,oBAAoB,IAAI,yBAAyB,EACjD,wBAAwB,IAAI,6BAA6B,EACzD,iBAAiB,EACjB,IAAI,GACJ,MAAM,iCAAiC,CAAC;AAGzC,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC;AAEzD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW,EAAE,QAAiB,EAAU;IAC5E,OAAO,yBAAyB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAAA,CAChD;AASD,4BAA4B;AAC5B,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,OAAO,GAA8B,EAAE,EAAe;IAC3G,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC;AAAA,CAC3E;AAED,MAAM,UAAU,wBAAwB,CAAC,GAAW,EAAE,QAAiB,EAAU;IAChF,OAAO,6BAA6B,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAAA,CACpD;AAED,4BAA4B;AAC5B,MAAM,UAAU,qBAAqB,CAAC,UAAkB,EAAE,GAAY,EAAiB;IACtF,OAAO,cAAc,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;AAAA,CACvC","sourcesContent":["import {\n\tfindMostRecent,\n\tgetDefaultSessionDir as getDefaultJsonlSessionDir,\n\tgetDefaultSessionDirPath as getDefaultJsonlSessionDirPath,\n\tJsonlSessionStore,\n\tload,\n} from \"./stores/jsonl-session-store.ts\";\nimport type { FileEntry } from \"./types.ts\";\n\nexport const jsonlSessionStore = new JsonlSessionStore();\n\n/**\n * Compute the default session directory for a cwd.\n * Encodes cwd into a safe directory name under ~/.grip/agent/sessions/.\n */\nexport function getDefaultSessionDir(cwd: string, agentDir?: string): string {\n\treturn getDefaultJsonlSessionDir(cwd, agentDir);\n}\n\ntype JsonlSessionEntryLoadPhase = \"fork\" | \"open\" | \"import\" | \"migrate\";\n\ninterface LoadSessionEntriesOptions {\n\trepair?: boolean;\n\tphase?: JsonlSessionEntryLoadPhase;\n}\n\n/** Exported for testing. */\nexport function loadEntriesFromFile(filePath: string, options: LoadSessionEntriesOptions = {}): FileEntry[] {\n\treturn load(filePath, {}, options.repair ?? true, options.phase ?? \"open\");\n}\n\nexport function getDefaultSessionDirPath(cwd: string, agentDir?: string): string {\n\treturn getDefaultJsonlSessionDirPath(cwd, agentDir);\n}\n\n/** Exported for testing. */\nexport function findMostRecentSession(sessionDir: string, cwd?: string): string | null {\n\treturn findMostRecent(sessionDir, cwd);\n}\n"]}

package/dist/core/session/local-session-manager.d.ts

@@ -0,0 +1,30 @@
+import { LocalSession } from "./local-session.ts";
+import type { Session } from "./session.ts";
+import type { OpenSessionOptions, SessionManager } from "./session-manager.ts";
+import type { NewSessionOptions, SessionInfo, SessionListProgress } from "./types.ts";
+export interface LocalSessionManagerOptions {
+    cwd: string;
+    sessionDir?: string;
+}
+export declare class LocalSessionManager implements SessionManager {
+    private readonly cwd;
+    private readonly sessionDir?;
+    private readonly activePublicationDestinations;
+    private readonly firstPublicationCoordinator;
+    constructor(options: LocalSessionManagerOptions);
+    create(options?: NewSessionOptions): LocalSession;
+    openReference(reference: string, options?: OpenSessionOptions): LocalSession;
+    continueRecent(): LocalSession;
+    usesDefaultSessionDir(): boolean;
+    forkFrom(reference: string): LocalSession;
+    private publishFirstSnapshot;
+    private claimFirstPublication;
+    private rejectConflictingPublicationCandidate;
+    private rejectExistingSession;
+    private canonicalCwd;
+    forkSession(source: Session, targetLeafId: string | null): LocalSession;
+    importJsonl(inputPath: string, options?: OpenSessionOptions): LocalSession;
+    list(onProgress?: SessionListProgress): Promise<SessionInfo[]>;
+    listAll(onProgress?: SessionListProgress): Promise<SessionInfo[]>;
+}
+//# sourceMappingURL=local-session-manager.d.ts.map

package/dist/core/session/local-session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-session-manager.d.ts","sourceRoot":"","sources":["../../../src/core/session/local-session-manager.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAiB/E,OAAO,KAAK,EAAa,iBAAiB,EAAiB,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEhH,MAAM,WAAW,0BAA0B;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AASD,qBAAa,mBAAoB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAqB;IACnE,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAG1C;IAEF,YAAY,OAAO,EAAE,0BAA0B,EAG9C;IAED,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,YAAY,CAOhD;IAED,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,YAAY,CAmB3E;IAED,cAAc,IAAI,YAAY,CAQ7B;IAED,qBAAqB,IAAI,OAAO,CAE/B;IAED,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAqCxC;IAED,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,qBAAqB;IAwB7B,OAAO,CAAC,qCAAqC;IA0B7C,OAAO,CAAC,qBAAqB;IAa7B,OAAO,CAAC,YAAY;IAOpB,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,CAYtE;IAED,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,YAAY,CAiCzE;IAEK,IAAI,CAAC,UAAU,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CASnE;IAEK,OAAO,CAAC,UAAU,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAMtE;CACD","sourcesContent":["import { existsSync, lstatSync, readdirSync } from \"node:fs\";\nimport { basename, dirname, join, resolve } from \"node:path\";\nimport { CURRENT_SESSION_VERSION } from \"./constants.ts\";\nimport { createSessionId } from \"./ids.ts\";\nimport { createJsonlSessionDecodeError } from \"./jsonl-errors.ts\";\nimport {\n\tfindMostRecentSession,\n\tgetDefaultSessionDir,\n\tgetDefaultSessionDirPath,\n\tloadEntriesFromFile,\n} from \"./jsonl-helpers.ts\";\nimport { LocalSession } from \"./local-session.ts\";\nimport { migrateToCurrentVersion } from \"./migrations.ts\";\nimport type { Session } from \"./session.ts\";\nimport type { OpenSessionOptions, SessionManager } from \"./session-manager.ts\";\nimport {\n\tensureDir,\n\tforkSession as forkJsonlSession,\n\tgetJsonlEntryLocations,\n\tgetSessionDirForReference,\n\tgetSessionsRoot,\n\ttype JsonlFirstPublicationCoordinator,\n\tlistAll as listAllJsonlSessions,\n\tlist as listJsonlSessions,\n\tprepareSessionReference,\n\tpublishJsonlAtomically,\n\treadSessionHeader,\n\tSessionAlreadyExistsError,\n\tSessionHeaderScanLimitError,\n\tvalidateCurrentSessionEntries,\n} from \"./stores/jsonl-session-store.ts\";\nimport type { FileEntry, NewSessionOptions, SessionHeader, SessionInfo, SessionListProgress } from \"./types.ts\";\n\nexport interface LocalSessionManagerOptions {\n\tcwd: string;\n\tsessionDir?: string;\n}\n\ntype SessionPublicationPhase = \"create\" | \"fork\" | \"import\";\n\ninterface SessionPublicationClaimOptions {\n\tallowExistingEmptyFile: boolean;\n\tphase: SessionPublicationPhase;\n}\n\nexport class LocalSessionManager implements SessionManager {\n\tprivate readonly cwd: string;\n\tprivate readonly sessionDir?: string;\n\tprivate readonly activePublicationDestinations = new Set<string>();\n\tprivate readonly firstPublicationCoordinator: JsonlFirstPublicationCoordinator = {\n\t\tpublish: (filePath, entries, operation, options) =>\n\t\t\tthis.publishFirstSnapshot(filePath, entries, operation, options),\n\t};\n\n\tconstructor(options: LocalSessionManagerOptions) {\n\t\tthis.cwd = options.cwd;\n\t\tthis.sessionDir = options.sessionDir;\n\t}\n\n\tcreate(options?: NewSessionOptions): LocalSession {\n\t\tconst dir = this.sessionDir ?? getDefaultSessionDir(this.cwd);\n\t\tconst session = new LocalSession(this.cwd, dir, undefined, this, undefined, this.firstPublicationCoordinator);\n\t\tif (options?.id || options?.parentSession) {\n\t\t\tsession.newSession(options);\n\t\t}\n\t\treturn session;\n\t}\n\n\topenReference(reference: string, options?: OpenSessionOptions): LocalSession {\n\t\tlet header: SessionHeader | null = null;\n\t\tlet preloadedFileEntries: FileEntry[] | undefined;\n\t\tif (options?.cwdOverride === undefined && existsSync(reference)) {\n\t\t\ttry {\n\t\t\t\theader = readSessionHeader(reference);\n\t\t\t} catch (error) {\n\t\t\t\tif (!(error instanceof SessionHeaderScanLimitError)) throw error;\n\t\t\t\t// The bounded scan is only a discovery optimization. A full load remains\n\t\t\t\t// authoritative for legacy files with very large headers or prefixes.\n\t\t\t\tpreloadedFileEntries = loadEntriesFromFile(reference);\n\t\t\t\tconst firstEntry = preloadedFileEntries[0];\n\t\t\t\theader = firstEntry?.type === \"session\" ? firstEntry : null;\n\t\t\t}\n\t\t}\n\t\tconst storedCwd = typeof header?.cwd === \"string\" ? header.cwd : undefined;\n\t\tconst cwd = options?.cwdOverride ?? storedCwd ?? this.cwd;\n\t\tconst dir = this.sessionDir ?? getSessionDirForReference(reference);\n\t\treturn new LocalSession(cwd, dir, reference, this, preloadedFileEntries, this.firstPublicationCoordinator);\n\t}\n\n\tcontinueRecent(): LocalSession {\n\t\tconst dir = this.sessionDir ?? getDefaultSessionDir(this.cwd);\n\t\tconst filterCwd = this.sessionDir !== undefined && dir !== getDefaultSessionDirPath(this.cwd);\n\t\tconst mostRecent = findMostRecentSession(dir, filterCwd ? this.cwd : undefined);\n\t\tif (mostRecent) {\n\t\t\treturn new LocalSession(this.cwd, dir, mostRecent, this, undefined, this.firstPublicationCoordinator);\n\t\t}\n\t\treturn new LocalSession(this.cwd, dir, undefined, this, undefined, this.firstPublicationCoordinator);\n\t}\n\n\tusesDefaultSessionDir(): boolean {\n\t\treturn (this.sessionDir ?? getDefaultSessionDir(this.cwd)) === getDefaultSessionDirPath(this.cwd);\n\t}\n\n\tforkFrom(reference: string): LocalSession {\n\t\tconst sourceEntries = loadEntriesFromFile(reference, { repair: false, phase: \"fork\" });\n\t\tif (sourceEntries.length === 0) {\n\t\t\tthrow createJsonlSessionDecodeError(reference, \"fork\", \"schema\", `Cannot fork empty session: ${reference}`);\n\t\t}\n\t\tmigrateToCurrentVersion(sourceEntries);\n\t\tvalidateCurrentSessionEntries(sourceEntries, reference, {\n\t\t\tphase: \"fork\",\n\t\t\tlocations: getJsonlEntryLocations(sourceEntries),\n\t\t});\n\t\tconst sourceHeader = sourceEntries[0];\n\t\tif (sourceHeader?.type !== \"session\") {\n\t\t\tthrow new Error(`Cannot fork: source session has no header: ${reference}`);\n\t\t}\n\n\t\tconst dir = this.sessionDir ?? getDefaultSessionDir(this.cwd);\n\t\tensureDir(dir);\n\n\t\tconst newSessionId = createSessionId();\n\t\tconst timestamp = new Date().toISOString();\n\t\tconst newHeader: SessionHeader = {\n\t\t\ttype: \"session\",\n\t\t\tversion: CURRENT_SESSION_VERSION,\n\t\t\tid: newSessionId,\n\t\t\ttimestamp,\n\t\t\tcwd: this.cwd,\n\t\t\tparentSession: reference,\n\t\t};\n\t\tconst expectedReference = prepareSessionReference(dir, newHeader.id, newHeader.timestamp);\n\t\tconst newSessionReference = this.claimFirstPublication(\n\t\t\texpectedReference,\n\t\t\t[newHeader, ...sourceEntries],\n\t\t\t() => forkJsonlSession(dir, newHeader, sourceEntries),\n\t\t\t{ allowExistingEmptyFile: false, phase: \"fork\" },\n\t\t);\n\n\t\treturn new LocalSession(this.cwd, dir, newSessionReference, this, undefined, this.firstPublicationCoordinator);\n\t}\n\n\tprivate publishFirstSnapshot(\n\t\tfilePath: string,\n\t\tentries: FileEntry[],\n\t\toperation: () => void,\n\t\toptions: SessionPublicationClaimOptions,\n\t): void {\n\t\tthis.claimFirstPublication(filePath, entries, operation, options);\n\t}\n\n\tprivate claimFirstPublication<T>(\n\t\tfilePath: string,\n\t\tentries: FileEntry[],\n\t\toperation: () => T,\n\t\toptions: SessionPublicationClaimOptions = {\n\t\t\tallowExistingEmptyFile: false,\n\t\t\tphase: \"create\",\n\t\t},\n\t): T {\n\t\tconst header = entries.find((entry): entry is SessionHeader => entry.type === \"session\");\n\t\tif (!header) throw new Error(`Cannot publish session without a header: ${filePath}`);\n\t\tconst key = `${this.canonicalCwd(header.cwd)}\\0${header.id}`;\n\t\tif (this.activePublicationDestinations.has(key)) {\n\t\t\tthrow new SessionAlreadyExistsError(filePath, header.id, options.phase);\n\t\t}\n\t\tthis.activePublicationDestinations.add(key);\n\t\ttry {\n\t\t\tthis.rejectExistingSession(filePath, header, options);\n\t\t\treturn operation();\n\t\t} finally {\n\t\t\tthis.activePublicationDestinations.delete(key);\n\t\t}\n\t}\n\n\tprivate rejectConflictingPublicationCandidate(\n\t\tcandidate: string,\n\t\tresolvedTarget: string,\n\t\theader: SessionHeader,\n\t\toptions: SessionPublicationClaimOptions,\n\t): void {\n\t\tif (candidate === resolvedTarget) {\n\t\t\tif (options.allowExistingEmptyFile && lstatSync(candidate).isFile() && lstatSync(candidate).size === 0) return;\n\t\t\tthrow new SessionAlreadyExistsError(candidate, header.id, options.phase);\n\t\t}\n\t\ttry {\n\t\t\tconst existing = readSessionHeader(candidate);\n\t\t\tif (\n\t\t\t\texisting?.id === header.id &&\n\t\t\t\ttypeof existing.cwd === \"string\" &&\n\t\t\t\tthis.canonicalCwd(existing.cwd) === this.canonicalCwd(header.cwd)\n\t\t\t) {\n\t\t\t\tthrow new SessionAlreadyExistsError(candidate, header.id, options.phase);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tif (error instanceof SessionAlreadyExistsError) throw error;\n\t\t\tif (error instanceof SessionHeaderScanLimitError) return;\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tprivate rejectExistingSession(\n\t\tfilePath: string,\n\t\theader: SessionHeader,\n\t\toptions: SessionPublicationClaimOptions,\n\t): void {\n\t\tconst resolvedTarget = resolve(filePath);\n\t\tfor (const name of readdirSync(dirname(resolvedTarget))) {\n\t\t\tif (!name.endsWith(\".jsonl\")) continue;\n\t\t\tconst candidate = resolve(dirname(resolvedTarget), name);\n\t\t\tthis.rejectConflictingPublicationCandidate(candidate, resolvedTarget, header, options);\n\t\t}\n\t}\n\n\tprivate canonicalCwd(cwd: string): string {\n\t\tconst canonical = resolve(cwd);\n\t\treturn process.platform === \"win32\"\n\t\t\t? canonical.replace(/^([A-Z]):/, (_, drive: string) => `${drive.toLowerCase()}:`)\n\t\t\t: canonical;\n\t}\n\n\tforkSession(source: Session, targetLeafId: string | null): LocalSession {\n\t\tconst parentSession = source.getSessionReference();\n\t\tif (!targetLeafId) {\n\t\t\tconst session = this.create();\n\t\t\tsession.newSession({ parentSession });\n\t\t\treturn session;\n\t\t}\n\n\t\tconst branchSource = parentSession && existsSync(parentSession) ? this.openReference(parentSession) : source;\n\t\tconst target = this.create({ parentSession });\n\t\ttarget.copyBranchFrom(branchSource, targetLeafId, parentSession);\n\t\treturn target;\n\t}\n\n\timportJsonl(inputPath: string, options?: OpenSessionOptions): LocalSession {\n\t\tconst resolvedPath = resolve(inputPath);\n\t\tif (!existsSync(resolvedPath)) throw new Error(`File not found: ${resolvedPath}`);\n\n\t\tconst entries = loadEntriesFromFile(resolvedPath, { repair: false, phase: \"import\" });\n\t\tif (entries.length === 0) {\n\t\t\tthrow createJsonlSessionDecodeError(\n\t\t\t\tresolvedPath,\n\t\t\t\t\"import\",\n\t\t\t\t\"schema\",\n\t\t\t\t`Cannot import empty session JSONL: ${resolvedPath}`,\n\t\t\t);\n\t\t}\n\t\tmigrateToCurrentVersion(entries);\n\t\tvalidateCurrentSessionEntries(entries, resolvedPath, {\n\t\t\tphase: \"import\",\n\t\t\tlocations: getJsonlEntryLocations(entries),\n\t\t});\n\n\t\tconst dir = this.sessionDir ?? getDefaultSessionDir(this.cwd);\n\t\tensureDir(dir);\n\t\tconst destinationPath = join(dir, basename(resolvedPath));\n\t\tif (resolve(destinationPath) === resolvedPath) return this.openReference(resolvedPath, options);\n\n\t\tconst header = entries[0];\n\t\tif (header?.type !== \"session\") throw new Error(`Cannot import session without a header: ${resolvedPath}`);\n\t\tthis.claimFirstPublication(\n\t\t\tdestinationPath,\n\t\t\tentries,\n\t\t\t() => publishJsonlAtomically(destinationPath, entries, { phase: \"import\" }),\n\t\t\t{ allowExistingEmptyFile: false, phase: \"import\" },\n\t\t);\n\t\treturn this.openReference(destinationPath, options);\n\t}\n\n\tasync list(onProgress?: SessionListProgress): Promise<SessionInfo[]> {\n\t\tconst dir = this.sessionDir ?? getDefaultSessionDir(this.cwd);\n\t\tconst filterCwd = this.sessionDir !== undefined && dir !== getDefaultSessionDirPath(this.cwd);\n\t\tconst resolvedCwd = resolve(this.cwd);\n\t\tconst sessions = (await listJsonlSessions(dir, onProgress)).filter(\n\t\t\t(session) => !filterCwd || (session.cwd !== undefined && resolve(session.cwd) === resolvedCwd),\n\t\t);\n\t\tsessions.sort((a, b) => b.modified.getTime() - a.modified.getTime());\n\t\treturn sessions;\n\t}\n\n\tasync listAll(onProgress?: SessionListProgress): Promise<SessionInfo[]> {\n\t\tconst sessions = this.sessionDir\n\t\t\t? await listJsonlSessions(this.sessionDir, onProgress)\n\t\t\t: await listAllJsonlSessions(getSessionsRoot(), onProgress);\n\t\tsessions.sort((a, b) => b.modified.getTime() - a.modified.getTime());\n\t\treturn sessions;\n\t}\n}\n"]}