@saihm/shm 0.0.0-stage → 0.38.0

package/dist/host/index.js

@@ -0,0 +1,10 @@
+export { HostHookAdapter, DEFAULT_HOST_TURN_ITEMS, DEFAULT_HOST_ACTION_ITEMS, DEFAULT_HOST_OVERFETCH, DEFAULT_HOST_WINDOWS, } from "./adapter.js";
+export { parseHostEvent, forwardableEvent, HOST_EVENT_FIELDS } from "./event.js";
+export { hostReply, sanitizeHostReply, serializeHostReply } from "./reply.js";
+export { TranscriptCompactionCounter } from "./compaction.js";
+export { runHostHook } from "./client.js";
+export { MAX_SOCKET_PATH_BYTES, socketPathProblem } from "./socket_path.js";
+export { sessionsUnder, ALL_SESSIONS } from "./sessions.js";
+export { parseSessionStartEvent, forwardableSessionStart, SESSION_START_FIELDS, } from "./session_start_event.js";
+export { SessionStartBrief, routeHostHooks, checkpointFromLedger, workstreamsOf, DEFAULT_BRIEF_MAX_CHARS, DEFAULT_BRIEF_SOURCE_TIMEOUT_MS, } from "./session_brief.js";
+//# sourceMappingURL=index.js.map

package/dist/host/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/host/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,GAMrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAA0E,MAAM,YAAY,CAAC;AACzJ,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,kBAAkB,EAAsB,MAAM,YAAY,CAAC;AAClG,OAAO,EAAE,2BAA2B,EAAyD,MAAM,iBAAiB,CAAC;AACrH,OAAO,EAAE,WAAW,EAA+E,MAAM,aAAa,CAAC;AACvH,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,YAAY,EAA0C,MAAM,eAAe,CAAC;AACpG,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,GAGrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,uBAAuB,EACvB,+BAA+B,GAQhC,MAAM,oBAAoB,CAAC"}

package/dist/host/reply.d.ts

@@ -0,0 +1,11 @@
+import type { HostEventName } from "./event.js";
+export interface HostHookReply<E extends string = HostEventName> {
+    readonly hookSpecificOutput: {
+        readonly hookEventName: E;
+        readonly additionalContext: string;
+    };
+}
+export declare function hostReply<E extends string>(eventName: E, additionalContext: string): HostHookReply<E>;
+export declare function sanitizeHostReply<E extends string>(value: unknown, expected: E, maxChars: number): HostHookReply<E> | undefined;
+export declare function serializeHostReply(reply: HostHookReply<string>): string;
+//# sourceMappingURL=reply.d.ts.map

package/dist/host/reply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply.d.ts","sourceRoot":"","sources":["../../src/host/reply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,aAAa;IAC7D,QAAQ,CAAC,kBAAkB,EAAE;QAC3B,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;QAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;KACpC,CAAC;CACH;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,iBAAiB,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAErG;AAED,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAY/H;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,CAEvE"}

package/dist/host/reply.js

@@ -0,0 +1,24 @@
+export function hostReply(eventName, additionalContext) {
+    return { hookSpecificOutput: { hookEventName: eventName, additionalContext } };
+}
+export function sanitizeHostReply(value, expected, maxChars) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return undefined;
+    const hso = Object.prototype.hasOwnProperty.call(value, "hookSpecificOutput")
+        ? value["hookSpecificOutput"]
+        : undefined;
+    if (typeof hso !== "object" || hso === null || Array.isArray(hso))
+        return undefined;
+    const o = hso;
+    const name = Object.prototype.hasOwnProperty.call(o, "hookEventName") ? o["hookEventName"] : undefined;
+    const ctx = Object.prototype.hasOwnProperty.call(o, "additionalContext") ? o["additionalContext"] : undefined;
+    if (name !== expected)
+        return undefined;
+    if (typeof ctx !== "string" || ctx.trim() === "" || ctx.length > maxChars)
+        return undefined;
+    return hostReply(expected, ctx);
+}
+export function serializeHostReply(reply) {
+    return `${JSON.stringify(hostReply(reply.hookSpecificOutput.hookEventName, reply.hookSpecificOutput.additionalContext))}\n`;
+}
+//# sourceMappingURL=reply.js.map

package/dist/host/reply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply.js","sourceRoot":"","sources":["../../src/host/reply.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,SAAS,CAAmB,SAAY,EAAE,iBAAyB;IACjF,OAAO,EAAE,kBAAkB,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,iBAAiB,EAAE,EAAE,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAmB,KAAc,EAAE,QAAW,EAAE,QAAgB;IAC/F,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1F,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,oBAAoB,CAAC;QAC3E,CAAC,CAAE,KAAiC,CAAC,oBAAoB,CAAC;QAC1D,CAAC,CAAC,SAAS,CAAC;IACd,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACpF,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvG,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9G,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,CAAC,MAAM,GAAG,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC5F,OAAO,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAA4B;IAC7D,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,kBAAkB,CAAC,aAAa,EAAE,KAAK,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC;AAC9H,CAAC"}

package/dist/host/session_brief.d.ts

@@ -0,0 +1,80 @@
+import { type CheckpointState } from "../derived/checkpoint.js";
+import type { MintedLedger } from "../derived/ledger.js";
+import type { SaihmDerivedStore } from "../derived/store.js";
+import { type Probe } from "../resume/resume.js";
+import { type HostHookReply } from "./reply.js";
+import type { SessionAdmission } from "./sessions.js";
+import { type SessionStartSource } from "./session_start_event.js";
+export declare const DEFAULT_BRIEF_MAX_CHARS = 6000;
+export declare const DEFAULT_BRIEF_SOURCE_TIMEOUT_MS = 1500;
+export interface SessionCheckpoint {
+    readonly id: string;
+    readonly state: CheckpointState;
+}
+export interface WorkstreamLine {
+    readonly slug: string;
+    readonly members: number;
+    readonly status?: string;
+}
+export interface SessionStartBriefOptions {
+    readonly admitSession: SessionAdmission;
+    readonly checkpoint?: () => Promise<SessionCheckpoint | undefined>;
+    readonly probes?: () => Promise<Readonly<Record<string, Probe>>>;
+    readonly here?: string;
+    readonly matches?: (stated: string, actual: string) => boolean;
+    readonly workstreams?: () => Promise<readonly WorkstreamLine[]>;
+    readonly sources?: readonly SessionStartSource[];
+    readonly maxChars?: number;
+    readonly sourceTimeoutMs?: number;
+    readonly onBrief?: (record: SessionBriefRecord) => void;
+}
+export type BriefSection = "shown" | "none" | "unavailable" | "not-configured";
+export interface SessionBriefRecord {
+    readonly eventName: "SessionStart";
+    readonly source: SessionStartSource;
+    readonly outcome: "fired" | "off" | "silent" | "error";
+    readonly reason?: "no-session-binding" | "foreign-session" | "source-not-served" | "nothing-configured" | "too-small" | "fault";
+    readonly checkpoint: BriefSection;
+    readonly checkpointFault?: SourceFault;
+    readonly probes: "ran" | "unavailable" | "not-run";
+    readonly claims: number;
+    readonly holds: number;
+    readonly drifted: number;
+    readonly unverifiable: number;
+    readonly foreign: number;
+    readonly safeToResume: boolean;
+    readonly workstreams: BriefSection;
+    readonly workstreamsFault?: SourceFault;
+    readonly workstreamCount: number;
+    readonly lines: number;
+    readonly linesNotShown: number;
+    readonly chars: number;
+    readonly neutralized: boolean;
+}
+export type SourceFault = "failed" | "timeout" | "malformed";
+export declare class SessionStartBrief {
+    private readonly opts;
+    private readonly maxChars;
+    private readonly sourceTimeoutMs;
+    constructor(opts: SessionStartBriefOptions);
+    handle(payload: unknown): Promise<HostHookReply<"SessionStart"> | undefined>;
+    private lines;
+    private audit;
+}
+export interface HookHandler {
+    handle(payload: unknown): Promise<HostHookReply<string> | undefined>;
+}
+export declare function routeHostHooks(routes: {
+    readonly adapter?: HookHandler;
+    readonly sessionStart?: HookHandler;
+}): HookHandler;
+export declare function checkpointFromLedger(store: SaihmDerivedStore, ledger: MintedLedger, thread: string): () => Promise<SessionCheckpoint | undefined>;
+export declare function workstreamsOf(session: {
+    threads(): ReadonlyMap<string, number>;
+    thread(slug: string): {
+        readonly status?: string | undefined;
+    };
+}, opts?: {
+    readonly status?: "open" | "any";
+}): () => Promise<readonly WorkstreamLine[]>;
+//# sourceMappingURL=session_brief.d.ts.map

package/dist/host/session_brief.d.ts.map

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

package/dist/host/session_brief.js

@@ -0,0 +1,294 @@
+import { buildInjectionContext } from "../answer/context.js";
+import { encodeCheckpointText, latestCheckpoint, parseCheckpointText, readCheckpoint } from "../derived/checkpoint.js";
+import { verifyResume } from "../resume/resume.js";
+import { hostReply } from "./reply.js";
+import { parseSessionStartEvent } from "./session_start_event.js";
+export const DEFAULT_BRIEF_MAX_CHARS = 6000;
+export const DEFAULT_BRIEF_SOURCE_TIMEOUT_MS = 1500;
+const NOTE_CHARS = 1500;
+const LINE_CHARS = 300;
+const SLUG_CHARS = 80;
+const BRIEF_BLOCK_ID = "session-brief";
+const posIntElse = (v, dflt) => Number.isInteger(v) && v > 0 ? v : dflt;
+const clip = (s, n) => (s.length <= n ? s : `${s.slice(0, n - 1)}…`);
+async function sourced(fn, ms) {
+    let timer;
+    const timeout = new Promise((resolve) => {
+        timer = setTimeout(() => resolve({ ok: false, fault: "timeout" }), ms);
+    });
+    const run = (async () => {
+        try {
+            return { ok: true, value: await fn() };
+        }
+        catch {
+            return { ok: false, fault: "failed" };
+        }
+    })();
+    try {
+        return await Promise.race([run, timeout]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function wellFormed(cp) {
+    if (typeof cp !== "object" || cp === null)
+        return undefined;
+    const o = cp;
+    if (typeof o.id !== "string" || o.id.trim() === "")
+        return undefined;
+    try {
+        const state = parseCheckpointText(encodeCheckpointText(o.state));
+        return state === undefined ? undefined : { id: o.id.trim(), state };
+    }
+    catch {
+        return undefined;
+    }
+}
+function wellFormedWorkstreams(v) {
+    if (!Array.isArray(v))
+        return undefined;
+    const out = [];
+    for (const w of v) {
+        if (typeof w !== "object" || w === null)
+            return undefined;
+        const r = w;
+        if (typeof r.slug !== "string" || r.slug.trim() === "")
+            return undefined;
+        const members = Number.isInteger(r.members) && r.members >= 0 ? r.members : -1;
+        out.push({ slug: r.slug.trim(), members, ...(typeof r.status === "string" ? { status: r.status } : {}) });
+    }
+    return out;
+}
+export class SessionStartBrief {
+    opts;
+    maxChars;
+    sourceTimeoutMs;
+    constructor(opts) {
+        this.opts = opts;
+        this.maxChars = posIntElse(opts.maxChars, DEFAULT_BRIEF_MAX_CHARS);
+        this.sourceTimeoutMs = posIntElse(opts.sourceTimeoutMs, DEFAULT_BRIEF_SOURCE_TIMEOUT_MS);
+    }
+    async handle(payload) {
+        const event = parseSessionStartEvent(payload);
+        if (event === undefined)
+            return undefined;
+        const base = {
+            eventName: "SessionStart", source: event.source, outcome: "off",
+            checkpoint: "not-configured", probes: "not-run",
+            claims: 0, holds: 0, drifted: 0, unverifiable: 0, foreign: 0, safeToResume: false,
+            workstreams: "not-configured", workstreamCount: 0,
+            lines: 0, linesNotShown: 0, chars: 0, neutralized: false,
+        };
+        const observe = (r) => {
+            try {
+                this.opts.onBrief?.(r);
+            }
+            catch { }
+        };
+        try {
+            const admit = this.opts.admitSession;
+            if (typeof admit !== "function") {
+                observe({ ...base, reason: "no-session-binding" });
+                return undefined;
+            }
+            let admitted = false;
+            try {
+                admitted = admit(event) === true;
+            }
+            catch {
+                admitted = false;
+            }
+            if (!admitted) {
+                observe({ ...base, reason: "foreign-session" });
+                return undefined;
+            }
+            const served = this.opts.sources;
+            if (served !== undefined && !served.includes(event.source)) {
+                observe({ ...base, reason: "source-not-served" });
+                return undefined;
+            }
+            if (this.opts.checkpoint === undefined && this.opts.workstreams === undefined) {
+                observe({ ...base, reason: "nothing-configured" });
+                return undefined;
+            }
+            const ms = this.sourceTimeoutMs;
+            const [cpRaw, wsRaw] = await Promise.all([
+                this.opts.checkpoint === undefined ? undefined : sourced(this.opts.checkpoint, ms),
+                this.opts.workstreams === undefined ? undefined : sourced(this.opts.workstreams, ms),
+            ]);
+            let record = { ...base };
+            let checkpoint;
+            let report;
+            if (cpRaw !== undefined) {
+                if (!cpRaw.ok) {
+                    record = { ...record, checkpoint: "unavailable", checkpointFault: cpRaw.fault };
+                }
+                else if (cpRaw.value === undefined) {
+                    record = { ...record, checkpoint: "none" };
+                }
+                else {
+                    checkpoint = wellFormed(cpRaw.value);
+                    if (checkpoint === undefined) {
+                        record = { ...record, checkpoint: "unavailable", checkpointFault: "malformed" };
+                    }
+                    else {
+                        let probes = {};
+                        let probesState = "not-run";
+                        if (this.opts.probes !== undefined) {
+                            const pr = await sourced(this.opts.probes, ms);
+                            const ok = pr.ok && typeof pr.value === "object" && pr.value !== null && !Array.isArray(pr.value);
+                            probes = ok ? pr.value : {};
+                            probesState = ok ? "ran" : "unavailable";
+                        }
+                        try {
+                            report = verifyResume(checkpoint.state.claims, probes, {
+                                ...(this.opts.here !== undefined ? { here: this.opts.here } : {}),
+                                ...(this.opts.matches !== undefined ? { matches: this.opts.matches } : {}),
+                            });
+                        }
+                        catch {
+                            report = undefined;
+                        }
+                        record = report === undefined
+                            ? { ...record, checkpoint: "unavailable", checkpointFault: "failed", probes: probesState }
+                            : {
+                                ...record, checkpoint: "shown", probes: probesState,
+                                claims: report.claims.length, holds: report.holds, drifted: report.drifted,
+                                unverifiable: report.unverifiable, foreign: report.foreign, safeToResume: report.safeToResume,
+                            };
+                        if (report === undefined)
+                            checkpoint = undefined;
+                    }
+                }
+            }
+            let workstreams;
+            if (wsRaw !== undefined) {
+                if (!wsRaw.ok) {
+                    record = { ...record, workstreams: "unavailable", workstreamsFault: wsRaw.fault };
+                }
+                else {
+                    workstreams = wellFormedWorkstreams(wsRaw.value);
+                    record = workstreams === undefined
+                        ? { ...record, workstreams: "unavailable", workstreamsFault: "malformed" }
+                        : { ...record, workstreams: workstreams.length === 0 ? "none" : "shown", workstreamCount: workstreams.length };
+                }
+            }
+            const lines = this.lines(checkpoint, report, workstreams);
+            for (let k = lines.length; k >= 0; k--) {
+                const notShown = lines.length - k;
+                const shown = lines.slice(0, k);
+                if (notShown > 0)
+                    shown.push(`… ${notShown} more line(s) not shown (brief limit ${this.maxChars} chars)`);
+                if (shown.length === 0)
+                    shown.push("nothing could be assembled");
+                const ctx = buildInjectionContext([{ cellId: BRIEF_BLOCK_ID, plaintext: shown.join("\n"), epoch: 0, tier: "brief" }]);
+                if (ctx.prompt === "")
+                    continue;
+                const text = `${this.audit(event.source, record, notShown, ctx.neutralized)}\n${ctx.prompt}`;
+                if (text.length > this.maxChars)
+                    continue;
+                observe({ ...record, outcome: "fired", lines: lines.length, linesNotShown: notShown, chars: text.length, neutralized: ctx.neutralized });
+                return hostReply("SessionStart", text);
+            }
+            observe({ ...record, outcome: "silent", reason: "too-small", lines: lines.length, linesNotShown: lines.length });
+            return undefined;
+        }
+        catch {
+            observe({ ...base, outcome: "error", reason: "fault" });
+            return undefined;
+        }
+    }
+    lines(checkpoint, report, workstreams) {
+        const out = [];
+        if (checkpoint !== undefined && report !== undefined) {
+            out.push(clip(`checkpoint ${checkpoint.id} — ${report.verdict}`, LINE_CHARS));
+            for (const c of report.claims)
+                if (c.verdict === "drifted")
+                    out.push(clip(c.note, LINE_CHARS));
+            for (const c of report.claims)
+                if (c.verdict === "unverifiable")
+                    out.push(clip(c.note, LINE_CHARS));
+            if (checkpoint.state.note !== undefined && checkpoint.state.note.trim() !== "") {
+                out.push(clip(`where it stopped: ${checkpoint.state.note.trim()}`, NOTE_CHARS));
+            }
+            for (const c of report.claims)
+                if (c.verdict === "foreign")
+                    out.push(clip(c.note, LINE_CHARS));
+            const held = report.claims.filter((c) => c.verdict === "holds").map((c) => c.claim.id);
+            if (held.length > 0)
+                out.push(clip(`holds (${held.length}): ${held.join(", ")}`, LINE_CHARS));
+        }
+        if (workstreams !== undefined && workstreams.length > 0) {
+            out.push(`workstreams (${workstreams.length}), as the source reported them:`);
+            for (const w of workstreams) {
+                const members = w.members >= 0 ? `${w.members} member(s)` : "members unknown";
+                out.push(`  ${clip(w.slug, SLUG_CHARS)} — ${members}${w.status !== undefined ? `, ${clip(w.status, SLUG_CHARS)}` : ""}`);
+            }
+        }
+        return out;
+    }
+    audit(source, r, notShown, neutralized) {
+        const parts = [];
+        if (r.checkpoint === "shown") {
+            const head = r.safeToResume ? "RESUME SAFE" : r.drifted > 0 ? "DRIFTED" : "NOT CLEARED";
+            parts.push(`checkpoint ${head} — ${r.holds} hold, ${r.drifted} drifted, ${r.unverifiable} unverifiable, ${r.foreign} foreign` +
+                (r.probes === "unavailable" ? " (probes UNAVAILABLE)" : r.probes === "not-run" ? " (no probes)" : ""));
+        }
+        else if (r.checkpoint === "none") {
+            parts.push("no checkpoint");
+        }
+        else if (r.checkpoint === "unavailable") {
+            parts.push(`checkpoint UNAVAILABLE (${r.checkpointFault ?? "failed"})`);
+        }
+        if (r.workstreams === "shown" || r.workstreams === "none")
+            parts.push(`${r.workstreamCount} workstream(s)`);
+        else if (r.workstreams === "unavailable")
+            parts.push(`workstreams UNAVAILABLE (${r.workstreamsFault ?? "failed"})`);
+        return (`⇱ SHM session brief (${source}): ${parts.join("; ")}` +
+            (notShown > 0 ? ` ⚠ ${notShown} line(s) not shown` : "") +
+            (neutralized ? " ⚠ a line tried to forge a delimiter" : ""));
+    }
+}
+export function routeHostHooks(routes) {
+    return {
+        async handle(payload) {
+            const name = typeof payload === "object" && payload !== null && !Array.isArray(payload)
+                && Object.prototype.hasOwnProperty.call(payload, "hook_event_name")
+                ? payload["hook_event_name"]
+                : undefined;
+            const route = name === "SessionStart" ? routes.sessionStart : routes.adapter;
+            if (route === undefined)
+                return undefined;
+            try {
+                return await route.handle(payload);
+            }
+            catch {
+                return undefined;
+            }
+        },
+    };
+}
+export function checkpointFromLedger(store, ledger, thread) {
+    return async () => {
+        const rec = await latestCheckpoint(ledger, thread);
+        if (rec === undefined)
+            return undefined;
+        const state = await readCheckpoint(store, rec.cellId);
+        if (state === undefined)
+            throw new Error("the newest checkpoint could not be read");
+        return { id: rec.cellId, state };
+    };
+}
+export function workstreamsOf(session, opts = {}) {
+    return async () => {
+        const rows = [...session.threads().entries()]
+            .sort((a, b) => a[0].localeCompare(b[0]))
+            .map(([slug, members]) => {
+            const status = session.thread(slug).status;
+            return { slug, members, ...(status !== undefined ? { status } : {}) };
+        });
+        return (opts.status ?? "open") === "open" ? rows.filter((r) => r.status === "open") : rows;
+    };
+}
+//# sourceMappingURL=session_brief.js.map

package/dist/host/session_brief.js.map

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

package/dist/host/session_start_event.d.ts

@@ -0,0 +1,12 @@
+export type SessionStartSource = "startup" | "resume" | "clear" | "compact" | "fork" | "unknown";
+export declare const SESSION_START_FIELDS: readonly string[];
+export interface SessionStartEvent {
+    readonly kind: "session-start";
+    readonly eventName: "SessionStart";
+    readonly source: SessionStartSource;
+    readonly sessionId?: string;
+    readonly transcriptPath?: string;
+}
+export declare function parseSessionStartEvent(payload: unknown): SessionStartEvent | undefined;
+export declare function forwardableSessionStart(payload: unknown): Record<string, unknown> | undefined;
+//# sourceMappingURL=session_start_event.d.ts.map

package/dist/host/session_start_event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session_start_event.d.ts","sourceRoot":"","sources":["../../src/host/session_start_event.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAIjG,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAmE,CAAC;AAEtH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAQD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAkBtF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAO7F"}

package/dist/host/session_start_event.js

@@ -0,0 +1,35 @@
+import { parseHostEvent } from "./event.js";
+const KNOWN_SOURCES = new Set(["startup", "resume", "clear", "compact", "fork"]);
+export const SESSION_START_FIELDS = ["hook_event_name", "session_id", "transcript_path", "source"];
+const isPlainObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+const own = (o, k) => Object.prototype.hasOwnProperty.call(o, k) ? o[k] : undefined;
+export function parseSessionStartEvent(payload) {
+    if (!isPlainObject(payload) || own(payload, "hook_event_name") !== "SessionStart")
+        return undefined;
+    const ids = parseHostEvent({
+        hook_event_name: "UserPromptSubmit",
+        prompt: "session-start",
+        session_id: own(payload, "session_id"),
+        transcript_path: own(payload, "transcript_path"),
+    });
+    const src = own(payload, "source");
+    const source = typeof src === "string" && KNOWN_SOURCES.has(src) ? src : "unknown";
+    return {
+        kind: "session-start",
+        eventName: "SessionStart",
+        source,
+        ...(ids?.sessionId !== undefined ? { sessionId: ids.sessionId } : {}),
+        ...(ids?.transcriptPath !== undefined ? { transcriptPath: ids.transcriptPath } : {}),
+    };
+}
+export function forwardableSessionStart(payload) {
+    if (!isPlainObject(payload) || own(payload, "hook_event_name") !== "SessionStart")
+        return undefined;
+    const out = {};
+    for (const k of SESSION_START_FIELDS) {
+        if (Object.prototype.hasOwnProperty.call(payload, k))
+            out[k] = payload[k];
+    }
+    return out;
+}
+//# sourceMappingURL=session_start_event.js.map

package/dist/host/session_start_event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session_start_event.js","sourceRoot":"","sources":["../../src/host/session_start_event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAI5C,MAAM,aAAa,GAAwB,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAEtG,MAAM,CAAC,MAAM,oBAAoB,GAAsB,CAAC,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,EAAE,QAAQ,CAAC,CAAC;AAUtH,MAAM,aAAa,GAAG,CAAC,CAAU,EAAgC,EAAE,CACjE,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAE3D,MAAM,GAAG,GAAG,CAAC,CAA0B,EAAE,CAAS,EAAW,EAAE,CAC7D,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAEhE,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,iBAAiB,CAAC,KAAK,cAAc;QAAE,OAAO,SAAS,CAAC;IACpG,MAAM,GAAG,GAAG,cAAc,CAAC;QACzB,eAAe,EAAE,kBAAkB;QACnC,MAAM,EAAE,eAAe;QACvB,UAAU,EAAE,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC;QACtC,eAAe,EAAE,GAAG,CAAC,OAAO,EAAE,iBAAiB,CAAC;KACjD,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACnC,MAAM,MAAM,GACV,OAAO,GAAG,KAAK,QAAQ,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,GAA0B,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9F,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,SAAS,EAAE,cAAc;QACzB,MAAM;QACN,GAAG,CAAC,GAAG,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,GAAG,CAAC,GAAG,EAAE,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,iBAAiB,CAAC,KAAK,cAAc;QAAE,OAAO,SAAS,CAAC;IACpG,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,oBAAoB,EAAE,CAAC;QACrC,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/host/sessions.d.ts

@@ -0,0 +1,8 @@
+export interface SessionRef {
+    readonly sessionId?: string;
+    readonly transcriptPath?: string;
+}
+export type SessionAdmission = (event: SessionRef) => boolean;
+export declare const ALL_SESSIONS: SessionAdmission;
+export declare function sessionsUnder(transcriptDir: string): SessionAdmission;
+//# sourceMappingURL=sessions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/host/sessions.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC;AAE9D,eAAO,MAAM,YAAY,EAAE,gBAA6B,CAAC;AAEzD,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,gBAAgB,CAgBrE"}

package/dist/host/sessions.js

@@ -0,0 +1,32 @@
+import { lstatSync, realpathSync } from "node:fs";
+import { basename, dirname, isAbsolute, normalize, sep } from "node:path";
+export const ALL_SESSIONS = () => true;
+export function sessionsUnder(transcriptDir) {
+    return (event) => {
+        try {
+            const { sessionId, transcriptPath } = event;
+            if (sessionId === undefined || transcriptPath === undefined)
+                return false;
+            if (!isAbsolute(transcriptPath) || basename(transcriptPath) !== `${sessionId}.jsonl`)
+                return false;
+            if (normalize(transcriptPath) !== transcriptPath)
+                return false;
+            if (!transcriptPath.endsWith(`${sep}${sessionId}.jsonl`))
+                return false;
+            let present;
+            try {
+                present = lstatSync(transcriptPath);
+            }
+            catch {
+                present = undefined;
+            }
+            if (present !== undefined && !present.isFile())
+                return false;
+            return realpathSync(dirname(transcriptPath)) === realpathSync(transcriptDir);
+        }
+        catch {
+            return false;
+        }
+    };
+}
+//# sourceMappingURL=sessions.js.map

package/dist/host/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/host/sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAS1E,MAAM,CAAC,MAAM,YAAY,GAAqB,GAAG,EAAE,CAAC,IAAI,CAAC;AAEzD,MAAM,UAAU,aAAa,CAAC,aAAqB;IACjD,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;YAC5C,IAAI,SAAS,KAAK,SAAS,IAAI,cAAc,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC;YAC1E,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,QAAQ,CAAC,cAAc,CAAC,KAAK,GAAG,SAAS,QAAQ;gBAAE,OAAO,KAAK,CAAC;YACnG,IAAI,SAAS,CAAC,cAAc,CAAC,KAAK,cAAc;gBAAE,OAAO,KAAK,CAAC;YAC/D,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,GAAG,GAAG,SAAS,QAAQ,CAAC;gBAAE,OAAO,KAAK,CAAC;YACvE,IAAI,OAAiD,CAAC;YACtD,IAAI,CAAC;gBAAC,OAAO,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO,GAAG,SAAS,CAAC;YAAC,CAAC;YAC3E,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;gBAAE,OAAO,KAAK,CAAC;YAC7D,OAAO,YAAY,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,KAAK,YAAY,CAAC,aAAa,CAAC,CAAC;QAC/E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/host/socket_path.d.ts

@@ -0,0 +1,3 @@
+export declare const MAX_SOCKET_PATH_BYTES = 103;
+export declare function socketPathProblem(path: string): string | undefined;
+//# sourceMappingURL=socket_path.d.ts.map

package/dist/host/socket_path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket_path.d.ts","sourceRoot":"","sources":["../../src/host/socket_path.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWlE"}

package/dist/host/socket_path.js

@@ -0,0 +1,14 @@
+export const MAX_SOCKET_PATH_BYTES = 103;
+export function socketPathProblem(path) {
+    const nul = path.indexOf("\0");
+    if (nul !== -1) {
+        const at = Buffer.byteLength(path.slice(0, nul), "utf8");
+        return `socketPath contains a NUL byte at byte ${at} of ${Buffer.byteLength(path, "utf8")} bytes — the runtime would cut the path there`;
+    }
+    const bytes = Buffer.byteLength(path, "utf8");
+    if (bytes > MAX_SOCKET_PATH_BYTES) {
+        return `socketPath is ${bytes} bytes; a unix socket path may hold at most ${MAX_SOCKET_PATH_BYTES} — the runtime can cut a longer one short without an error`;
+    }
+    return undefined;
+}
+//# sourceMappingURL=socket_path.js.map

package/dist/host/socket_path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket_path.js","sourceRoot":"","sources":["../../src/host/socket_path.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;QACzD,OAAO,0CAA0C,EAAE,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,+CAA+C,CAAC;IAC3I,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9C,IAAI,KAAK,GAAG,qBAAqB,EAAE,CAAC;QAClC,OAAO,iBAAiB,KAAK,+CAA+C,qBAAqB,4DAA4D,CAAC;IAChK,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/inbound/index.d.ts

@@ -0,0 +1,8 @@
+export { triageInbound, refKey, sharerMatches, refsFromListing, readShareListing, ListingError, TruncatedListingError } from "../coordination/inbound.js";
+export type { SharedRef, InboundOptions, InboundTriage, ShareListingRead } from "../coordination/inbound.js";
+export { escapeUntrusted, displayUntrusted } from "../coordination/untrusted_text.js";
+export { readShareStates, readShareStatesFile, countsOf, fileCurrency, summaryFindings, mapIsWhole, entryFor, copyStanding, COPY_SKEW_MS, shareObligations, obligationKey, pendingObligations, shareTransitions, nextBaseline, carryObligations, readObligationLedger, renderCarriedObligations, versionKey, readMarkOf, unreadVersions, citingNotes, MIN_CITED_ID_LENGTH, renderShareNotices, } from "../coordination/share_states.js";
+export type { ShareStatus, EndedBy, ShareStateEntry, ShareStateMap, ShareStateSummary, ShareCounts, FeedStopped, FileCurrency, SummaryFindings, ShareStatesRead, CopyStanding, HeldCopy, CopyVerdict, ShareObligationKind, ShareObligation, CarriedObligationKind, OpenObligation, ObligationCarry, ObligationLedgerRead, ShareTransitionKind, ShareTransition, ShareBaseline, ShareTransitionReport, ReadMark, Citations, NoticePolicy, } from "../coordination/share_states.js";
+export { readNoteLineage, standingOf, lineageDuties, undeclaredCitations, unknownDeclarations, renderLineageDuties, notesToWithhold, handlingBlockedBy, } from "../coordination/note_lineage.js";
+export type { NoteRef, NoteLineage, CitationStanding, LineageDuty, LineageReport, WithheldNote } from "../coordination/note_lineage.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/inbound/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAC1J,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC7G,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACtF,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,UAAU,EACV,UAAU,EACV,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,WAAW,EACX,OAAO,EACP,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,eAAe,EACf,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,QAAQ,EACR,SAAS,EACT,YAAY,GACb,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,eAAe,EACf,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,GAClB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC"}