@gencode/uni 0.3.1 → 0.4.1

package/dist/uni/src/session/context-store.js

@@ -0,0 +1,222 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { atomicWriteUniFile, uniContextPath, uniToolResultsDir, } from "./session-store.js";
+export const UNI_CONTEXT_VERSION = 2;
+export const DEFAULT_UNI_TOOL_RESULT_THRESHOLD_CHARS = 12_000;
+export const DEFAULT_UNI_TOOL_RESULT_PREVIEW_CHARS = 2_000;
+const MAX_TRACKED_TOOL_RESULTS = 100;
+const MAX_TRACKED_BUDGETS = 200;
+export async function createUniContextStore(options) {
+    const filePath = uniContextPath(options.dataDir, options.logicalSessionId, options.storeName);
+    const loaded = await loadUniContextSnapshot(options.dataDir, options.logicalSessionId, options.storeName);
+    const toolResults = new Map(loaded.toolResults.map((reference) => [reference.toolCallId, reference]));
+    const budgets = [...loaded.compaction.budgets];
+    let modelUsage = loaded.compaction.modelUsage;
+    let writeQueue = Promise.resolve();
+    const snapshot = () => ({
+        version: UNI_CONTEXT_VERSION,
+        updatedAt: new Date().toISOString(),
+        readStates: [...loaded.readStates],
+        toolResults: [...toolResults.values()].slice(-MAX_TRACKED_TOOL_RESULTS),
+        compaction: {
+            sessionMemory: loaded.compaction.sessionMemory,
+            modelUsage,
+            budgets: budgets.slice(-MAX_TRACKED_BUDGETS),
+            snips: [...loaded.compaction.snips],
+            collapseSpans: [...loaded.compaction.collapseSpans],
+            consecutiveAutocompactFailures: loaded.compaction.consecutiveAutocompactFailures,
+            lastCompactionAt: loaded.compaction.lastCompactionAt,
+            lastCompactionLayer: loaded.compaction.lastCompactionLayer,
+        },
+    });
+    const persist = async () => {
+        const next = writeQueue.catch(() => undefined).then(async () => {
+            await atomicWriteUniFile(filePath, `${JSON.stringify(snapshot(), null, 2)}\n`);
+        });
+        writeQueue = next;
+        await next;
+    };
+    // Creation is also the base-file initialization path. Existing snapshots
+    // are normalized to V2 while preserving all verifiable state.
+    await persist();
+    return {
+        getSnapshot: snapshot,
+        async recordModelUsage(params) {
+            const model = params.model.trim();
+            if (!model) {
+                throw new Error("Model usage requires a non-empty model identifier");
+            }
+            const checkpoint = {
+                version: 1,
+                model,
+                inputTokens: normalizeTokenCount(params.usage.input),
+                outputTokens: normalizeTokenCount(params.usage.output),
+                totalTokens: normalizeTokenCount(params.usage.total),
+                coveredTranscriptEntryCount: normalizeTokenCount(params.coveredTranscriptEntryCount),
+                recordedAt: params.recordedAt ?? new Date().toISOString(),
+            };
+            modelUsage = checkpoint;
+            await persist();
+            return checkpoint;
+        },
+        async persistToolResult(params) {
+            const thresholdChars = params.thresholdChars
+                ?? DEFAULT_UNI_TOOL_RESULT_THRESHOLD_CHARS;
+            if (params.content.length <= thresholdChars) {
+                return { content: params.content };
+            }
+            const previewChars = params.previewChars
+                ?? DEFAULT_UNI_TOOL_RESULT_PREVIEW_CHARS;
+            const resultsDir = uniToolResultsDir(options.dataDir, options.logicalSessionId, options.storeName);
+            const resultPath = path.join(resultsDir, safeToolResultFileName(params.toolCallId));
+            await atomicWriteUniFile(resultPath, params.content);
+            const createdAt = new Date().toISOString();
+            const preview = generatePreview(params.content, previewChars);
+            const reference = {
+                sessionId: options.logicalSessionId,
+                toolCallId: params.toolCallId,
+                toolName: params.toolName,
+                storagePath: path.relative(options.dataDir, resultPath).split(path.sep).join("/"),
+                preview,
+                originalChars: params.content.length,
+                truncated: true,
+                createdAt,
+            };
+            const budget = {
+                toolCallId: params.toolCallId,
+                toolName: params.toolName,
+                originalChars: params.content.length,
+                storedChars: params.content.length,
+                previewChars: preview.length,
+                strategy: "persist",
+                createdAt,
+            };
+            toolResults.set(reference.toolCallId, reference);
+            budgets.push(budget);
+            await persist();
+            return {
+                content: renderPersistedToolResult(reference),
+                reference,
+            };
+        },
+    };
+}
+export async function loadUniContextSnapshot(dataDir, logicalSessionId, storeName) {
+    try {
+        const parsed = JSON.parse(await fs.readFile(uniContextPath(dataDir, logicalSessionId, storeName), "utf8"));
+        if (parsed.version !== 1 && parsed.version !== UNI_CONTEXT_VERSION) {
+            return emptyUniContextSnapshot();
+        }
+        return {
+            version: UNI_CONTEXT_VERSION,
+            updatedAt: typeof parsed.updatedAt === "string"
+                ? parsed.updatedAt
+                : new Date(0).toISOString(),
+            readStates: Array.isArray(parsed.readStates)
+                ? parsed.readStates
+                : [],
+            toolResults: Array.isArray(parsed.toolResults)
+                ? parsed.toolResults
+                : [],
+            compaction: {
+                sessionMemory: parsed.compaction?.sessionMemory,
+                modelUsage: parseModelUsage(parsed.compaction?.modelUsage),
+                budgets: Array.isArray(parsed.compaction?.budgets)
+                    ? parsed.compaction.budgets
+                    : [],
+                snips: Array.isArray(parsed.compaction?.snips)
+                    ? parsed.compaction.snips
+                    : [],
+                collapseSpans: Array.isArray(parsed.compaction?.collapseSpans)
+                    ? parsed.compaction.collapseSpans
+                    : [],
+                consecutiveAutocompactFailures: typeof parsed.compaction?.consecutiveAutocompactFailures === "number"
+                    ? parsed.compaction.consecutiveAutocompactFailures
+                    : 0,
+                lastCompactionAt: typeof parsed.compaction?.lastCompactionAt === "string"
+                    ? parsed.compaction.lastCompactionAt
+                    : undefined,
+                lastCompactionLayer: isCompactionLayer(parsed.compaction?.lastCompactionLayer)
+                    ? parsed.compaction.lastCompactionLayer
+                    : undefined,
+            },
+        };
+    }
+    catch {
+        return emptyUniContextSnapshot();
+    }
+}
+export function emptyUniContextSnapshot(now = new Date(0)) {
+    return {
+        version: UNI_CONTEXT_VERSION,
+        updatedAt: now.toISOString(),
+        readStates: [],
+        toolResults: [],
+        compaction: {
+            budgets: [],
+            snips: [],
+            collapseSpans: [],
+            consecutiveAutocompactFailures: 0,
+        },
+    };
+}
+function parseModelUsage(value) {
+    if (!value || typeof value !== "object") {
+        return undefined;
+    }
+    const candidate = value;
+    if (candidate.version !== 1
+        || typeof candidate.model !== "string"
+        || typeof candidate.inputTokens !== "number"
+        || typeof candidate.outputTokens !== "number"
+        || typeof candidate.totalTokens !== "number"
+        || typeof candidate.coveredTranscriptEntryCount !== "number"
+        || typeof candidate.recordedAt !== "string") {
+        return undefined;
+    }
+    return {
+        version: 1,
+        model: candidate.model,
+        inputTokens: normalizeTokenCount(candidate.inputTokens),
+        outputTokens: normalizeTokenCount(candidate.outputTokens),
+        totalTokens: normalizeTokenCount(candidate.totalTokens),
+        coveredTranscriptEntryCount: normalizeTokenCount(candidate.coveredTranscriptEntryCount),
+        recordedAt: candidate.recordedAt,
+    };
+}
+function normalizeTokenCount(value) {
+    if (!Number.isFinite(value) || value < 0) {
+        throw new Error(`Invalid token count: ${String(value)}`);
+    }
+    return Math.floor(value);
+}
+function isCompactionLayer(value) {
+    return value === "L1"
+        || value === "L2"
+        || value === "L3"
+        || value === "L4"
+        || value === "L5"
+        || value === "L6";
+}
+function safeToolResultFileName(toolCallId) {
+    const encoded = encodeURIComponent(toolCallId).replace(/\./g, "%2E");
+    return `${encoded || "tool-result"}.txt`;
+}
+function generatePreview(content, maxChars) {
+    if (content.length <= maxChars) {
+        return content;
+    }
+    const truncated = content.slice(0, maxChars);
+    const lastNewline = truncated.lastIndexOf("\n");
+    const cutPoint = lastNewline > maxChars * 0.5 ? lastNewline : maxChars;
+    return content.slice(0, cutPoint);
+}
+function renderPersistedToolResult(reference) {
+    return [
+        `[tool result persisted] ${reference.toolName} output was too large (${reference.originalChars} chars).`,
+        `Full output: ${reference.storagePath}`,
+        "Preview:",
+        reference.preview,
+    ].join("\n");
+}
+//# sourceMappingURL=context-store.js.map

package/dist/uni/src/session/context-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-store.js","sourceRoot":"","sources":["../../../../src/session/context-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAO7B,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAU,CAAC;AAC9C,MAAM,CAAC,MAAM,uCAAuC,GAAG,MAAM,CAAC;AAC9D,MAAM,CAAC,MAAM,qCAAqC,GAAG,KAAK,CAAC;AAE3D,MAAM,wBAAwB,GAAG,GAAG,CAAC;AACrC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AA8BhC,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAA+B;IAE/B,MAAM,QAAQ,GAAG,cAAc,CAC7B,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,gBAAgB,EACxB,OAAO,CAAC,SAAS,CAClB,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,gBAAgB,EACxB,OAAO,CAAC,SAAS,CAClB,CAAC;IACF,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CACzE,CAAC;IACF,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC;IAC9C,IAAI,UAAU,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAEnC,MAAM,QAAQ,GAAG,GAA2B,EAAE,CAAC,CAAC;QAC9C,OAAO,EAAE,mBAAmB;QAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,UAAU,EAAE,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC;QAClC,WAAW,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,wBAAwB,CAAC;QACvE,UAAU,EAAE;YACV,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,aAAa;YAC9C,UAAU;YACV,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,mBAAmB,CAAC;YAC5C,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;YACnC,aAAa,EAAE,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC;YACnD,8BAA8B,EAAE,MAAM,CAAC,UAAU,CAAC,8BAA8B;YAChF,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,gBAAgB;YACpD,mBAAmB,EAAE,MAAM,CAAC,UAAU,CAAC,mBAAmB;SAC3D;KACF,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;QACxC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAC7D,MAAM,kBAAkB,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACjF,CAAC,CAAC,CAAC;QACH,UAAU,GAAG,IAAI,CAAC;QAClB,MAAM,IAAI,CAAC;IACb,CAAC,CAAC;IAEF,yEAAyE;IACzE,8DAA8D;IAC9D,MAAM,OAAO,EAAE,CAAC;IAEhB,OAAO;QACL,WAAW,EAAE,QAAQ;QAErB,KAAK,CAAC,gBAAgB,CAAC,MAAM;YAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;YACvE,CAAC;YACD,MAAM,UAAU,GAAyB;gBACvC,OAAO,EAAE,CAAC;gBACV,KAAK;gBACL,WAAW,EAAE,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;gBACpD,YAAY,EAAE,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;gBACtD,WAAW,EAAE,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;gBACpD,2BAA2B,EAAE,mBAAmB,CAAC,MAAM,CAAC,2BAA2B,CAAC;gBACpF,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAC1D,CAAC;YACF,UAAU,GAAG,UAAU,CAAC;YACxB,MAAM,OAAO,EAAE,CAAC;YAChB,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,KAAK,CAAC,iBAAiB,CAAC,MAAM;YAC5B,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc;mBACvC,uCAAuC,CAAC;YAC7C,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,cAAc,EAAE,CAAC;gBAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YACrC,CAAC;YAED,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY;mBACnC,qCAAqC,CAAC;YAC3C,MAAM,UAAU,GAAG,iBAAiB,CAClC,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,gBAAgB,EACxB,OAAO,CAAC,SAAS,CAClB,CAAC;YACF,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,sBAAsB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;YACpF,MAAM,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YAErD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YAC9D,MAAM,SAAS,GAAwB;gBACrC,SAAS,EAAE,OAAO,CAAC,gBAAgB;gBACnC,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBACjF,OAAO;gBACP,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;gBACpC,SAAS,EAAE,IAAI;gBACf,SAAS;aACV,CAAC;YACF,MAAM,MAAM,GAA2B;gBACrC,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;gBACpC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;gBAClC,YAAY,EAAE,OAAO,CAAC,MAAM;gBAC5B,QAAQ,EAAE,SAAS;gBACnB,SAAS;aACV,CAAC;YACF,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,MAAM,OAAO,EAAE,CAAC;YAEhB,OAAO;gBACL,OAAO,EAAE,yBAAyB,CAAC,SAAS,CAAC;gBAC7C,SAAS;aACV,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAe,EACf,gBAAwB,EACxB,SAAkB;IAElB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CACvB,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAOhF,CAAC;QACF,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,KAAK,mBAAmB,EAAE,CAAC;YACnE,OAAO,uBAAuB,EAAE,CAAC;QACnC,CAAC;QACD,OAAO;YACL,OAAO,EAAE,mBAAmB;YAC5B,SAAS,EAAE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;gBAC7C,CAAC,CAAC,MAAM,CAAC,SAAS;gBAClB,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;YAC7B,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;gBAC1C,CAAC,CAAC,MAAM,CAAC,UAAkD;gBAC3D,CAAC,CAAC,EAAE;YACN,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC;gBAC5C,CAAC,CAAC,MAAM,CAAC,WAAoD;gBAC7D,CAAC,CAAC,EAAE;YACN,UAAU,EAAE;gBACV,aAAa,EAAE,MAAM,CAAC,UAAU,EAAE,aAAa;gBAC/C,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC;gBAC1D,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC;oBAChD,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO;oBAC3B,CAAC,CAAC,EAAE;gBACN,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC;oBAC5C,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK;oBACzB,CAAC,CAAC,EAAE;gBACN,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC;oBAC5D,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,aAAa;oBACjC,CAAC,CAAC,EAAE;gBACN,8BAA8B,EAC5B,OAAO,MAAM,CAAC,UAAU,EAAE,8BAA8B,KAAK,QAAQ;oBACnE,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,8BAA8B;oBAClD,CAAC,CAAC,CAAC;gBACP,gBAAgB,EACd,OAAO,MAAM,CAAC,UAAU,EAAE,gBAAgB,KAAK,QAAQ;oBACrD,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB;oBACpC,CAAC,CAAC,SAAS;gBACf,mBAAmB,EAAE,iBAAiB,CAAC,MAAM,CAAC,UAAU,EAAE,mBAAmB,CAAC;oBAC5E,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,mBAAmB;oBACvC,CAAC,CAAC,SAAS;aACd;SACF,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,uBAAuB,EAAE,CAAC;IACnC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC;IACvD,OAAO;QACL,OAAO,EAAE,mBAAmB;QAC5B,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;QAC5B,UAAU,EAAE,EAAE;QACd,WAAW,EAAE,EAAE;QACf,UAAU,EAAE;YACV,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,EAAE;YACT,aAAa,EAAE,EAAE;YACjB,8BAA8B,EAAE,CAAC;SAClC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,SAAS,GAAG,KAAsC,CAAC;IACzD,IACE,SAAS,CAAC,OAAO,KAAK,CAAC;WACpB,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ;WACnC,OAAO,SAAS,CAAC,WAAW,KAAK,QAAQ;WACzC,OAAO,SAAS,CAAC,YAAY,KAAK,QAAQ;WAC1C,OAAO,SAAS,CAAC,WAAW,KAAK,QAAQ;WACzC,OAAO,SAAS,CAAC,2BAA2B,KAAK,QAAQ;WACzD,OAAO,SAAS,CAAC,UAAU,KAAK,QAAQ,EAC3C,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO;QACL,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,WAAW,EAAE,mBAAmB,CAAC,SAAS,CAAC,WAAW,CAAC;QACvD,YAAY,EAAE,mBAAmB,CAAC,SAAS,CAAC,YAAY,CAAC;QACzD,WAAW,EAAE,mBAAmB,CAAC,SAAS,CAAC,WAAW,CAAC;QACvD,2BAA2B,EAAE,mBAAmB,CAAC,SAAS,CAAC,2BAA2B,CAAC;QACvF,UAAU,EAAE,SAAS,CAAC,UAAU;KACjC,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAc;IAEd,OAAO,KAAK,KAAK,IAAI;WAChB,KAAK,KAAK,IAAI;WACd,KAAK,KAAK,IAAI;WACd,KAAK,KAAK,IAAI;WACd,KAAK,KAAK,IAAI;WACd,KAAK,KAAK,IAAI,CAAC;AACtB,CAAC;AAED,SAAS,sBAAsB,CAAC,UAAkB;IAChD,MAAM,OAAO,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACrE,OAAO,GAAG,OAAO,IAAI,aAAa,MAAM,CAAC;AAC3C,CAAC;AAED,SAAS,eAAe,CAAC,OAAe,EAAE,QAAgB;IACxD,IAAI,OAAO,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;IACvE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,yBAAyB,CAAC,SAA8B;IAC/D,OAAO;QACL,2BAA2B,SAAS,CAAC,QAAQ,0BAA0B,SAAS,CAAC,aAAa,UAAU;QACxG,gBAAgB,SAAS,CAAC,WAAW,EAAE;QACvC,UAAU;QACV,SAAS,CAAC,OAAO;KAClB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/uni/src/session/session-store.d.ts

@@ -1,7 +1,13 @@
-import type { SessionMetadata, Channel } from "@gencode/shared";
+import type { ArtifactRecord, Channel, SessionMetadata } from "@gencode/shared";
+export declare const DEFAULT_UNI_SESSION_STORE_NAME = "sessions";
+export type UniSessionErrorCode = "invalid_session" | "runtime_mismatch" | "provider_binding_conflict" | "legacy_unresolved" | "not_uni_session";
+export declare class UniSessionError extends Error {
+    readonly code: UniSessionErrorCode;
+    constructor(code: UniSessionErrorCode, message: string);
+}
 type UniTranscriptEntryBase = {
     timestamp: string;
-    runtimeAgent?: string;
+    runtimeAgent: string;
     messageId?: string;
 };
 export type UniTranscriptEntry = (UniTranscriptEntryBase & {
@@ -10,6 +16,8 @@ export type UniTranscriptEntry = (UniTranscriptEntryBase & {
 }) | (UniTranscriptEntryBase & {
     role: "assistant";
     content: string;
+    thinking?: string;
+    artifacts?: ArtifactRecord[];
     toolCalls?: Array<{
         id: string;
         name: string;
@@ -29,12 +37,59 @@ export type UniTranscriptEntry = (UniTranscriptEntryBase & {
     content: string;
     isError: boolean;
 });
+export type PrepareUniSessionOptions = {
+    dataDir: string;
+    logicalSessionId: string;
+    runtimeAgent: string;
+    title: string;
+    channel: Channel;
+    storeName?: string;
+    /** Provider-owned roots that may contain exact native session evidence. */
+    providerStateRoots?: readonly string[];
+};
+export type PreparedUniSession = {
+    logicalSessionId: string;
+    providerSessionId?: string;
+    metadata: SessionMetadata;
+    isNew: boolean;
+    migratedLegacy: boolean;
+    /** Entry count before the current run appends its user entry. */
+    existingTranscriptEntryCount: number;
+};
+export declare function normalizeUniSessionStoreName(storeName?: string): string;
+export declare function uniSessionsDir(dataDir: string, storeName?: string): string;
+export declare function uniSessionDir(dataDir: string, sessionId: string, storeName?: string): string;
+export declare function uniMetadataPath(dataDir: string, sessionId: string, storeName?: string): string;
+export declare function uniChannelPath(dataDir: string, sessionId: string, storeName?: string): string;
+export declare function uniTranscriptPath(dataDir: string, sessionId: string, storeName?: string): string;
+export declare function uniContextPath(dataDir: string, sessionId: string, storeName?: string): string;
+export declare function uniToolResultsDir(dataDir: string, sessionId: string, storeName?: string): string;
+export declare function ensureUniSessionDir(dataDir: string, sessionId: string, storeName?: string): Promise<string>;
+export declare function atomicWriteUniFile(filePath: string, content: string): Promise<void>;
 export declare function saveUniSessionMetadata(dataDir: string, metadata: SessionMetadata, storeName?: string): Promise<void>;
+export declare function loadUniSessionMetadata(dataDir: string, sessionId: string, storeName?: string): Promise<SessionMetadata | null>;
+export type UniSessionMetadataUpdate = Partial<Omit<SessionMetadata, "id" | "createdAt" | "updatedAt">>;
+export declare function updateUniSessionMetadata(dataDir: string, sessionId: string, updates: UniSessionMetadataUpdate, storeName?: string): Promise<SessionMetadata>;
+export declare function ensureUniChannelFile(dataDir: string, sessionId: string, channel: Channel, storeName?: string): Promise<void>;
+export declare function ensureUniTranscriptFile(dataDir: string, sessionId: string, storeName?: string): Promise<void>;
+export declare function appendUniTranscriptEntries(dataDir: string, sessionId: string, entries: readonly UniTranscriptEntry[], storeName?: string): Promise<void>;
 export declare function appendUniTranscriptEntry(dataDir: string, sessionId: string, entry: UniTranscriptEntry, storeName?: string): Promise<void>;
+export declare function loadUniTranscript(dataDir: string, sessionId: string, storeName?: string): Promise<UniTranscriptEntry[]>;
+export declare function countUniTranscriptEntries(dataDir: string, sessionId: string, storeName?: string): Promise<number>;
 export declare function buildUniSessionMetadata(params: {
     sessionId: string;
     title: string;
     channel: Channel;
+    runtimeAgent?: string;
+    providerSessionId?: string;
 }): SessionMetadata;
+export declare function prepareUniSession(options: PrepareUniSessionOptions): Promise<PreparedUniSession>;
+export declare function bindUniProviderSession(params: {
+    dataDir: string;
+    logicalSessionId: string;
+    runtimeAgent: string;
+    providerSessionId: string;
+    storeName?: string;
+}): Promise<SessionMetadata>;
 export {};
 //# sourceMappingURL=session-store.d.ts.map

package/dist/uni/src/session/session-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../../../src/session/session-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAkBhE,KAAK,sBAAsB,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC1B,CAAC,sBAAsB,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC,GACA,CAAC,sBAAsB,GAAG;IACxB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC,CAAC;IACH,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC,GACA,CAAC,sBAAsB,GAAG;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CACpB,CAAC,CAAC;AAEL,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,eAAe,EACzB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,kBAAkB,EACzB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,eAAe,CASlB"}
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../../../src/session/session-store.ts"],"names":[],"mappings":"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"}