trellis-hgl-core 0.6.0-beta.18

package/dist/channel/api/inbox.js

@@ -0,0 +1,176 @@
+import { readChannelEvents as readEventsInternal, } from "../internal/store/events.js";
+import { matchesInboxPolicy } from "../internal/store/inbox.js";
+import { watchEvents } from "../internal/store/watch.js";
+import { reduceWorkerRegistry } from "../internal/store/worker-state.js";
+import { resolveChannelRef } from "./resolve.js";
+export class WorkerInboxError extends Error {
+    code;
+    channel;
+    workerId;
+    constructor(code, channel, workerId, message) {
+        super(message ?? defaultMessage(code, channel, workerId));
+        this.name = "WorkerInboxError";
+        this.code = code;
+        this.channel = channel;
+        this.workerId = workerId;
+    }
+}
+function defaultMessage(code, channel, workerId) {
+    switch (code) {
+        case "WORKER_INBOX_WORKER_NOT_FOUND":
+            return `Worker '${workerId}' not found in channel '${channel}'`;
+        case "WORKER_INBOX_WORKER_TERMINAL":
+            return `Worker '${workerId}' in channel '${channel}' is terminal`;
+    }
+}
+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 } : {}),
+    });
+}
+/**
+ * Read durable inbox messages for a specific worker.
+ *
+ * Reduces the worker registry from the channel event log, finds the worker,
+ * and filters `message` events through `matchesInboxPolicy()` using the
+ * worker's latest `inboxPolicy`. Core only reasons from the durable event
+ * log; it does not claim the OS process is live.
+ */
+export async function readWorkerInbox(input) {
+    const ref = resolve(input);
+    const events = await readEventsInternal(input.channel, ref.project);
+    const registry = reduceWorkerRegistry(events, ref);
+    const worker = registry.workers.find((w) => w.workerId === input.workerId);
+    if (!worker) {
+        throw new WorkerInboxError("WORKER_INBOX_WORKER_NOT_FOUND", input.channel, input.workerId);
+    }
+    if (worker.terminal && !input.includeTerminal) {
+        throw new WorkerInboxError("WORKER_INBOX_WORKER_TERMINAL", input.channel, input.workerId);
+    }
+    if (input.limit !== undefined &&
+        (!Number.isInteger(input.limit) || input.limit < 0)) {
+        throw new Error("readWorkerInbox: limit must be a non-negative integer");
+    }
+    if (input.limit === 0)
+        return [];
+    const afterSeq = input.afterSeq ?? 0;
+    const out = [];
+    for (const ev of events) {
+        if (ev.seq <= afterSeq)
+            continue;
+        if (!matchesInboxPolicy(ev, input.workerId, worker.inboxPolicy))
+            continue;
+        out.push({
+            workerId: input.workerId,
+            event: ev,
+            seq: ev.seq,
+            cursor: ev.seq,
+        });
+        if (input.limit !== undefined && out.length >= input.limit)
+            break;
+    }
+    return out;
+}
+/**
+ * Watch future inbox messages for a specific worker.
+ *
+ * Performs upfront worker validation and captures the current `lastSeq`,
+ * then returns a generator that yields future inbox-matching messages
+ * through the channel watch primitives. The generator ends when a terminal
+ * event for the watched worker arrives; it does not cross a terminal event
+ * into a later respawn with the same id.
+ *
+ * Eager validation means errors surface from the outer call, and the
+ * watch's `sinceSeq` snapshot is taken before the caller can append more
+ * events.
+ */
+export async function watchWorkerInbox(input) {
+    const ref = resolve(input);
+    const events = await readEventsInternal(input.channel, ref.project);
+    const registry = reduceWorkerRegistry(events, ref);
+    const worker = registry.workers.find((w) => w.workerId === input.workerId);
+    if (!worker) {
+        throw new WorkerInboxError("WORKER_INBOX_WORKER_NOT_FOUND", input.channel, input.workerId);
+    }
+    if (worker.terminal) {
+        throw new WorkerInboxError("WORKER_INBOX_WORKER_TERMINAL", input.channel, input.workerId);
+    }
+    const policy = worker.inboxPolicy;
+    const lastSeq = events.length > 0 ? events[events.length - 1].seq : 0;
+    const generationFloorSeq = findGenerationFloorSeq(events, input.workerId);
+    const watchOpts = { project: ref.project };
+    if (input.signal !== undefined)
+        watchOpts.signal = input.signal;
+    if (input.fromStart) {
+        watchOpts.sinceSeq = generationFloorSeq;
+    }
+    else if (input.sinceSeq !== undefined) {
+        watchOpts.sinceSeq = Math.max(input.sinceSeq, generationFloorSeq);
+    }
+    else {
+        watchOpts.sinceSeq = lastSeq;
+    }
+    return inboxWatchGenerator(input.channel, input.workerId, policy, watchOpts);
+}
+async function* inboxWatchGenerator(channel, workerId, policy, watchOpts) {
+    for await (const ev of watchEvents(channel, { includeNonMeaningful: true, includeProgress: false }, watchOpts)) {
+        if (isTerminalForWorker(ev, workerId))
+            return;
+        if (matchesInboxPolicy(ev, workerId, policy)) {
+            yield {
+                workerId,
+                event: ev,
+                seq: ev.seq,
+                cursor: ev.seq,
+            };
+        }
+    }
+}
+function isTerminalForWorker(ev, workerId) {
+    if (ev.kind === "killed") {
+        return resolveWorkerId(ev) === workerId;
+    }
+    if (ev.kind === "done") {
+        if (ev.synthesized !== true)
+            return false;
+        return resolveWorkerId(ev) === workerId;
+    }
+    if (ev.kind === "error") {
+        const synthesized = ev.synthesized === true;
+        const fromSupervisor = ev.by.startsWith("supervisor:");
+        if (!synthesized && !fromSupervisor)
+            return false;
+        return resolveWorkerId(ev) === workerId;
+    }
+    return false;
+}
+function findGenerationFloorSeq(events, workerId) {
+    let lastTerminalSeq = 0;
+    let generationFloorSeq = 0;
+    for (const ev of events) {
+        if (isTerminalForWorker(ev, workerId)) {
+            lastTerminalSeq = ev.seq;
+            continue;
+        }
+        if (isSpawnedForWorker(ev, workerId)) {
+            generationFloorSeq = lastTerminalSeq;
+        }
+    }
+    return generationFloorSeq;
+}
+function isSpawnedForWorker(ev, workerId) {
+    return ev.kind === "spawned" && ev.as === workerId;
+}
+function resolveWorkerId(ev) {
+    const explicit = ev.worker ?? ev.as;
+    if (explicit)
+        return explicit;
+    return stripSupervisor(ev.by);
+}
+function stripSupervisor(by) {
+    return by.startsWith("supervisor:") ? by.slice("supervisor:".length) : by;
+}
+//# sourceMappingURL=inbox.js.map

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

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

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

@@ -0,0 +1,31 @@
+import { type ChannelEvent, type InterruptReason } from "../internal/store/events.js";
+import type { WorkerRuntime } from "./runtime.js";
+import type { ChannelAddressOptions, MutationCommonOptions } from "./types.js";
+export interface InterruptWorkerInput extends ChannelAddressOptions, MutationCommonOptions {
+    workerId: string;
+    message?: string;
+    reason?: InterruptReason;
+}
+export type InterruptDelivery = "interrupted-current-turn" | "no-active-turn" | "worker-terminal" | "worker-unknown";
+export interface InterruptWorkerResult {
+    /** Last durable event appended (`interrupted` if attempted, else `interrupt_requested`). */
+    event: ChannelEvent;
+    interrupted: boolean;
+    delivery: InterruptDelivery;
+}
+/**
+ * Durable-event-only interrupt. Appends an `interrupt_requested` event
+ * recording intent. Does not touch any worker runtime.
+ */
+export declare function requestInterrupt(input: InterruptWorkerInput): Promise<ChannelEvent>;
+/**
+ * Orchestration interrupt. Appends `interrupt_requested`, asks the
+ * injected runtime to interrupt the worker, then appends `interrupted`
+ * with the runtime-reported `method` / `outcome`. Core never imports CLI
+ * provider adapters — the runtime is injected.
+ *
+ * Skips the runtime call (and the `interrupted` event) when the worker
+ * is unknown or terminal in the durable registry.
+ */
+export declare function interruptWorker(input: InterruptWorkerInput, runtime: WorkerRuntime): Promise<InterruptWorkerResult>;
+//# sourceMappingURL=interrupt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interrupt.d.ts","sourceRoot":"","sources":["../../../src/channel/api/interrupt.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,KAAK,EAAyB,aAAa,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE/E,MAAM,WAAW,oBACf,SAAQ,qBAAqB,EAC3B,qBAAqB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,MAAM,iBAAiB,GACzB,0BAA0B,GAC1B,gBAAgB,GAChB,iBAAiB,GACjB,gBAAgB,CAAC;AAErB,MAAM,WAAW,qBAAqB;IACpC,4FAA4F;IAC5F,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAsBvB;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,qBAAqB,CAAC,CAiFhC"}

package/dist/channel/api/interrupt.js

@@ -0,0 +1,102 @@
+import { appendEvent, readChannelEvents, } from "../internal/store/events.js";
+import { reduceWorkerRegistry } from "../internal/store/worker-state.js";
+import { resolveChannelRef } from "./resolve.js";
+/**
+ * Durable-event-only interrupt. Appends an `interrupt_requested` event
+ * recording intent. Does not touch any worker runtime.
+ */
+export async function requestInterrupt(input) {
+    const ref = resolveChannelRef({
+        channel: input.channel,
+        ...(input.scope !== undefined ? { scope: input.scope } : {}),
+        ...(input.projectKey !== undefined
+            ? { projectKey: input.projectKey }
+            : {}),
+        ...(input.cwd !== undefined ? { cwd: input.cwd } : {}),
+    });
+    return appendEvent(input.channel, {
+        kind: "interrupt_requested",
+        by: input.by,
+        worker: input.workerId,
+        ...(input.reason !== undefined ? { reason: input.reason } : {}),
+        ...(input.message !== undefined ? { message: input.message } : {}),
+        ...(input.origin !== undefined ? { origin: input.origin } : {}),
+        ...(input.meta !== undefined ? { meta: input.meta } : {}),
+    }, ref.project);
+}
+/**
+ * Orchestration interrupt. Appends `interrupt_requested`, asks the
+ * injected runtime to interrupt the worker, then appends `interrupted`
+ * with the runtime-reported `method` / `outcome`. Core never imports CLI
+ * provider adapters — the runtime is injected.
+ *
+ * Skips the runtime call (and the `interrupted` event) when the worker
+ * is unknown or terminal in the durable registry.
+ */
+export async function interruptWorker(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 events = await readChannelEvents(input.channel, ref.project);
+    const registry = reduceWorkerRegistry(events);
+    const worker = registry.workers.find((w) => w.workerId === input.workerId);
+    const turnId = worker?.activeTurnId;
+    const requestEvent = await appendEvent(input.channel, {
+        kind: "interrupt_requested",
+        by: input.by,
+        worker: input.workerId,
+        ...(turnId !== undefined ? { turnId } : {}),
+        ...(input.reason !== undefined ? { reason: input.reason } : {}),
+        ...(input.message !== undefined ? { message: input.message } : {}),
+        ...(input.origin !== undefined ? { origin: input.origin } : {}),
+        ...(input.meta !== undefined ? { meta: input.meta } : {}),
+    }, ref.project);
+    if (!worker) {
+        return {
+            event: requestEvent,
+            interrupted: false,
+            delivery: "worker-unknown",
+        };
+    }
+    if (worker.terminal) {
+        return {
+            event: requestEvent,
+            interrupted: false,
+            delivery: "worker-terminal",
+        };
+    }
+    const result = runtime.interrupt
+        ? await runtime.interrupt({
+            workerId: input.workerId,
+            ...(turnId !== undefined ? { turnId } : {}),
+            ...(input.reason !== undefined ? { reason: input.reason } : {}),
+            ...(input.message !== undefined ? { message: input.message } : {}),
+        })
+        : { method: "none", outcome: "unsupported" };
+    const interruptedEvent = await appendEvent(input.channel, {
+        kind: "interrupted",
+        by: input.by,
+        worker: input.workerId,
+        method: result.method,
+        outcome: result.outcome,
+        ...(turnId !== undefined ? { turnId } : {}),
+        ...(input.reason !== undefined ? { reason: input.reason } : {}),
+        ...(result.message !== undefined ? { message: result.message } : {}),
+        ...(input.origin !== undefined ? { origin: input.origin } : {}),
+        ...(input.meta !== undefined ? { meta: input.meta } : {}),
+    }, ref.project);
+    const delivery = worker.activity === "mid-turn"
+        ? "interrupted-current-turn"
+        : "no-active-turn";
+    return {
+        event: interruptedEvent,
+        interrupted: result.outcome === "interrupted",
+        delivery,
+    };
+}
+//# sourceMappingURL=interrupt.js.map

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

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

package/dist/channel/api/post-thread.d.ts

@@ -0,0 +1,14 @@
+import { type ThreadChannelEvent } from "../internal/store/events.js";
+import type { PostThreadOptions, RenameThreadOptions } from "./types.js";
+/**
+ * Append a structured thread event. Throws when the channel is not of
+ * `forum` type, when `action` is invalid, or when a non-`opened` event
+ * is missing a thread key.
+ */
+export declare function postThread(opts: PostThreadOptions): Promise<ThreadChannelEvent>;
+/**
+ * Rename a thread. Records a `kind:"thread", action:"rename"` event so
+ * subsequent reducers can flatten alias chains.
+ */
+export declare function renameThread(opts: RenameThreadOptions): Promise<ThreadChannelEvent>;
+//# sourceMappingURL=post-thread.d.ts.map

package/dist/channel/api/post-thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-thread.d.ts","sourceRoot":"","sources":["../../../src/channel/api/post-thread.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,6BAA6B,CAAC;AAOrC,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAYzE;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAuC7B;AAWD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CAyD7B"}

package/dist/channel/api/post-thread.js

@@ -0,0 +1,106 @@
+import { appendEvent, } from "../internal/store/events.js";
+import { normalizeThreadKey } from "../internal/store/schema.js";
+import { buildThreadAliasResolver, } from "../internal/store/thread-state.js";
+import { readForumChannelEvents } from "./assert.js";
+import { resolveChannelRef } from "./resolve.js";
+const VALID_ACTIONS = new Set([
+    "opened",
+    "comment",
+    "status",
+    "labels",
+    "assignees",
+    "summary",
+    "processed",
+]);
+/**
+ * Append a structured thread event. Throws when the channel is not of
+ * `forum` type, when `action` is invalid, or when a non-`opened` event
+ * is missing a thread key.
+ */
+export async function postThread(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 } : {}),
+    });
+    if (!VALID_ACTIONS.has(opts.action)) {
+        throw new Error(`Invalid thread action '${opts.action}'. Must be one of: ${[...VALID_ACTIONS].join(", ")}`);
+    }
+    await readForumChannelEvents(opts.channel, ref.project, "post");
+    const thread = resolveThreadKey(opts.action, opts.thread);
+    const event = await appendEvent(opts.channel, {
+        kind: "thread",
+        by: opts.by,
+        action: opts.action,
+        thread,
+        ...(opts.title !== undefined ? { title: opts.title } : {}),
+        ...(opts.text !== undefined ? { text: opts.text } : {}),
+        ...(opts.description !== undefined
+            ? { description: opts.description }
+            : {}),
+        ...(opts.status !== undefined ? { status: opts.status } : {}),
+        ...(opts.labels !== undefined ? { labels: opts.labels } : {}),
+        ...(opts.assignees !== undefined ? { assignees: opts.assignees } : {}),
+        ...(opts.summary !== undefined ? { summary: opts.summary } : {}),
+        ...(opts.context !== undefined && opts.context.length > 0
+            ? { context: opts.context }
+            : {}),
+        ...(opts.origin !== undefined ? { origin: opts.origin } : {}),
+        ...(opts.meta !== undefined ? { meta: opts.meta } : {}),
+    }, ref.project);
+    return event;
+}
+function resolveThreadKey(action, value) {
+    if (value)
+        return normalizeThreadKey(value);
+    if (action === "opened")
+        return `thread-${Date.now().toString(36)}`;
+    throw new Error("--thread is required unless action is 'opened'");
+}
+/**
+ * Rename a thread. Records a `kind:"thread", action:"rename"` event so
+ * subsequent reducers can flatten alias chains.
+ */
+export async function renameThread(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 events = await readForumChannelEvents(opts.channel, ref.project, "thread rename");
+    const oldKey = normalizeThreadKey(opts.thread);
+    const newKey = normalizeThreadKey(opts.newThread);
+    if (oldKey === newKey) {
+        throw new Error("Old and new thread keys are identical");
+    }
+    // Reject renames that would silently merge two existing threads.
+    const resolver = buildThreadAliasResolver(events);
+    const oldCurrent = resolver.resolve(oldKey);
+    const currentTarget = resolver.resolve(newKey);
+    const knownKeys = new Set();
+    for (const ev of events) {
+        if (ev.kind === "thread" &&
+            typeof ev.thread === "string") {
+            knownKeys.add(resolver.resolve(ev.thread));
+        }
+    }
+    if (!knownKeys.has(oldCurrent)) {
+        throw new Error(`Thread '${oldKey}' not found in channel '${opts.channel}'.`);
+    }
+    if (knownKeys.has(currentTarget) && currentTarget !== oldCurrent) {
+        throw new Error(`Thread '${newKey}' already exists in channel '${opts.channel}'. Refusing to merge two timelines.`);
+    }
+    const event = await appendEvent(opts.channel, {
+        kind: "thread",
+        by: opts.by,
+        action: "rename",
+        thread: oldKey,
+        newThread: newKey,
+        ...(opts.origin !== undefined ? { origin: opts.origin } : {}),
+        ...(opts.meta !== undefined ? { meta: opts.meta } : {}),
+    }, ref.project);
+    return event;
+}
+//# sourceMappingURL=post-thread.js.map

package/dist/channel/api/post-thread.js.map

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

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

@@ -0,0 +1,17 @@
+import { type ChannelEvent, type ContextChannelEvent, type ReadChannelEventsPagination, type ThreadChannelEvent } from "../internal/store/events.js";
+import { type ThreadState } from "../internal/store/thread-state.js";
+import type { ChannelMetadata } from "../internal/store/schema.js";
+import type { ChannelAddressOptions } from "./types.js";
+/**
+ * Cursor pagination options. Omitting all of them returns every event,
+ * preserving the read-all default for existing callers.
+ */
+export interface ReadChannelEventsOptions extends ChannelAddressOptions, ReadChannelEventsPagination {
+}
+export declare function readChannelEvents(opts: ReadChannelEventsOptions): Promise<ChannelEvent[]>;
+export declare function readChannelMetadata(opts: ChannelAddressOptions): Promise<ChannelMetadata>;
+export declare function listForumThreads(opts: ChannelAddressOptions): Promise<ThreadState[]>;
+export declare function showThread(opts: ChannelAddressOptions & {
+    thread: string;
+}): Promise<(ThreadChannelEvent | ContextChannelEvent)[]>;
+//# sourceMappingURL=read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/channel/api/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,EACxB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,wBACf,SAAQ,qBAAqB,EAC3B,2BAA2B;CAAG;AAElC,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,YAAY,EAAE,CAAC,CAYzB;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAG1B;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,WAAW,EAAE,CAAC,CAaxB;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,qBAAqB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAC/C,OAAO,CAAC,CAAC,kBAAkB,GAAG,mBAAmB,CAAC,EAAE,CAAC,CAavD"}

package/dist/channel/api/read.js

@@ -0,0 +1,44 @@
+import { readChannelEvents as readEventsInternal, } from "../internal/store/events.js";
+import { reduceChannelMetadata } from "../internal/store/channel-metadata.js";
+import { collectThreadTimeline, reduceThreads, } from "../internal/store/thread-state.js";
+import { normalizeThreadKey } from "../internal/store/schema.js";
+import { readForumChannelEvents } from "./assert.js";
+import { resolveChannelRef } from "./resolve.js";
+export async function readChannelEvents(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 readEventsInternal(opts.channel, ref.project, {
+        ...(opts.afterSeq !== undefined ? { afterSeq: opts.afterSeq } : {}),
+        ...(opts.beforeSeq !== undefined ? { beforeSeq: opts.beforeSeq } : {}),
+        ...(opts.limit !== undefined ? { limit: opts.limit } : {}),
+    });
+}
+export async function readChannelMetadata(opts) {
+    const events = await readChannelEvents(opts);
+    return reduceChannelMetadata(events);
+}
+export async function listForumThreads(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 events = await readForumChannelEvents(opts.channel, ref.project, "forum");
+    return reduceThreads(events);
+}
+export async function showThread(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 events = await readForumChannelEvents(opts.channel, ref.project, "thread");
+    return collectThreadTimeline(events, normalizeThreadKey(opts.thread));
+}
+//# sourceMappingURL=read.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/channel/api/read.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,IAAI,kBAAkB,GAKxC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EACL,qBAAqB,EACrB,aAAa,GAEd,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAWjD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAA8B;IAE9B,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,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;QACnD,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,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,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAA2B;IAE3B,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAA2B;IAE3B,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,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC,IAAI,CAAC,OAAO,EACZ,GAAG,CAAC,OAAO,EACX,OAAO,CACR,CAAC;IACF,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAgD;IAEhD,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,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC,IAAI,CAAC,OAAO,EACZ,GAAG,CAAC,OAAO,EACX,QAAQ,CACT,CAAC;IACF,OAAO,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AACxE,CAAC"}

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

@@ -0,0 +1,21 @@
+import type { ChannelRef, ChannelScope } from "../internal/store/schema.js";
+export interface ResolveChannelRefOptions {
+    channel: string;
+    scope?: ChannelScope;
+    /** Storage project bucket key. Wins when set. */
+    projectKey?: string;
+    /** cwd used to derive the project bucket when scope is "project". */
+    cwd?: string;
+    /**
+     * If true, do not require the channel to exist on disk. Used for the
+     * create path. Defaults to false (existence required).
+     */
+    forCreate?: boolean;
+}
+/**
+ * Resolve a `ChannelRef` honoring `--scope`, an explicit `projectKey`,
+ * or cwd-derived defaults. Mirrors the CLI's scope-resolution rules so
+ * downstream consumers behave the same way.
+ */
+export declare function resolveChannelRef(opts: ResolveChannelRefOptions): ChannelRef;
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/channel/api/resolve.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACb,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,wBAAwB,GAAG,UAAU,CAoB5E"}

package/dist/channel/api/resolve.js

@@ -0,0 +1,28 @@
+import { channelDir, resolveChannelProjectForCreate, resolveExistingChannelRef, } from "../internal/store/paths.js";
+/**
+ * Resolve a `ChannelRef` honoring `--scope`, an explicit `projectKey`,
+ * or cwd-derived defaults. Mirrors the CLI's scope-resolution rules so
+ * downstream consumers behave the same way.
+ */
+export function resolveChannelRef(opts) {
+    if (opts.projectKey) {
+        const project = opts.projectKey;
+        return {
+            name: opts.channel,
+            scope: opts.scope ?? "project",
+            project,
+            dir: channelDir(opts.channel, project),
+        };
+    }
+    if (opts.forCreate) {
+        return resolveChannelProjectForCreate(opts.channel, {
+            scope: opts.scope,
+            cwd: opts.cwd,
+        });
+    }
+    return resolveExistingChannelRef(opts.channel, {
+        scope: opts.scope,
+        cwd: opts.cwd,
+    });
+}
+//# sourceMappingURL=resolve.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/channel/api/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,8BAA8B,EAC9B,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AAoBpC;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA8B;IAC9D,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC;QAChC,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,OAAO;YAClB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,SAAS;YAC9B,OAAO;YACP,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC;SACvC,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,OAAO,8BAA8B,CAAC,IAAI,CAAC,OAAO,EAAE;YAClD,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAC;IACL,CAAC;IACD,OAAO,yBAAyB,CAAC,IAAI,CAAC,OAAO,EAAE;QAC7C,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,EAAE,IAAI,CAAC,GAAG;KACd,CAAC,CAAC;AACL,CAAC"}