trellis-hgl-core 0.6.0-beta.18

package/dist/channel/internal/store/seq.js

@@ -0,0 +1,133 @@
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import path from "node:path";
+const READ_TAIL_BYTES = 4096;
+/** Parse the sidecar file content. Returns null on missing / non-integer. */
+function parseSidecar(text) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return null;
+    // Reject leading +/-/0x/whitespace permutations; require pure digits.
+    if (!/^[0-9]+$/.test(trimmed))
+        return null;
+    const n = Number(trimmed);
+    if (!Number.isFinite(n) || n < 0)
+        return null;
+    return n;
+}
+async function readSidecar(sidecarPath) {
+    if (!fs.existsSync(sidecarPath))
+        return null;
+    try {
+        const text = await fsp.readFile(sidecarPath, "utf-8");
+        return parseSidecar(text);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read the last seq value from the JSONL file by tailing the end of the
+ * file without loading the entire content. Returns 0 when the file is
+ * absent or empty. Throws when the file has content but no recoverable
+ * seq, because guessing would risk duplicate seq assignment.
+ *
+ * Falls back to a full-scan when the tail cannot establish a max seq
+ * (e.g. last event spans the tail window or every line is corrupt).
+ */
+async function readLastJsonlSeq(jsonlPath) {
+    if (!fs.existsSync(jsonlPath))
+        return 0;
+    let stat;
+    try {
+        stat = await fsp.stat(jsonlPath);
+    }
+    catch {
+        return 0;
+    }
+    if (stat.size === 0)
+        return 0;
+    const seqFromBuffer = (buf) => {
+        const text = buf.toString("utf-8");
+        const lines = text.split("\n");
+        for (let i = lines.length - 1; i >= 0; i--) {
+            const line = lines[i].trim();
+            if (!line)
+                continue;
+            try {
+                const parsed = JSON.parse(line);
+                if (typeof parsed.seq === "number" && Number.isFinite(parsed.seq)) {
+                    return parsed.seq;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return null;
+    };
+    // Tail-read first.
+    const tailLen = Math.min(stat.size, READ_TAIL_BYTES);
+    const fh = await fsp.open(jsonlPath, "r");
+    try {
+        const buf = Buffer.alloc(tailLen);
+        await fh.read(buf, 0, tailLen, stat.size - tailLen);
+        // Find the first newline so we don't try to JSON.parse a partial
+        // first line that the tail window happened to slice mid-event.
+        let usable = buf;
+        if (stat.size > tailLen) {
+            const firstNewline = buf.indexOf(0x0a);
+            usable = firstNewline >= 0 ? buf.subarray(firstNewline + 1) : Buffer.alloc(0);
+        }
+        if (usable.length > 0) {
+            const found = seqFromBuffer(usable);
+            if (found !== null)
+                return found;
+        }
+    }
+    finally {
+        await fh.close();
+    }
+    // Tail did not produce a seq — fall back to a full scan.
+    const text = await fsp.readFile(jsonlPath, "utf-8");
+    const found = seqFromBuffer(Buffer.from(text));
+    if (found !== null)
+        return found;
+    if (text.split("\n").some((line) => line.trim() !== "")) {
+        throw new Error(`Unable to recover channel seq from ${jsonlPath}`);
+    }
+    return 0;
+}
+/**
+ * Compute the next seq to assign by reconciling the `.seq` sidecar with
+ * the JSONL tail. Repairs the sidecar when it is missing, corrupted,
+ * lower than the JSONL tail, or ahead of the JSONL tail (for example,
+ * after manual corruption or a stale future reservation).
+ *
+ * Caller must hold the channel lock when invoking this and the
+ * subsequent JSONL append + sidecar write.
+ */
+export async function reconcileSeq(jsonlPath, sidecarPath) {
+    const sidecar = await readSidecar(sidecarPath);
+    const jsonlTail = await readLastJsonlSeq(jsonlPath);
+    // Decision matrix:
+    //   sidecar = N, jsonl = N      -> normal; next = N+1
+    //   sidecar = N, jsonl = N+k    -> sidecar stale; repair forward to N+k
+    //   sidecar = N, jsonl = N-k    -> sidecar ahead of JSONL;
+    //                                   rewind to JSONL tail so we never
+    //                                   leave a seq gap from a stale
+    //                                   reservation
+    //   sidecar = null, jsonl = M   -> lazy rebuild; use jsonl tail
+    const last = jsonlTail;
+    if (sidecar !== last) {
+        await writeSidecar(sidecarPath, last);
+    }
+    return last;
+}
+export async function writeSidecar(sidecarPath, seq) {
+    await fsp.mkdir(path.dirname(sidecarPath), { recursive: true });
+    const tmp = `${sidecarPath}.tmp.${process.pid}.${Date.now()}`;
+    await fsp.writeFile(tmp, `${seq}\n`, "utf-8");
+    await fsp.rename(tmp, sidecarPath);
+}
+//# sourceMappingURL=seq.js.map

package/dist/channel/internal/store/seq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seq.js","sourceRoot":"","sources":["../../../../src/channel/internal/store/seq.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,GAAG,MAAM,kBAAkB,CAAC;AACnC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,eAAe,GAAG,IAAI,CAAC;AAE7B,6EAA6E;AAC7E,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,sEAAsE;IACtE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO,CAAC,CAAC;AACX,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,WAAmB;IAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACtD,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,gBAAgB,CAAC,SAAiB;IAC/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,CAAC,CAAC;IACxC,IAAI,IAAc,CAAC;IACnB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAE9B,MAAM,aAAa,GAAG,CAAC,GAAW,EAAiB,EAAE;QACnD,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7B,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAqB,CAAC;gBACpD,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;oBAClE,OAAO,MAAM,CAAC,GAAG,CAAC;gBACpB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,mBAAmB;IACnB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IACrD,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC;QACpD,iEAAiE;QACjE,+DAA+D;QAC/D,IAAI,MAAM,GAAG,GAAG,CAAC;QACjB,IAAI,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,CAAC;YACxB,MAAM,YAAY,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,GAAG,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAChF,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;QACnC,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,yDAAyD;IACzD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACjC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,sCAAsC,SAAS,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,SAAiB,EACjB,WAAmB;IAEnB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAEpD,mBAAmB;IACnB,sDAAsD;IACtD,wEAAwE;IACxE,2DAA2D;IAC3D,qEAAqE;IACrE,iEAAiE;IACjE,gDAAgD;IAChD,gEAAgE;IAChE,MAAM,IAAI,GAAG,SAAS,CAAC;IACvB,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAmB,EACnB,GAAW;IAEX,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,MAAM,GAAG,GAAG,GAAG,WAAW,QAAQ,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IAC9D,MAAM,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AACrC,CAAC"}

package/dist/channel/internal/store/thread-state.d.ts

@@ -0,0 +1,37 @@
+import { type ChannelEvent, type ContextChannelEvent, type ThreadChannelEvent } from "./events.js";
+import { type ContextEntry } from "./schema.js";
+export interface ThreadState {
+    thread: string;
+    title?: string;
+    status: string;
+    labels: string[];
+    assignees: string[];
+    description?: string;
+    context?: ContextEntry[];
+    summary?: string;
+    openedAt?: string;
+    updatedAt?: string;
+    lastSeq: number;
+    comments: number;
+    /** Previous thread keys after rename. Resolved-from-old-key consumers
+     *  use this set to recover history that references the rename source. */
+    aliases: string[];
+}
+/**
+ * Resolve thread aliases over an event stream. Returns a function that
+ * maps any (current or previous) thread key to its current canonical
+ * key, plus the set of historical aliases for each current key.
+ */
+export interface ThreadAliasResolver {
+    resolve(key: string): string;
+    aliasesFor(currentKey: string): string[];
+}
+export declare function buildThreadAliasResolver(events: ChannelEvent[]): ThreadAliasResolver;
+export declare function reduceThreads(events: ChannelEvent[]): ThreadState[];
+/**
+ * Return the timeline events that belong to a given thread (or any of
+ * its rename aliases), in seq order. Includes thread events and
+ * thread-targeted context events.
+ */
+export declare function collectThreadTimeline(events: ChannelEvent[], threadKey: string): (ThreadChannelEvent | ContextChannelEvent)[];
+//# sourceMappingURL=thread-state.d.ts.map

package/dist/channel/internal/store/thread-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-state.d.ts","sourceRoot":"","sources":["../../../../src/channel/internal/store/thread-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB;6EACyE;IACzE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAMD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC1C;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,YAAY,EAAE,GACrB,mBAAmB,CAsDrB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,WAAW,EAAE,CAgFnE;AAoDD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EAAE,EACtB,SAAS,EAAE,MAAM,GAChB,CAAC,kBAAkB,GAAG,mBAAmB,CAAC,EAAE,CAgB9C"}

package/dist/channel/internal/store/thread-state.js

@@ -0,0 +1,206 @@
+import { isContextEvent, isThreadEvent, } from "./events.js";
+import { asContextEntries, asStringArray, contextEntryKey, } from "./schema.js";
+export function buildThreadAliasResolver(events) {
+    // Map from any historical key -> current key (chain-flattened).
+    const aliasToCurrent = new Map();
+    // Reverse index: current key -> set of historical aliases (excluding self).
+    const aliasesByCurrent = new Map();
+    const currentFor = (key) => {
+        let cur = aliasToCurrent.get(key) ?? key;
+        // Flatten any chain that may form if the same key was renamed more
+        // than once. We rebuild on each call so callers do not see stale
+        // pointers when this function is called mid-stream.
+        const seen = new Set();
+        while (aliasToCurrent.has(cur) && !seen.has(cur)) {
+            seen.add(cur);
+            cur = aliasToCurrent.get(cur);
+        }
+        return cur;
+    };
+    for (const ev of events) {
+        if (!isThreadEvent(ev) || ev.action !== "rename")
+            continue;
+        const newKey = typeof ev.newThread === "string" ? ev.newThread.trim() : undefined;
+        const oldKey = ev.thread;
+        if (!newKey || !oldKey || newKey === oldKey)
+            continue;
+        const oldCurrent = currentFor(oldKey);
+        const targetCurrent = currentFor(newKey);
+        if (oldCurrent === targetCurrent)
+            continue;
+        // Migrate the alias group rooted at `oldCurrent` onto `targetCurrent`.
+        const movingAliases = aliasesByCurrent.get(oldCurrent) ?? new Set();
+        movingAliases.add(oldCurrent);
+        aliasesByCurrent.delete(oldCurrent);
+        const targetAliases = aliasesByCurrent.get(targetCurrent) ?? new Set();
+        for (const alias of movingAliases) {
+            if (alias !== targetCurrent)
+                targetAliases.add(alias);
+            aliasToCurrent.set(alias, targetCurrent);
+        }
+        aliasesByCurrent.set(targetCurrent, targetAliases);
+    }
+    return {
+        resolve(key) {
+            return currentFor(key);
+        },
+        aliasesFor(currentKey) {
+            const set = aliasesByCurrent.get(currentKey);
+            return set ? [...set] : [];
+        },
+    };
+}
+export function reduceThreads(events) {
+    const resolver = buildThreadAliasResolver(events);
+    const states = new Map();
+    const ensure = (key, seq) => {
+        const current = states.get(key);
+        if (current)
+            return current;
+        const fresh = {
+            thread: key,
+            status: "open",
+            labels: [],
+            assignees: [],
+            lastSeq: seq,
+            comments: 0,
+            aliases: [],
+            contextMap: new Map(),
+        };
+        states.set(key, fresh);
+        return fresh;
+    };
+    for (const ev of events) {
+        if (isThreadEvent(ev)) {
+            const current = resolver.resolve(ev.thread);
+            const state = ensure(current, ev.seq);
+            if (typeof ev.ts === "string")
+                state.updatedAt = ev.ts;
+            if (!state.openedAt && typeof ev.ts === "string") {
+                state.openedAt = ev.ts;
+            }
+            state.lastSeq = ev.seq;
+            applyThreadAction(state, ev);
+            continue;
+        }
+        if (isContextEvent(ev) && ev.target === "thread" && ev.thread) {
+            const current = resolver.resolve(ev.thread);
+            const state = states.get(current);
+            if (!state)
+                continue;
+            const entries = asContextEntries(ev.context);
+            if (!entries)
+                continue;
+            if (ev.action === "add") {
+                for (const entry of entries) {
+                    state.contextMap.set(contextEntryKey(entry), entry);
+                }
+            }
+            else if (ev.action === "delete") {
+                for (const entry of entries) {
+                    state.contextMap.delete(contextEntryKey(entry));
+                }
+            }
+            if (typeof ev.ts === "string")
+                state.updatedAt = ev.ts;
+            state.lastSeq = ev.seq;
+            continue;
+        }
+    }
+    return [...states.entries()]
+        .map(([currentKey, state]) => {
+        const aliases = resolver.aliasesFor(currentKey);
+        const context = state.contextMap.size > 0 ? [...state.contextMap.values()] : undefined;
+        const result = {
+            thread: state.thread,
+            ...(state.title !== undefined ? { title: state.title } : {}),
+            status: state.status,
+            labels: state.labels,
+            assignees: state.assignees,
+            ...(state.description !== undefined
+                ? { description: state.description }
+                : {}),
+            ...(context !== undefined ? { context } : {}),
+            ...(state.summary !== undefined ? { summary: state.summary } : {}),
+            ...(state.openedAt !== undefined ? { openedAt: state.openedAt } : {}),
+            ...(state.updatedAt !== undefined ? { updatedAt: state.updatedAt } : {}),
+            lastSeq: state.lastSeq,
+            comments: state.comments,
+            aliases,
+        };
+        return result;
+    })
+        .sort((a, b) => (b.updatedAt ?? "").localeCompare(a.updatedAt ?? ""));
+}
+function applyThreadAction(current, ev) {
+    switch (ev.action) {
+        case "opened":
+            current.status = typeof ev.status === "string" ? ev.status : "open";
+            if (typeof ev.title === "string")
+                current.title = ev.title;
+            if (typeof ev.description === "string") {
+                current.description = ev.description;
+            }
+            {
+                const initial = asContextEntries(ev.context) ?? asContextEntries(ev.linkedContext);
+                if (initial) {
+                    current.contextMap.clear();
+                    for (const entry of initial) {
+                        current.contextMap.set(contextEntryKey(entry), entry);
+                    }
+                }
+            }
+            current.labels = asStringArray(ev.labels) ?? current.labels;
+            current.assignees = asStringArray(ev.assignees) ?? current.assignees;
+            return;
+        case "comment":
+            current.comments += 1;
+            return;
+        case "status":
+            if (typeof ev.status === "string")
+                current.status = ev.status;
+            return;
+        case "labels":
+            current.labels = asStringArray(ev.labels) ?? current.labels;
+            return;
+        case "assignees":
+            current.assignees = asStringArray(ev.assignees) ?? current.assignees;
+            return;
+        case "summary":
+            if (typeof ev.summary === "string")
+                current.summary = ev.summary;
+            return;
+        case "processed":
+            current.status = typeof ev.status === "string" ? ev.status : "processed";
+            return;
+        case "rename":
+            // Rename handled by the alias resolver; nothing to do here.
+            return;
+        default:
+            return;
+    }
+}
+/**
+ * Return the timeline events that belong to a given thread (or any of
+ * its rename aliases), in seq order. Includes thread events and
+ * thread-targeted context events.
+ */
+export function collectThreadTimeline(events, threadKey) {
+    const resolver = buildThreadAliasResolver(events);
+    const current = resolver.resolve(threadKey);
+    const aliases = new Set([current, ...resolver.aliasesFor(current)]);
+    const out = [];
+    for (const ev of events) {
+        if (isThreadEvent(ev)) {
+            if (aliases.has(ev.thread))
+                out.push(ev);
+            continue;
+        }
+        if (isContextEvent(ev) && ev.target === "thread" && ev.thread) {
+            if (aliases.has(ev.thread))
+                out.push(ev);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=thread-state.js.map

package/dist/channel/internal/store/thread-state.js.map

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

package/dist/channel/internal/store/watch.d.ts

@@ -0,0 +1,10 @@
+import type { ChannelEvent } from "./events.js";
+import { type ChannelEventFilter } from "./filter.js";
+export type WatchFilter = ChannelEventFilter;
+export declare function watchEvents(channelName: string, filter: WatchFilter, opts?: {
+    signal?: AbortSignal;
+    fromStart?: boolean;
+    sinceSeq?: number;
+    project?: string;
+}): AsyncGenerator<ChannelEvent, void, unknown>;
+//# sourceMappingURL=watch.d.ts.map

package/dist/channel/internal/store/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../../src/channel/internal/store/watch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAG1E,MAAM,MAAM,WAAW,GAAG,kBAAkB,CAAC;AAgD7C,wBAAuB,WAAW,CAChC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,IAAI,GAAE;IACJ,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CACb,GACL,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,CA6E7C"}

package/dist/channel/internal/store/watch.js

@@ -0,0 +1,122 @@
+import fs from "node:fs";
+import { matchesEventFilter } from "./filter.js";
+import { channelDir, eventsPath } from "./paths.js";
+async function readNewEvents(filePath, state) {
+    if (!fs.existsSync(filePath)) {
+        state.byteOffset = 0;
+        state.carry = "";
+        return [];
+    }
+    const stat = await fs.promises.stat(filePath);
+    if (stat.size < state.byteOffset) {
+        state.byteOffset = 0;
+        state.carry = "";
+    }
+    if (stat.size <= state.byteOffset)
+        return [];
+    const fh = await fs.promises.open(filePath, "r");
+    try {
+        const length = stat.size - state.byteOffset;
+        const buf = Buffer.alloc(length);
+        await fh.read(buf, 0, length, state.byteOffset);
+        state.byteOffset = stat.size;
+        const text = state.carry + buf.toString("utf-8");
+        const lines = text.split("\n");
+        state.carry = lines.pop() ?? "";
+        const events = [];
+        for (const line of lines) {
+            const t = line.trim();
+            if (!t)
+                continue;
+            try {
+                events.push(JSON.parse(t));
+            }
+            catch {
+                continue;
+            }
+        }
+        return events;
+    }
+    finally {
+        await fh.close();
+    }
+}
+export async function* watchEvents(channelName, filter, opts = {}) {
+    const file = eventsPath(channelName, opts.project);
+    if (!fs.existsSync(channelDir(channelName, opts.project))) {
+        await fs.promises.mkdir(channelDir(channelName, opts.project), {
+            recursive: true,
+        });
+    }
+    let initialOffset = 0;
+    if (!opts.fromStart && opts.sinceSeq === undefined) {
+        try {
+            if (fs.existsSync(file)) {
+                initialOffset = (await fs.promises.stat(file)).size;
+            }
+        }
+        catch {
+            initialOffset = 0;
+        }
+    }
+    const state = { byteOffset: initialOffset, carry: "" };
+    const sinceSeq = opts.sinceSeq;
+    let resolveNext = null;
+    const wake = () => {
+        if (resolveNext) {
+            const r = resolveNext;
+            resolveNext = null;
+            r();
+        }
+    };
+    let watcher = null;
+    try {
+        watcher = fs.watch(channelDir(channelName, opts.project), () => wake());
+        watcher.on("error", () => {
+            try {
+                watcher?.close();
+            }
+            catch {
+                // already closed
+            }
+            watcher = null;
+            // Keep the generator alive; the 200ms poll remains the fallback.
+            wake();
+        });
+    }
+    catch {
+        // ignore — fall back to polling
+    }
+    const poll = setInterval(wake, 200);
+    const abortHandler = () => wake();
+    opts.signal?.addEventListener("abort", abortHandler);
+    try {
+        while (true) {
+            if (opts.signal?.aborted)
+                return;
+            const fresh = await readNewEvents(file, state);
+            for (const ev of fresh) {
+                if (sinceSeq !== undefined && ev.seq <= sinceSeq)
+                    continue;
+                if (matchesEventFilter(ev, filter))
+                    yield ev;
+                if (opts.signal?.aborted)
+                    return;
+            }
+            await new Promise((resolve) => {
+                resolveNext = resolve;
+            });
+        }
+    }
+    finally {
+        clearInterval(poll);
+        try {
+            watcher?.close();
+        }
+        catch {
+            // already closed
+        }
+        opts.signal?.removeEventListener("abort", abortHandler);
+    }
+}
+//# sourceMappingURL=watch.js.map

package/dist/channel/internal/store/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../../../src/channel/internal/store/watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAGzB,OAAO,EAAE,kBAAkB,EAA2B,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AASpD,KAAK,UAAU,aAAa,CAC1B,QAAgB,EAChB,KAAmB;IAEnB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;QACrB,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC;QACjB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;QACjC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;QACrB,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC;IACnB,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAE7C,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC;QAC5C,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAChD,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC;QAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAChC,MAAM,MAAM,GAAmB,EAAE,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC;gBAAE,SAAS;YACjB,IAAI,CAAC;gBACH,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAiB,CAAC,CAAC;YAC7C,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,WAAW,CAChC,WAAmB,EACnB,MAAmB,EACnB,OAKI,EAAE;IAEN,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC1D,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE;YAC7D,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnD,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,aAAa,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YACtD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,aAAa,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAE/B,IAAI,WAAW,GAAwB,IAAI,CAAC;IAE5C,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,CAAC,GAAG,WAAW,CAAC;YACtB,WAAW,GAAG,IAAI,CAAC;YACnB,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,OAAO,GAAwB,IAAI,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACxE,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACvB,IAAI,CAAC;gBACH,OAAO,EAAE,KAAK,EAAE,CAAC;YACnB,CAAC;YAAC,MAAM,CAAC;gBACP,iBAAiB;YACnB,CAAC;YACD,OAAO,GAAG,IAAI,CAAC;YACf,iEAAiE;YACjE,IAAI,EAAE,CAAC;QACT,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,gCAAgC;IAClC,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAEpC,MAAM,YAAY,GAAG,GAAS,EAAE,CAAC,IAAI,EAAE,CAAC;IACxC,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAErD,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO;gBAAE,OAAO;YAEjC,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC/C,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;gBACvB,IAAI,QAAQ,KAAK,SAAS,IAAI,EAAE,CAAC,GAAG,IAAI,QAAQ;oBAAE,SAAS;gBAC3D,IAAI,kBAAkB,CAAC,EAAE,EAAE,MAAM,CAAC;oBAAE,MAAM,EAAE,CAAC;gBAC7C,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO;oBAAE,OAAO;YACnC,CAAC;YAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,WAAW,GAAG,OAAO,CAAC;YACxB,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;YAAS,CAAC;QACT,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,EAAE,KAAK,EAAE,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC"}

package/dist/channel/internal/store/worker-state.d.ts

@@ -0,0 +1,49 @@
+import type { ChannelEvent } from "./events.js";
+import type { ChannelRef, InboxPolicy } from "./schema.js";
+/**
+ * Process lifecycle of a worker, projected purely from durable channel
+ * events. Distinct from {@link WorkerActivity}, which tracks whether the
+ * worker is mid-turn.
+ */
+export type WorkerLifecycle = "starting" | "running" | "done" | "error" | "killed" | "crashed";
+/** Turn activity of a worker — is it currently running a turn? */
+export type WorkerActivity = "idle" | "mid-turn";
+export interface WorkerState {
+    workerId: string;
+    /** Channel the worker belongs to. Stamped by the API layer. */
+    channel?: ChannelRef;
+    agent?: string;
+    provider?: string;
+    lifecycle: WorkerLifecycle;
+    terminal: boolean;
+    activity: WorkerActivity;
+    activeTurnId?: string;
+    activeTurnStartedAt?: string;
+    /**
+     * Count of deliverable `message` events (matching the worker inbox
+     * policy) with seq greater than the latest consumed `turn_started.inputSeq`.
+     * Derived only from durable events — never from host-local cursors.
+     * Always 0 for terminal workers.
+     */
+    pendingMessageCount: number;
+    inboxPolicy: InboxPolicy;
+    spawnedAt?: string;
+    updatedAt: string;
+    startedBy?: string;
+    exitCode?: number;
+    signal?: string;
+    reason?: string;
+    error?: string;
+    /** Seq of the last event applied to this worker. */
+    lastSeq: number;
+}
+export interface WorkerRegistry {
+    workers: WorkerState[];
+}
+/**
+ * Project durable channel events into the worker registry. Pure — only
+ * the event log feeds the projection (no pid files, no inbox cursors).
+ */
+export declare function reduceWorkerRegistry(events: ChannelEvent[], channel?: ChannelRef): WorkerRegistry;
+export declare function isTerminalLifecycle(lifecycle: WorkerLifecycle): boolean;
+//# sourceMappingURL=worker-state.d.ts.map

package/dist/channel/internal/store/worker-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-state.d.ts","sourceRoot":"","sources":["../../../../src/channel/internal/store/worker-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE3D;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,SAAS,GACT,MAAM,GACN,OAAO,GACP,QAAQ,GACR,SAAS,CAAC;AAEd,kEAAkE;AAClE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,CAAC;AASjD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,eAAe,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,cAAc,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AA4ED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EAAE,EACtB,OAAO,CAAC,EAAE,UAAU,GACnB,cAAc,CA+HhB;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,CAEvE"}