trellis-hgl-core 0.6.0-beta.18

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

@@ -0,0 +1,207 @@
+import { matchesInboxPolicy, DEFAULT_INBOX_POLICY } from "./inbox.js";
+const TERMINAL_LIFECYCLES = new Set([
+    "done",
+    "error",
+    "killed",
+    "crashed",
+]);
+function strField(ev, key) {
+    const v = ev[key];
+    return typeof v === "string" ? v : undefined;
+}
+function numField(ev, key) {
+    const v = ev[key];
+    return typeof v === "number" ? v : undefined;
+}
+/**
+ * Resolve the worker id an event refers to, and whether the event kind
+ * is allowed to *create* a worker entry (only `spawned` and clearly
+ * worker-identified terminal events can — this avoids phantom workers
+ * from plain `by` aliases).
+ */
+function identifyWorker(ev) {
+    switch (ev.kind) {
+        case "spawned": {
+            const id = strField(ev, "as");
+            return id ? { id, canCreate: true } : null;
+        }
+        case "turn_started":
+        case "turn_finished":
+        case "interrupt_requested":
+        case "interrupted": {
+            const id = strField(ev, "worker");
+            return id ? { id, canCreate: false } : null;
+        }
+        case "killed": {
+            const explicit = strField(ev, "worker") ?? strField(ev, "as");
+            if (explicit)
+                return { id: explicit, canCreate: true };
+            const by = ev.by;
+            if (by.startsWith("supervisor:")) {
+                return { id: by.slice("supervisor:".length), canCreate: true };
+            }
+            return { id: by, canCreate: false };
+        }
+        case "done":
+        case "error": {
+            const explicit = strField(ev, "worker") ?? strField(ev, "as");
+            if (explicit)
+                return { id: explicit, canCreate: true };
+            const by = ev.by;
+            if (by.startsWith("supervisor:")) {
+                return { id: by.slice("supervisor:".length), canCreate: true };
+            }
+            return { id: by, canCreate: false };
+        }
+        default:
+            return null;
+    }
+}
+function blankWorker(id, ev) {
+    return {
+        workerId: id,
+        lifecycle: "running",
+        terminal: false,
+        activity: "idle",
+        pendingMessageCount: 0,
+        inboxPolicy: DEFAULT_INBOX_POLICY,
+        updatedAt: ev.ts,
+        lastSeq: ev.seq,
+        consumedInputSeq: 0,
+    };
+}
+/**
+ * Project durable channel events into the worker registry. Pure — only
+ * the event log feeds the projection (no pid files, no inbox cursors).
+ */
+export function reduceWorkerRegistry(events, channel) {
+    const acc = new Map();
+    for (const ev of events) {
+        const ident = identifyWorker(ev);
+        if (!ident)
+            continue;
+        let w = acc.get(ident.id);
+        if (!w) {
+            if (!ident.canCreate)
+                continue;
+            w = blankWorker(ident.id, ev);
+            acc.set(ident.id, w);
+        }
+        w.updatedAt = ev.ts;
+        w.lastSeq = ev.seq;
+        switch (ev.kind) {
+            case "spawned": {
+                w.lifecycle = "running";
+                w.terminal = false;
+                w.activity = "idle";
+                delete w.activeTurnId;
+                delete w.activeTurnStartedAt;
+                delete w.exitCode;
+                delete w.signal;
+                delete w.reason;
+                delete w.error;
+                w.spawnedAt = ev.ts;
+                w.startedBy = ev.by;
+                w.provider = strField(ev, "provider") ?? w.provider;
+                w.agent = strField(ev, "agent") ?? w.agent;
+                w.inboxPolicy =
+                    strField(ev, "inboxPolicy") ??
+                        w.inboxPolicy;
+                break;
+            }
+            case "turn_started": {
+                w.activity = "mid-turn";
+                w.activeTurnId = strField(ev, "turnId");
+                w.activeTurnStartedAt = ev.ts;
+                const inputSeq = numField(ev, "inputSeq");
+                if (inputSeq !== undefined && inputSeq > w.consumedInputSeq) {
+                    w.consumedInputSeq = inputSeq;
+                }
+                break;
+            }
+            case "turn_finished": {
+                w.activity = "idle";
+                delete w.activeTurnId;
+                delete w.activeTurnStartedAt;
+                break;
+            }
+            case "interrupted": {
+                // An interrupt aborts the active turn.
+                w.activity = "idle";
+                delete w.activeTurnId;
+                delete w.activeTurnStartedAt;
+                break;
+            }
+            case "interrupt_requested":
+                // Durable intent only — no lifecycle/activity change.
+                break;
+            case "done": {
+                w.activity = "idle";
+                delete w.activeTurnId;
+                delete w.activeTurnStartedAt;
+                if (ev.synthesized === true) {
+                    w.lifecycle = "done";
+                    w.terminal = true;
+                    w.exitCode = numField(ev, "exit_code") ?? w.exitCode;
+                }
+                break;
+            }
+            case "error": {
+                w.activity = "idle";
+                delete w.activeTurnId;
+                delete w.activeTurnStartedAt;
+                w.error = strField(ev, "message") ?? w.error;
+                if (ev.synthesized === true ||
+                    ev.by.startsWith("supervisor:")) {
+                    w.lifecycle = "error";
+                    w.terminal = true;
+                    w.exitCode = numField(ev, "exit_code") ?? w.exitCode;
+                    w.signal = strField(ev, "exit_signal") ?? w.signal;
+                }
+                break;
+            }
+            case "killed": {
+                const reason = strField(ev, "reason");
+                w.lifecycle = reason === "crash" ? "crashed" : "killed";
+                w.terminal = true;
+                w.activity = "idle";
+                delete w.activeTurnId;
+                delete w.activeTurnStartedAt;
+                w.reason = reason ?? w.reason;
+                w.signal = strField(ev, "signal") ?? w.signal;
+                break;
+            }
+            default:
+                break;
+        }
+    }
+    // Second pass: pending message count from durable events only.
+    for (const w of acc.values()) {
+        if (w.terminal) {
+            w.pendingMessageCount = 0;
+            continue;
+        }
+        let pending = 0;
+        for (const ev of events) {
+            if (ev.seq <= w.consumedInputSeq)
+                continue;
+            if (matchesInboxPolicy(ev, w.workerId, w.inboxPolicy))
+                pending++;
+        }
+        w.pendingMessageCount = pending;
+    }
+    const workers = [];
+    for (const w of acc.values()) {
+        const { consumedInputSeq: _drop, ...state } = w;
+        void _drop;
+        if (channel)
+            state.channel = channel;
+        workers.push(state);
+    }
+    workers.sort((a, b) => a.workerId.localeCompare(b.workerId));
+    return { workers };
+}
+export function isTerminalLifecycle(lifecycle) {
+    return TERMINAL_LIFECYCLES.has(lifecycle);
+}
+//# sourceMappingURL=worker-state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker-state.js","sourceRoot":"","sources":["../../../../src/channel/internal/store/worker-state.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAmBtE,MAAM,mBAAmB,GAAiC,IAAI,GAAG,CAAC;IAChE,MAAM;IACN,OAAO;IACP,QAAQ;IACR,SAAS;CACV,CAAC,CAAC;AAyCH,SAAS,QAAQ,CAAC,EAAgB,EAAE,GAAW;IAC7C,MAAM,CAAC,GAAI,EAA8B,CAAC,GAAG,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/C,CAAC;AAED,SAAS,QAAQ,CAAC,EAAgB,EAAE,GAAW;IAC7C,MAAM,CAAC,GAAI,EAA8B,CAAC,GAAG,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CACrB,EAAgB;IAEhB,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QAChB,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,EAAE,GAAG,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC9B,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7C,CAAC;QACD,KAAK,cAAc,CAAC;QACpB,KAAK,eAAe,CAAC;QACrB,KAAK,qBAAqB,CAAC;QAC3B,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,EAAE,GAAG,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;YAClC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9C,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,QAAQ,GAAG,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC9D,IAAI,QAAQ;gBAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YACvD,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;YACjB,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBACjC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YACjE,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QACtC,CAAC;QACD,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,QAAQ,GAAG,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC9D,IAAI,QAAQ;gBAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YACvD,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;YACjB,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBACjC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YACjE,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QACtC,CAAC;QACD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,EAAU,EAAE,EAAgB;IAC/C,OAAO;QACL,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,SAAS;QACpB,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,MAAM;QAChB,mBAAmB,EAAE,CAAC;QACtB,WAAW,EAAE,oBAAoB;QACjC,SAAS,EAAE,EAAE,CAAC,EAAE;QAChB,OAAO,EAAE,EAAE,CAAC,GAAG;QACf,gBAAgB,EAAE,CAAC;KACpB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAsB,EACtB,OAAoB;IAEpB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAqB,CAAC;IAEzC,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,IAAI,CAAC,KAAK,CAAC,SAAS;gBAAE,SAAS;YAC/B,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC9B,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACvB,CAAC;QACD,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,EAAE,CAAC;QACpB,CAAC,CAAC,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC;QAEnB,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;YAChB,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,CAAC,CAAC,SAAS,GAAG,SAAS,CAAC;gBACxB,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC;gBACnB,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC;gBACpB,OAAO,CAAC,CAAC,YAAY,CAAC;gBACtB,OAAO,CAAC,CAAC,mBAAmB,CAAC;gBAC7B,OAAO,CAAC,CAAC,QAAQ,CAAC;gBAClB,OAAO,CAAC,CAAC,MAAM,CAAC;gBAChB,OAAO,CAAC,CAAC,MAAM,CAAC;gBAChB,OAAO,CAAC,CAAC,KAAK,CAAC;gBACf,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,EAAE,CAAC;gBACpB,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,EAAE,CAAC;gBACpB,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC;gBACpD,CAAC,CAAC,KAAK,GAAG,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC;gBAC3C,CAAC,CAAC,WAAW;oBACV,QAAQ,CAAC,EAAE,EAAE,aAAa,CAA6B;wBACxD,CAAC,CAAC,WAAW,CAAC;gBAChB,MAAM;YACR,CAAC;YACD,KAAK,cAAc,CAAC,CAAC,CAAC;gBACpB,CAAC,CAAC,QAAQ,GAAG,UAAU,CAAC;gBACxB,CAAC,CAAC,YAAY,GAAG,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;gBACxC,CAAC,CAAC,mBAAmB,GAAG,EAAE,CAAC,EAAE,CAAC;gBAC9B,MAAM,QAAQ,GAAG,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;gBAC1C,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,GAAG,CAAC,CAAC,gBAAgB,EAAE,CAAC;oBAC5D,CAAC,CAAC,gBAAgB,GAAG,QAAQ,CAAC;gBAChC,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC;gBACpB,OAAO,CAAC,CAAC,YAAY,CAAC;gBACtB,OAAO,CAAC,CAAC,mBAAmB,CAAC;gBAC7B,MAAM;YACR,CAAC;YACD,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,uCAAuC;gBACvC,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC;gBACpB,OAAO,CAAC,CAAC,YAAY,CAAC;gBACtB,OAAO,CAAC,CAAC,mBAAmB,CAAC;gBAC7B,MAAM;YACR,CAAC;YACD,KAAK,qBAAqB;gBACxB,sDAAsD;gBACtD,MAAM;YACR,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC;gBACpB,OAAO,CAAC,CAAC,YAAY,CAAC;gBACtB,OAAO,CAAC,CAAC,mBAAmB,CAAC;gBAC7B,IAAK,EAAgC,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;oBAC3D,CAAC,CAAC,SAAS,GAAG,MAAM,CAAC;oBACrB,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC;oBAClB,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC;gBACvD,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC;gBACpB,OAAO,CAAC,CAAC,YAAY,CAAC;gBACtB,OAAO,CAAC,CAAC,mBAAmB,CAAC;gBAC7B,CAAC,CAAC,KAAK,GAAG,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC;gBAC7C,IACG,EAAgC,CAAC,WAAW,KAAK,IAAI;oBACtD,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAC/B,CAAC;oBACD,CAAC,CAAC,SAAS,GAAG,OAAO,CAAC;oBACtB,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC;oBAClB,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC;oBACrD,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;gBACrD,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;gBACtC,CAAC,CAAC,SAAS,GAAG,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;gBACxD,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC;gBAClB,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC;gBACpB,OAAO,CAAC,CAAC,YAAY,CAAC;gBACtB,OAAO,CAAC,CAAC,mBAAmB,CAAC;gBAC7B,CAAC,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC;gBAC9B,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;gBAC9C,MAAM;YACR,CAAC;YACD;gBACE,MAAM;QACV,CAAC;IACH,CAAC;IAED,+DAA+D;IAC/D,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACf,CAAC,CAAC,mBAAmB,GAAG,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;YACxB,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,gBAAgB;gBAAE,SAAS;YAC3C,IAAI,kBAAkB,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,WAAW,CAAC;gBAAE,OAAO,EAAE,CAAC;QACnE,CAAC;QACD,CAAC,CAAC,mBAAmB,GAAG,OAAO,CAAC;IAClC,CAAC;IAED,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;QAC7B,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,GAAG,CAAC,CAAC;QAChD,KAAK,KAAK,CAAC;QACX,IAAI,OAAO;YAAE,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7D,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,SAA0B;IAC5D,OAAO,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./channel/index.js";
+export * from "./task/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+// Root barrel — re-exports the channel and task public APIs so callers
+// can `import { ... } from "@mindfoldhq/trellis-core"`. Sub-path
+// imports (`@mindfoldhq/trellis-core/channel`, `/task`) remain the
+// recommended form for tree-shake-friendly consumption.
+export * from "./channel/index.js";
+export * from "./task/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,iEAAiE;AACjE,mEAAmE;AACnE,wDAAwD;AAExD,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

package/dist/mem/adapters/claude.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Persisted Claude Code session reader.
+ *
+ * Layout: `~/.claude/projects/<sanitized-cwd>/<sessionId>.jsonl`, with an
+ * optional `<projectDir>/sessions-index.json` providing cwd / created / title.
+ */
+import type { DialogueTurn, MemFilter, MemSessionInfo, SearchHit, TaskPyEvent } from "../types.js";
+export declare function claudeListSessions(f: MemFilter): MemSessionInfo[];
+export declare function claudeExtractDialogue(s: MemSessionInfo): DialogueTurn[];
+export declare function claudeSearch(s: MemSessionInfo, kw: string): SearchHit;
+/**
+ * Single-pass scan of a Claude JSONL file that produces both the cleaned
+ * dialogue turns (semantically identical to {@link claudeExtractDialogue}) and
+ * the list of `task.py create|start` Bash tool_use events with their
+ * `turnIndex`. Compaction resets both `turns` AND `events` — pre-compact event
+ * indices stop pointing at real turns once history is collapsed.
+ */
+export declare function collectClaudeTurnsAndEvents(s: MemSessionInfo): {
+    turns: DialogueTurn[];
+    events: TaskPyEvent[];
+};
+//# sourceMappingURL=claude.d.ts.map

package/dist/mem/adapters/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../src/mem/adapters/claude.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,cAAc,EACd,SAAS,EACT,WAAW,EACZ,MAAM,aAAa,CAAC;AAkErB,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,SAAS,GAAG,cAAc,EAAE,CA+DjE;AAID,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,cAAc,GAAG,YAAY,EAAE,CAuDvE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAErE;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,cAAc,GAAG;IAC9D,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CA6EA"}

package/dist/mem/adapters/claude.js

@@ -0,0 +1,252 @@
+/**
+ * Persisted Claude Code session reader.
+ *
+ * Layout: `~/.claude/projects/<sanitized-cwd>/<sessionId>.jsonl`, with an
+ * optional `<projectDir>/sessions-index.json` providing cwd / created / title.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { stripInjectionTags, isBootstrapTurn } from "../dialogue.js";
+import { inRangeOverlap, sameProject } from "../filter.js";
+import { findInJsonl, readJsonFile, readJsonl, readJsonlFirst, } from "../internal/jsonl.js";
+import { CLAUDE_PROJECTS, claudeProjectDirFromCwd } from "../internal/paths.js";
+import { parseTaskPyCommandsAll } from "../phase.js";
+import { searchInDialogue } from "../search.js";
+function resolveScopedClaudeProjectDirs(cwd) {
+    const direct = claudeProjectDirFromCwd(cwd);
+    const fallback = new Set();
+    if (fs.existsSync(direct))
+        fallback.add(direct);
+    if (!fs.existsSync(CLAUDE_PROJECTS))
+        return [...fallback];
+    for (const dir of fs.readdirSync(CLAUDE_PROJECTS, { withFileTypes: true })) {
+        if (!dir.isDirectory())
+            continue;
+        const dirPath = path.join(CLAUDE_PROJECTS, dir.name);
+        let entries;
+        try {
+            entries = fs.readdirSync(dirPath, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        const file = entries.find((entry) => entry.isFile() && entry.name.endsWith(".jsonl"));
+        if (!file)
+            continue;
+        const evt = findInJsonl(path.join(dirPath, file.name), (o) => typeof o.cwd === "string", 20);
+        if (sameProject(evt?.cwd, cwd))
+            fallback.add(dirPath);
+    }
+    return [...fallback];
+}
+// ---------- list ----------
+export function claudeListSessions(f) {
+    if (!fs.existsSync(CLAUDE_PROJECTS))
+        return [];
+    const out = [];
+    const projectDirs = f.cwd
+        ? resolveScopedClaudeProjectDirs(f.cwd)
+        : fs.readdirSync(CLAUDE_PROJECTS).map((d) => path.join(CLAUDE_PROJECTS, d));
+    for (const dir of projectDirs) {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        const indexFile = path.join(dir, "sessions-index.json");
+        const index = readJsonFile(indexFile);
+        const indexById = new Map();
+        for (const e of Array.isArray(index?.entries) ? index.entries : []) {
+            if (typeof e.id === "string")
+                indexById.set(e.id, e);
+        }
+        for (const e of entries) {
+            if (!e.isFile() || !e.name.endsWith(".jsonl"))
+                continue;
+            const filePath = path.join(dir, e.name);
+            const id = e.name.replace(/\.jsonl$/, "");
+            const idx = indexById.get(id);
+            let cwd = idx?.cwd;
+            let created = idx?.created;
+            const title = idx?.title;
+            if (!cwd || !created) {
+                const evt = findInJsonl(filePath, (o) => typeof o.cwd === "string", 100);
+                cwd = cwd ?? evt?.cwd;
+                created =
+                    created ??
+                        evt?.timestamp ??
+                        readJsonlFirst(filePath)?.timestamp;
+            }
+            const stat = fs.statSync(filePath);
+            const updated = stat.mtime.toISOString();
+            // Interval overlap: cross-day sessions that started before --since but
+            // were still active inside the window must survive.
+            if (!inRangeOverlap(created, updated, f))
+                continue;
+            if (f.cwd && cwd && !sameProject(cwd, f.cwd))
+                continue;
+            out.push({
+                platform: "claude",
+                id,
+                title,
+                cwd,
+                created,
+                updated,
+                filePath,
+            });
+        }
+    }
+    return out;
+}
+// ---------- extract ----------
+export function claudeExtractDialogue(s) {
+    // - user: type=="user" + role=="user" + content is a string
+    // - assistant: type=="assistant" + role=="assistant", keep only `text` blocks
+    // - thinking / tool_use blocks dropped entirely; injection tags stripped
+    // - compaction: an `isCompactSummary` user event resets prior turns and
+    //   replaces them with a single synthetic [compact summary] turn
+    let turns = [];
+    readJsonl(s.filePath, (obj) => {
+        const t = obj.type;
+        const msg = obj.message;
+        if (!msg)
+            return;
+        const content = msg.content;
+        if (t === "user" && obj.isCompactSummary === true) {
+            let summary = "";
+            if (typeof content === "string") {
+                summary = stripInjectionTags(content);
+            }
+            else if (Array.isArray(content)) {
+                const parts = [];
+                for (const block of content) {
+                    if (block.type === "text" && typeof block.text === "string") {
+                        const cleaned = stripInjectionTags(block.text);
+                        if (cleaned)
+                            parts.push(cleaned);
+                    }
+                }
+                summary = parts.join("\n\n");
+            }
+            turns = summary
+                ? [{ role: "user", text: `[compact summary]\n${summary}` }]
+                : [];
+            return;
+        }
+        if (t === "user" && msg.role === "user") {
+            if (typeof content === "string") {
+                const text = stripInjectionTags(content);
+                if (text && !isBootstrapTurn(text, content.length)) {
+                    turns.push({ role: "user", text });
+                }
+            }
+        }
+        else if (t === "assistant" &&
+            msg.role === "assistant" &&
+            Array.isArray(content)) {
+            const parts = [];
+            for (const block of content) {
+                if (block.type === "text" && typeof block.text === "string") {
+                    const cleaned = stripInjectionTags(block.text);
+                    if (cleaned)
+                        parts.push(cleaned);
+                }
+            }
+            if (parts.length)
+                turns.push({ role: "assistant", text: parts.join("\n\n") });
+        }
+    });
+    return turns;
+}
+export function claudeSearch(s, kw) {
+    return searchInDialogue(claudeExtractDialogue(s), kw);
+}
+/**
+ * Single-pass scan of a Claude JSONL file that produces both the cleaned
+ * dialogue turns (semantically identical to {@link claudeExtractDialogue}) and
+ * the list of `task.py create|start` Bash tool_use events with their
+ * `turnIndex`. Compaction resets both `turns` AND `events` — pre-compact event
+ * indices stop pointing at real turns once history is collapsed.
+ */
+export function collectClaudeTurnsAndEvents(s) {
+    let turns = [];
+    let events = [];
+    readJsonl(s.filePath, (obj) => {
+        const t = obj.type;
+        const msg = obj.message;
+        if (!msg)
+            return;
+        const content = msg.content;
+        if (t === "user" && obj.isCompactSummary === true) {
+            let summary = "";
+            if (typeof content === "string") {
+                summary = stripInjectionTags(content);
+            }
+            else if (Array.isArray(content)) {
+                const parts = [];
+                for (const block of content) {
+                    if (block.type === "text" && typeof block.text === "string") {
+                        const cleaned = stripInjectionTags(block.text);
+                        if (cleaned)
+                            parts.push(cleaned);
+                    }
+                }
+                summary = parts.join("\n\n");
+            }
+            turns = summary
+                ? [{ role: "user", text: `[compact summary]\n${summary}` }]
+                : [];
+            events = [];
+            return;
+        }
+        if (t === "user" && msg.role === "user") {
+            if (typeof content === "string") {
+                const text = stripInjectionTags(content);
+                if (text && !isBootstrapTurn(text, content.length)) {
+                    turns.push({ role: "user", text });
+                }
+            }
+            return;
+        }
+        if (t === "assistant" &&
+            msg.role === "assistant" &&
+            Array.isArray(content)) {
+            const parts = [];
+            for (const block of content) {
+                if (block.type === "text" && typeof block.text === "string") {
+                    const cleaned = stripInjectionTags(block.text);
+                    if (cleaned)
+                        parts.push(cleaned);
+                }
+                else if (block.type === "tool_use") {
+                    if (block.name !== "Bash")
+                        continue;
+                    const inp = block.input;
+                    if (!inp || typeof inp !== "object")
+                        continue;
+                    const command = inp.command;
+                    if (typeof command !== "string")
+                        continue;
+                    const parsedAll = parseTaskPyCommandsAll(command);
+                    for (const parsed of parsedAll) {
+                        const ev = {
+                            action: parsed.action,
+                            timestamp: obj.timestamp ?? "",
+                            turnIndex: turns.length,
+                            ...(parsed.action === "create"
+                                ? { slug: parsed.slug }
+                                : { taskDir: parsed.taskDir }),
+                        };
+                        events.push(ev);
+                    }
+                }
+            }
+            if (parts.length)
+                turns.push({ role: "assistant", text: parts.join("\n\n") });
+        }
+    });
+    return { turns, events };
+}
+//# sourceMappingURL=claude.js.map

package/dist/mem/adapters/claude.js.map

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

package/dist/mem/adapters/codex.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Persisted Codex session reader.
+ *
+ * Layout: `~/.codex/sessions/**\/rollout-<ts>-<id>.jsonl`. Metadata is read
+ * from the first event's `payload`; the filename timestamp is a fallback
+ * `created`.
+ */
+import type { DialogueTurn, MemFilter, MemSessionInfo, SearchHit, TaskPyEvent } from "../types.js";
+/**
+ * Recover the shell command string from a Codex `function_call` event's
+ * `arguments` field. Codex versions vary in how they encode it:
+ *
+ *   - a raw shell string
+ *   - a stringified JSON object with `cmd` / `command` (string) or
+ *     `argv` (string[] — joined with spaces)
+ *   - a raw object with the same `cmd` / `command` / `argv` shape
+ *
+ * Returns `undefined` when no command can be recovered.
+ */
+export declare function commandFromCodexArguments(argsRaw: unknown): string | undefined;
+export declare function codexListSessions(f: MemFilter): MemSessionInfo[];
+export declare function codexExtractDialogue(s: MemSessionInfo): DialogueTurn[];
+export declare function codexSearch(s: MemSessionInfo, kw: string): SearchHit;
+/**
+ * Codex twin of `collectClaudeTurnsAndEvents`. Single pass over the rollout
+ * file; emits both the cleaned dialogue turns and the list of
+ * `task.py create|start` invocations found inside `function_call` events whose
+ * `name === "exec_command"` (or `"shell"`). Compaction resets both `turns` and
+ * `events`.
+ */
+export declare function collectCodexTurnsAndEvents(s: MemSessionInfo): {
+    turns: DialogueTurn[];
+    events: TaskPyEvent[];
+};
+//# sourceMappingURL=codex.d.ts.map

package/dist/mem/adapters/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../src/mem/adapters/codex.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,OAAO,KAAK,EAEV,YAAY,EACZ,SAAS,EACT,cAAc,EACd,SAAS,EACT,WAAW,EACZ,MAAM,aAAa,CAAC;AAoCrB;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAgC9E;AAID,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,SAAS,GAAG,cAAc,EAAE,CAmChE;AAwBD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,cAAc,GAAG,YAAY,EAAE,CA8BtE;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAEpE;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,cAAc,GAAG;IAC7D,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CAoDA"}