trellis-hgl-core 0.6.0-beta.18

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

@@ -0,0 +1,70 @@
+/**
+ * Provider-injected worker runtime contract.
+ *
+ * Core owns event writes, reducer state, and the lifecycle contract. It
+ * must NOT import CLI provider adapters or shell-specific process
+ * behavior. The CLI adapter registry (or an external daemon) implements
+ * {@link WorkerRuntime} and passes it into {@link spawnWorker} /
+ * {@link interruptWorker}.
+ */
+import type { InterruptMethod, InterruptOutcome, InterruptReason } from "../internal/store/events.js";
+import type { ChannelRef, ChannelScope, InboxPolicy } from "../internal/store/schema.js";
+export interface WorkerStartInput {
+    channel: ChannelRef;
+    workerId: string;
+    cwd: string;
+    systemPrompt: string;
+    model?: string;
+    resume?: string;
+    env?: Record<string, string>;
+}
+export interface WorkerRuntimeHandle {
+    workerId: string;
+    provider?: string;
+    pid?: number;
+    startedAt: string;
+}
+export interface WorkerInterruptInput {
+    workerId: string;
+    turnId?: string;
+    reason?: InterruptReason;
+    message?: string;
+}
+export interface WorkerInterruptResult {
+    method: InterruptMethod;
+    outcome: InterruptOutcome;
+    message?: string;
+}
+export interface WorkerStopInput {
+    workerId: string;
+    reason: "explicit-kill" | "timeout" | "crash" | "shutdown";
+    signal?: NodeJS.Signals;
+    force?: boolean;
+}
+export interface WorkerStopResult {
+    outcome: "stopped" | "already-stopped" | "failed";
+    signal?: NodeJS.Signals;
+    message?: string;
+}
+export interface WorkerRuntime {
+    start(input: WorkerStartInput): Promise<WorkerRuntimeHandle>;
+    interrupt?(input: WorkerInterruptInput): Promise<WorkerInterruptResult>;
+    stop?(input: WorkerStopInput): Promise<WorkerStopResult>;
+}
+export interface SpawnWorkerInput {
+    channel: string;
+    scope?: ChannelScope;
+    projectKey?: string;
+    cwd: string;
+    by: string;
+    workerId: string;
+    provider?: string;
+    agent?: string;
+    systemPrompt: string;
+    model?: string;
+    resume?: string;
+    inboxPolicy?: InboxPolicy;
+    timeoutMs?: number;
+    meta?: Record<string, unknown>;
+}
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/channel/api/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,eAAe,EAChB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACZ,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,eAAe,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,SAAS,GAAG,iBAAiB,GAAG,QAAQ,CAAC;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC7D,SAAS,CAAC,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACxE,IAAI,CAAC,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC"}

package/dist/channel/api/runtime.js

@@ -0,0 +1,11 @@
+/**
+ * Provider-injected worker runtime contract.
+ *
+ * Core owns event writes, reducer state, and the lifecycle contract. It
+ * must NOT import CLI provider adapters or shell-specific process
+ * behavior. The CLI adapter registry (or an external daemon) implements
+ * {@link WorkerRuntime} and passes it into {@link spawnWorker} /
+ * {@link interruptWorker}.
+ */
+export {};
+//# sourceMappingURL=runtime.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/channel/api/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

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

@@ -0,0 +1,4 @@
+import { type MessageChannelEvent } from "../internal/store/events.js";
+import type { SendMessageOptions } from "./types.js";
+export declare function sendMessage(opts: SendMessageOptions): Promise<MessageChannelEvent>;
+//# sourceMappingURL=send.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../src/channel/api/send.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,6BAA6B,CAAC;AAIrC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAgD9B"}

package/dist/channel/api/send.js

@@ -0,0 +1,44 @@
+import { appendEvent, readChannelEvents, } from "../internal/store/events.js";
+import { classifyDelivery } from "../internal/store/delivery.js";
+import { reduceWorkerRegistry } from "../internal/store/worker-state.js";
+import { resolveChannelRef } from "./resolve.js";
+export async function sendMessage(opts) {
+    const ref = resolveChannelRef({
+        channel: opts.channel,
+        ...(opts.scope !== undefined ? { scope: opts.scope } : {}),
+        ...(opts.projectKey !== undefined ? { projectKey: opts.projectKey } : {}),
+        ...(opts.cwd !== undefined ? { cwd: opts.cwd } : {}),
+    });
+    const event = (await appendEvent(opts.channel, {
+        kind: "message",
+        by: opts.by,
+        text: opts.text,
+        ...(opts.tag !== undefined ? { tag: opts.tag } : {}),
+        ...(opts.to !== undefined ? { to: opts.to } : {}),
+        ...(opts.origin !== undefined ? { origin: opts.origin } : {}),
+        ...(opts.meta !== undefined ? { meta: opts.meta } : {}),
+    }, ref.project));
+    // Strict delivery modes: classify targets against the durable worker
+    // registry and append `undeliverable` for failures. The message event
+    // is already durable above, so user intent is never lost.
+    const mode = opts.deliveryMode ?? "appendOnly";
+    if (mode !== "appendOnly" && opts.to !== undefined) {
+        const targets = Array.isArray(opts.to) ? opts.to : [opts.to];
+        const events = await readChannelEvents(opts.channel, ref.project);
+        const registry = reduceWorkerRegistry(events);
+        const failures = classifyDelivery(registry, targets, mode);
+        for (const failure of failures) {
+            await appendEvent(opts.channel, {
+                kind: "undeliverable",
+                by: opts.by,
+                targetWorker: failure.targetWorker,
+                messageSeq: event.seq,
+                reason: failure.reason,
+                ...(opts.origin !== undefined ? { origin: opts.origin } : {}),
+                ...(opts.meta !== undefined ? { meta: opts.meta } : {}),
+            }, ref.project);
+        }
+    }
+    return event;
+}
+//# sourceMappingURL=send.js.map

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

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

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

@@ -0,0 +1,13 @@
+import { type WorkerState } from "../internal/store/worker-state.js";
+import type { SpawnWorkerInput, WorkerRuntime } from "./runtime.js";
+/**
+ * Spawn a worker through a provider-injected runtime.
+ *
+ * Core resolves the channel, asks the injected runtime to start the
+ * worker process, appends the durable `spawned` event (with runtime
+ * metadata and the selected inbox policy), and returns the projected
+ * {@link WorkerState}. The runtime owns process launch details; core
+ * owns event writes and state projection.
+ */
+export declare function spawnWorker(input: SpawnWorkerInput, runtime: WorkerRuntime): Promise<WorkerState>;
+//# sourceMappingURL=spawn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/channel/api/spawn.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EAEd,MAAM,cAAc,CAAC;AAEtB;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,WAAW,CAAC,CAkDtB"}

package/dist/channel/api/spawn.js

@@ -0,0 +1,54 @@
+import { appendEvent, readChannelEvents, } from "../internal/store/events.js";
+import { DEFAULT_INBOX_POLICY } from "../internal/store/inbox.js";
+import { reduceWorkerRegistry, } from "../internal/store/worker-state.js";
+import { resolveChannelRef } from "./resolve.js";
+/**
+ * Spawn a worker through a provider-injected runtime.
+ *
+ * Core resolves the channel, asks the injected runtime to start the
+ * worker process, appends the durable `spawned` event (with runtime
+ * metadata and the selected inbox policy), and returns the projected
+ * {@link WorkerState}. The runtime owns process launch details; core
+ * owns event writes and state projection.
+ */
+export async function spawnWorker(input, runtime) {
+    const ref = resolveChannelRef({
+        channel: input.channel,
+        ...(input.scope !== undefined ? { scope: input.scope } : {}),
+        ...(input.projectKey !== undefined
+            ? { projectKey: input.projectKey }
+            : {}),
+        ...(input.cwd !== undefined ? { cwd: input.cwd } : {}),
+    });
+    const startInput = {
+        channel: ref,
+        workerId: input.workerId,
+        cwd: input.cwd,
+        systemPrompt: input.systemPrompt,
+        ...(input.model !== undefined ? { model: input.model } : {}),
+        ...(input.resume !== undefined ? { resume: input.resume } : {}),
+    };
+    const handle = await runtime.start(startInput);
+    const inboxPolicy = input.inboxPolicy ?? DEFAULT_INBOX_POLICY;
+    await appendEvent(input.channel, {
+        kind: "spawned",
+        by: input.by,
+        as: input.workerId,
+        inboxPolicy,
+        ...(input.provider ?? handle.provider
+            ? { provider: input.provider ?? handle.provider }
+            : {}),
+        ...(handle.pid !== undefined ? { pid: handle.pid } : {}),
+        ...(input.agent !== undefined ? { agent: input.agent } : {}),
+        ...(input.meta !== undefined ? { meta: input.meta } : {}),
+    }, ref.project);
+    const events = await readChannelEvents(input.channel, ref.project);
+    const registry = reduceWorkerRegistry(events, ref);
+    const state = registry.workers.find((w) => w.workerId === input.workerId);
+    if (!state) {
+        // Should never happen — we just appended the spawned event.
+        throw new Error(`spawnWorker: worker '${input.workerId}' missing from registry after spawn`);
+    }
+    return state;
+}
+//# sourceMappingURL=spawn.js.map

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

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

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

@@ -0,0 +1,5 @@
+import { type ChannelMetadataEvent } from "../internal/store/events.js";
+import type { ClearChannelTitleOptions, SetChannelTitleOptions } from "./types.js";
+export declare function setChannelTitle(opts: SetChannelTitleOptions): Promise<ChannelMetadataEvent>;
+export declare function clearChannelTitle(opts: ClearChannelTitleOptions): Promise<ChannelMetadataEvent>;
+//# sourceMappingURL=title.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"title.d.ts","sourceRoot":"","sources":["../../../src/channel/api/title.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,wBAAsB,eAAe,CACnC,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAuB/B;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAoB/B"}

package/dist/channel/api/title.js

@@ -0,0 +1,40 @@
+import { appendEvent, } from "../internal/store/events.js";
+import { resolveChannelRef } from "./resolve.js";
+export async function setChannelTitle(opts) {
+    if (!opts.title || opts.title.length === 0) {
+        throw new Error("Channel title must not be empty (use clearChannelTitle)");
+    }
+    const ref = resolveChannelRef({
+        channel: opts.channel,
+        ...(opts.scope !== undefined ? { scope: opts.scope } : {}),
+        ...(opts.projectKey !== undefined ? { projectKey: opts.projectKey } : {}),
+        ...(opts.cwd !== undefined ? { cwd: opts.cwd } : {}),
+    });
+    const event = await appendEvent(opts.channel, {
+        kind: "channel",
+        action: "title",
+        by: opts.by,
+        title: opts.title,
+        ...(opts.origin !== undefined ? { origin: opts.origin } : {}),
+        ...(opts.meta !== undefined ? { meta: opts.meta } : {}),
+    }, ref.project);
+    return event;
+}
+export async function clearChannelTitle(opts) {
+    const ref = resolveChannelRef({
+        channel: opts.channel,
+        ...(opts.scope !== undefined ? { scope: opts.scope } : {}),
+        ...(opts.projectKey !== undefined ? { projectKey: opts.projectKey } : {}),
+        ...(opts.cwd !== undefined ? { cwd: opts.cwd } : {}),
+    });
+    const event = await appendEvent(opts.channel, {
+        kind: "channel",
+        action: "title",
+        by: opts.by,
+        title: null,
+        ...(opts.origin !== undefined ? { origin: opts.origin } : {}),
+        ...(opts.meta !== undefined ? { meta: opts.meta } : {}),
+    }, ref.project);
+    return event;
+}
+//# sourceMappingURL=title.js.map

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

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

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

@@ -0,0 +1,64 @@
+import type { DeliveryMode } from "../internal/store/delivery.js";
+import type { ChannelScope, ContextEntry, EventOrigin } from "../internal/store/schema.js";
+export interface ChannelAddressOptions {
+    channel: string;
+    scope?: ChannelScope;
+    /** Storage project bucket key. Not the create-event `project` slug. */
+    projectKey?: string;
+    /** cwd used to derive the project bucket when scope is "project". */
+    cwd?: string;
+}
+export interface MutationCommonOptions {
+    by: string;
+    origin?: EventOrigin;
+    meta?: Record<string, unknown>;
+}
+export interface CreateChannelOptions extends ChannelAddressOptions, MutationCommonOptions {
+    type?: "chat" | "forum";
+    task?: string;
+    project?: string;
+    labels?: string[];
+    description?: string;
+    context?: ContextEntry[];
+    ephemeral?: boolean;
+    force?: boolean;
+}
+export interface SendMessageOptions extends ChannelAddressOptions, MutationCommonOptions {
+    text: string;
+    to?: string | string[];
+    tag?: string;
+    /**
+     * Delivery validation mode. Defaults to `appendOnly`, which preserves
+     * append-only / pre-spawn backlog behavior. Strict modes append the
+     * message first, then append `undeliverable` events for targeted
+     * workers that fail the selected condition.
+     */
+    deliveryMode?: DeliveryMode;
+}
+export interface PostThreadOptions extends ChannelAddressOptions, MutationCommonOptions {
+    action: "opened" | "comment" | "status" | "labels" | "assignees" | "summary" | "processed";
+    thread: string;
+    title?: string;
+    text?: string;
+    description?: string;
+    status?: string;
+    labels?: string[];
+    assignees?: string[];
+    summary?: string;
+    context?: ContextEntry[];
+}
+export interface ContextMutationOptions extends ChannelAddressOptions, MutationCommonOptions {
+    context: ContextEntry[];
+}
+export interface ThreadContextMutationOptions extends ContextMutationOptions {
+    thread: string;
+}
+export interface RenameThreadOptions extends ChannelAddressOptions, MutationCommonOptions {
+    thread: string;
+    newThread: string;
+}
+export interface SetChannelTitleOptions extends ChannelAddressOptions, MutationCommonOptions {
+    title: string;
+}
+export type ClearChannelTitleOptions = ChannelAddressOptions & MutationCommonOptions;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/channel/api/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACZ,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,oBACf,SAAQ,qBAAqB,EAC3B,qBAAqB;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CAEjB;AAED,MAAM,WAAW,kBACf,SAAQ,qBAAqB,EAC3B,qBAAqB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,MAAM,WAAW,iBACf,SAAQ,qBAAqB,EAC3B,qBAAqB;IACvB,MAAM,EACF,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,SAAS,GACT,WAAW,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,sBACf,SAAQ,qBAAqB,EAC3B,qBAAqB;IACvB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,4BAA6B,SAAQ,sBAAsB;IAC1E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBACf,SAAQ,qBAAqB,EAC3B,qBAAqB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBACf,SAAQ,qBAAqB,EAC3B,qBAAqB;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,wBAAwB,GAAG,qBAAqB,GAC1D,qBAAqB,CAAC"}

package/dist/channel/api/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/channel/api/types.ts"],"names":[],"mappings":""}

package/dist/channel/api/watch-channels.d.ts

@@ -0,0 +1,40 @@
+import type { ChannelEvent } from "../internal/store/events.js";
+import type { ChannelEventFilter } from "../internal/store/filter.js";
+import { type ChannelRef } from "../internal/store/schema.js";
+/** Stable per-channel cursor key: `${scope}/${project}/${name}`. */
+export type ChannelCursorKey = string;
+/** Per-channel resume cursor for the cross-channel watcher. */
+export type ChannelCursor = Record<ChannelCursorKey, number>;
+export declare function channelCursorKey(ref: ChannelRef): ChannelCursorKey;
+export interface WatchChannelsInput {
+    /** Project bucket scope, or the global bucket. */
+    scope: {
+        projectKey: string;
+    } | "global";
+    filter?: ChannelEventFilter;
+    /** Per-channel resume cursors keyed by {@link channelCursorKey}. */
+    cursor?: ChannelCursor;
+    signal?: AbortSignal;
+    /**
+     * When a channel is discovered after the watcher starts, read its
+     * backlog from seq 0. Default false (tail from end).
+     */
+    fromStartNewChannels?: boolean;
+    /** Channel-discovery poll interval in ms. Default 500. */
+    discoveryIntervalMs?: number;
+}
+export interface CrossChannelEvent {
+    channel: ChannelRef;
+    event: ChannelEvent;
+    /** Snapshot of the full cursor map after applying this event. */
+    cursor: ChannelCursor;
+}
+/**
+ * Watch every channel in a project (or the global) scope and fan their
+ * events into a single stream. Channels created inside the scope after
+ * the watcher starts are discovered dynamically. Each yielded event
+ * carries a snapshot of the per-channel cursor map so consumers can
+ * checkpoint `(channel, seq)` — delivery is at-least-once.
+ */
+export declare function watchChannels(input: WatchChannelsInput): AsyncGenerator<CrossChannelEvent, void, unknown>;
+//# sourceMappingURL=watch-channels.d.ts.map

package/dist/channel/api/watch-channels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-channels.d.ts","sourceRoot":"","sources":["../../../src/channel/api/watch-channels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAKtE,OAAO,EAEL,KAAK,UAAU,EAEhB,MAAM,6BAA6B,CAAC;AAGrC,oEAAoE;AACpE,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEtC,+DAA+D;AAC/D,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;AAE7D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,gBAAgB,CAElE;AAED,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ,CAAC;IACzC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,oEAAoE;IACpE,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,0DAA0D;IAC1D,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,iEAAiE;IACjE,MAAM,EAAE,aAAa,CAAC;CACvB;AAYD;;;;;;GAMG;AACH,wBAAuB,aAAa,CAClC,KAAK,EAAE,kBAAkB,GACxB,cAAc,CAAC,iBAAiB,EAAE,IAAI,EAAE,OAAO,CAAC,CAgIlD"}

package/dist/channel/api/watch-channels.js

@@ -0,0 +1,143 @@
+import { channelDir, listChannelNamesInProject, } from "../internal/store/paths.js";
+import { GLOBAL_PROJECT_KEY, } from "../internal/store/schema.js";
+import { watchEvents } from "../internal/store/watch.js";
+export function channelCursorKey(ref) {
+    return `${ref.scope}/${ref.project}/${ref.name}`;
+}
+function resolveScope(input) {
+    if (input.scope === "global") {
+        return { project: GLOBAL_PROJECT_KEY, scope: "global" };
+    }
+    return { project: input.scope.projectKey, scope: "project" };
+}
+/**
+ * Watch every channel in a project (or the global) scope and fan their
+ * events into a single stream. Channels created inside the scope after
+ * the watcher starts are discovered dynamically. Each yielded event
+ * carries a snapshot of the per-channel cursor map so consumers can
+ * checkpoint `(channel, seq)` — delivery is at-least-once.
+ */
+export async function* watchChannels(input) {
+    const { project, scope } = resolveScope(input);
+    const filter = input.filter ?? {};
+    const discoveryIntervalMs = input.discoveryIntervalMs ?? 500;
+    const cursor = { ...(input.cursor ?? {}) };
+    const queue = [];
+    const active = new Set();
+    const controllers = new Map();
+    const tasks = new Set();
+    let wake = null;
+    let done = false;
+    let discovery;
+    let cleaned = false;
+    const notify = () => {
+        if (wake) {
+            const w = wake;
+            wake = null;
+            w();
+        }
+    };
+    const cleanup = () => {
+        if (cleaned)
+            return;
+        cleaned = true;
+        for (const controller of controllers.values()) {
+            controller.abort();
+        }
+        controllers.clear();
+        if (discovery !== undefined) {
+            clearInterval(discovery);
+            discovery = undefined;
+        }
+        input.signal?.removeEventListener("abort", abortHandler);
+    };
+    const abortHandler = () => {
+        done = true;
+        cleanup();
+        notify();
+    };
+    input.signal?.addEventListener("abort", abortHandler);
+    let initialScan = true;
+    const startWatcher = (name) => {
+        const ref = {
+            name,
+            scope,
+            project,
+            dir: channelDir(name, project),
+        };
+        const key = channelCursorKey(ref);
+        if (active.has(key))
+            return;
+        active.add(key);
+        const controller = new AbortController();
+        controllers.set(key, controller);
+        const resume = cursor[key];
+        const watchOpts = { project };
+        watchOpts.signal = controller.signal;
+        if (resume !== undefined) {
+            watchOpts.sinceSeq = resume;
+        }
+        else {
+            // No prior cursor: initial channels read their backlog; channels
+            // discovered later follow `fromStartNewChannels`.
+            watchOpts.fromStart = initialScan
+                ? true
+                : (input.fromStartNewChannels ?? false);
+        }
+        const task = (async () => {
+            try {
+                for await (const ev of watchEvents(name, filter, watchOpts)) {
+                    cursor[key] = ev.seq;
+                    queue.push({ channel: ref, event: ev, cursor: { ...cursor } });
+                    notify();
+                }
+            }
+            catch {
+                // Watcher ended (abort / fs error). Discovery may restart it
+                // while the parent watcher is still active.
+            }
+            finally {
+                active.delete(key);
+                controllers.delete(key);
+            }
+        })();
+        tasks.add(task);
+        void task.finally(() => {
+            tasks.delete(task);
+        });
+    };
+    for (const name of listChannelNamesInProject(project)) {
+        startWatcher(name);
+    }
+    initialScan = false;
+    discovery = setInterval(() => {
+        if (done)
+            return;
+        for (const name of listChannelNamesInProject(project)) {
+            startWatcher(name);
+        }
+    }, discoveryIntervalMs);
+    try {
+        while (!done) {
+            if (input.signal?.aborted)
+                return;
+            if (queue.length > 0) {
+                yield queue.shift();
+                continue;
+            }
+            await new Promise((resolve) => {
+                wake = resolve;
+            });
+        }
+        // Drain anything that landed during the final wake.
+        while (queue.length > 0) {
+            yield queue.shift();
+        }
+    }
+    finally {
+        done = true;
+        cleanup();
+        await Promise.allSettled([...tasks]);
+    }
+}
+//# sourceMappingURL=watch-channels.js.map

package/dist/channel/api/watch-channels.js.map

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

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

@@ -0,0 +1,11 @@
+import { type WatchFilter } from "../internal/store/watch.js";
+import type { ChannelEvent } from "../internal/store/events.js";
+import type { ChannelAddressOptions } from "./types.js";
+export interface WatchChannelOptions extends ChannelAddressOptions {
+    filter?: WatchFilter;
+    signal?: AbortSignal;
+    fromStart?: boolean;
+    sinceSeq?: number;
+}
+export declare function watchChannelEvents(opts: WatchChannelOptions): AsyncGenerator<ChannelEvent, void, unknown>;
+//# sourceMappingURL=watch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/channel/api/watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,mBAAoB,SAAQ,qBAAqB;IAChE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,mBAAmB,GACxB,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,CAa7C"}

package/dist/channel/api/watch.js

@@ -0,0 +1,17 @@
+import { watchEvents, } from "../internal/store/watch.js";
+import { resolveChannelRef } from "./resolve.js";
+export function watchChannelEvents(opts) {
+    const ref = resolveChannelRef({
+        channel: opts.channel,
+        ...(opts.scope !== undefined ? { scope: opts.scope } : {}),
+        ...(opts.projectKey !== undefined ? { projectKey: opts.projectKey } : {}),
+        ...(opts.cwd !== undefined ? { cwd: opts.cwd } : {}),
+    });
+    return watchEvents(opts.channel, opts.filter ?? {}, {
+        project: ref.project,
+        ...(opts.signal !== undefined ? { signal: opts.signal } : {}),
+        ...(opts.fromStart !== undefined ? { fromStart: opts.fromStart } : {}),
+        ...(opts.sinceSeq !== undefined ? { sinceSeq: opts.sinceSeq } : {}),
+    });
+}
+//# sourceMappingURL=watch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../../src/channel/api/watch.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,GAEZ,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAUjD,MAAM,UAAU,kBAAkB,CAChC,IAAyB;IAEzB,MAAM,GAAG,GAAG,iBAAiB,CAAC;QAC5B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,CAAC,CAAC;IACH,OAAO,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE;QAClD,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpE,CAAC,CAAC;AACL,CAAC"}