@devxiyang/agent-kernel 0.0.2

package/dist/core/agent/wrap-tool.d.ts

@@ -0,0 +1,12 @@
+import type { TObject } from '@sinclair/typebox';
+import type { AgentTool, ToolWrapHooks } from './types';
+/**
+ * Wrap an AgentTool with before/after hooks.
+ *
+ * - `before`: can block, modify input, or replace the result entirely
+ * - `after`: can partially override content, isError, and/or details
+ *
+ * Hooks are transparent to the agent loop — the loop only sees a plain AgentTool.
+ */
+export declare function wrapTool<TSchema extends TObject = TObject, TDetails = unknown>(tool: AgentTool<TSchema, TDetails>, hooks: ToolWrapHooks): AgentTool<TSchema, TDetails>;
+//# sourceMappingURL=wrap-tool.d.ts.map

package/dist/core/agent/wrap-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-tool.d.ts","sourceRoot":"","sources":["../../../src/core/agent/wrap-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,KAAK,EACV,SAAS,EAGT,aAAa,EACd,MAAM,SAAS,CAAA;AAEhB;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,OAAO,SAAU,OAAO,GAAG,OAAO,EAClC,QAAQ,GAAG,OAAO,EAElB,IAAI,EAAG,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,EACnC,KAAK,EAAE,aAAa,GACnB,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CA8B9B"}

package/dist/core/agent/wrap-tool.js

@@ -0,0 +1,37 @@
+/**
+ * Wrap an AgentTool with before/after hooks.
+ *
+ * - `before`: can block, modify input, or replace the result entirely
+ * - `after`: can partially override content, isError, and/or details
+ *
+ * Hooks are transparent to the agent loop — the loop only sees a plain AgentTool.
+ */
+export function wrapTool(tool, hooks) {
+    return {
+        ...tool,
+        execute: async (toolCallId, input, signal, onUpdate) => {
+            // ── before hook ──────────────────────────────────────────────────────
+            if (hooks.before) {
+                const before = await hooks.before(toolCallId, tool.name, input);
+                if (before?.action === 'block') {
+                    return { content: before.reason, isError: true };
+                }
+            }
+            // ── execute ──────────────────────────────────────────────────────────
+            let result = await tool.execute(toolCallId, input, signal, onUpdate);
+            // ── after hook ───────────────────────────────────────────────────────
+            if (hooks.after) {
+                const after = await hooks.after(toolCallId, tool.name, result);
+                if (after) {
+                    result = {
+                        content: after.content !== undefined ? after.content : result.content,
+                        isError: after.isError !== undefined ? after.isError : result.isError,
+                        details: after.details !== undefined ? after.details : result.details,
+                    };
+                }
+            }
+            return result;
+        },
+    };
+}
+//# sourceMappingURL=wrap-tool.js.map

package/dist/core/agent/wrap-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-tool.js","sourceRoot":"","sources":["../../../src/core/agent/wrap-tool.ts"],"names":[],"mappings":"AAQA;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAItB,IAAmC,EACnC,KAAoB;IAEpB,OAAO;QACL,GAAG,IAAI;QACP,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE;YACrD,wEAAwE;YACxE,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;gBAC/D,IAAI,MAAM,EAAE,MAAM,KAAK,OAAO,EAAE,CAAC;oBAC/B,OAAO,EAAE,OAAO,EAAG,MAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAA0B,CAAA;gBAC3F,CAAC;YACH,CAAC;YAED,wEAAwE;YACxE,IAAI,MAAM,GAAyB,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;YAE1F,wEAAwE;YACxE,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;gBAC9D,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,GAAG;wBACP,OAAO,EAAG,KAAK,CAAC,OAAO,KAAM,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC,CAAC,MAAM,CAAC,OAAO;wBACpF,OAAO,EAAG,KAAK,CAAC,OAAO,KAAM,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC,CAAC,MAAM,CAAC,OAAO;wBACpF,OAAO,EAAG,KAAK,CAAC,OAAO,KAAM,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAmB,CAAE,CAAC,CAAC,MAAM,CAAC,OAAO;qBACrF,CAAA;gBACH,CAAC;YACH,CAAC;YAED,OAAO,MAAM,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/core/kernel/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @module agent-kernel/kernel
+ *
+ * Public surface of the Kernel module. Exports all types, the createKernel factory,
+ * and session management utilities (listSessions, deleteSession, updateSessionMeta).
+ */
+export type { Usage, DataContent, TextPart, ImagePart, AudioPart, VideoPart, FilePart, ContentPart, ImageMediaType, AudioMediaType, VideoMediaType, FileMediaType, StopReason, ToolCallInfo, AgentEntry, AgentMessage, StoredEntry, AppendResult, CompactionEntry, TokenBudget, AgentKernel, KernelOptions, SessionMeta, } from './types';
+export { COMPACTION_TYPE } from './types';
+export { createKernel } from './kernel';
+export type { SessionInfo } from './session-store';
+export { listSessions, deleteSession, updateSessionMeta } from './session-store';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/kernel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/kernel/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,KAAK,EACL,WAAW,EACX,QAAQ,EACR,SAAS,EACT,SAAS,EACT,SAAS,EACT,QAAQ,EACR,WAAW,EACX,cAAc,EACd,cAAc,EACd,cAAc,EACd,aAAa,EACb,UAAU,EACV,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,eAAe,EACf,WAAW,EACX,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAEvC,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/core/kernel/index.js

@@ -0,0 +1,10 @@
+/**
+ * @module agent-kernel/kernel
+ *
+ * Public surface of the Kernel module. Exports all types, the createKernel factory,
+ * and session management utilities (listSessions, deleteSession, updateSessionMeta).
+ */
+export { COMPACTION_TYPE } from './types';
+export { createKernel } from './kernel';
+export { listSessions, deleteSession, updateSessionMeta } from './session-store';
+//# sourceMappingURL=index.js.map

package/dist/core/kernel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/kernel/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4BH,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAGvC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/core/kernel/kernel.d.ts

@@ -0,0 +1,15 @@
+import type { AgentKernel, KernelOptions } from './types';
+/**
+ * Kernel — conversation state manager and optional JSONL persistence layer.
+ *
+ * Maintains a linked tree of StoredEntry nodes (parentId → id) that models the
+ * full conversation history including branches and compaction. The "current branch"
+ * is the path from the root to _leafId.
+ *
+ * Two files are written per session:
+ *   - kernel.jsonl — current branch only (rewritten on compact)
+ *   - log.jsonl    — append-only full history (never compacted); for UI display
+ */
+/** Create a kernel. Pass options for file-backed persistence; omit for in-memory (tests). */
+export declare function createKernel(options?: KernelOptions): AgentKernel;
+//# sourceMappingURL=kernel.d.ts.map

package/dist/core/kernel/kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../../src/core/kernel/kernel.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,WAAW,EAKX,aAAa,EAId,MAAM,SAAS,CAAA;AAGhB;;;;;;;;;;GAUG;AAIH,6FAA6F;AAC7F,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,WAAW,CAEjE"}

package/dist/core/kernel/kernel.js

@@ -0,0 +1,320 @@
+import { readFileSync, appendFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { COMPACTION_TYPE } from './types';
+/**
+ * Kernel — conversation state manager and optional JSONL persistence layer.
+ *
+ * Maintains a linked tree of StoredEntry nodes (parentId → id) that models the
+ * full conversation history including branches and compaction. The "current branch"
+ * is the path from the root to _leafId.
+ *
+ * Two files are written per session:
+ *   - kernel.jsonl — current branch only (rewritten on compact)
+ *   - log.jsonl    — append-only full history (never compacted); for UI display
+ */
+// ─── Factory ──────────────────────────────────────────────────────────────────
+/** Create a kernel. Pass options for file-backed persistence; omit for in-memory (tests). */
+export function createKernel(options) {
+    return new Kernel(options);
+}
+// ─── Kernel implementation ────────────────────────────────────────────────────
+class Kernel {
+    /** All stored entries indexed by id — the in-memory conversation tree. */
+    byId = new Map();
+    /** Next id to assign on append. */
+    nextId = 0;
+    /** Input tokens from the most recent assistant entry (tracks context window usage). */
+    tokenUsed = 0;
+    /** Configurable context size cap; Infinity until the caller sets budget.set(). */
+    tokenLimit = Number.POSITIVE_INFINITY;
+    /** Absolute path to kernel.jsonl, or undefined when running in-memory. */
+    kernelPath;
+    /** Absolute path to log.jsonl, or undefined when running in-memory. */
+    logPath;
+    /** The id of the most recent entry on the current branch (the "tip"). */
+    _leafId = null;
+    budget;
+    constructor(options) {
+        if (options) {
+            const sessionDir = join(options.dir, options.sessionId);
+            mkdirSync(sessionDir, { recursive: true });
+            this.kernelPath = join(sessionDir, 'kernel.jsonl');
+            this.logPath = join(sessionDir, 'log.jsonl');
+            const metaPath = join(sessionDir, 'meta.json');
+            if (!existsSync(metaPath)) {
+                const meta = { createdAt: Date.now(), ...options.meta };
+                writeFileSync(metaPath, JSON.stringify(meta));
+            }
+            else if (options.meta && Object.keys(options.meta).length > 0) {
+                const existing = JSON.parse(readFileSync(metaPath, 'utf-8'));
+                writeFileSync(metaPath, JSON.stringify({ ...existing, ...options.meta }));
+            }
+        }
+        const kernel = this;
+        this.budget = {
+            get used() { return kernel.tokenUsed; },
+            get limit() { return kernel.tokenLimit; },
+            set(limit) { kernel.tokenLimit = limit; },
+        };
+        if (this.kernelPath && existsSync(this.kernelPath)) {
+            this.loadFromFile(this.kernelPath);
+        }
+    }
+    // ─── Log ──────────────────────────────────────────────────────────────────
+    /**
+     * Write an entry to the in-memory tree and (if configured) to both
+     * kernel.jsonl and log.jsonl. Advances the leaf pointer.
+     */
+    append(entry) {
+        const result = this.write(entry);
+        if (result.ok && this.logPath) {
+            appendFileSync(this.logPath, JSON.stringify(entry) + '\n');
+        }
+        return result;
+    }
+    /** Return all entries on the current branch in chronological order (root → leaf). */
+    read() {
+        if (this._leafId === null)
+            return [];
+        return this.walkBranch(this._leafId);
+    }
+    // ─── Compaction ──────────────────────────────────────────────────────────
+    /**
+     * Replace entries [fromId, toId] with a single summary entry.
+     * Writes a compaction marker to kernel.jsonl, materialises the summary in memory,
+     * then rewrites kernel.jsonl to contain only the current branch (no markers).
+     * Also appends the summary to log.jsonl as a divider.
+     */
+    compact(fromId, toId, summaryText) {
+        const summaryEntry = { type: 'summary', payload: { text: summaryText } };
+        const compactionEntry = {
+            type: COMPACTION_TYPE,
+            payload: { fromId, toId, summary: summaryEntry },
+        };
+        const result = this.writeCompaction(compactionEntry);
+        if (result.ok) {
+            this.materialize(fromId, toId, summaryEntry);
+            // Append summary divider to conversation log
+            if (this.logPath) {
+                appendFileSync(this.logPath, JSON.stringify(summaryEntry) + '\n');
+            }
+        }
+        return result;
+    }
+    // ─── Context size ─────────────────────────────────────────────────────────
+    get contextSize() {
+        const last = this.peek();
+        return last?.type === 'assistant' ? (last.usage?.input ?? 0) : 0;
+    }
+    // ─── Branch ───────────────────────────────────────────────────────────────
+    get leafId() {
+        return this._leafId;
+    }
+    peek() {
+        if (this._leafId === null)
+            return null;
+        return this.byId.get(this._leafId) ?? null;
+    }
+    branch(toId) {
+        if (!this.byId.has(toId)) {
+            throw new Error(`Entry ${toId} not found`);
+        }
+        this._leafId = toId;
+    }
+    // ─── Messages ─────────────────────────────────────────────────────────────
+    buildMessages() {
+        const messages = [];
+        for (const entry of this.read()) {
+            messages.push(...entryToMessages(entry));
+        }
+        return messages;
+    }
+    // ─── Conversation log ─────────────────────────────────────────────────────
+    readLog() {
+        if (!this.logPath || !existsSync(this.logPath))
+            return [];
+        const content = readFileSync(this.logPath, 'utf-8');
+        return content
+            .split('\n')
+            .filter(line => line.trim() !== '')
+            .map(line => JSON.parse(line));
+    }
+    // ─── Private ──────────────────────────────────────────────────────────────
+    /** Internal: assign id/parentId/timestamp, update byId and leafId, persist to kernel.jsonl. */
+    write(entry) {
+        const record = {
+            ...normalizeEntry(entry),
+            id: this.nextId++,
+            parentId: this._leafId,
+            timestamp: Date.now(),
+        };
+        this.byId.set(record.id, record);
+        this._leafId = record.id;
+        if (record.type === 'assistant' && record.usage?.input) {
+            this.tokenUsed = record.usage.input;
+        }
+        if (this.kernelPath) {
+            appendFileSync(this.kernelPath, JSON.stringify(record) + '\n');
+        }
+        return { ok: true, id: record.id };
+    }
+    /** Write a raw compaction marker record to kernel.jsonl and advance leafId. */
+    writeCompaction(entry) {
+        const record = {
+            ...entry,
+            id: this.nextId++,
+            parentId: this._leafId,
+            timestamp: Date.now(),
+        };
+        this._leafId = record.id;
+        if (this.kernelPath) {
+            appendFileSync(this.kernelPath, JSON.stringify(record) + '\n');
+        }
+        return { ok: true, id: record.id };
+    }
+    /**
+     * Apply a compaction in-memory: delete the compacted range from byId,
+     * insert the summary at the compaction slot, and rewrite kernel.jsonl
+     * to hold only the clean current branch.
+     */
+    materialize(fromId, toId, summary) {
+        const compactionId = this._leafId;
+        // The summary takes the place of the compacted range in the tree:
+        // its parentId is the parentId of the first compacted entry (fromId).
+        const rangeStartParentId = this.byId.get(fromId)?.parentId ?? null;
+        // Remove compacted entries from byId first
+        for (const [id] of this.byId) {
+            if (id >= fromId && id <= toId) {
+                this.byId.delete(id);
+            }
+        }
+        // Insert summary entry at compactionId, linking to what preceded the range
+        const compactionRecord = {
+            ...summary,
+            id: compactionId,
+            parentId: rangeStartParentId,
+            timestamp: Date.now(),
+        };
+        this.byId.set(compactionId, compactionRecord);
+        // Rewrite kernel file with current branch (clean, no compaction markers)
+        if (this.kernelPath) {
+            const branchPath = this.read();
+            writeFileSync(this.kernelPath, branchPath.map(e => JSON.stringify(e)).join('\n') + '\n');
+        }
+    }
+    /** Walk the parentId chain from `fromId` back to the root, returning entries root-first. */
+    walkBranch(fromId) {
+        const path = [];
+        let current = this.byId.get(fromId);
+        while (current) {
+            path.unshift(current);
+            current = current.parentId !== null ? this.byId.get(current.parentId) : undefined;
+        }
+        return path;
+    }
+    /** Replay kernel.jsonl on startup to restore the in-memory tree and leafId. */
+    loadFromFile(filePath) {
+        const content = readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n').filter(line => line.trim() !== '');
+        for (const line of lines) {
+            const record = JSON.parse(line);
+            this.byId.set(record.id, record);
+            this._leafId = record.id;
+            if (record.type === 'assistant' && record.usage?.input) {
+                this.tokenUsed = record.usage.input;
+            }
+            if (record.id >= this.nextId) {
+                this.nextId = record.id + 1;
+            }
+        }
+    }
+}
+// ─── entryToMessages ──────────────────────────────────────────────────────────
+/**
+ * Convert a single AgentEntry to zero or more provider-agnostic AgentMessages.
+ * Summary entries become user messages with a "[Context Summary]" prefix.
+ */
+function entryToMessages(entry) {
+    switch (entry.type) {
+        case 'user': {
+            const { parts } = entry.payload;
+            // Shorthand: single text part → string content
+            if (parts.length === 1 && parts[0].type === 'text') {
+                return [{ role: 'user', content: parts[0].text }];
+            }
+            return [{ role: 'user', content: parts }];
+        }
+        case 'assistant': {
+            const { text, reasoning, toolCalls } = entry.payload;
+            if (!reasoning && toolCalls.length === 0) {
+                return [{ role: 'assistant', content: text }];
+            }
+            const parts = [];
+            if (reasoning)
+                parts.push({ type: 'reasoning', text: reasoning });
+            if (text)
+                parts.push({ type: 'text', text });
+            for (const tc of toolCalls) {
+                parts.push({ type: 'tool-call', toolCallId: tc.toolCallId, toolName: tc.toolName, input: tc.input });
+            }
+            return [{ role: 'assistant', content: parts }];
+        }
+        case 'tool_result':
+            return [{
+                    role: 'tool',
+                    content: [{
+                            type: 'tool-result',
+                            toolCallId: entry.payload.toolCallId,
+                            toolName: entry.payload.toolName,
+                            content: entry.payload.content,
+                            isError: entry.payload.isError,
+                        }],
+                }];
+        case 'summary':
+            return [{ role: 'user', content: `[Context Summary]\n${entry.payload.text}` }];
+        default:
+            return [];
+    }
+}
+// ─── Serialization helpers ────────────────────────────────────────────────────
+/**
+ * Normalize a ContentPart for JSONL storage.
+ * Uint8Array / ArrayBuffer → base64 string. URL → href string.
+ */
+function normalizeContentPart(part) {
+    if (part.type === 'text')
+        return part;
+    if ('url' in part)
+        return part; // URL string stored as-is
+    return { ...part, data: normalizeData(part.data) };
+}
+/** Convert Uint8Array to base64; pass through strings unchanged. */
+function normalizeData(value) {
+    if (value instanceof Uint8Array)
+        return bufferToBase64(value);
+    return value; // already a base64 string
+}
+/** Encode raw bytes to a base64 string for JSONL storage. */
+function bufferToBase64(bytes) {
+    let binary = '';
+    for (let i = 0; i < bytes.byteLength; i++) {
+        binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary);
+}
+/**
+ * Normalize all ContentParts in a user or tool_result entry before persisting.
+ */
+function normalizeEntry(entry) {
+    if (entry.type === 'user') {
+        return { ...entry, payload: { parts: entry.payload.parts.map(normalizeContentPart) } };
+    }
+    if (entry.type === 'tool_result' && Array.isArray(entry.payload.content)) {
+        return {
+            ...entry,
+            payload: { ...entry.payload, content: entry.payload.content.map(normalizeContentPart) },
+        };
+    }
+    return entry;
+}
+//# sourceMappingURL=kernel.js.map

package/dist/core/kernel/kernel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.js","sourceRoot":"","sources":["../../../src/core/kernel/kernel.ts"],"names":[],"mappings":"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"}

package/dist/core/kernel/session-store.d.ts

@@ -0,0 +1,24 @@
+import type { SessionMeta } from './types';
+export type SessionInfo = {
+    sessionId: string;
+    updatedAt: number;
+    messageCount: number;
+    meta: SessionMeta | null;
+};
+/**
+ * List all sessions under `dir`, sorted by most recently updated first.
+ * Returns [] if `dir` does not exist or contains no sessions.
+ */
+export declare function listSessions(dir: string): SessionInfo[];
+/**
+ * Merge metadata fields into an existing session's meta.json.
+ * `createdAt` is protected and cannot be overwritten.
+ * Silent no-op if the session does not have a meta.json yet.
+ */
+export declare function updateSessionMeta(dir: string, sessionId: string, meta: Partial<Omit<SessionMeta, 'createdAt'>>): void;
+/**
+ * Delete a session directory and all its contents.
+ * Silent no-op if `dir` or `sessionId` does not exist.
+ */
+export declare function deleteSession(dir: string, sessionId: string): void;
+//# sourceMappingURL=session-store.d.ts.map

package/dist/core/kernel/session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../../src/core/kernel/session-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAI1C,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAK,MAAM,CAAA;IACpB,SAAS,EAAK,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAU,WAAW,GAAG,IAAI,CAAA;CACjC,CAAA;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CAyDvD;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAQ,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAO,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,GACjD,IAAI,CAKN;AAID;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAIlE"}

package/dist/core/kernel/session-store.js

@@ -0,0 +1,90 @@
+import { readdirSync, statSync, readFileSync, writeFileSync, rmSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+// ─── listSessions ─────────────────────────────────────────────────────────────
+/**
+ * List all sessions under `dir`, sorted by most recently updated first.
+ * Returns [] if `dir` does not exist or contains no sessions.
+ */
+export function listSessions(dir) {
+    if (!existsSync(dir))
+        return [];
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const sessions = [];
+    for (const sessionId of entries) {
+        const sessionDir = join(dir, sessionId);
+        const logPath = join(sessionDir, 'log.jsonl');
+        let stat;
+        try {
+            stat = statSync(sessionDir);
+            if (!stat.isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        if (!existsSync(logPath)) {
+            let meta = null;
+            const metaPath = join(sessionDir, 'meta.json');
+            if (existsSync(metaPath)) {
+                try {
+                    meta = JSON.parse(readFileSync(metaPath, 'utf-8'));
+                }
+                catch { }
+            }
+            sessions.push({ sessionId, updatedAt: stat.mtimeMs, messageCount: 0, meta });
+            continue;
+        }
+        let updatedAt = stat.mtimeMs;
+        let messageCount = 0;
+        try {
+            const logStat = statSync(logPath);
+            updatedAt = logStat.mtimeMs;
+            const content = readFileSync(logPath, 'utf-8');
+            messageCount = content.split('\n').filter(l => l.trim() !== '').length;
+        }
+        catch {
+            // Malformed log — still include the session with what we have
+        }
+        let meta = null;
+        const metaPath = join(sessionDir, 'meta.json');
+        if (existsSync(metaPath)) {
+            try {
+                meta = JSON.parse(readFileSync(metaPath, 'utf-8'));
+            }
+            catch { }
+        }
+        sessions.push({ sessionId, updatedAt, messageCount, meta });
+    }
+    return sessions.sort((a, b) => b.updatedAt - a.updatedAt);
+}
+// ─── updateSessionMeta ────────────────────────────────────────────────────────
+/**
+ * Merge metadata fields into an existing session's meta.json.
+ * `createdAt` is protected and cannot be overwritten.
+ * Silent no-op if the session does not have a meta.json yet.
+ */
+export function updateSessionMeta(dir, sessionId, meta) {
+    const metaPath = join(dir, sessionId, 'meta.json');
+    if (!existsSync(metaPath))
+        return;
+    const existing = JSON.parse(readFileSync(metaPath, 'utf-8'));
+    writeFileSync(metaPath, JSON.stringify({ ...existing, ...meta }));
+}
+// ─── deleteSession ────────────────────────────────────────────────────────────
+/**
+ * Delete a session directory and all its contents.
+ * Silent no-op if `dir` or `sessionId` does not exist.
+ */
+export function deleteSession(dir, sessionId) {
+    const sessionDir = join(dir, sessionId);
+    if (!existsSync(sessionDir))
+        return;
+    rmSync(sessionDir, { recursive: true, force: true });
+}
+//# sourceMappingURL=session-store.js.map

package/dist/core/kernel/session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../../src/core/kernel/session-store.ts"],"names":[],"mappings":"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"}