@zelari/core 1.48.1 → 2.0.0-alpha.2

package/dist/session/exportSession.js

@@ -0,0 +1,37 @@
+/**
+ * session/exportSession.ts — portable, machine-readable session export.
+ *
+ * The export embeds the full event log plus a compact summary; it requires
+ * no lock and is safe to produce from a crashed/interrupted session.
+ */
+import { buildProjection } from './replay.js';
+export const SESSION_EXPORT_FORMAT = 'zelari-session-export';
+export const SESSION_EXPORT_VERSION = 1;
+export async function exportSession(store, sessionId) {
+    const report = await store.read(sessionId);
+    const projection = buildProjection(report.events, report.issues);
+    return {
+        format: SESSION_EXPORT_FORMAT,
+        version: SESSION_EXPORT_VERSION,
+        sessionId,
+        exportedAt: Date.now(),
+        summary: {
+            lastSeq: projection.lastSeq,
+            eventCount: projection.eventCount,
+            startedAt: projection.startedAt,
+            endedAt: projection.endedAt,
+            forkParent: projection.fork?.parentSessionId,
+            toolCalls: projection.toolCalls,
+            toolResults: projection.toolResults,
+            verifications: projection.verifications.length,
+            issues: report.issues.length,
+        },
+        events: report.events,
+    };
+}
+/** Pretty-printed JSON export (headless `--session-export` output). */
+export async function exportSessionJson(store, sessionId) {
+    const exported = await exportSession(store, sessionId);
+    return JSON.stringify(exported, null, 2);
+}
+//# sourceMappingURL=exportSession.js.map

package/dist/session/exportSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exportSession.js","sourceRoot":"","sources":["../../src/session/exportSession.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAC7D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAqBxC,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAmB,EAAE,SAAiB;IACxE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACjE,OAAO;QACL,MAAM,EAAE,qBAAqB;QAC7B,OAAO,EAAE,sBAAsB;QAC/B,SAAS;QACT,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;QACtB,OAAO,EAAE;YACP,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,UAAU,EAAE,UAAU,CAAC,UAAU;YACjC,SAAS,EAAE,UAAU,CAAC,SAAS;YAC/B,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,UAAU,EAAE,UAAU,CAAC,IAAI,EAAE,eAAe;YAC5C,SAAS,EAAE,UAAU,CAAC,SAAS;YAC/B,WAAW,EAAE,UAAU,CAAC,WAAW;YACnC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,MAAM;YAC9C,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;SAC7B;QACD,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAmB,EAAE,SAAiB;IAC5E,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC"}

package/dist/session/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @zelari/core/session — the session spine (ADR-0016/0021).
+ *
+ * Append-only JSONL log, single writer with ownership lock, tolerant replay,
+ * deriveMessages as the only model-history path, fork/resume lineage and
+ * portable export.
+ */
+export * from './types.js';
+export * from './modelSurface.js';
+export * from './writer.js';
+export * from './replay.js';
+export * from './store.js';
+export * from './lineage.js';
+export * from './exportSession.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/dist/session/index.js

@@ -0,0 +1,15 @@
+/**
+ * @zelari/core/session — the session spine (ADR-0016/0021).
+ *
+ * Append-only JSONL log, single writer with ownership lock, tolerant replay,
+ * deriveMessages as the only model-history path, fork/resume lineage and
+ * portable export.
+ */
+export * from './types.js';
+export * from './modelSurface.js';
+export * from './writer.js';
+export * from './replay.js';
+export * from './store.js';
+export * from './lineage.js';
+export * from './exportSession.js';
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/dist/session/lineage.d.ts

@@ -0,0 +1,38 @@
+/**
+ * session/lineage.ts — fork / resume on top of the spine.
+ *
+ * Fork copies the parent trajectory up to `fromSeq` into a NEW session
+ * (re-sequenced 1..n; kinds/actors/data preserved verbatim, timestamps
+ * re-stamped by the writer) and appends `session.forked {parentSessionId,
+ * parentSeq}`. Resume reopens the log and appends `session.resumed`. Resume
+ * fidelity is deterministic on the trajectory plane: same events → same
+ * projection.
+ */
+import { type SessionProjection } from './replay.js';
+import type { SessionStore } from './store.js';
+import type { SessionLogWriter } from './writer.js';
+export interface ForkOptions {
+    /** Copy events with seq <= fromSeq (default: all). */
+    fromSeq?: number;
+    reason?: string;
+}
+export interface ForkResult {
+    sessionId: string;
+    writer: SessionLogWriter;
+    copiedEvents: number;
+}
+/** Fork a session into a new one, preserving the trajectory up to fromSeq. */
+export declare function forkSession(store: SessionStore, parentSessionId: string, options?: ForkOptions): Promise<ForkResult>;
+export interface ResumeResult {
+    writer: SessionLogWriter;
+    /** Projection including the `session.resumed` marker. */
+    projection: SessionProjection;
+}
+/** Resume a session: reopen the log (seq continues) and mark the resume. */
+export declare function resumeSession(store: SessionStore, sessionId: string): Promise<ResumeResult>;
+/**
+ * Ancestor chain of a session (root first). Walks `session.forked` markers
+ * across the store; stops on cycles or missing parents.
+ */
+export declare function lineageOf(store: SessionStore, sessionId: string): Promise<string[]>;
+//# sourceMappingURL=lineage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lineage.d.ts","sourceRoot":"","sources":["../../src/session/lineage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,8EAA8E;AAC9E,wBAAsB,WAAW,CAC/B,KAAK,EAAE,YAAY,EACnB,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAiBrB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,gBAAgB,CAAC;IACzB,yDAAyD;IACzD,UAAU,EAAE,iBAAiB,CAAC;CAC/B;AAED,4EAA4E;AAC5E,wBAAsB,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CASjG;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAkBzF"}

package/dist/session/lineage.js

@@ -0,0 +1,69 @@
+/**
+ * session/lineage.ts — fork / resume on top of the spine.
+ *
+ * Fork copies the parent trajectory up to `fromSeq` into a NEW session
+ * (re-sequenced 1..n; kinds/actors/data preserved verbatim, timestamps
+ * re-stamped by the writer) and appends `session.forked {parentSessionId,
+ * parentSeq}`. Resume reopens the log and appends `session.resumed`. Resume
+ * fidelity is deterministic on the trajectory plane: same events → same
+ * projection.
+ */
+import { ACTOR_SYSTEM } from './types.js';
+import { buildProjection } from './replay.js';
+/** Fork a session into a new one, preserving the trajectory up to fromSeq. */
+export async function forkSession(store, parentSessionId, options = {}) {
+    const parent = await store.read(parentSessionId);
+    if (parent.events.length === 0 && parent.issues.length === 0) {
+        throw new Error(`Cannot fork — session not found: ${parentSessionId}`);
+    }
+    const fromSeq = options.fromSeq ?? parent.events[parent.events.length - 1]?.seq ?? 0;
+    const copied = parent.events.filter((e) => e.seq <= fromSeq);
+    const created = await store.create({ reason: options.reason ?? 'fork' });
+    for (const e of copied) {
+        await created.writer.append({ kind: e.kind, actor: e.actor, data: e.data });
+    }
+    await created.writer.append({
+        kind: 'session.forked',
+        actor: ACTOR_SYSTEM,
+        data: { parentSessionId, parentSeq: fromSeq },
+    });
+    return { sessionId: created.sessionId, writer: created.writer, copiedEvents: copied.length };
+}
+/** Resume a session: reopen the log (seq continues) and mark the resume. */
+export async function resumeSession(store, sessionId) {
+    const opened = await store.open(sessionId);
+    const resumed = await opened.writer.append({
+        kind: 'session.resumed',
+        actor: ACTOR_SYSTEM,
+        data: { fromSeq: opened.projection.lastSeq },
+    });
+    const projection = buildProjection([...opened.report.events, resumed]);
+    return { writer: opened.writer, projection };
+}
+/**
+ * Ancestor chain of a session (root first). Walks `session.forked` markers
+ * across the store; stops on cycles or missing parents.
+ */
+export async function lineageOf(store, sessionId) {
+    const chain = [sessionId];
+    const seen = new Set([sessionId]);
+    let current = sessionId;
+    for (let depth = 0; depth < 64; depth++) {
+        const report = await store.read(current);
+        const forkEvent = [...report.events]
+            .reverse()
+            .find((e) => e.kind === 'session.forked');
+        if (!forkEvent)
+            break;
+        const parent = typeof forkEvent.data.parentSessionId === 'string' ? forkEvent.data.parentSessionId : '';
+        if (!parent || seen.has(parent))
+            break;
+        if (!(await store.exists(parent)))
+            break;
+        chain.unshift(parent);
+        seen.add(parent);
+        current = parent;
+    }
+    return chain;
+}
+//# sourceMappingURL=lineage.js.map

package/dist/session/lineage.js.map

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

package/dist/session/modelSurface.d.ts

@@ -0,0 +1,43 @@
+/**
+ * session/modelSurface.ts — the ONLY path from session events to model history.
+ *
+ * `isModelSurfaceEvent` decides what counts as model-visible; `deriveMessages`
+ * projects surface events into a provider-neutral message list. The CLI maps
+ * these onto its provider-specific request format — nothing else may invent
+ * model-visible history (ADR-0016 invariant: model-visible ⟺ logged).
+ */
+import type { SessionEventEnvelope, SessionEventKind } from './types.js';
+/** Event kinds that (may) feed the model input. Everything else is state. */
+export declare const MODEL_SURFACE_KINDS: ReadonlySet<SessionEventKind>;
+export declare function isModelSurfaceEvent(event: {
+    kind: string;
+}): boolean;
+/** Provider-neutral derived message with provenance (source event seq). */
+export interface DerivedMessage {
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content: string;
+    /** Present for tool results (and tool calls when includeToolCalls). */
+    toolCallId?: string;
+    toolName?: string;
+    isError?: boolean;
+    /** Seq of the source envelope — provenance for audit/replay. */
+    seq: number;
+}
+export interface DeriveMessagesOptions {
+    /**
+     * Emit tool.call events as assistant messages (JSON-encoded args). Default
+     * false: the neutral history pairs calls via tool.result only; providers
+     * that need explicit call blocks build them from pairToolCalls().
+     */
+    includeToolCalls?: boolean;
+}
+/** Project surface events into the neutral model history. Deterministic. */
+export declare function deriveMessages(events: readonly SessionEventEnvelope[], options?: DeriveMessagesOptions): DerivedMessage[];
+/** A tool call paired with its result (when both exist in the log). */
+export interface ToolCallPair {
+    call: SessionEventEnvelope;
+    result?: SessionEventEnvelope;
+}
+/** Pair tool.call events with the matching tool.result by callId, in order. */
+export declare function pairToolCalls(events: readonly SessionEventEnvelope[]): ToolCallPair[];
+//# sourceMappingURL=modelSurface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"modelSurface.d.ts","sourceRoot":"","sources":["../../src/session/modelSurface.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEzE,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,gBAAgB,CAM5D,CAAC;AAEH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAEpE;AAED,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAMD,4EAA4E;AAC5E,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,oBAAoB,EAAE,EACvC,OAAO,GAAE,qBAA0B,GAClC,cAAc,EAAE,CA+ClB;AAED,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,GAAG,YAAY,EAAE,CAoBrF"}

package/dist/session/modelSurface.js

@@ -0,0 +1,96 @@
+/**
+ * session/modelSurface.ts — the ONLY path from session events to model history.
+ *
+ * `isModelSurfaceEvent` decides what counts as model-visible; `deriveMessages`
+ * projects surface events into a provider-neutral message list. The CLI maps
+ * these onto its provider-specific request format — nothing else may invent
+ * model-visible history (ADR-0016 invariant: model-visible ⟺ logged).
+ */
+/** Event kinds that (may) feed the model input. Everything else is state. */
+export const MODEL_SURFACE_KINDS = new Set([
+    'user.message',
+    'assistant.message',
+    'tool.call',
+    'tool.result',
+    'session.compacted',
+]);
+export function isModelSurfaceEvent(event) {
+    return MODEL_SURFACE_KINDS.has(event.kind);
+}
+function asString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+/** Project surface events into the neutral model history. Deterministic. */
+export function deriveMessages(events, options = {}) {
+    const messages = [];
+    for (const e of events) {
+        if (!isModelSurfaceEvent(e))
+            continue;
+        const d = e.data;
+        switch (e.kind) {
+            case 'user.message':
+                messages.push({ role: 'user', content: String(d.text ?? ''), seq: e.seq });
+                break;
+            case 'assistant.message':
+                messages.push({
+                    role: 'assistant',
+                    content: String(d.text ?? ''),
+                    seq: e.seq,
+                });
+                break;
+            case 'tool.call':
+                if (options.includeToolCalls) {
+                    messages.push({
+                        role: 'assistant',
+                        content: JSON.stringify({ tool: d.tool, args: d.args ?? {} }),
+                        toolCallId: asString(d.callId),
+                        toolName: asString(d.tool),
+                        seq: e.seq,
+                    });
+                }
+                break;
+            case 'tool.result':
+                messages.push({
+                    role: 'tool',
+                    content: String(d.output ?? ''),
+                    toolCallId: asString(d.callId),
+                    toolName: asString(d.tool),
+                    isError: d.ok === false,
+                    seq: e.seq,
+                });
+                break;
+            case 'session.compacted':
+                messages.push({
+                    role: 'system',
+                    content: String(d.summary ?? '[session compacted]'),
+                    seq: e.seq,
+                });
+                break;
+        }
+    }
+    return messages;
+}
+/** Pair tool.call events with the matching tool.result by callId, in order. */
+export function pairToolCalls(events) {
+    const pending = new Map();
+    const ordered = [];
+    for (const e of events) {
+        if (e.kind === 'tool.call') {
+            const callId = typeof e.data.callId === 'string' ? e.data.callId : `seq:${e.seq}`;
+            const pair = { call: e };
+            ordered.push(pair);
+            pending.set(callId, pair);
+        }
+        else if (e.kind === 'tool.result') {
+            if (typeof e.data.callId === 'string') {
+                const pair = pending.get(e.data.callId);
+                if (pair) {
+                    pair.result = e;
+                    pending.delete(e.data.callId);
+                }
+            }
+        }
+    }
+    return ordered;
+}
+//# sourceMappingURL=modelSurface.js.map

package/dist/session/modelSurface.js.map

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

package/dist/session/replay.d.ts

@@ -0,0 +1,61 @@
+/**
+ * session/replay.ts — tolerant log reader + projection.
+ *
+ * Replay never throws on a damaged log: corrupt lines, seq gaps, duplicates
+ * and schema mismatches are reported as ReplayIssue so the trajectory can be
+ * audited (replay reconstructs the trajectory, not model-output determinism).
+ */
+import { type SessionEventEnvelope } from './types.js';
+import { type DerivedMessage } from './modelSurface.js';
+export type ReplayIssueType = 'corrupt-line' | 'schema-mismatch' | 'seq-duplicate' | 'seq-gap' | 'seq-nonmonotonic';
+export interface ReplayIssue {
+    type: ReplayIssueType;
+    /** 1-based line number in the JSONL file. */
+    line: number;
+    seq?: number;
+    detail?: string;
+}
+export interface ReplayReport {
+    path: string;
+    events: SessionEventEnvelope[];
+    issues: ReplayIssue[];
+    /** True when every line parsed and seq is 1..n gap-free. */
+    ok: boolean;
+}
+export declare function readSessionLog(filePath: string): Promise<ReplayReport>;
+/** Loose summary of a verification.run event (defensive reads). */
+export interface VerificationRunSummary {
+    seq: number;
+    at: number;
+    results: Array<{
+        criterionId: string;
+        status: string;
+        evidenceCount: number;
+    }>;
+    complete?: boolean;
+}
+export interface SessionProjection {
+    sessionId: string;
+    lastSeq: number;
+    eventCount: number;
+    startedAt?: number;
+    endedAt?: number;
+    fork?: {
+        parentSessionId: string;
+        parentSeq: number;
+    };
+    resumedCount: number;
+    messages: DerivedMessage[];
+    toolCalls: number;
+    toolResults: number;
+    verifications: VerificationRunSummary[];
+    missionPhases: Array<{
+        seq: number;
+        phase: string;
+    }>;
+    replans: number;
+    issues: ReplayIssue[];
+}
+/** Build the materialized view of a session from its (valid) events. */
+export declare function buildProjection(events: readonly SessionEventEnvelope[], issues?: ReplayIssue[]): SessionProjection;
+//# sourceMappingURL=replay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/session/replay.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExE,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,iBAAiB,GACjB,eAAe,GACf,SAAS,GACT,kBAAkB,CAAC;AAEvB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,4DAA4D;IAC5D,EAAE,EAAE,OAAO,CAAC;CACb;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAoD5E;AAED,mEAAmE;AACnE,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,sBAAsB,EAAE,CAAC;IACxC,aAAa,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAmBD,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,EAAE,MAAM,GAAE,WAAW,EAAO,GAAG,iBAAiB,CAkDtH"}

package/dist/session/replay.js

@@ -0,0 +1,137 @@
+/**
+ * session/replay.ts — tolerant log reader + projection.
+ *
+ * Replay never throws on a damaged log: corrupt lines, seq gaps, duplicates
+ * and schema mismatches are reported as ReplayIssue so the trajectory can be
+ * audited (replay reconstructs the trajectory, not model-output determinism).
+ */
+import { promises as fs } from 'node:fs';
+import { SessionEventEnvelopeSchema, } from './types.js';
+import { deriveMessages } from './modelSurface.js';
+export async function readSessionLog(filePath) {
+    let content;
+    try {
+        content = await fs.readFile(filePath, 'utf-8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            return { path: filePath, events: [], issues: [], ok: true };
+        }
+        throw err;
+    }
+    const events = [];
+    const issues = [];
+    let expected = 1;
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const trimmed = lines[i].trim();
+        if (!trimmed)
+            continue;
+        const lineNo = i + 1;
+        let parsed;
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch {
+            issues.push({ type: 'corrupt-line', line: lineNo });
+            continue;
+        }
+        const result = SessionEventEnvelopeSchema.safeParse(parsed);
+        if (!result.success) {
+            issues.push({
+                type: 'schema-mismatch',
+                line: lineNo,
+                detail: result.error.issues[0]?.message ?? 'schema validation failed',
+            });
+            continue;
+        }
+        const envelope = result.data;
+        if (envelope.seq === expected) {
+            events.push(envelope);
+            expected += 1;
+        }
+        else if (envelope.seq < expected) {
+            issues.push({ type: 'seq-duplicate', line: lineNo, seq: envelope.seq });
+        }
+        else {
+            issues.push({
+                type: 'seq-gap',
+                line: lineNo,
+                seq: envelope.seq,
+                detail: `missing seq ${expected}..${envelope.seq - 1}`,
+            });
+            events.push(envelope);
+            expected = envelope.seq + 1;
+        }
+    }
+    return { path: filePath, events, issues, ok: issues.length === 0 };
+}
+function parseVerification(e) {
+    const raw = Array.isArray(e.data.results) ? e.data.results : [];
+    const results = raw
+        .filter((r) => typeof r === 'object' && r !== null)
+        .map((r) => ({
+        criterionId: String(r.criterionId ?? 'unknown'),
+        status: String(r.status ?? 'unknown'),
+        evidenceCount: Array.isArray(r.evidence) ? r.evidence.length : 0,
+    }));
+    return {
+        seq: e.seq,
+        at: e.ts,
+        results,
+        complete: typeof e.data.complete === 'boolean' ? e.data.complete : undefined,
+    };
+}
+/** Build the materialized view of a session from its (valid) events. */
+export function buildProjection(events, issues = []) {
+    const last = events[events.length - 1];
+    const projection = {
+        sessionId: last?.sessionId ?? '',
+        lastSeq: last?.seq ?? 0,
+        eventCount: events.length,
+        resumedCount: 0,
+        messages: deriveMessages(events),
+        toolCalls: 0,
+        toolResults: 0,
+        verifications: [],
+        missionPhases: [],
+        replans: 0,
+        issues,
+    };
+    for (const e of events) {
+        switch (e.kind) {
+            case 'session.started':
+                projection.startedAt = e.ts;
+                break;
+            case 'session.ended':
+                projection.endedAt = e.ts;
+                break;
+            case 'session.resumed':
+                projection.resumedCount += 1;
+                break;
+            case 'session.forked':
+                projection.fork = {
+                    parentSessionId: String(e.data.parentSessionId ?? ''),
+                    parentSeq: Number(e.data.parentSeq ?? 0),
+                };
+                break;
+            case 'tool.call':
+                projection.toolCalls += 1;
+                break;
+            case 'tool.result':
+                projection.toolResults += 1;
+                break;
+            case 'verification.run':
+                projection.verifications.push(parseVerification(e));
+                break;
+            case 'mission.phase':
+                projection.missionPhases.push({ seq: e.seq, phase: String(e.data.phase ?? '') });
+                break;
+            case 'mission.replan':
+                projection.replans += 1;
+                break;
+        }
+    }
+    return projection;
+}
+//# sourceMappingURL=replay.js.map

package/dist/session/replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.js","sourceRoot":"","sources":["../../src/session/replay.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EACL,0BAA0B,GAE3B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAuB,MAAM,mBAAmB,CAAC;AAyBxE,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QAC9D,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;QACrB,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACpD,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,0BAA0B,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,iBAAiB;gBACvB,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,0BAA0B;aACtE,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;QAC7B,IAAI,QAAQ,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtB,QAAQ,IAAI,CAAC,CAAC;QAChB,CAAC;aAAM,IAAI,QAAQ,CAAC,GAAG,GAAG,QAAQ,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1E,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,QAAQ,CAAC,GAAG;gBACjB,MAAM,EAAE,eAAe,QAAQ,KAAK,QAAQ,CAAC,GAAG,GAAG,CAAC,EAAE;aACvD,CAAC,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtB,QAAQ,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;AACrE,CAAC;AA2BD,SAAS,iBAAiB,CAAC,CAAuB;IAChD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,OAAO,GAAG,GAAG;SAChB,MAAM,CAAC,CAAC,CAAC,EAAgC,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC;SAChF,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,SAAS,CAAC;QAC/C,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC;QACrC,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;KACjE,CAAC,CAAC,CAAC;IACN,OAAO;QACL,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,OAAO;QACP,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;KAC7E,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,eAAe,CAAC,MAAuC,EAAE,SAAwB,EAAE;IACjG,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvC,MAAM,UAAU,GAAsB;QACpC,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,EAAE;QAChC,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC,MAAM;QACzB,YAAY,EAAE,CAAC;QACf,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC;QAChC,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,CAAC;QACd,aAAa,EAAE,EAAE;QACjB,aAAa,EAAE,EAAE;QACjB,OAAO,EAAE,CAAC;QACV,MAAM;KACP,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,iBAAiB;gBACpB,UAAU,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC5B,MAAM;YACR,KAAK,eAAe;gBAClB,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC1B,MAAM;YACR,KAAK,iBAAiB;gBACpB,UAAU,CAAC,YAAY,IAAI,CAAC,CAAC;gBAC7B,MAAM;YACR,KAAK,gBAAgB;gBACnB,UAAU,CAAC,IAAI,GAAG;oBAChB,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC;oBACrD,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;iBACzC,CAAC;gBACF,MAAM;YACR,KAAK,WAAW;gBACd,UAAU,CAAC,SAAS,IAAI,CAAC,CAAC;gBAC1B,MAAM;YACR,KAAK,aAAa;gBAChB,UAAU,CAAC,WAAW,IAAI,CAAC,CAAC;gBAC5B,MAAM;YACR,KAAK,kBAAkB;gBACrB,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;gBACpD,MAAM;YACR,KAAK,eAAe;gBAClB,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;gBACjF,MAAM;YACR,KAAK,gBAAgB;gBACnB,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;gBACxB,MAAM;QACV,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/session/store.d.ts

@@ -0,0 +1,60 @@
+/**
+ * session/store.ts — session directory management.
+ *
+ * Default location (ADR-0016 ratification): `<workspaceRoot>/.zelari/sessions/
+ * <sessionId>/events.jsonl`, overridable via `ZELARI_SESSIONS_DIR` or the
+ * explicit option. The legacy home-level sidecar remains read-only compat.
+ */
+import { SessionLogWriter } from './writer.js';
+import { type ReplayReport, type SessionProjection } from './replay.js';
+export interface SessionsDirOptions {
+    /** Explicit base dir (tests / Desktop multi-cwd). */
+    baseDir?: string;
+    /** Workspace root — defaults to process.cwd(). */
+    workspaceRoot?: string;
+    /** Env override source (defaults to process.env). */
+    env?: Record<string, string | undefined>;
+}
+export declare function resolveSessionsDir(options?: SessionsDirOptions): string;
+export interface SessionCreateOptions {
+    reason?: string;
+    profile?: string;
+    workspace?: string;
+}
+export interface SessionListEntry {
+    sessionId: string;
+    lastSeq: number;
+    eventCount: number;
+    startedAt?: number;
+    endedAt?: number;
+    forkParent?: string;
+}
+export declare class SessionStore {
+    private readonly baseDir;
+    constructor(baseDir: string);
+    static withDefaults(options?: SessionsDirOptions): SessionStore;
+    get dir(): string;
+    sessionDir(sessionId: string): string;
+    eventsPath(sessionId: string): string;
+    /** Create a new session and its writer; appends `session.started`. */
+    create(options?: SessionCreateOptions): Promise<{
+        sessionId: string;
+        writer: SessionLogWriter;
+    }>;
+    /** Replay a session log (tolerant read). */
+    read(sessionId: string): Promise<ReplayReport>;
+    /** Materialized view of a session. */
+    projection(sessionId: string): Promise<SessionProjection>;
+    /** Reopen a session for writing (continues seq after lastSeq). Pure: no event appended. */
+    open(sessionId: string): Promise<{
+        writer: SessionLogWriter;
+        report: ReplayReport;
+        projection: SessionProjection;
+    }>;
+    exists(sessionId: string): Promise<boolean>;
+    /** Summaries of all stored sessions (newest first by startedAt). */
+    list(): Promise<SessionListEntry[]>;
+    /** End a session cleanly (appends `session.ended` and releases the writer). */
+    end(writer: SessionLogWriter, reason?: string): Promise<void>;
+}
+//# 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":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAmC,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGzG,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAM3E;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAE5C,MAAM,CAAC,YAAY,CAAC,OAAO,GAAE,kBAAuB,GAAG,YAAY;IAInE,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIrC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIrC,sEAAsE;IAChE,MAAM,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAA;KAAE,CAAC;IAe1G,4CAA4C;IACtC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAIpD,sCAAsC;IAChC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAK/D,2FAA2F;IACrF,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,gBAAgB,CAAC;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,UAAU,EAAE,iBAAiB,CAAA;KAAE,CAAC;IAUnH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASjD,oEAAoE;IAC9D,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAyBzC,+EAA+E;IACzE,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,SAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAKzE"}