@sema-ai/core 1.275.1

package/dist/engine/lsp/stdio-lsp-transport.js

@@ -0,0 +1,185 @@
+/**
+ * `StdioLspTransport` — LSP JSON-RPC over a language server's stdin/stdout (the TOC transport, a faithful copy
+ * of CC's `services/lsp/LSPClient`: `spawn` the server, `Content-Length`-frame requests to stdin, decode frames
+ * from stdout). Implements core's {@link LspTransport} so `TransportLspSession` drives it with the SAME protocol
+ * logic as the TOB WS transport. Request/response correlation + timeout + abort are ported from service's
+ * `WsLspTransport`; the framing is the part stdio adds (a WS message is already one message).
+ */
+import { encodeFrame, makeFrameDecoder } from "./frame-decoder.js";
+import { killProcessTree } from "../execution-env/kill-tree.js";
+export class StdioLspTransport {
+    child;
+    requestTimeoutMs;
+    nextId = 0;
+    pending = new Map();
+    isClosed = false;
+    decode = makeFrameDecoder();
+    /** design/121: server→client notification subscribers (publishDiagnostics, …). Empty = pre-121 behavior. */
+    notificationHandlers = new Set();
+    constructor(child, requestTimeoutMs = 30_000) {
+        this.child = child;
+        this.requestTimeoutMs = requestTimeoutMs;
+        child.stdout.on("data", (chunk) => {
+            for (const frame of this.decode(chunk))
+                this.onMessage(frame);
+        });
+        // EPIPE on a write racing the server's exit must not crash the process.
+        child.stdin.on("error", () => { });
+        child.on("exit", () => this.failAll(new Error("LSP server exited")));
+        child.on("error", (e) => this.failAll(toError(e))); // spawn failure (ENOENT) or runtime error
+    }
+    /** Manager-visible liveness: evict + reopen instead of reusing a dead server (crashed / killed). */
+    get closed() {
+        return this.isClosed;
+    }
+    onMessage(raw) {
+        let msg;
+        try {
+            msg = JSON.parse(raw);
+        }
+        catch {
+            return; // not JSON (or a log line the server wrote to stdout) — ignore
+        }
+        // A server→client REQUEST carries BOTH an id AND a method (`workspace/configuration`,
+        // `window/workDoneProgress/create`, `client/registerCapability`, …). We register no handlers, so a server
+        // that BLOCKS waiting for the reply would otherwise hang to our op timeout — reply `MethodNotFound` (-32601)
+        // at once (what `vscode-jsonrpc` does for an unhandled request). Handling this FIRST (and returning) also
+        // keeps the response branch below correct: a server→client request's id lives in the SERVER's id space and
+        // could numerically collide with one of OUR pending ids — without this guard it'd be mis-read as a response.
+        // 🔴 Guarded + try'd: this runs in the stdout callback, and if the server just exited, writing to its ended
+        // stdin throws SYNCHRONOUSLY (ERR_STREAM_WRITE_AFTER_END) — which EPIPE's async 'error' handler would NOT
+        // catch, so it must not escape here.
+        if (msg.method != null && msg.id != null) {
+            if (!this.isClosed) {
+                try {
+                    this.send({ jsonrpc: "2.0", id: msg.id, error: { code: -32601, message: `Method not found: ${String(msg.method)}` } });
+                }
+                catch {
+                    /* server gone mid-write — nothing to reply to */
+                }
+            }
+            return;
+        }
+        if (typeof msg.id === "number") {
+            const p = this.pending.get(msg.id);
+            if (p) {
+                this.pending.delete(msg.id);
+                if (msg.error)
+                    p.reject(new Error(msg.error.message ?? "LSP error"));
+                else
+                    p.resolve(msg.result);
+            }
+            return;
+        }
+        // design/121: server→client NOTIFICATIONs (a method, no id — publishDiagnostics, window/logMessage, …)
+        // are dispatched to subscribers; with none registered this is the pre-121 drop. A throwing handler is
+        // swallowed — this runs in the stdout read loop, and a bad consumer must never kill it.
+        if (typeof msg.method === "string" && this.notificationHandlers.size > 0) {
+            const params = msg.params;
+            for (const handler of this.notificationHandlers) {
+                try {
+                    handler(msg.method, params);
+                }
+                catch {
+                    /* consumer bug — never fault the read loop */
+                }
+            }
+        }
+    }
+    /** design/121 {@link LspTransport.onNotification}: subscribe to server notifications; returns unsubscribe. */
+    onNotification(handler) {
+        this.notificationHandlers.add(handler);
+        return () => this.notificationHandlers.delete(handler);
+    }
+    failAll(err) {
+        this.isClosed = true;
+        for (const p of this.pending.values())
+            p.reject(err);
+        this.pending.clear();
+    }
+    send(msg) {
+        this.child.stdin.write(encodeFrame(JSON.stringify(msg)));
+    }
+    request(method, params, signal) {
+        if (this.isClosed)
+            return Promise.reject(new Error("LSP transport closed"));
+        const id = ++this.nextId;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                if (this.pending.delete(id)) {
+                    signal?.removeEventListener("abort", onAbort);
+                    reject(new Error(`LSP ${method} timed out after ${this.requestTimeoutMs}ms`));
+                }
+            }, this.requestTimeoutMs);
+            timer.unref?.();
+            const cleanup = () => {
+                clearTimeout(timer);
+                signal?.removeEventListener("abort", onAbort);
+            };
+            const onAbort = () => {
+                if (this.pending.delete(id)) {
+                    cleanup();
+                    // Tell the server to stop computing the abandoned request (best-effort; `notify` no-ops if closed).
+                    this.notify("$/cancelRequest", { id });
+                    reject(new Error(`LSP ${method} aborted`));
+                }
+            };
+            this.pending.set(id, {
+                resolve: (v) => {
+                    cleanup();
+                    resolve(v);
+                },
+                reject: (e) => {
+                    cleanup();
+                    reject(e);
+                },
+            });
+            if (signal) {
+                if (signal.aborted)
+                    return onAbort();
+                signal.addEventListener("abort", onAbort, { once: true });
+            }
+            try {
+                this.send({ jsonrpc: "2.0", id, method, params });
+            }
+            catch (e) {
+                if (this.pending.delete(id)) {
+                    cleanup();
+                    reject(e instanceof Error ? e : new Error(String(e)));
+                }
+            }
+        });
+    }
+    notify(method, params) {
+        if (this.isClosed)
+            return;
+        try {
+            this.send({ jsonrpc: "2.0", method, params });
+        }
+        catch {
+            /* fire-and-forget */
+        }
+    }
+    async close() {
+        this.failAll(new Error("LSP transport closed"));
+        try {
+            // win32 + shell:true spawn: this.child is the cmd.exe shim — kill() alone orphans the
+            // language server; tree-kill via taskkill. POSIX path byte-identical (service [377] ask ②).
+            if (process.platform === "win32" && this.child.pid)
+                killProcessTree(this.child.pid, { force: true });
+            else
+                this.child.kill();
+        }
+        catch {
+            /* already gone */
+        }
+    }
+}
+/** Error-or-event → Error (a spawn 'error' may be an errno object, not an Error). */
+function toError(e) {
+    if (e instanceof Error)
+        return e;
+    const m = e?.message;
+    return new Error(typeof m === "string" && m ? m : String(e));
+}
+//# sourceMappingURL=stdio-lsp-transport.js.map

package/dist/engine/lsp/stdio-lsp-transport.js.map

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

package/dist/engine/session/import-validate.d.ts

@@ -0,0 +1,44 @@
+import { type SessionTreeEntry } from "../harness/types.js";
+/**
+ * The SINGLE invariant gate for cross-backend session IMPORT (2c session-sync, service [266]②), as a STREAMING
+ * online validator — feed entries oldest-first via {@link step}, then {@link finish}. The 2c NDJSON path imports
+ * entries as a stream (keyset pages, no whole-array buffer), so the gate must be incremental; the array form
+ * {@link validateEntriesForImport} is a thin wrapper over this (ONE source of truth — fork/tests keep the array
+ * API). Fail-CLOSED: the first violation throws `SessionError("invalid_session")` and the caller writes nothing.
+ *
+ * Invariants enforced (the session-tree contract — see `storage-base.ts` getPathToRoot/appendEntry):
+ *  1. Unique entry ids.
+ *  2. Append order = parent-before-child: every non-null `parentId` MUST reference an entry stepped EARLIER. This
+ *     is also the floor-truncation tripwire — if the export silently dropped pre-floor entries (the `getEntries()`
+ *     tail-only bug), a tail entry's parent would be absent → throw, instead of a broken headless tree.
+ *  3. Exactly one root (a single `parentId === null` entry) for a non-empty log — checked at `finish`.
+ *  4. The derived leaf (after the last entry) resolves to a stepped entry — checked at `finish`.
+ *
+ * The validator NEVER rewrites entries — ids/parents/timestamps are preserved verbatim (the caller re-stamps only
+ * the owner). It is single-use: `step` after `finish`, or a second `finish`, throws.
+ */
+export declare class StreamingImportValidator {
+    private readonly seen;
+    private rootCount;
+    private runningLeaf;
+    private done;
+    /** Validate ONE entry, in oldest-first order. Throws `SessionError("invalid_session")` on the first violation
+     *  (duplicate id, or a parent/structural reference not stepped before this entry). */
+    step(entry: SessionTreeEntry): void;
+    /** Finalize the stream: exactly one root (for a non-empty log) + the derived leaf resolves to a stepped entry.
+     *  Returns the resolved leaf id (null for an empty session). Throws on violation; single-use. */
+    finish(): {
+        leafId: string | null;
+    };
+}
+/**
+ * Validate a verbatim session-entry log for cross-backend IMPORT (2c session-sync, service [266]②). The ARRAY
+ * form of {@link StreamingImportValidator} (ONE source of truth — this just drives step()/finish() over the
+ * array, kept for `fork`/tests that already hold the whole log). Fail-CLOSED: any violation throws
+ * `SessionError("invalid_session")` and nothing is written.
+ *
+ * Returns the entries VERBATIM (validated, never rewritten — ids/parents/timestamps preserved so the imported
+ * session is byte-identical to the source; only the owner is re-stamped by the caller, not here).
+ */
+export declare function validateEntriesForImport(entries: SessionTreeEntry[]): SessionTreeEntry[];
+//# sourceMappingURL=import-validate.d.ts.map

package/dist/engine/session/import-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-validate.d.ts","sourceRoot":"","sources":["../../../src/engine/session/import-validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAG7B;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,IAAI,CAAS;IAErB;0FACsF;IACtF,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAsCnC;qGACiG;IACjG,MAAM,IAAI;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;CAmBpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAKxF"}

package/dist/engine/session/import-validate.js

@@ -0,0 +1,92 @@
+import { SessionError, } from "../harness/types.js";
+import { leafIdAfterEntry } from "./storage-base.js";
+/**
+ * The SINGLE invariant gate for cross-backend session IMPORT (2c session-sync, service [266]②), as a STREAMING
+ * online validator — feed entries oldest-first via {@link step}, then {@link finish}. The 2c NDJSON path imports
+ * entries as a stream (keyset pages, no whole-array buffer), so the gate must be incremental; the array form
+ * {@link validateEntriesForImport} is a thin wrapper over this (ONE source of truth — fork/tests keep the array
+ * API). Fail-CLOSED: the first violation throws `SessionError("invalid_session")` and the caller writes nothing.
+ *
+ * Invariants enforced (the session-tree contract — see `storage-base.ts` getPathToRoot/appendEntry):
+ *  1. Unique entry ids.
+ *  2. Append order = parent-before-child: every non-null `parentId` MUST reference an entry stepped EARLIER. This
+ *     is also the floor-truncation tripwire — if the export silently dropped pre-floor entries (the `getEntries()`
+ *     tail-only bug), a tail entry's parent would be absent → throw, instead of a broken headless tree.
+ *  3. Exactly one root (a single `parentId === null` entry) for a non-empty log — checked at `finish`.
+ *  4. The derived leaf (after the last entry) resolves to a stepped entry — checked at `finish`.
+ *
+ * The validator NEVER rewrites entries — ids/parents/timestamps are preserved verbatim (the caller re-stamps only
+ * the owner). It is single-use: `step` after `finish`, or a second `finish`, throws.
+ */
+export class StreamingImportValidator {
+    seen = new Set();
+    rootCount = 0;
+    runningLeaf = null;
+    done = false;
+    /** Validate ONE entry, in oldest-first order. Throws `SessionError("invalid_session")` on the first violation
+     *  (duplicate id, or a parent/structural reference not stepped before this entry). */
+    step(entry) {
+        if (this.done) {
+            throw new SessionError("invalid_session", "StreamingImportValidator.step() called after finish()");
+        }
+        const e = entry;
+        if (this.seen.has(e.id)) {
+            throw new SessionError("invalid_session", `Duplicate entry id "${e.id}" in import log`);
+        }
+        if (e.parentId === null) {
+            this.rootCount++;
+        }
+        else if (!this.seen.has(e.parentId)) {
+            // Parent not yet seen → either the stream is not oldest-first, or pre-floor ancestors were dropped
+            // (the floor-bypass tripwire). Either way the tree is broken; refuse to import a headless branch.
+            throw new SessionError("invalid_session", `Entry "${e.id}" references parent "${e.parentId}" that does not appear before it ` +
+                `(non-oldest-first order, or a truncated pre-floor chain — exportEntries must return the FULL log)`);
+        }
+        // Other STRUCTURAL references must also resolve to an earlier entry (a truncation that drops a referent off
+        // the active branch wouldn't trip the parent check, but it would corrupt replay — buildSessionContext throws
+        // on a missing compaction firstKept, etc.). Catch it here, at the write gate, fail-closed.
+        if (e.type === "compaction" && !this.seen.has(e.firstKeptEntryId)) {
+            throw new SessionError("invalid_session", `Compaction "${e.id}" firstKeptEntryId "${e.firstKeptEntryId}" not present before it (truncated log)`);
+        }
+        if ((e.type === "label" || e.type === "leaf") && e.targetId !== null && !this.seen.has(e.targetId)) {
+            throw new SessionError("invalid_session", `${e.type} entry "${e.id}" targets "${e.targetId}" which is not present before it (truncated log)`);
+        }
+        this.seen.add(e.id);
+        this.runningLeaf = leafIdAfterEntry(e); // the leaf after the LAST stepped entry (mirrors resolveLeafId)
+    }
+    /** Finalize the stream: exactly one root (for a non-empty log) + the derived leaf resolves to a stepped entry.
+     *  Returns the resolved leaf id (null for an empty session). Throws on violation; single-use. */
+    finish() {
+        if (this.done) {
+            throw new SessionError("invalid_session", "StreamingImportValidator.finish() called twice");
+        }
+        this.done = true;
+        if (this.seen.size === 0) {
+            return { leafId: null }; // an empty session is valid (a freshly-created session with no entries yet)
+        }
+        if (this.rootCount !== 1) {
+            throw new SessionError("invalid_session", `A session log must have exactly ONE root entry (parentId null); found ${this.rootCount}`);
+        }
+        if (this.runningLeaf !== null && !this.seen.has(this.runningLeaf)) {
+            throw new SessionError("invalid_session", `Resolved leaf "${this.runningLeaf}" is not present in the import log`);
+        }
+        return { leafId: this.runningLeaf };
+    }
+}
+/**
+ * Validate a verbatim session-entry log for cross-backend IMPORT (2c session-sync, service [266]②). The ARRAY
+ * form of {@link StreamingImportValidator} (ONE source of truth — this just drives step()/finish() over the
+ * array, kept for `fork`/tests that already hold the whole log). Fail-CLOSED: any violation throws
+ * `SessionError("invalid_session")` and nothing is written.
+ *
+ * Returns the entries VERBATIM (validated, never rewritten — ids/parents/timestamps preserved so the imported
+ * session is byte-identical to the source; only the owner is re-stamped by the caller, not here).
+ */
+export function validateEntriesForImport(entries) {
+    const v = new StreamingImportValidator();
+    for (const e of entries)
+        v.step(e);
+    v.finish();
+    return entries;
+}
+//# sourceMappingURL=import-validate.js.map

package/dist/engine/session/import-validate.js.map

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

package/dist/engine/session/memory-repo.d.ts

@@ -0,0 +1,25 @@
+import { type SessionApi, type SessionMetadata, type SessionRepo, type SessionTreeEntry } from "../harness/types.js";
+export declare class InMemorySessionRepo implements SessionRepo<SessionMetadata, {
+    id?: string;
+}> {
+    private sessions;
+    create(options?: {
+        id?: string;
+    }): Promise<SessionApi>;
+    open(metadata: SessionMetadata): Promise<SessionApi>;
+    list(): Promise<SessionMetadata[]>;
+    delete(metadata: SessionMetadata): Promise<void>;
+    fork(sourceMetadata: SessionMetadata, options: {
+        entryId?: string;
+        position?: "before" | "at";
+        id?: string;
+    }): Promise<SessionApi>;
+    /** 2c session-sync ([266]②): the FULL log for export. InMemory holds everything (no F3 floor), so
+     *  `getEntries()` IS the full oldest-first log with `id`/`parentId` verbatim. */
+    exportEntries(sessionId: string): Promise<SessionTreeEntry[]>;
+    /** 2c session-sync ([266]②): import a verbatim log into `sessionId`. The single invariant gate runs first
+     *  ({@link validateEntriesForImport}, fail-closed); `owner` is a durable multi-tenant concept that the local
+     *  in-memory backend has no field for, so it is accepted but unused here. */
+    importEntries(sessionId: string, owner: string | undefined, entries: SessionTreeEntry[]): Promise<void>;
+}
+//# sourceMappingURL=memory-repo.d.ts.map

package/dist/engine/session/memory-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-repo.d.ts","sourceRoot":"","sources":["../../../src/engine/session/memory-repo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAgB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAKnI,qBAAa,mBAAoB,YAAW,WAAW,CAAC,eAAe,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;IACvF,OAAO,CAAC,QAAQ,CAAiC;IAE3C,MAAM,CAAC,OAAO,GAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAW1D,IAAI,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAQpD,IAAI,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAIlC,MAAM,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,IAAI,CACR,cAAc,EAAE,eAAe,EAC/B,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GACrE,OAAO,CAAC,UAAU,CAAC;IActB;qFACiF;IAC3E,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAKnE;;iFAE6E;IACvE,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAM9G"}

package/dist/engine/session/memory-repo.js

@@ -0,0 +1,59 @@
+import { SessionError } from "../harness/types.js";
+import { validateEntriesForImport } from "./import-validate.js";
+import { InMemorySessionStorage } from "./memory-storage.js";
+import { createSessionId, createTimestamp, getEntriesToFork, toSession } from "./repo-utils.js";
+export class InMemorySessionRepo {
+    sessions = new Map();
+    async create(options = {}) {
+        const metadata = {
+            id: options.id ?? createSessionId(),
+            createdAt: createTimestamp(),
+        };
+        const storage = new InMemorySessionStorage({ metadata });
+        const session = toSession(storage);
+        this.sessions.set(metadata.id, session);
+        return session;
+    }
+    async open(metadata) {
+        const session = this.sessions.get(metadata.id);
+        if (!session) {
+            throw new SessionError("not_found", `Session not found: ${metadata.id}`);
+        }
+        return session;
+    }
+    async list() {
+        return Promise.all([...this.sessions.values()].map((session) => session.getMetadata()));
+    }
+    async delete(metadata) {
+        this.sessions.delete(metadata.id);
+    }
+    async fork(sourceMetadata, options) {
+        const source = await this.open(sourceMetadata);
+        const forkedEntries = await getEntriesToFork(source.getStorage(), options);
+        const metadata = {
+            id: options.id ?? createSessionId(),
+            createdAt: createTimestamp(),
+            forkedFrom: sourceMetadata.id, // F7 fork-GC seam: lineage for a deployment's reap
+        };
+        const storage = new InMemorySessionStorage({ metadata, entries: forkedEntries });
+        const session = toSession(storage);
+        this.sessions.set(metadata.id, session);
+        return session;
+    }
+    /** 2c session-sync ([266]②): the FULL log for export. InMemory holds everything (no F3 floor), so
+     *  `getEntries()` IS the full oldest-first log with `id`/`parentId` verbatim. */
+    async exportEntries(sessionId) {
+        const session = await this.open({ id: sessionId, createdAt: "" });
+        return session.getStorage().getEntries();
+    }
+    /** 2c session-sync ([266]②): import a verbatim log into `sessionId`. The single invariant gate runs first
+     *  ({@link validateEntriesForImport}, fail-closed); `owner` is a durable multi-tenant concept that the local
+     *  in-memory backend has no field for, so it is accepted but unused here. */
+    async importEntries(sessionId, owner, entries) {
+        void owner;
+        const validated = validateEntriesForImport(entries);
+        const metadata = { id: sessionId, createdAt: createTimestamp() };
+        this.sessions.set(sessionId, toSession(new InMemorySessionStorage({ metadata, entries: validated })));
+    }
+}
+//# sourceMappingURL=memory-repo.js.map

package/dist/engine/session/memory-repo.js.map

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

package/dist/engine/session/memory-storage.d.ts

@@ -0,0 +1,14 @@
+import type { SessionMetadata, SessionTreeEntry, SessionWriteOptions } from "../harness/types.js";
+import { BaseSessionStorage } from "./storage-base.js";
+/** Volatile session storage used by tests and in-process harness callers. */
+export declare class InMemorySessionStorage<TMetadata extends SessionMetadata = SessionMetadata> extends BaseSessionStorage<TMetadata> {
+    constructor(options?: {
+        entries?: SessionTreeEntry[];
+        metadata?: TMetadata;
+        /** Branch floor for a bounded-window load (F3); the entries must start at this id. */
+        floorEntryId?: string | null;
+    });
+    setLeafId(leafId: string | null, opts?: SessionWriteOptions): Promise<void>;
+    appendEntry(entry: SessionTreeEntry, opts?: SessionWriteOptions): Promise<void>;
+}
+//# sourceMappingURL=memory-storage.d.ts.map

package/dist/engine/session/memory-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-storage.d.ts","sourceRoot":"","sources":["../../../src/engine/session/memory-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAClG,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD,6EAA6E;AAC7E,qBAAa,sBAAsB,CACjC,SAAS,SAAS,eAAe,GAAG,eAAe,CACnD,SAAQ,kBAAkB,CAAC,SAAS,CAAC;gBACzB,OAAO,CAAC,EAAE;QACpB,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;QAC7B,QAAQ,CAAC,EAAE,SAAS,CAAC;QACrB,sFAAsF;QACtF,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B;IASc,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3E,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAI/F"}

package/dist/engine/session/memory-storage.js

@@ -0,0 +1,17 @@
+import { BaseSessionStorage } from "./storage-base.js";
+import { uuidv7 } from "./uuid.js";
+/** Volatile session storage used by tests and in-process harness callers. */
+export class InMemorySessionStorage extends BaseSessionStorage {
+    constructor(options) {
+        super(options?.metadata ?? { id: uuidv7(), createdAt: new Date().toISOString() }, options?.entries ? [...options.entries] : [], undefined, options?.floorEntryId !== undefined ? { floorEntryId: options.floorEntryId } : undefined);
+    }
+    async setLeafId(leafId, opts) {
+        this.assertExpectedLeaf(opts);
+        this.recordEntry(this.createLeafEntry(leafId));
+    }
+    async appendEntry(entry, opts) {
+        this.assertExpectedLeaf(opts);
+        this.recordEntry(entry);
+    }
+}
+//# sourceMappingURL=memory-storage.js.map

package/dist/engine/session/memory-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-storage.js","sourceRoot":"","sources":["../../../src/engine/session/memory-storage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,6EAA6E;AAC7E,MAAM,OAAO,sBAEX,SAAQ,kBAA6B;IACrC,YAAY,OAKX;QACC,KAAK,CACH,OAAO,EAAE,QAAQ,IAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAgB,EACzF,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAC5C,SAAS,EACT,OAAO,EAAE,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,SAAS,CACzF,CAAC;IACJ,CAAC;IAEQ,KAAK,CAAC,SAAS,CAAC,MAAqB,EAAE,IAA0B;QACxE,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IACjD,CAAC;IAEQ,KAAK,CAAC,WAAW,CAAC,KAAuB,EAAE,IAA0B;QAC5E,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/engine/session/repo-utils.d.ts

@@ -0,0 +1,11 @@
+import { type FileError, type Result, type SessionMetadata, type SessionStorage, type SessionTreeEntry } from "../harness/types.js";
+import { Session } from "./session.js";
+export declare function createSessionId(): string;
+export declare function createTimestamp(): string;
+export declare function toSession<TMetadata extends SessionMetadata>(storage: SessionStorage<TMetadata>): Session<TMetadata>;
+export declare function getFileSystemResultOrThrow<TValue>(result: Result<TValue, FileError>, message: string): TValue;
+export declare function getEntriesToFork(storage: SessionStorage, options: {
+    entryId?: string;
+    position?: "before" | "at";
+}): Promise<SessionTreeEntry[]>;
+//# sourceMappingURL=repo-utils.d.ts.map

package/dist/engine/session/repo-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-utils.d.ts","sourceRoot":"","sources":["../../../src/engine/session/repo-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,SAAS,EACd,KAAK,MAAM,EAEX,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,SAAS,CAAC,SAAS,SAAS,eAAe,EACzD,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,GACjC,OAAO,CAAC,SAAS,CAAC,CAEpB;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EACjC,OAAO,EAAE,MAAM,GACd,MAAM,CAMR;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;CAAE,GACxD,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAqB7B"}

package/dist/engine/session/repo-utils.js

@@ -0,0 +1,40 @@
+import { SessionError, } from "../harness/types.js";
+import { Session } from "./session.js";
+import { uuidv7 } from "./uuid.js";
+export function createSessionId() {
+    return uuidv7();
+}
+export function createTimestamp() {
+    return new Date().toISOString();
+}
+export function toSession(storage) {
+    return new Session(storage);
+}
+export function getFileSystemResultOrThrow(result, message) {
+    if (!result.ok) {
+        const code = result.error.code === "not_found" ? "not_found" : "storage";
+        throw new SessionError(code, `${message}: ${result.error.message}`, result.error);
+    }
+    return result.value;
+}
+export async function getEntriesToFork(storage, options) {
+    if (!options.entryId) {
+        return storage.getEntries();
+    }
+    const target = await storage.getEntry(options.entryId);
+    if (!target) {
+        throw new SessionError("invalid_fork_target", `Entry ${options.entryId} not found`);
+    }
+    let effectiveLeafId;
+    if ((options.position ?? "before") === "at") {
+        effectiveLeafId = target.id;
+    }
+    else {
+        if (target.type !== "message" || target.message.role !== "user") {
+            throw new SessionError("invalid_fork_target", `Entry ${options.entryId} is not a user message`);
+        }
+        effectiveLeafId = target.parentId;
+    }
+    return storage.getPathToRoot(effectiveLeafId);
+}
+//# sourceMappingURL=repo-utils.js.map

package/dist/engine/session/repo-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-utils.js","sourceRoot":"","sources":["../../../src/engine/session/repo-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,YAAY,GAIb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,MAAM,UAAU,eAAe;IAC7B,OAAO,MAAM,EAAE,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,OAAkC;IAElC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,MAAiC,EACjC,OAAe;IAEf,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;QACzE,MAAM,IAAI,YAAY,CAAC,IAAI,EAAE,GAAG,OAAO,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAuB,EACvB,OAAyD;IAEzD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO,OAAO,CAAC,UAAU,EAAE,CAAC;IAC9B,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,YAAY,CAAC,qBAAqB,EAAE,SAAS,OAAO,CAAC,OAAO,YAAY,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,eAA8B,CAAC;IACnC,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;QAC5C,eAAe,GAAG,MAAM,CAAC,EAAE,CAAC;IAC9B,CAAC;SAAM,CAAC;QACN,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAChE,MAAM,IAAI,YAAY,CACpB,qBAAqB,EACrB,SAAS,OAAO,CAAC,OAAO,wBAAwB,CACjD,CAAC;QACJ,CAAC;QACD,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC;IACpC,CAAC;IACD,OAAO,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;AAChD,CAAC"}

package/dist/engine/session/session.d.ts

@@ -0,0 +1,34 @@
+import type { ImageContent, TextContent } from "../llm/index.js";
+import type { AgentMessage } from "../loop/types.js";
+import type { SessionApi, SessionContext, SessionMetadata, SessionStorage, SessionTreeEntry } from "../harness/types.js";
+/** Build model context from the active session branch and its latest state markers. */
+export declare function buildSessionContext(pathEntries: SessionTreeEntry[]): SessionContext;
+/** High-level session API backed by pluggable tree storage. Implements the vendored `Session` CONTRACT
+ *  (`SessionContract`) the harness consumes — dependency inversion so the vendored substrate needs no
+ *  `import` of this concrete class (de-vendoring prep); `implements` makes the contract drift caught here. */
+export declare class Session<TMetadata extends SessionMetadata = SessionMetadata> implements SessionApi<TMetadata> {
+    private storage;
+    constructor(storage: SessionStorage<TMetadata>);
+    getMetadata(): Promise<TMetadata>;
+    getStorage(): SessionStorage<TMetadata>;
+    getLeafId(): Promise<string | null>;
+    getEntry(id: string): Promise<SessionTreeEntry | undefined>;
+    getEntries(): Promise<SessionTreeEntry[]>;
+    getBranch(fromId?: string): Promise<SessionTreeEntry[]>;
+    buildContext(): Promise<SessionContext>;
+    getLabel(id: string): Promise<string | undefined>;
+    getSessionName(): Promise<string | undefined>;
+    private appendTypedEntry;
+    appendMessage(message: AgentMessage): Promise<string>;
+    appendThinkingLevelChange(thinkingLevel: string): Promise<string>;
+    appendModelChange(provider: string, modelId: string): Promise<string>;
+    appendCompaction(summary: string, firstKeptEntryId: string, tokensBefore: number, details?: unknown, fromHook?: boolean): Promise<string>;
+    /** Append a non-LLM transcript marker for harness-specific state. */
+    appendCustomEntry(customType: string, data?: unknown): Promise<string>;
+    /** Append harness-specific content that can also be replayed into model context. */
+    appendCustomMessageEntry(customType: string, content: string | (TextContent | ImageContent)[], display: boolean, details?: unknown): Promise<string>;
+    /** Record or clear the display label for an existing session entry. */
+    appendLabel(targetId: string, label: string | undefined): Promise<string>;
+    appendSessionName(name: string): Promise<string>;
+}
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/engine/session/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAMrD,OAAO,KAAK,EAOV,UAAU,EACV,cAAc,EAEd,eAAe,EACf,cAAc,EACd,gBAAgB,EAEjB,MAAM,qBAAqB,CAAC;AAG7B,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,cAAc,CA8GnF;AAED;;8GAE8G;AAC9G,qBAAa,OAAO,CAAC,SAAS,SAAS,eAAe,GAAG,eAAe,CAAE,YAAW,UAAU,CAAC,SAAS,CAAC;IACxG,OAAO,CAAC,OAAO,CAA4B;gBAE/B,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC;IAI9C,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC;IAIjC,UAAU,IAAI,cAAc,CAAC,SAAS,CAAC;IAIvC,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAInC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAI3D,UAAU,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAInC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAKvD,YAAY,IAAI,OAAO,CAAC,cAAc,CAAC;IAI7C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAI3C,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;YAKrC,gBAAgB;IASxB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAUrD,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUjE,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWrE,gBAAgB,CACpB,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,OAAO,EACjB,QAAQ,CAAC,EAAE,OAAO,GACjB,OAAO,CAAC,MAAM,CAAC;IAclB,qEAAqE;IAC/D,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAW5E,oFAAoF;IAC9E,wBAAwB,CAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,EAAE,EAChD,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,MAAM,CAAC;IAalB,uEAAuE;IACjE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAczE,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAcvD"}