@vinhnt-sdk/core 0.1.0

package/dist/session/null-store.js

@@ -0,0 +1,78 @@
+const nullSessionId = "null-session";
+const nullForkSessionId = "null-session-fork";
+const nullMessageId = "null-message";
+export class NullRunEventStore {
+    listeners = new Set();
+    events = [];
+    async append(event) {
+        if (event.persist === false)
+            return;
+        this.events.push(event);
+        for (const listener of this.listeners)
+            listener(event);
+    }
+    async list(_runId, _afterSequence) {
+        return [];
+    }
+    async saveSnapshot(_runId, _state) { }
+    async getSnapshot(_runId) {
+        return null;
+    }
+    async getSnapshotAfterSequence(_runId, _sequence) {
+        return null;
+    }
+    async getNextSequence(_aggregateId) {
+        return 1;
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+}
+export class NullSessionStore {
+    async createSession(_title, _parentSessionId) {
+        return {
+            id: nullSessionId,
+            title: _title ?? "New Session",
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            isActive: true,
+        };
+    }
+    async forkSession(_sourceSessionId, _title) {
+        return {
+            id: nullForkSessionId,
+            title: _title ?? "New Session",
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            isActive: true,
+        };
+    }
+    async getSession(_id) {
+        return null;
+    }
+    async listSessions(_limit, _offset) {
+        return [];
+    }
+    async updateSession(_id, _updates) { }
+    async deleteSession(_id) { }
+    async addMessage(_sessionId, _role, _content, _toolCallId, _tokens, _model, _cost) {
+        return {
+            id: nullMessageId,
+            sessionId: _sessionId,
+            role: _role,
+            content: _content,
+            createdAt: new Date().toISOString(),
+        };
+    }
+    async listMessages(_sessionId) {
+        return [];
+    }
+    async searchMessages(_query, _limit) {
+        return [];
+    }
+    async getSessionStats() {
+        return { totalSessions: 0, totalMessages: 0, totalCost: 0, totalInputTokens: 0, totalOutputTokens: 0, sessionsByDate: [], costByModel: [] };
+    }
+}
+//# sourceMappingURL=null-store.js.map

package/dist/session/null-store.js.map

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

package/dist/session/run-coordinator.d.ts

@@ -0,0 +1,52 @@
+import type { RunId, Session, RequestContext, Result, AgentConfig } from "@vinhnt-sdk/schema";
+import type { MessageContentPart } from "../model.js";
+import type { SessionStore } from "../session/store.js";
+import type { SessionTree } from "../session/session-tree.js";
+import { AgentKernel, type RunState } from "../kernel/kernel.js";
+import { KernelError } from "../kernel/kernel.js";
+export type SessionEventType = "session.created" | "session.switched" | "session.closed" | "session.forked" | "run.started" | "run.state_changed";
+export type SessionEvent = {
+    type: SessionEventType;
+    sessionId: string;
+    runId?: string;
+    data: unknown;
+};
+/** Interface for run management — allows swapping kernel implementations. */
+export interface RunHandler {
+    runSafe(prompt: string, ctx: RequestContext, sessionId?: string, userContentParts?: readonly MessageContentPart[]): Result<{
+        runId: RunId;
+        abort(): void;
+        completed: Promise<void>;
+    }, KernelError>;
+    cancelCurrentRun(): void;
+    sendInput(runId: RunId, text: string): void;
+    getRunState(runId: RunId): RunState | undefined;
+    setCurrentAgent(agent: AgentConfig): void;
+    onRunStateChange(listener: (runId: string, state: string) => void): () => void;
+}
+export declare class SessionRunCoordinator {
+    private readonly handler;
+    private readonly sessionStore;
+    private readonly sessionTree?;
+    private activeSession;
+    private activeRunId;
+    private readonly eventListeners;
+    private unsubRunState;
+    constructor(handler: RunHandler, sessionStore: SessionStore, sessionTree?: SessionTree | undefined);
+    get currentSession(): Session | null;
+    get currentRunId(): RunId | null;
+    get runState(): RunState | undefined;
+    onEvent(listener: (event: SessionEvent) => void): () => void;
+    private emit;
+    listSessions(limit?: number, offset?: number): Promise<readonly Session[]>;
+    getSession(id: string): Promise<Session | null>;
+    createSession(title?: string): Promise<Session>;
+    forkSession(title?: string): Promise<Session | null>;
+    switchSession(id: string): Promise<Session | null>;
+    startRun(prompt: string, ctx: RequestContext, agent?: AgentConfig, userContentParts?: readonly MessageContentPart[]): Promise<Result<RunId, KernelError>>;
+    sendInput(text: string): Promise<void>;
+    cancelRun(): void;
+}
+/** Adapter: wraps AgentKernel as a RunHandler for backward compatibility. */
+export declare function kernelAsRunHandler(kernel: AgentKernel): RunHandler;
+//# sourceMappingURL=run-coordinator.d.ts.map

package/dist/session/run-coordinator.d.ts.map

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

package/dist/session/run-coordinator.js

@@ -0,0 +1,127 @@
+import { KernelError } from "../kernel/kernel.js";
+export class SessionRunCoordinator {
+    handler;
+    sessionStore;
+    sessionTree;
+    activeSession = null;
+    activeRunId = null;
+    eventListeners = new Set();
+    unsubRunState = null;
+    constructor(handler, sessionStore, sessionTree) {
+        this.handler = handler;
+        this.sessionStore = sessionStore;
+        this.sessionTree = sessionTree;
+    }
+    get currentSession() {
+        return this.activeSession;
+    }
+    get currentRunId() {
+        return this.activeRunId;
+    }
+    get runState() {
+        return this.activeRunId ? this.handler.getRunState(this.activeRunId) : undefined;
+    }
+    onEvent(listener) {
+        this.eventListeners.add(listener);
+        return () => { this.eventListeners.delete(listener); };
+    }
+    emit(event) {
+        for (const listener of this.eventListeners) {
+            try {
+                listener(event);
+            }
+            catch { /* isolated */ }
+        }
+    }
+    async listSessions(limit = 50, offset = 0) {
+        return this.sessionStore.listSessions(limit, offset);
+    }
+    async getSession(id) {
+        return this.sessionStore.getSession(id);
+    }
+    async createSession(title) {
+        const session = await this.sessionStore.createSession(title);
+        this.activeSession = session;
+        this.sessionTree?.add(session.id, session.title);
+        this.emit({ type: "session.created", sessionId: session.id, data: { title: session.title } });
+        return session;
+    }
+    async forkSession(title) {
+        if (!this.activeSession)
+            return null;
+        const parentSession = this.activeSession;
+        const session = await this.sessionStore.forkSession(parentSession.id, title);
+        this.activeSession = session;
+        this.sessionTree?.add(session.id, session.title, parentSession.id);
+        this.emit({ type: "session.forked", sessionId: session.id, data: { parentId: parentSession.id, title: session.title } });
+        return session;
+    }
+    async switchSession(id) {
+        const session = await this.sessionStore.getSession(id);
+        if (!session)
+            return null;
+        this.activeSession = session;
+        this.sessionTree?.setActive(session.id);
+        this.emit({ type: "session.switched", sessionId: session.id, data: { title: session.title } });
+        return session;
+    }
+    async startRun(prompt, ctx, agent, userContentParts) {
+        if (this.activeRunId) {
+            return { ok: false, error: new KernelError("session_busy", "A run is already active in this session — cancel first") };
+        }
+        this.activeRunId = "pending";
+        let session = this.activeSession;
+        if (!session) {
+            session = await this.sessionStore.createSession();
+            this.activeSession = session;
+            this.sessionTree?.add(session.id, session.title);
+            this.emit({ type: "session.created", sessionId: session.id, data: { title: session.title } });
+        }
+        if (agent)
+            this.handler.setCurrentAgent(agent);
+        const handleResult = this.handler.runSafe(prompt, ctx, session.id, userContentParts);
+        if (!handleResult.ok) {
+            this.activeRunId = null;
+            return handleResult;
+        }
+        const handle = handleResult.value;
+        this.activeRunId = handle.runId;
+        this.emit({ type: "run.started", sessionId: session.id, runId: handle.runId, data: { prompt } });
+        const unsub = this.handler.onRunStateChange((runId, state) => {
+            if (runId === this.activeRunId) {
+                this.emit({ type: "run.state_changed", sessionId: session.id, runId, data: { state } });
+            }
+        });
+        this.unsubRunState?.();
+        this.unsubRunState = unsub;
+        handle.completed.finally(() => {
+            this.activeRunId = null;
+            unsub();
+            if (this.unsubRunState === unsub) {
+                this.unsubRunState = null;
+            }
+        });
+        return { ok: true, value: handle.runId };
+    }
+    async sendInput(text) {
+        if (this.activeRunId) {
+            this.handler.sendInput(this.activeRunId, text);
+        }
+    }
+    cancelRun() {
+        this.handler.cancelCurrentRun();
+        // activeRunId is nullified by handle.completed.finally to avoid race
+    }
+}
+/** Adapter: wraps AgentKernel as a RunHandler for backward compatibility. */
+export function kernelAsRunHandler(kernel) {
+    return {
+        runSafe: (prompt, ctx, sessionId, userContentParts) => kernel.runSafe(prompt, ctx, sessionId, userContentParts),
+        cancelCurrentRun: () => kernel.cancelCurrentRun(),
+        sendInput: (runId, text) => kernel.sendInput(runId, text),
+        getRunState: (runId) => kernel.getRunState(runId),
+        setCurrentAgent: (agent) => kernel.setCurrentAgent(agent),
+        onRunStateChange: (listener) => kernel.onRunStateChange(listener),
+    };
+}
+//# sourceMappingURL=run-coordinator.js.map

package/dist/session/run-coordinator.js.map

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

package/dist/session/session-state.d.ts

@@ -0,0 +1,37 @@
+import type { ChatMessage } from "../model.js";
+/** Runtime state of an active agent session */
+export interface SessionRuntimeState {
+    /** Ordered conversation messages for model context */
+    readonly messages: readonly ChatMessage[];
+    /** Active context sources as key-value pairs */
+    readonly context: ReadonlyMap<string, unknown>;
+    /** Current step count in the kernel loop */
+    step: number;
+    /** Cumulative tool calls in this run */
+    toolCallCount: number;
+    /** Whether the session is currently executing */
+    isRunning: boolean;
+    /** Append a message to conversation history */
+    pushMessage(msg: ChatMessage): void;
+    /** Replace the entire message list (e.g. after compaction) */
+    resetMessages(msgs: readonly ChatMessage[]): void;
+    /** Set a context value */
+    setContext(key: string, value: unknown): void;
+    /** Clear all context values */
+    clearContext(): void;
+    /** Snapshot current state for serialisation */
+    snapshot(): SessionRuntimeSnapshot;
+    /** Restore from snapshot */
+    restore(snapshot: SessionRuntimeSnapshot): void;
+    /** Create an independent copy for parallel sub-agent execution */
+    fork(): SessionRuntimeState;
+}
+/** Serializable snapshot of SessionRuntimeState */
+export interface SessionRuntimeSnapshot {
+    messages: readonly ChatMessage[];
+    context: Record<string, unknown>;
+    step: number;
+    toolCallCount: number;
+    isRunning: boolean;
+}
+//# sourceMappingURL=session-state.d.ts.map

package/dist/session/session-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.d.ts","sourceRoot":"","sources":["../../src/session/session-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAC;IAEnB,+CAA+C;IAC/C,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACpC,8DAA8D;IAC9D,aAAa,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,GAAG,IAAI,CAAC;IAClD,0BAA0B;IAC1B,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9C,+BAA+B;IAC/B,YAAY,IAAI,IAAI,CAAC;IACrB,+CAA+C;IAC/C,QAAQ,IAAI,sBAAsB,CAAC;IACnC,4BAA4B;IAC5B,OAAO,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAChD,kEAAkE;IAClE,IAAI,IAAI,mBAAmB,CAAC;CAC7B;AAED,mDAAmD;AACnD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB"}

package/dist/session/session-state.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-state.js.map

package/dist/session/session-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.js","sourceRoot":"","sources":["../../src/session/session-state.ts"],"names":[],"mappings":""}

package/dist/session/session-tree.d.ts

@@ -0,0 +1,34 @@
+import type { SessionId, SessionNode, SessionTreeSnapshot, SessionTreeEvent } from "@vinhnt-sdk/schema";
+export interface SessionTree {
+    add(sessionId: SessionId, title: string, parentId?: SessionId): void;
+    remove(sessionId: SessionId): void;
+    move(sessionId: SessionId, newParentId?: SessionId): void;
+    get(sessionId: SessionId): SessionNode | undefined;
+    getChildren(sessionId: SessionId): readonly SessionNode[];
+    getAncestors(sessionId: SessionId): readonly SessionNode[];
+    getRoots(): readonly SessionNode[];
+    getSnapshot(): SessionTreeSnapshot;
+    setActive(sessionId: SessionId): void;
+    setTitle(sessionId: SessionId, title: string): void;
+    onEvent(listener: (event: SessionTreeEvent) => void): () => void;
+}
+export declare class InMemorySessionTree implements SessionTree {
+    private readonly nodes;
+    private readonly listeners;
+    private activeId;
+    add(sessionId: SessionId, title: string, parentId?: SessionId): void;
+    remove(sessionId: SessionId): void;
+    move(sessionId: SessionId, newParentId?: SessionId): void;
+    get(sessionId: SessionId): SessionNode | undefined;
+    getChildren(sessionId: SessionId): readonly SessionNode[];
+    getAncestors(sessionId: SessionId): readonly SessionNode[];
+    getRoots(): readonly SessionNode[];
+    getSnapshot(): SessionTreeSnapshot;
+    setActive(sessionId: SessionId): void;
+    setTitle(sessionId: SessionId, title: string): void;
+    onEvent(listener: (event: SessionTreeEvent) => void): () => void;
+    private toNode;
+    private isDescendant;
+    private emit;
+}
+//# sourceMappingURL=session-tree.d.ts.map

package/dist/session/session-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tree.d.ts","sourceRoot":"","sources":["../../src/session/session-tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAExG,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACrE,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IACnC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC1D,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IACnD,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,WAAW,EAAE,CAAC;IAC1D,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,WAAW,EAAE,CAAC;IAC3D,QAAQ,IAAI,SAAS,WAAW,EAAE,CAAC;IACnC,WAAW,IAAI,mBAAmB,CAAC;IACnC,SAAS,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACpD,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAClE;AAWD,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmC;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgD;IAC1E,OAAO,CAAC,QAAQ,CAA0B;IAE1C,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,SAAS,GAAG,IAAI;IAwBpE,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAyBlC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,SAAS,GAAG,IAAI;IAyBzD,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS;IAMlD,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,WAAW,EAAE;IAMzD,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,WAAW,EAAE;IAY1D,QAAQ,IAAI,SAAS,WAAW,EAAE;IAMlC,WAAW,IAAI,mBAAmB;IAoBlC,SAAS,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAcrC,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOnD,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI;IAKhE,OAAO,CAAC,MAAM;IAed,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,IAAI;CAKb"}

package/dist/session/session-tree.js

@@ -0,0 +1,171 @@
+export class InMemorySessionTree {
+    nodes = new Map();
+    listeners = new Set();
+    activeId = null;
+    add(sessionId, title, parentId) {
+        if (this.nodes.has(sessionId))
+            return;
+        if (parentId && !this.nodes.has(parentId)) {
+            return; // Parent doesn't exist
+        }
+        this.nodes.set(sessionId, {
+            id: sessionId,
+            title,
+            parentId,
+            children: [],
+            isActive: false,
+            createdAt: Date.now(),
+        });
+        if (parentId) {
+            const parent = this.nodes.get(parentId);
+            parent.children.push(sessionId);
+        }
+        this.emit({ type: "node.added", sessionId, data: { title, parentId } });
+    }
+    remove(sessionId) {
+        const node = this.nodes.get(sessionId);
+        if (!node)
+            return;
+        // Remove from parent
+        if (node.parentId) {
+            const parent = this.nodes.get(node.parentId);
+            if (parent) {
+                parent.children = parent.children.filter((id) => id !== sessionId);
+            }
+        }
+        // Recursively remove children
+        for (const childId of [...node.children]) {
+            this.remove(childId);
+        }
+        this.nodes.delete(sessionId);
+        if (this.activeId === sessionId) {
+            this.activeId = null;
+        }
+        this.emit({ type: "node.removed", sessionId, data: {} });
+    }
+    move(sessionId, newParentId) {
+        const node = this.nodes.get(sessionId);
+        if (!node)
+            return;
+        if (newParentId && !this.nodes.has(newParentId))
+            return;
+        if (newParentId === sessionId)
+            return;
+        if (newParentId && this.isDescendant(sessionId, newParentId))
+            return; // Cycle guard
+        // Remove from old parent
+        if (node.parentId) {
+            const parent = this.nodes.get(node.parentId);
+            if (parent) {
+                parent.children = parent.children.filter((id) => id !== sessionId);
+            }
+        }
+        // Add to new parent
+        node.parentId = newParentId;
+        if (newParentId) {
+            const newParent = this.nodes.get(newParentId);
+            newParent.children.push(sessionId);
+        }
+        this.emit({ type: "node.moved", sessionId, data: { newParentId } });
+    }
+    get(sessionId) {
+        const node = this.nodes.get(sessionId);
+        if (!node)
+            return undefined;
+        return this.toNode(node);
+    }
+    getChildren(sessionId) {
+        const node = this.nodes.get(sessionId);
+        if (!node)
+            return [];
+        return node.children.map((id) => this.nodes.get(id)).filter(Boolean).map((n) => this.toNode(n));
+    }
+    getAncestors(sessionId) {
+        const ancestors = [];
+        let current = this.nodes.get(sessionId);
+        while (current?.parentId) {
+            const parent = this.nodes.get(current.parentId);
+            if (!parent)
+                break;
+            ancestors.unshift(this.toNode(parent));
+            current = parent;
+        }
+        return ancestors;
+    }
+    getRoots() {
+        return [...this.nodes.values()]
+            .filter((n) => !n.parentId)
+            .map((n) => this.toNode(n));
+    }
+    getSnapshot() {
+        const roots = this.getRoots();
+        const all = [];
+        const stack = [...roots];
+        while (stack.length > 0) {
+            const node = stack.pop();
+            all.push(node);
+            for (let i = node.children.length - 1; i >= 0; i--) {
+                stack.push(node.children[i]);
+            }
+        }
+        return {
+            rootId: roots.length === 1 ? roots[0].id : null,
+            nodes: all,
+            activeSessionId: this.activeId,
+        };
+    }
+    setActive(sessionId) {
+        if (!this.nodes.has(sessionId))
+            return;
+        // Deactivate all
+        for (const node of this.nodes.values()) {
+            node.isActive = false;
+        }
+        this.nodes.get(sessionId).isActive = true;
+        this.activeId = sessionId;
+        this.emit({ type: "node.activated", sessionId, data: {} });
+    }
+    setTitle(sessionId, title) {
+        const node = this.nodes.get(sessionId);
+        if (!node)
+            return;
+        node.title = title;
+        this.emit({ type: "node.title_changed", sessionId, data: { title } });
+    }
+    onEvent(listener) {
+        this.listeners.add(listener);
+        return () => { this.listeners.delete(listener); };
+    }
+    toNode(node, _depth = 0) {
+        const children = node.children
+            .map((id) => this.nodes.get(id))
+            .filter((n) => !!n);
+        return {
+            id: node.id,
+            title: node.title,
+            ...(node.parentId !== undefined ? { parentId: node.parentId } : {}),
+            children: children.map((n) => this.toNode(n, _depth + 1)),
+            isActive: node.isActive,
+            createdAt: node.createdAt,
+            depth: _depth,
+        };
+    }
+    isDescendant(ancestorId, candidateId) {
+        let current = this.nodes.get(candidateId);
+        while (current?.parentId) {
+            if (current.parentId === ancestorId)
+                return true;
+            current = this.nodes.get(current.parentId);
+        }
+        return false;
+    }
+    emit(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch { /* isolated */ }
+        }
+    }
+}
+//# sourceMappingURL=session-tree.js.map

package/dist/session/session-tree.js.map

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

package/dist/session/store.d.ts

@@ -0,0 +1,45 @@
+import type { RunEvent, Session, Message, SessionStats } from "@vinhnt-sdk/schema";
+export interface RunEventSnapshot {
+    readonly runId: string;
+    readonly sequence: number;
+    readonly state: Record<string, unknown>;
+    readonly occurredAt: string;
+}
+export type RunEventListener = (event: RunEvent) => void;
+export type SessionUpdates = Partial<Pick<Session, "title" | "isActive" | "model" | "cost" | "inputTokens" | "outputTokens" | "location" | "agentId">>;
+export interface RunEventStore {
+    append(event: RunEvent): Promise<void>;
+    /**
+     * Append an event and apply session updates atomically (in a DB transaction when available).
+     * Falls back to sequential execution if the store doesn't support transactions.
+     */
+    appendTransactional?(event: RunEvent, sessionUpdate?: {
+        sessionId: string;
+        updates: SessionUpdates;
+    }): Promise<void>;
+    /** Check if an event with the given ID already exists (idempotency guard). */
+    exists?(eventId: string): Promise<boolean>;
+    list(runId: string, afterSequence?: number): Promise<readonly RunEvent[]>;
+    getNextSequence(aggregateId: string): Promise<number>;
+    saveSnapshot(runId: string, state: Record<string, unknown>): Promise<void>;
+    getSnapshot(runId: string): Promise<RunEventSnapshot | null>;
+    getSnapshotAfterSequence(runId: string, sequence: number): Promise<RunEventSnapshot | null>;
+    subscribe(listener: RunEventListener): () => void;
+}
+export interface SessionStore {
+    createSession(title?: string, parentSessionId?: string): Promise<Session>;
+    forkSession(sourceSessionId: string, title?: string): Promise<Session>;
+    getSession(id: string): Promise<Session | null>;
+    listSessions(limit?: number, offset?: number): Promise<readonly Session[]>;
+    updateSession(id: string, updates: SessionUpdates): Promise<void>;
+    deleteSession(id: string): Promise<void>;
+    addMessage(sessionId: string, role: string, content: string, toolCallId?: string, tokens?: {
+        input: number;
+        output: number;
+        reasoning?: number;
+    }, model?: string, cost?: number): Promise<Message>;
+    listMessages(sessionId: string): Promise<readonly Message[]>;
+    searchMessages(query: string, limit?: number): Promise<readonly Message[]>;
+    getSessionStats(): Promise<SessionStats>;
+}
+//# sourceMappingURL=store.d.ts.map

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

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

package/dist/session/store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=store.js.map

package/dist/session/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/session/store.ts"],"names":[],"mappings":""}

package/dist/session/title.d.ts

@@ -0,0 +1,7 @@
+import type { ModelProvider } from "../model.js";
+export declare const TITLE_INPUT_TRUNCATION = 200;
+export declare const TITLE_MAX_TOKENS = 30;
+export declare const TITLE_OUTPUT_TRUNCATION = 80;
+export declare const TITLE_SYSTEM_PROMPT = "Generate a concise session title (max 8 words) from this user message. Respond with ONLY the title, no quotes, no punctuation.";
+export declare function createDefaultSessionTitleGenerator(model: ModelProvider): (prompt: string) => Promise<string>;
+//# sourceMappingURL=title.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"title.d.ts","sourceRoot":"","sources":["../../src/session/title.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,mBAAmB,mIAAmI,CAAC;AAEpK,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,aAAa,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAgB5G"}