@corenel/harness 0.1.0 → 0.3.2

package/dist/sessions/fileRecallStore.js

@@ -0,0 +1,112 @@
+import { sessionsRoot, flattenFiles } from '@corenel/protocol';
+import { PREVIEW_BYTES } from '../compression';
+/** Reserved pseudo-session for offloads produced outside any chat session
+ * (DAG node runs, the editor's prompt Run). */
+export const UNATTACHED_SESSION = '_unattached';
+/** Blob ids are model-supplied on read — accept only our own shape. */
+const SAFE_ID = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
+function safeJson(v) {
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        return String(v);
+    }
+}
+export class FileRecallStore {
+    constructor(getFiles, getSessionId = () => UNATTACHED_SESSION, root = sessionsRoot) {
+        Object.defineProperty(this, "getFiles", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: getFiles
+        });
+        Object.defineProperty(this, "getSessionId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: getSessionId
+        });
+        Object.defineProperty(this, "root", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: root
+        });
+        Object.defineProperty(this, "counter", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        Object.defineProperty(this, "prefix", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: Math.random().toString(36).slice(2, 7)
+        });
+    }
+    async files() {
+        const f = await this.getFiles();
+        if (!f)
+            throw new Error('No file workspace is connected — offload storage is unavailable.');
+        return f;
+    }
+    blobPath(id) {
+        return `${this.root()}/${this.getSessionId()}/blobs/${id}.json`;
+    }
+    async record(toolName, content) {
+        const text = typeof content === 'string' ? content : safeJson(content);
+        const id = `blob-${this.prefix}-${++this.counter}`;
+        const rec = { id, toolName, bytes: text.length, content: text, createdAt: Date.now() };
+        await (await this.files()).write(this.blobPath(id), JSON.stringify(rec));
+        return { id, toolName, bytes: text.length, preview: text.slice(0, PREVIEW_BYTES) };
+    }
+    async read(id) {
+        if (!SAFE_ID.test(id))
+            return null;
+        const text = await (await this.files()).read(this.blobPath(id)).catch(() => null);
+        if (text == null)
+            return null;
+        try {
+            return JSON.parse(text).content;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+/** All blobs for a session, newest first (for the context drawer). */
+export async function listSessionBlobs(files, sessionId, root = sessionsRoot()) {
+    const blobsDir = `${root}/${sessionId}/blobs`;
+    // Same caveat as JsonlSessionStore.list: some backends return a workspace-
+    // rooted tree with the ancestor chain at the top level — flatten and match
+    // the blob files by path instead of trusting the top-level nodes.
+    const nodes = await files.list(blobsDir).catch(() => []);
+    const blobFiles = flattenFiles(nodes).filter((f) => f.path.startsWith(blobsDir + '/') && f.path.endsWith('.json'));
+    const out = [];
+    for (const n of blobFiles) {
+        const text = await files.read(n.path).catch(() => null);
+        if (text == null)
+            continue;
+        try {
+            out.push(JSON.parse(text));
+        }
+        catch { /* skip corrupt */ }
+    }
+    return out.sort((a, b) => b.createdAt - a.createdAt);
+}
+/** Drop a session's offloaded blobs (housekeeping). */
+export async function clearSessionBlobs(files, sessionId, root = sessionsRoot()) {
+    await files.remove(`${root}/${sessionId}/blobs`).catch(() => { });
+}
+/** Delete one offloaded blob (the drawer's Restore removes the record after
+ * re-injecting its content). The id is validated against SAFE_ID — it arrives
+ * from the UI, but the same no-traversal defense as read() applies. Invalid
+ * ids and missing files are silent no-ops. */
+export async function removeSessionBlob(files, sessionId, id, root = sessionsRoot()) {
+    if (!SAFE_ID.test(id))
+        return;
+    await files.remove(`${root}/${sessionId}/blobs/${id}.json`).catch(() => { });
+}
+//# sourceMappingURL=fileRecallStore.js.map

package/dist/sessions/fileRecallStore.js.map

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

package/dist/sessions/fileSessionStore.d.ts

@@ -0,0 +1,20 @@
+import type { AgentSession, FileService, ISessionStore, SessionSurface } from '@corenel/protocol';
+export declare class JsonlSessionStore implements ISessionStore {
+    private getFiles;
+    private root;
+    private cursors;
+    constructor(getFiles: () => FileService | null | Promise<FileService | null>, root?: () => string);
+    private files;
+    private path;
+    create(title: string, surface?: SessionSurface): Promise<AgentSession>;
+    get(id: string): Promise<AgentSession | null>;
+    list(surface?: SessionSurface): Promise<AgentSession[]>;
+    save(session: AgentSession): Promise<void>;
+    /** Cursor for a session this instance hasn't touched (e.g. saved after a
+     * reload): fold the existing file, or start a fresh log from the session's
+     * own meta. */
+    private seed;
+    rename(id: string, title: string): Promise<void>;
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=fileSessionStore.d.ts.map

package/dist/sessions/fileSessionStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileSessionStore.d.ts","sourceRoot":"","sources":["../../sessions/fileSessionStore.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AA4BlG,qBAAa,iBAAkB,YAAW,aAAa;IAInD,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,IAAI;IAJd,OAAO,CAAC,OAAO,CAA6B;gBAGlC,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,EAChE,IAAI,GAAE,MAAM,MAAqB;YAG7B,KAAK;IAMnB,OAAO,CAAC,IAAI;IAIN,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAUtE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAe7C,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmBvD,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BhD;;mBAEe;YACD,IAAI;IAeZ,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYhD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAIxC"}

package/dist/sessions/fileSessionStore.js

@@ -0,0 +1,151 @@
+import { sessionsRoot, flattenFiles } from '@corenel/protocol';
+import { encodeLine, foldSession } from './jsonl';
+function uid(prefix) {
+    return `${prefix}_${Date.now().toString(36)}${Math.floor(Math.random() * 1e6).toString(36)}`;
+}
+/** Strictly-increasing millisecond clock. Plain `Date.now()` ties under fast
+ * synchronous calls (e.g. back-to-back create()/save() in the same tick),
+ * which would make updatedAt-desc ordering ambiguous. Bumping by 1ms on a tie
+ * keeps createdAt/updatedAt monotonic without changing the stored shape. */
+let lastTs = 0;
+function now() {
+    const t = Date.now();
+    lastTs = t > lastTs ? t : lastTs + 1;
+    return lastTs;
+}
+export class JsonlSessionStore {
+    constructor(getFiles, root = sessionsRoot) {
+        Object.defineProperty(this, "getFiles", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: getFiles
+        });
+        Object.defineProperty(this, "root", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: root
+        });
+        Object.defineProperty(this, "cursors", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+    }
+    async files() {
+        const f = await this.getFiles();
+        if (!f)
+            throw new Error('No file workspace is connected — sessions are unavailable.');
+        return f;
+    }
+    path(id) {
+        return `${this.root()}/${id}/SESSION.jsonl`;
+    }
+    async create(title, surface) {
+        const createdAt = now();
+        const id = uid('ses');
+        const meta = { k: 'meta', id, title, createdAt, ...(surface ? { surface } : {}) };
+        const text = encodeLine(meta);
+        await (await this.files()).write(this.path(id), text);
+        this.cursors.set(id, { text, turnJson: [], title });
+        return { id, title, createdAt, updatedAt: createdAt, messages: [], ...(surface ? { surface } : {}) };
+    }
+    async get(id) {
+        const text = await (await this.files()).read(this.path(id)).catch(() => null);
+        if (text == null)
+            return null;
+        const ses = foldSession(text);
+        if (ses) {
+            this.cursors.set(id, {
+                text,
+                turnJson: ses.messages.map((m) => JSON.stringify(m)),
+                title: ses.title,
+                titleLocked: ses.titleLocked,
+            });
+        }
+        return ses;
+    }
+    async list(surface) {
+        const files = await this.files();
+        const root = this.root();
+        // list(dir) shape differs per backend: MemoryFileService returns a tree
+        // rooted at the WORKSPACE root (the top level is the ancestor chain, e.g.
+        // ['.prompd']), while others return dir's children. Never trust the top
+        // level — flatten and match the SESSION.jsonl files by path.
+        const nodes = await files.list(root).catch(() => []);
+        const sessionFiles = flattenFiles(nodes).filter((f) => f.name === 'SESSION.jsonl' && f.path.startsWith(root + '/'));
+        const out = [];
+        for (const f of sessionFiles) {
+            const text = await files.read(f.path).catch(() => null);
+            const ses = text != null ? foldSession(text) : null;
+            if (ses)
+                out.push(ses);
+        }
+        const scoped = surface ? out.filter((s) => s.surface === surface || (surface === 'agent' && !s.surface)) : out;
+        return scoped.sort((a, b) => b.updatedAt - a.updatedAt);
+    }
+    async save(session) {
+        // Compute the timestamp candidate up front but don't touch `session` until we
+        // know something actually changed — a no-op save must not mutate the caller's
+        // object (it should be indistinguishable from not having called save() at all).
+        const at = now();
+        const cur = this.cursors.get(session.id) ?? (await this.seed(session));
+        const turnJson = session.messages.map((m) => JSON.stringify(m));
+        const appended = [];
+        for (let i = 0; i < turnJson.length; i++) {
+            if (cur.turnJson[i] !== turnJson[i]) {
+                appended.push(encodeLine({ k: 'turn', i, at, m: session.messages[i] }));
+            }
+        }
+        if (session.title !== cur.title || session.titleLocked !== cur.titleLocked) {
+            appended.push(encodeLine({
+                k: 'meta-update',
+                at,
+                title: session.title,
+                ...(session.titleLocked !== undefined ? { titleLocked: session.titleLocked } : {}),
+            }));
+        }
+        if (!appended.length)
+            return;
+        session.updatedAt = at;
+        const text = cur.text + appended.join('');
+        await (await this.files()).write(this.path(session.id), text);
+        this.cursors.set(session.id, { text, turnJson, title: session.title, titleLocked: session.titleLocked });
+    }
+    /** Cursor for a session this instance hasn't touched (e.g. saved after a
+     * reload): fold the existing file, or start a fresh log from the session's
+     * own meta. */
+    async seed(session) {
+        const text = await (await this.files()).read(this.path(session.id)).catch(() => null);
+        if (text != null) {
+            const ses = foldSession(text);
+            if (ses) {
+                return { text, turnJson: ses.messages.map((m) => JSON.stringify(m)), title: ses.title, titleLocked: ses.titleLocked };
+            }
+        }
+        const meta = encodeLine({
+            k: 'meta', id: session.id, title: session.title, createdAt: session.createdAt,
+            ...(session.surface ? { surface: session.surface } : {}),
+        });
+        return { text: meta, turnJson: [], title: session.title, titleLocked: undefined };
+    }
+    async rename(id, title) {
+        const cur = this.cursors.get(id);
+        const text = cur?.text ?? (await (await this.files()).read(this.path(id)).catch(() => null));
+        if (text == null)
+            return; // no-op on missing, matching the old store
+        const next = text + encodeLine({ k: 'meta-update', at: now(), title, titleLocked: true });
+        await (await this.files()).write(this.path(id), next);
+        const folded = foldSession(next);
+        if (folded) {
+            this.cursors.set(id, { text: next, turnJson: folded.messages.map((m) => JSON.stringify(m)), title, titleLocked: true });
+        }
+    }
+    async delete(id) {
+        this.cursors.delete(id);
+        await (await this.files()).remove(`${this.root()}/${id}`).catch(() => { });
+    }
+}
+//# sourceMappingURL=fileSessionStore.js.map

package/dist/sessions/fileSessionStore.js.map

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

package/dist/sessions/head.d.ts

@@ -0,0 +1,90 @@
+import type { TimelineEntry } from './timeline';
+export type SessionStatus = 'running' | 'paused' | 'archived' | 'failed' | 'completed';
+/** What the runtime is waiting on. Derived from the tail of the timeline. */
+export type CursorPhase = 'awaiting_model' | 'awaiting_tool_result' | 'awaiting_approval' | 'idle';
+/** A question only a human can answer. Survives transport: an approval requested
+ * on the laptop and answered from the phone is the SAME object, and only the
+ * client differs (spec s4.4.4). */
+export interface PendingApproval {
+    id: string;
+    kind: 'tool_permission' | 'resume_unknown' | 'budget';
+    callId: string | null;
+    /** The timeline entry this is about, so an answer can be attributed. */
+    index: number;
+    question: string;
+    options: {
+        id: string;
+        label: string;
+    }[];
+    requestedAt: string;
+}
+export interface SessionHead {
+    schemaVersion: 1;
+    sessionId: string;
+    status: SessionStatus;
+    updatedAt: string;
+    task?: {
+        id: string;
+        objective: string;
+        cwd: string;
+    };
+    agent?: {
+        package: string;
+        version: string;
+        entrypoint: string;
+    };
+    cursor: {
+        nextIndex: number;
+        phase: CursorPhase;
+    };
+    pendingApproval: PendingApproval | null;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        wallMs: number;
+    };
+    /** Opaque workflow position when the session is running a .pdflow package.
+     * Corenel stores and returns it; the workflow runtime owns its meaning. */
+    workflow?: {
+        package: string;
+        version: string;
+        position: unknown;
+        completedNodes: {
+            id: string;
+            outputRef: string;
+        }[];
+    };
+}
+export declare const HEAD_VERSION: 1;
+export interface DeriveHeadInput {
+    sessionId: string;
+    entries: readonly TimelineEntry[];
+    nextIndex: number;
+    updatedAt: string;
+    /** Carried through unchanged — none of it is derivable from the timeline. */
+    carry?: Pick<SessionHead, 'task' | 'agent' | 'workflow' | 'pendingApproval'>;
+    /** The session's own status when it is not implied by the timeline (paused,
+     * archived). Absent, the phase decides between running and idle. */
+    status?: SessionStatus;
+}
+/**
+ * Rebuild the head from the timeline.
+ *
+ * The phase comes from the LAST entry, because that is what the runtime is
+ * actually blocked on:
+ *   - a tool call still `executing`  -> awaiting_tool_result
+ *   - a user message with no reply   -> awaiting_model
+ *   - an approval outstanding        -> awaiting_approval (it outranks the rest;
+ *                                       nothing proceeds until it is answered)
+ *   - anything else                  -> idle
+ */
+export declare function deriveHead(input: DeriveHeadInput): SessionHead;
+export declare function serializeHead(head: SessionHead): string;
+/**
+ * Parse a stored head, or null when it is unusable.
+ *
+ * Null is not an error condition for the caller: the head is a cache, so the
+ * answer to "it did not parse" is "fold the log again", never "fail the session".
+ */
+export declare function parseHead(text: string): SessionHead | null;
+//# sourceMappingURL=head.d.ts.map

package/dist/sessions/head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../../sessions/head.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEvF,6EAA6E;AAC7E,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,sBAAsB,GAAG,mBAAmB,GAAG,MAAM,CAAC;AAEnG;;mCAEmC;AACnC,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,QAAQ,CAAC;IACtD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,CAAC,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,WAAW,CAAA;KAAE,CAAC;IAClD,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE;+EAC2E;IAC3E,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,cAAc,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC;CACzH;AAED,eAAO,MAAM,YAAY,EAAG,CAAU,CAAC;AAEvC,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,iBAAiB,CAAC,CAAC;IAC7E;wEACoE;IACpE,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,WAAW,CAqB9D;AAsBD,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAO1D"}

package/dist/sessions/head.js

@@ -0,0 +1,82 @@
+export const HEAD_VERSION = 1;
+/**
+ * Rebuild the head from the timeline.
+ *
+ * The phase comes from the LAST entry, because that is what the runtime is
+ * actually blocked on:
+ *   - a tool call still `executing`  -> awaiting_tool_result
+ *   - a user message with no reply   -> awaiting_model
+ *   - an approval outstanding        -> awaiting_approval (it outranks the rest;
+ *                                       nothing proceeds until it is answered)
+ *   - anything else                  -> idle
+ */
+export function deriveHead(input) {
+    const pendingApproval = input.carry?.pendingApproval ?? null;
+    const last = input.entries[input.entries.length - 1];
+    let phase = 'idle';
+    if (pendingApproval)
+        phase = 'awaiting_approval';
+    else if (input.entries.some((e) => e.type === 'tool_call' && e.status === 'executing'))
+        phase = 'awaiting_tool_result';
+    else if (last?.type === 'user_message')
+        phase = 'awaiting_model';
+    return {
+        schemaVersion: HEAD_VERSION,
+        sessionId: input.sessionId,
+        status: input.status ?? (phase === 'idle' ? 'completed' : 'running'),
+        updatedAt: input.updatedAt,
+        ...(input.carry?.task ? { task: input.carry.task } : {}),
+        ...(input.carry?.agent ? { agent: input.carry.agent } : {}),
+        ...(input.carry?.workflow ? { workflow: input.carry.workflow } : {}),
+        cursor: { nextIndex: input.nextIndex, phase },
+        pendingApproval,
+        usage: usageOf(input.entries),
+    };
+}
+/** Token and wall-clock totals, summed from the timeline rather than tracked
+ * separately — a counter that drifts from the log is worse than no counter. */
+function usageOf(entries) {
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let wallMs = 0;
+    for (const e of entries) {
+        const u = e.usage;
+        if (u && typeof u === 'object') {
+            if (typeof u.inputTokens === 'number')
+                inputTokens += u.inputTokens;
+            if (typeof u.outputTokens === 'number')
+                outputTokens += u.outputTokens;
+        }
+        if (e.type === 'tool_call' && e.startedAt && e.completedAt) {
+            const ms = Date.parse(e.completedAt) - Date.parse(e.startedAt);
+            if (Number.isFinite(ms) && ms > 0)
+                wallMs += ms;
+        }
+    }
+    return { inputTokens, outputTokens, wallMs };
+}
+export function serializeHead(head) {
+    return JSON.stringify(head, null, 2) + '\n';
+}
+/**
+ * Parse a stored head, or null when it is unusable.
+ *
+ * Null is not an error condition for the caller: the head is a cache, so the
+ * answer to "it did not parse" is "fold the log again", never "fail the session".
+ */
+export function parseHead(text) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+        return null;
+    const h = parsed;
+    if (h.schemaVersion !== HEAD_VERSION || typeof h.sessionId !== 'string' || !h.cursor)
+        return null;
+    return h;
+}
+//# sourceMappingURL=head.js.map

package/dist/sessions/head.js.map

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

package/dist/sessions/inflight.d.ts

@@ -0,0 +1,58 @@
+export interface InflightWork {
+    sessionId: string;
+    /** The tool call this represents, for the report when a drain times out. */
+    callId: string;
+    startedAt: number;
+}
+export interface DrainResult {
+    /** True when everything finished before the deadline. */
+    drained: boolean;
+    /** Call ids still running when we gave up. Empty when `drained`. */
+    remaining: string[];
+    /** How long the drain actually waited. */
+    waitedMs: number;
+}
+export interface DrainOptions {
+    /** Give up after this long. 0 means "do not wait at all". */
+    timeoutMs: number;
+    /** Poll interval. Small enough to feel instant, large enough not to spin. */
+    stepMs?: number;
+    now: () => number;
+    sleep: (ms: number) => Promise<void>;
+}
+/**
+ * Tracks the tool calls currently running per session.
+ *
+ * Deliberately a registry the runtime writes to, rather than something the
+ * backend infers: only the caller knows when a tool call starts and ends, and a
+ * backend guessing at it would be wrong in exactly the cases that matter.
+ */
+export declare class InflightRegistry {
+    private readonly work;
+    private key;
+    begin(sessionId: string, callId: string, at: number): void;
+    /** Idempotent: ending a call that already ended is a no-op, not an error, so
+     * cleanup paths can be unconditional. */
+    end(sessionId: string, callId: string): void;
+    /** Call ids running for a session, oldest first — the oldest is the one most
+     * likely to be stuck, so it leads the report. */
+    running(sessionId: string): string[];
+    count(sessionId: string): number;
+    /** Forget a session's work outright — for destroy, where nothing is coming back. */
+    clear(sessionId: string): void;
+    /**
+     * Wait for a session's in-flight work to finish.
+     *
+     * Returns rather than throwing on timeout: a drain that could not complete is
+     * information the caller has to act on (record a problem, mark entries
+     * `executing`), not an error that should abandon the export. Losing the
+     * snapshot because one tool hung would be a worse outcome than a torn one that
+     * says it is torn.
+     */
+    drain(sessionId: string, opts: DrainOptions): Promise<DrainResult>;
+}
+/** Default drain budget. Long enough for an ordinary file write or a short
+ * command, short enough that closing a laptop still feels immediate. Overridable
+ * per call, so a hosted runner and a laptop can differ. */
+export declare const DEFAULT_DRAIN_MS = 5000;
+//# sourceMappingURL=inflight.d.ts.map

package/dist/sessions/inflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inflight.d.ts","sourceRoot":"","sources":["../../sessions/inflight.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmC;IAExD,OAAO,CAAC,GAAG;IAIX,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAI1D;6CACyC;IACzC,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAI5C;qDACiD;IACjD,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;IAOpC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIhC,oFAAoF;IACpF,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI9B;;;;;;;;OAQG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;CAWzE;AAED;;2DAE2D;AAC3D,eAAO,MAAM,gBAAgB,OAAO,CAAC"}

package/dist/sessions/inflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inflight.js","sourceRoot":"","sources":["../../sessions/inflight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AA2BH;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IAA7B;QACmB;;;;mBAAO,IAAI,GAAG,EAAwB;WAAC;IAsD1D,CAAC;IApDS,GAAG,CAAC,SAAiB,EAAE,MAAc;QAC3C,OAAO,GAAG,SAAS,IAAI,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,SAAiB,EAAE,MAAc,EAAE,EAAU;QACjD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;IACnF,CAAC;IAED;6CACyC;IACzC,GAAG,CAAC,SAAiB,EAAE,MAAc;QACnC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,CAAC;IAED;qDACiD;IACjD,OAAO,CAAC,SAAiB;QACvB,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;aAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC;aACxC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;aACzC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,SAAiB;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;IACxC,CAAC;IAED,oFAAoF;IACpF,KAAK,CAAC,SAAiB;QACrB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAK,CAAC,SAAiB,EAAE,IAAkB;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QAC5C,SAAS,CAAC;YACR,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAC1C,IAAI,CAAC,SAAS,CAAC,MAAM;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;YAC7F,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YAClC,IAAI,MAAM,IAAI,IAAI,CAAC,SAAS;gBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;YACrF,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;CACF;AAED;;2DAE2D;AAC3D,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC"}

package/dist/sessions/jsonl.d.ts

@@ -0,0 +1,23 @@
+import type { AgentSession, SessionSurface } from '@corenel/protocol';
+export type SessionLine = {
+    k: 'meta';
+    id: string;
+    title: string;
+    createdAt: number;
+    surface?: SessionSurface;
+} | {
+    k: 'meta-update';
+    at: number;
+    title?: string;
+    titleLocked?: boolean;
+} | {
+    k: 'turn';
+    i: number;
+    at: number;
+    m: unknown;
+};
+export declare function encodeLine(line: SessionLine): string;
+/** Fold a SESSION.jsonl text into an AgentSession, or null when no valid meta
+ * line exists (empty/foreign file). */
+export declare function foldSession(text: string): AgentSession | null;
+//# sourceMappingURL=jsonl.d.ts.map

package/dist/sessions/jsonl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.d.ts","sourceRoot":"","sources":["../../sessions/jsonl.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEtE,MAAM,MAAM,WAAW,GACnB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,cAAc,CAAA;CAAE,GACrF;IAAE,CAAC,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GACvE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAErD,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAEpD;AAED;uCACuC;AACvC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAkC7D"}

package/dist/sessions/jsonl.js

@@ -0,0 +1,52 @@
+export function encodeLine(line) {
+    return JSON.stringify(line) + '\n';
+}
+/** Fold a SESSION.jsonl text into an AgentSession, or null when no valid meta
+ * line exists (empty/foreign file). */
+export function foldSession(text) {
+    let meta = null;
+    const turns = [];
+    let title = '';
+    let titleLocked;
+    let updatedAt = 0;
+    for (const raw of text.split('\n')) {
+        const s = raw.trim();
+        if (!s)
+            continue;
+        let line;
+        try {
+            line = JSON.parse(s);
+        }
+        catch {
+            continue;
+        }
+        if (line.k === 'meta' && !meta && typeof line.id === 'string' && typeof line.createdAt === 'number') {
+            meta = line;
+            title = typeof line.title === 'string' ? line.title : '';
+            updatedAt = Math.max(updatedAt, line.createdAt);
+        }
+        else if (line.k === 'meta-update' && typeof line.at === 'number') {
+            if (typeof line.title === 'string')
+                title = line.title;
+            if (typeof line.titleLocked === 'boolean')
+                titleLocked = line.titleLocked;
+            updatedAt = Math.max(updatedAt, line.at);
+        }
+        else if (line.k === 'turn' && Number.isInteger(line.i) && line.i >= 0 && typeof line.at === 'number') {
+            turns[line.i] = line.m;
+            updatedAt = Math.max(updatedAt, line.at);
+        }
+    }
+    if (!meta)
+        return null;
+    return {
+        id: meta.id,
+        title,
+        createdAt: meta.createdAt,
+        updatedAt: updatedAt || meta.createdAt,
+        messages: turns.filter((t) => t !== undefined),
+        ...(meta.surface ? { surface: meta.surface } : {}),
+        ...(titleLocked !== undefined ? { titleLocked } : {}),
+    };
+}
+//# sourceMappingURL=jsonl.js.map