trellis-hgl-core 0.6.0-beta.18

package/dist/channel/api/workers.d.ts

@@ -0,0 +1,69 @@
+import { type ChannelEvent } from "../internal/store/events.js";
+import type { ChannelScope } from "../internal/store/schema.js";
+import { type WorkerState } from "../internal/store/worker-state.js";
+export interface ListWorkersInput {
+    channel: string;
+    scope?: ChannelScope;
+    projectKey?: string;
+    cwd?: string;
+    /** Include `done` / `error` / `killed` / `crashed` workers. Default false. */
+    includeTerminal?: boolean;
+}
+/**
+ * Project the durable worker registry for a channel. SOT for CLI list /
+ * status, daemon runtime cards, and tests — do not reparse event logs
+ * independently.
+ */
+export declare function listWorkers(input: ListWorkersInput): Promise<WorkerState[]>;
+export interface WatchWorkersInput extends ListWorkersInput {
+    sinceSeq?: number;
+    signal?: AbortSignal;
+}
+/**
+ * Watch the durable worker registry. Yields a fresh registry snapshot
+ * whenever a worker-relevant event lands. The first yield is the current
+ * snapshot.
+ */
+export declare function watchWorkers(input: WatchWorkersInput): AsyncGenerator<WorkerState[], void, unknown>;
+export interface WorkerRuntimeObservation {
+    workerId: string;
+    /** Supervisor pid from `<worker>.pid`. */
+    pid?: number;
+    /** Worker child pid from `<worker>.worker-pid`. */
+    workerPid?: number;
+    supervisorAlive?: boolean;
+    workerAlive?: boolean;
+    observedAt: string;
+    source: "local-pid-files";
+}
+export interface ProbeWorkerRuntimeInput {
+    channel: string;
+    scope?: ChannelScope;
+    projectKey?: string;
+    cwd?: string;
+}
+/**
+ * Host-local runtime observation. Reads `<worker>.pid` /
+ * `<worker>.worker-pid` files and checks OS liveness. This is NOT
+ * durable channel truth — `reduceWorkerRegistry` must never read pid
+ * files. Only valid on the machine that owns the supervisor files.
+ */
+export declare function probeWorkerRuntime(input: ProbeWorkerRuntimeInput): Promise<WorkerRuntimeObservation[]>;
+export interface ReconcileWorkerLivenessInput extends ProbeWorkerRuntimeInput {
+    now?: () => Date;
+    /** Append the proposed terminal events. Default false (no durable writes). */
+    appendTerminalEvents?: boolean;
+}
+export interface ReconcileWorkerLivenessResult {
+    observations: WorkerRuntimeObservation[];
+    proposedEvents: ChannelEvent[];
+    appended: ChannelEvent[];
+}
+/**
+ * Reconcile durable worker state against host-local pid files. Reports
+ * observations and the durable events it would propose. Only writes when
+ * `appendTerminalEvents` is true — the default performs no durable
+ * writes. Valid only on the machine that owns the supervisor files.
+ */
+export declare function reconcileWorkerLiveness(input: ReconcileWorkerLivenessInput): Promise<ReconcileWorkerLivenessResult>;
+//# sourceMappingURL=workers.d.ts.map

package/dist/channel/api/workers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.d.ts","sourceRoot":"","sources":["../../../src/channel/api/workers.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,mCAAmC,CAAC;AAG3C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAkBD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,WAAW,EAAE,CAAC,CAOxB;AAED,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAuB,YAAY,CACjC,KAAK,EAAE,iBAAiB,GACvB,cAAc,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CA6B9C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAoBD,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,EAAE,CAAC,CA2BrC;AAED,MAAM,WAAW,4BAA6B,SAAQ,uBAAuB;IAC3E,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,6BAA6B;IAC5C,YAAY,EAAE,wBAAwB,EAAE,CAAC;IACzC,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,6BAA6B,CAAC,CA4CxC"}

package/dist/channel/api/workers.js

@@ -0,0 +1,145 @@
+import fs from "node:fs";
+import { appendEvent, readChannelEvents, } from "../internal/store/events.js";
+import { workerFile } from "../internal/store/paths.js";
+import { watchEvents } from "../internal/store/watch.js";
+import { reduceWorkerRegistry, } from "../internal/store/worker-state.js";
+import { resolveChannelRef } from "./resolve.js";
+function resolve(input) {
+    return resolveChannelRef({
+        channel: input.channel,
+        ...(input.scope !== undefined ? { scope: input.scope } : {}),
+        ...(input.projectKey !== undefined
+            ? { projectKey: input.projectKey }
+            : {}),
+        ...(input.cwd !== undefined ? { cwd: input.cwd } : {}),
+    });
+}
+/**
+ * Project the durable worker registry for a channel. SOT for CLI list /
+ * status, daemon runtime cards, and tests — do not reparse event logs
+ * independently.
+ */
+export async function listWorkers(input) {
+    const ref = resolve(input);
+    const events = await readChannelEvents(input.channel, ref.project);
+    const registry = reduceWorkerRegistry(events, ref);
+    return input.includeTerminal
+        ? registry.workers
+        : registry.workers.filter((w) => !w.terminal);
+}
+/**
+ * Watch the durable worker registry. Yields a fresh registry snapshot
+ * whenever a worker-relevant event lands. The first yield is the current
+ * snapshot.
+ */
+export async function* watchWorkers(input) {
+    const ref = resolve(input);
+    const events = await readChannelEvents(input.channel, ref.project);
+    const snapshot = () => {
+        const registry = reduceWorkerRegistry(events, ref);
+        return input.includeTerminal
+            ? registry.workers
+            : registry.workers.filter((w) => !w.terminal);
+    };
+    yield snapshot();
+    const lastSeq = events.length > 0 ? events[events.length - 1].seq : 0;
+    const watchOpts = { project: ref.project, sinceSeq: input.sinceSeq ?? lastSeq };
+    if (input.signal)
+        watchOpts.signal = input.signal;
+    for await (const ev of watchEvents(input.channel, { includeNonMeaningful: true, includeProgress: false }, watchOpts)) {
+        events.push(ev);
+        yield snapshot();
+    }
+}
+function pidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function readPidFile(path) {
+    try {
+        const n = Number(fs.readFileSync(path, "utf-8").trim());
+        return Number.isFinite(n) && n > 0 ? n : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Host-local runtime observation. Reads `<worker>.pid` /
+ * `<worker>.worker-pid` files and checks OS liveness. This is NOT
+ * durable channel truth — `reduceWorkerRegistry` must never read pid
+ * files. Only valid on the machine that owns the supervisor files.
+ */
+export async function probeWorkerRuntime(input) {
+    const ref = resolve(input);
+    const events = await readChannelEvents(input.channel, ref.project);
+    const registry = reduceWorkerRegistry(events, ref);
+    const observedAt = new Date().toISOString();
+    return registry.workers.map((w) => {
+        const pid = readPidFile(workerFile(input.channel, w.workerId, "pid", ref.project));
+        const workerPid = readPidFile(workerFile(input.channel, w.workerId, "worker-pid", ref.project));
+        const obs = {
+            workerId: w.workerId,
+            observedAt,
+            source: "local-pid-files",
+        };
+        if (pid !== undefined) {
+            obs.pid = pid;
+            obs.supervisorAlive = pidAlive(pid);
+        }
+        if (workerPid !== undefined) {
+            obs.workerPid = workerPid;
+            obs.workerAlive = pidAlive(workerPid);
+        }
+        return obs;
+    });
+}
+/**
+ * Reconcile durable worker state against host-local pid files. Reports
+ * observations and the durable events it would propose. Only writes when
+ * `appendTerminalEvents` is true — the default performs no durable
+ * writes. Valid only on the machine that owns the supervisor files.
+ */
+export async function reconcileWorkerLiveness(input) {
+    const ref = resolve(input);
+    const events = await readChannelEvents(input.channel, ref.project);
+    const registry = reduceWorkerRegistry(events, ref);
+    const observations = await probeWorkerRuntime(input);
+    const obsById = new Map(observations.map((o) => [o.workerId, o]));
+    const now = (input.now ?? (() => new Date()))();
+    const proposedEvents = [];
+    for (const w of registry.workers) {
+        if (w.terminal)
+            continue;
+        const obs = obsById.get(w.workerId);
+        // A non-terminal worker whose supervisor pid is gone is a crash that
+        // never wrote a terminal event.
+        if (obs?.supervisorAlive === false) {
+            proposedEvents.push({
+                seq: 0,
+                ts: now.toISOString(),
+                kind: "error",
+                by: `supervisor:${w.workerId}`,
+                worker: w.workerId,
+                message: "supervisor process not alive (reconciled)",
+                synthesized: true,
+            });
+        }
+    }
+    const appended = [];
+    if (input.appendTerminalEvents) {
+        for (const ev of proposedEvents) {
+            const { seq: _seq, ts: _ts, ...partial } = ev;
+            void _seq;
+            void _ts;
+            appended.push(await appendEvent(input.channel, partial, ref.project));
+        }
+    }
+    return { observations, proposedEvents, appended };
+}
+//# sourceMappingURL=workers.js.map

package/dist/channel/api/workers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.js","sourceRoot":"","sources":["../../../src/channel/api/workers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,OAAO,EACL,WAAW,EACX,iBAAiB,GAElB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EACL,oBAAoB,GAErB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAWjD,SAAS,OAAO,CAAC,KAKhB;IACC,OAAO,iBAAiB,CAAC;QACvB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS;YAChC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;YAClC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvD,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAuB;IAEvB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3B,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnD,OAAO,KAAK,CAAC,eAAe;QAC1B,CAAC,CAAC,QAAQ,CAAC,OAAO;QAClB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAClD,CAAC;AAOD;;;;GAIG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,YAAY,CACjC,KAAwB;IAExB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3B,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IAEnE,MAAM,QAAQ,GAAG,GAAkB,EAAE;QACnC,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACnD,OAAO,KAAK,CAAC,eAAe;YAC1B,CAAC,CAAC,QAAQ,CAAC,OAAO;YAClB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC,CAAC;IAEF,MAAM,QAAQ,EAAE,CAAC;IAEjB,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,SAAS,GAIX,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,OAAO,EAAE,CAAC;IAClE,IAAI,KAAK,CAAC,MAAM;QAAE,SAAS,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAElD,IAAI,KAAK,EAAE,MAAM,EAAE,IAAI,WAAW,CAChC,KAAK,CAAC,OAAO,EACb,EAAE,oBAAoB,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,EACtD,SAAS,CACV,EAAE,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChB,MAAM,QAAQ,EAAE,CAAC;IACnB,CAAC;AACH,CAAC;AAcD,SAAS,QAAQ,CAAC,GAAW;IAC3B,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACxD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AASD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAA8B;IAE9B,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3B,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAChC,MAAM,GAAG,GAAG,WAAW,CACrB,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAC1D,CAAC;QACF,MAAM,SAAS,GAAG,WAAW,CAC3B,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,CACjE,CAAC;QACF,MAAM,GAAG,GAA6B;YACpC,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,UAAU;YACV,MAAM,EAAE,iBAAiB;SAC1B,CAAC;QACF,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC;YACd,GAAG,CAAC,eAAe,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;YAC1B,GAAG,CAAC,WAAW,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;AACL,CAAC;AAcD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAAmC;IAEnC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3B,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;IAEhD,MAAM,cAAc,GAAmB,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC,CAAC,QAAQ;YAAE,SAAS;QACzB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACpC,qEAAqE;QACrE,gCAAgC;QAChC,IAAI,GAAG,EAAE,eAAe,KAAK,KAAK,EAAE,CAAC;YACnC,cAAc,CAAC,IAAI,CAAC;gBAClB,GAAG,EAAE,CAAC;gBACN,EAAE,EAAE,GAAG,CAAC,WAAW,EAAE;gBACrB,IAAI,EAAE,OAAO;gBACb,EAAE,EAAE,cAAc,CAAC,CAAC,QAAQ,EAAE;gBAC9B,MAAM,EAAE,CAAC,CAAC,QAAQ;gBAClB,OAAO,EAAE,2CAA2C;gBACpD,WAAW,EAAE,IAAI;aACF,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,IAAI,KAAK,CAAC,oBAAoB,EAAE,CAAC;QAC/B,KAAK,MAAM,EAAE,IAAI,cAAc,EAAE,CAAC;YAChC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,CAAC;YAC9C,KAAK,IAAI,CAAC;YACV,KAAK,GAAG,CAAC;YACT,QAAQ,CAAC,IAAI,CACX,MAAM,WAAW,CACf,KAAK,CAAC,OAAO,EACb,OAA4C,EAC5C,GAAG,CAAC,OAAO,CACZ,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;AACpD,CAAC"}

package/dist/channel/index.d.ts

@@ -0,0 +1,38 @@
+export type { ChannelScope, ChannelType, ChannelRef, ChannelMetadata, ContextEntry, FileContextEntry, RawContextEntry, ContextTarget, ContextMutationAction, EventOrigin, ThreadAction, InboxPolicy, } from "./internal/store/schema.js";
+export { GLOBAL_PROJECT_KEY, CHANNEL_TYPES, THREAD_ACTIONS, EVENT_ORIGINS, INBOX_POLICIES, parseChannelScope, parseChannelType, parseThreadAction, parseEventOrigin, parseInboxPolicy, normalizeThreadKey, buildContextEntries, contextEntryKey, asContextEntries, asStringArray, } from "./internal/store/schema.js";
+export type { ChannelEvent, ChannelEventKind, CreateChannelEvent, MessageChannelEvent, ThreadChannelEvent, ContextChannelEvent, ChannelMetadataEvent, SpawnedChannelEvent, KilledChannelEvent, DoneChannelEvent, ErrorChannelEvent, ProgressChannelEvent, UndeliverableChannelEvent, InterruptRequestedChannelEvent, TurnStartedChannelEvent, TurnFinishedChannelEvent, InterruptedChannelEvent, SupervisorWarningChannelEvent, SupervisorWarningReason, InterruptReason, InterruptMethod, InterruptOutcome, UndeliverableReason, ReadChannelEventsPagination, } from "./internal/store/events.js";
+export { CHANNEL_EVENT_KINDS, DEFAULT_CURSOR_PAGE_SIZE, parseChannelKind, parseChannelKinds, isCreateEvent, isThreadEvent, isContextEvent, isChannelMetadataEvent, } from "./internal/store/events.js";
+export type { WorkerState, WorkerLifecycle, WorkerActivity, WorkerRegistry, } from "./internal/store/worker-state.js";
+export { reduceWorkerRegistry, isTerminalLifecycle, } from "./internal/store/worker-state.js";
+export { DEFAULT_INBOX_POLICY, matchesInboxPolicy, } from "./internal/store/inbox.js";
+export type { DeliveryMode, UndeliverableTarget, } from "./internal/store/delivery.js";
+export { DELIVERY_MODES, parseDeliveryMode, classifyDelivery, } from "./internal/store/delivery.js";
+export type { ChannelEventFilter } from "./internal/store/filter.js";
+export type { WatchFilter } from "./internal/store/watch.js";
+export { MEANINGFUL_EVENT_KINDS, matchesEventFilter, } from "./internal/store/filter.js";
+export { reduceChannelMetadata, } from "./internal/store/channel-metadata.js";
+export type { ThreadState, ThreadAliasResolver, } from "./internal/store/thread-state.js";
+export { reduceThreads, buildThreadAliasResolver, collectThreadTimeline, } from "./internal/store/thread-state.js";
+export { createChannel, } from "./api/create.js";
+export { sendMessage, } from "./api/send.js";
+export { readWorkerInbox, watchWorkerInbox, WorkerInboxError, } from "./api/inbox.js";
+export type { ReadWorkerInboxInput, WatchWorkerInboxInput, WorkerInboxMessage, WorkerInboxErrorCode, } from "./api/inbox.js";
+export { postThread, renameThread, } from "./api/post-thread.js";
+export { addChannelContext, deleteChannelContext, listChannelContext, addThreadContext, deleteThreadContext, listThreadContext, } from "./api/context.js";
+export { setChannelTitle, clearChannelTitle, } from "./api/title.js";
+export { readChannelEvents, readChannelMetadata, listForumThreads, showThread, } from "./api/read.js";
+export type { ReadChannelEventsOptions } from "./api/read.js";
+export { watchChannelEvents, } from "./api/watch.js";
+export type { WatchChannelOptions } from "./api/watch.js";
+export { watchChannels, channelCursorKey, } from "./api/watch-channels.js";
+export type { WatchChannelsInput, CrossChannelEvent, ChannelCursor, ChannelCursorKey, } from "./api/watch-channels.js";
+export { listWorkers, watchWorkers, probeWorkerRuntime, reconcileWorkerLiveness, } from "./api/workers.js";
+export type { ListWorkersInput, WatchWorkersInput, WorkerRuntimeObservation, ProbeWorkerRuntimeInput, ReconcileWorkerLivenessInput, ReconcileWorkerLivenessResult, } from "./api/workers.js";
+export { spawnWorker } from "./api/spawn.js";
+export { requestInterrupt, interruptWorker, } from "./api/interrupt.js";
+export type { InterruptWorkerInput, InterruptWorkerResult, InterruptDelivery, } from "./api/interrupt.js";
+export type { WorkerStartInput, WorkerRuntimeHandle, WorkerInterruptInput, WorkerInterruptResult, WorkerStopInput, WorkerStopResult, WorkerRuntime, SpawnWorkerInput, } from "./api/runtime.js";
+export { resolveChannelRef } from "./api/resolve.js";
+export type { ResolveChannelRefOptions } from "./api/resolve.js";
+export type { ChannelAddressOptions, MutationCommonOptions, CreateChannelOptions, SendMessageOptions, PostThreadOptions, ContextMutationOptions, ThreadContextMutationOptions, RenameThreadOptions, SetChannelTitleOptions, ClearChannelTitleOptions, } from "./api/types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channel/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,WAAW,EACX,YAAY,EACZ,WAAW,GACZ,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,aAAa,GACd,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,8BAA8B,EAC9B,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,6BAA6B,EAC7B,uBAAuB,EACvB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,WAAW,EACX,eAAe,EACf,cAAc,EACd,cAAc,GACf,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACV,YAAY,EACZ,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,EACL,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,qBAAqB,GACtB,MAAM,sCAAsC,CAAC;AAE9C,YAAY,EACV,WAAW,EACX,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,UAAU,EACV,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,EACL,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EACL,aAAa,EACb,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,uBAAuB,EACvB,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACL,gBAAgB,EAChB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAEjE,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,4BAA4B,EAC5B,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC"}

package/dist/channel/index.js

@@ -0,0 +1,23 @@
+// Public channel API surface.
+export { GLOBAL_PROJECT_KEY, CHANNEL_TYPES, THREAD_ACTIONS, EVENT_ORIGINS, INBOX_POLICIES, parseChannelScope, parseChannelType, parseThreadAction, parseEventOrigin, parseInboxPolicy, normalizeThreadKey, buildContextEntries, contextEntryKey, asContextEntries, asStringArray, } from "./internal/store/schema.js";
+export { CHANNEL_EVENT_KINDS, DEFAULT_CURSOR_PAGE_SIZE, parseChannelKind, parseChannelKinds, isCreateEvent, isThreadEvent, isContextEvent, isChannelMetadataEvent, } from "./internal/store/events.js";
+export { reduceWorkerRegistry, isTerminalLifecycle, } from "./internal/store/worker-state.js";
+export { DEFAULT_INBOX_POLICY, matchesInboxPolicy, } from "./internal/store/inbox.js";
+export { DELIVERY_MODES, parseDeliveryMode, classifyDelivery, } from "./internal/store/delivery.js";
+export { MEANINGFUL_EVENT_KINDS, matchesEventFilter, } from "./internal/store/filter.js";
+export { reduceChannelMetadata, } from "./internal/store/channel-metadata.js";
+export { reduceThreads, buildThreadAliasResolver, collectThreadTimeline, } from "./internal/store/thread-state.js";
+export { createChannel, } from "./api/create.js";
+export { sendMessage, } from "./api/send.js";
+export { readWorkerInbox, watchWorkerInbox, WorkerInboxError, } from "./api/inbox.js";
+export { postThread, renameThread, } from "./api/post-thread.js";
+export { addChannelContext, deleteChannelContext, listChannelContext, addThreadContext, deleteThreadContext, listThreadContext, } from "./api/context.js";
+export { setChannelTitle, clearChannelTitle, } from "./api/title.js";
+export { readChannelEvents, readChannelMetadata, listForumThreads, showThread, } from "./api/read.js";
+export { watchChannelEvents, } from "./api/watch.js";
+export { watchChannels, channelCursorKey, } from "./api/watch-channels.js";
+export { listWorkers, watchWorkers, probeWorkerRuntime, reconcileWorkerLiveness, } from "./api/workers.js";
+export { spawnWorker } from "./api/spawn.js";
+export { requestInterrupt, interruptWorker, } from "./api/interrupt.js";
+export { resolveChannelRef } from "./api/resolve.js";
+//# sourceMappingURL=index.js.map

package/dist/channel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/channel/index.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAiB9B,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,aAAa,GACd,MAAM,4BAA4B,CAAC;AA6BpC,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AASpC,OAAO,EACL,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAOnC,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AAKtC,OAAO,EACL,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,qBAAqB,GACtB,MAAM,sCAAsC,CAAC;AAO9C,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAQxB,OAAO,EACL,UAAU,EACV,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,GACX,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,aAAa,EACb,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAQjC,OAAO,EACL,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAU1B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACL,gBAAgB,EAChB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAkB5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/channel/internal/store/channel-metadata.d.ts

@@ -0,0 +1,23 @@
+import { type ChannelEvent } from "./events.js";
+import { type ChannelMetadata } from "./schema.js";
+/**
+ * Single source of truth for projecting a channel's metadata from its
+ * event stream.
+ *
+ * Covers:
+ *   - create event metadata (type, description, labels, context)
+ *   - legacy `linkedContext` field on create / thread events
+ *   - legacy `type:"thread"` / `type:"threads"` are NOT normalized to
+ *     `forum`; they project to `chat` so thread APIs reject them
+ *   - `kind:"context", target:"channel"` add/delete projection
+ *   - `kind:"channel", action:"title"` set/clear projection
+ */
+export declare function reduceChannelMetadata(events: ChannelEvent[]): ChannelMetadata;
+/**
+ * Legacy compatibility: project a single create event into channel
+ * metadata. New callers should use {@link reduceChannelMetadata} over
+ * the full event stream so context add/delete, title set/clear, and
+ * legacy `linkedContext` projection are honored.
+ */
+export declare function metadataFromCreateEvent(create: ChannelEvent | undefined): ChannelMetadata;
+//# sourceMappingURL=channel-metadata.d.ts.map

package/dist/channel/internal/store/channel-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-metadata.d.ts","sourceRoot":"","sources":["../../../../src/channel/internal/store/channel-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAIL,KAAK,eAAe,EAGrB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EAAE,GACrB,eAAe,CA2DjB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,YAAY,GAAG,SAAS,GAC/B,eAAe,CAGjB"}

package/dist/channel/internal/store/channel-metadata.js

@@ -0,0 +1,94 @@
+import { isChannelMetadataEvent, isContextEvent, isCreateEvent, } from "./events.js";
+import { asContextEntries, asStringArray, contextEntryKey, } from "./schema.js";
+/**
+ * Single source of truth for projecting a channel's metadata from its
+ * event stream.
+ *
+ * Covers:
+ *   - create event metadata (type, description, labels, context)
+ *   - legacy `linkedContext` field on create / thread events
+ *   - legacy `type:"thread"` / `type:"threads"` are NOT normalized to
+ *     `forum`; they project to `chat` so thread APIs reject them
+ *   - `kind:"context", target:"channel"` add/delete projection
+ *   - `kind:"channel", action:"title"` set/clear projection
+ */
+export function reduceChannelMetadata(events) {
+    let type = "chat";
+    let description;
+    let labels;
+    let title;
+    const contextMap = new Map();
+    const addEntries = (entries) => {
+        if (!entries)
+            return;
+        for (const entry of entries) {
+            contextMap.set(contextEntryKey(entry), entry);
+        }
+    };
+    const deleteEntries = (entries) => {
+        if (!entries)
+            return;
+        for (const entry of entries) {
+            contextMap.delete(contextEntryKey(entry));
+        }
+    };
+    for (const ev of events) {
+        if (isCreateEvent(ev)) {
+            type = normalizeChannelType(ev.type);
+            if (typeof ev.description === "string")
+                description = ev.description;
+            labels = asStringArray(ev.labels) ?? labels;
+            // Initial context comes from `context` (new) or legacy
+            // `linkedContext`. New entries replace any prior state because a
+            // `create` event is always seq 1.
+            const initial = asContextEntries(ev.context) ?? asContextEntries(ev.linkedContext);
+            contextMap.clear();
+            addEntries(initial);
+            continue;
+        }
+        if (isContextEvent(ev) && ev.target === "channel") {
+            const entries = asContextEntries(ev.context);
+            if (ev.action === "add")
+                addEntries(entries);
+            else if (ev.action === "delete")
+                deleteEntries(entries);
+            continue;
+        }
+        if (isChannelMetadataEvent(ev) && ev.action === "title") {
+            const next = ev.title;
+            if (typeof next === "string" && next.length > 0)
+                title = next;
+            else if (next === null || next === "")
+                title = undefined;
+            continue;
+        }
+    }
+    const context = contextMap.size > 0 ? [...contextMap.values()] : undefined;
+    return {
+        type,
+        ...(title !== undefined ? { title } : {}),
+        ...(description !== undefined ? { description } : {}),
+        ...(context !== undefined ? { context } : {}),
+        ...(labels !== undefined ? { labels } : {}),
+    };
+}
+/**
+ * Legacy compatibility: project a single create event into channel
+ * metadata. New callers should use {@link reduceChannelMetadata} over
+ * the full event stream so context add/delete, title set/clear, and
+ * legacy `linkedContext` projection are honored.
+ */
+export function metadataFromCreateEvent(create) {
+    if (!create || !isCreateEvent(create))
+        return { type: "chat" };
+    return reduceChannelMetadata([create]);
+}
+function normalizeChannelType(value) {
+    if (value === "forum")
+        return "forum";
+    // Legacy `"thread"` / `"threads"` values are intentionally not
+    // upgraded to `forum`; they fall through to `chat` so forum/thread
+    // APIs reject pre-rename channels.
+    return "chat";
+}
+//# sourceMappingURL=channel-metadata.js.map

package/dist/channel/internal/store/channel-metadata.js.map

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

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

@@ -0,0 +1,27 @@
+import type { UndeliverableReason } from "./events.js";
+import type { WorkerRegistry } from "./worker-state.js";
+/**
+ * Delivery validation mode for targeted `sendMessage`.
+ *
+ * - `appendOnly`: current behavior — append the message, never signal.
+ *   Preserves pre-spawn backlog delivery.
+ * - `requireKnownWorker`: signal `undeliverable` for targets that have
+ *   never existed in the durable worker registry.
+ * - `requireRunningWorker`: signal `undeliverable` for targets that are
+ *   unknown or terminal in the durable worker registry.
+ */
+export type DeliveryMode = "appendOnly" | "requireKnownWorker" | "requireRunningWorker";
+export declare const DELIVERY_MODES: ReadonlySet<DeliveryMode>;
+export declare function parseDeliveryMode(v: string | undefined): DeliveryMode | undefined;
+export interface UndeliverableTarget {
+    targetWorker: string;
+    reason: UndeliverableReason;
+}
+/**
+ * Classify which targeted workers a message cannot reach under the given
+ * delivery mode. Pure — decides only from the durable worker registry,
+ * never from OS liveness. `appendOnly` always returns an empty list.
+ * Broadcast messages (no targets) never produce undeliverable signals.
+ */
+export declare function classifyDelivery(registry: WorkerRegistry, targets: string[], mode: DeliveryMode): UndeliverableTarget[];
+//# sourceMappingURL=delivery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../../../src/channel/internal/store/delivery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GACpB,YAAY,GACZ,oBAAoB,GACpB,sBAAsB,CAAC;AAE3B,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,YAAY,CAInD,CAAC;AAEH,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,MAAM,GAAG,SAAS,GACpB,YAAY,GAAG,SAAS,CAQ1B;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,YAAY,GACjB,mBAAmB,EAAE,CAevB"}

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

@@ -0,0 +1,37 @@
+export const DELIVERY_MODES = new Set([
+    "appendOnly",
+    "requireKnownWorker",
+    "requireRunningWorker",
+]);
+export function parseDeliveryMode(v) {
+    if (v === undefined)
+        return undefined;
+    if (!DELIVERY_MODES.has(v)) {
+        throw new Error(`Invalid delivery mode '${v}'. Must be one of: ${[...DELIVERY_MODES].join(", ")}`);
+    }
+    return v;
+}
+/**
+ * Classify which targeted workers a message cannot reach under the given
+ * delivery mode. Pure — decides only from the durable worker registry,
+ * never from OS liveness. `appendOnly` always returns an empty list.
+ * Broadcast messages (no targets) never produce undeliverable signals.
+ */
+export function classifyDelivery(registry, targets, mode) {
+    if (mode === "appendOnly" || targets.length === 0)
+        return [];
+    const byId = new Map(registry.workers.map((w) => [w.workerId, w]));
+    const failed = [];
+    for (const target of targets) {
+        const worker = byId.get(target);
+        if (!worker) {
+            failed.push({ targetWorker: target, reason: "worker-unknown" });
+            continue;
+        }
+        if (mode === "requireRunningWorker" && worker.terminal) {
+            failed.push({ targetWorker: target, reason: "worker-terminal" });
+        }
+    }
+    return failed;
+}
+//# sourceMappingURL=delivery.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.js","sourceRoot":"","sources":["../../../../src/channel/internal/store/delivery.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,cAAc,GAA8B,IAAI,GAAG,CAAC;IAC/D,YAAY;IACZ,oBAAoB;IACpB,sBAAsB;CACvB,CAAC,CAAC;AAEH,MAAM,UAAU,iBAAiB,CAC/B,CAAqB;IAErB,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACtC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAiB,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,0BAA0B,CAAC,sBAAsB,CAAC,GAAG,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClF,CAAC;IACJ,CAAC;IACD,OAAO,CAAiB,CAAC;AAC3B,CAAC;AAOD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAwB,EACxB,OAAiB,EACjB,IAAkB;IAElB,IAAI,IAAI,KAAK,YAAY,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7D,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,MAAM,GAA0B,EAAE,CAAC;IACzC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;YAChE,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,sBAAsB,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACvD,MAAM,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}