octoflow-core 1.0.0

package/dist/runtime/bridge/task-runner.js

@@ -0,0 +1,238 @@
+import { isTerminalTaskState } from "../../adapters/data/task-store/index.js";
+import {
+  AgentTimeoutError,
+  BudgetExhaustedError,
+  QueueFullError
+} from "../../domain/errors/index.js";
+import { createMessage, textPart } from "../../utils/messages.js";
+import { toErrorInfo } from "../../utils/operation-info.js";
+import { nowIso } from "../../utils/time.js";
+import { createMetadata } from "../sessions/context-manager.js";
+import { executeQueuedTask } from "./task-runner-execution.js";
+import { applyHistoryStrategy } from "./task-executor.js";
+function isTaskSettled(state) {
+  return isTerminalTaskState(state) || state === "input-required" || state === "auth-required" || state === "approval-required" || state === "budget-exhausted";
+}
+function getTaskBackend(task) {
+  const metadata = task.metadata?.bridge;
+  if (!metadata || typeof metadata !== "object") return null;
+  const backend = metadata.backend;
+  return typeof backend === "string" ? backend : null;
+}
+function getPendingApprovalId(task) {
+  const metadata = task.metadata?.bridge;
+  if (!metadata || typeof metadata !== "object") return void 0;
+  const pendingApprovalId = metadata.pendingApprovalId;
+  return typeof pendingApprovalId === "string" && pendingApprovalId.length > 0 ? pendingApprovalId : void 0;
+}
+class TaskRunner {
+  abortControllers = /* @__PURE__ */ new Map();
+  onContextDrained;
+  pendingApprovals = /* @__PURE__ */ new Map();
+  tasksByContext = /* @__PURE__ */ new Map();
+  opts;
+  store;
+  getSessionFn;
+  deps;
+  emitEvent;
+  constructor(store, getSession, opts = {}) {
+    this.store = store;
+    this.getSessionFn = getSession;
+    this.opts = opts;
+    this.onContextDrained = opts.onContextDrained;
+    this.emitEvent = opts.emitEvent;
+    this.deps = {
+      store,
+      abortControllers: this.abortControllers,
+      circuitBreaker: opts.circuitBreaker,
+      costAccumulator: opts.costAccumulator,
+      onSessionResolved: opts.onSessionResolved,
+      switchBackend: opts.switchBackend,
+      mobilityEnabled: opts.mobilityEnabled,
+      maxSwitchesPerContext: opts.maxSwitchesPerContext,
+      allowCrossFamilySwitch: opts.allowCrossFamilySwitch,
+      emitEvent: opts.emitEvent
+    };
+  }
+  ensureCanEnqueue(context) {
+    const max = this.opts.maxQueueDepth ?? 0;
+    if (max > 0 && context.queueDepth >= max) {
+      throw new QueueFullError(context.id, context.queueDepth);
+    }
+    if (this.opts.costAccumulator) {
+      const budgetCheck = this.opts.costAccumulator.checkBudget(
+        context.id,
+        context.tenant
+      );
+      if (budgetCheck.status === "hard-limit") {
+        throw new BudgetExhaustedError(
+          context.id,
+          budgetCheck.info.spentUsd,
+          budgetCheck.info.limitUsd
+        );
+      }
+    }
+  }
+  assertCanEnqueue(context) {
+    this.ensureCanEnqueue(context);
+  }
+  enqueue(context, taskId, userMessage, params, backend) {
+    this.ensureCanEnqueue(context);
+    context.queueDepth++;
+    if (!this.tasksByContext.has(context.id)) {
+      this.tasksByContext.set(context.id, /* @__PURE__ */ new Set());
+    }
+    this.tasksByContext.get(context.id).add(taskId);
+    const run = async () => {
+      try {
+        await executeQueuedTask({
+          context,
+          taskId,
+          userMessage,
+          params,
+          backend,
+          store: this.store,
+          getSessionFn: this.getSessionFn,
+          opts: this.opts,
+          deps: this.deps,
+          emitEvent: this.emitEvent,
+          waitForApproval: (approvalId) => this.waitForApproval(approvalId)
+        });
+      } finally {
+        context.queueDepth--;
+        this.tasksByContext.get(context.id)?.delete(taskId);
+        if (context.queueDepth === 0 && context.pendingEviction) {
+          this.onContextDrained?.(context.id, context.tenant);
+        }
+      }
+    };
+    context.queue = context.queue.then(run).catch(async (err) => {
+      await params.onError?.(toErrorInfo("run", backend, err));
+    });
+  }
+  async cancel(taskId, task, context) {
+    const pendingApprovalId = getPendingApprovalId(task);
+    if (pendingApprovalId) {
+      this.resolveApproval(pendingApprovalId, false);
+    }
+    this.abortControllers.get(taskId)?.abort();
+    this.abortControllers.delete(taskId);
+    const backend = getTaskBackend(task);
+    const metadata = context && backend ? createMetadata(context, backend) : void 0;
+    await this.store.updateStatus({
+      taskId,
+      status: {
+        state: "canceled",
+        timestamp: nowIso(),
+        message: createMessage({
+          role: "agent",
+          contextId: task.contextId,
+          taskId,
+          parts: [textPart("Task canceled")],
+          metadata
+        })
+      },
+      final: true,
+      metadata
+    });
+    await this.emitEvent?.("task:canceled", {
+      taskId,
+      contextId: task.contextId
+    });
+  }
+  abort(taskId) {
+    this.abortControllers.get(taskId)?.abort();
+    this.abortControllers.delete(taskId);
+  }
+  abortAll() {
+    for (const [taskId, controller] of this.abortControllers) {
+      controller.abort();
+      this.abortControllers.delete(taskId);
+    }
+  }
+  resolveApproval(approvalId, approved) {
+    const pending = this.pendingApprovals.get(approvalId);
+    if (!pending) return;
+    if (pending.timer) clearTimeout(pending.timer);
+    this.pendingApprovals.delete(approvalId);
+    pending.resolve(approved);
+  }
+  waitForApproval(approvalId) {
+    return new Promise((resolve) => {
+      const timeoutMs = this.opts.approval?.approvalTimeoutMs;
+      let timer;
+      if (timeoutMs) {
+        timer = setTimeout(() => {
+          this.pendingApprovals.delete(approvalId);
+          resolve(false);
+        }, timeoutMs);
+      }
+      this.pendingApprovals.set(approvalId, { resolve, timer });
+    });
+  }
+  getTasksForContext(contextId) {
+    return this.tasksByContext.get(contextId) ?? /* @__PURE__ */ new Set();
+  }
+  abortContext(contextId) {
+    const tasks = this.tasksByContext.get(contextId);
+    if (!tasks) return;
+    for (const taskId of tasks) {
+      this.abort(taskId);
+    }
+  }
+  async waitForSettlement(taskId, timeoutMs) {
+    const current = await this.store.getTask(taskId);
+    if (!current || isTaskSettled(current.status.state)) return;
+    const subscription = await this.store.subscribe(taskId);
+    const drainUntilSettled = async () => {
+      for await (const event of subscription) {
+        if (event.kind === "task" && isTaskSettled(event.task.status.state)) {
+          return;
+        }
+        if (event.kind === "status-update" && isTaskSettled(event.event.status.state)) {
+          return;
+        }
+      }
+    };
+    if (timeoutMs == null) {
+      return drainUntilSettled();
+    }
+    const closeSubscription = () => {
+      const iterator = subscription[Symbol.asyncIterator]();
+      if (typeof iterator.return === "function") {
+        void iterator.return();
+      }
+    };
+    return new Promise((resolve, reject) => {
+      let settled = false;
+      const timer = setTimeout(() => {
+        if (settled) return;
+        settled = true;
+        closeSubscription();
+        this.abort(taskId);
+        reject(new AgentTimeoutError(timeoutMs));
+      }, timeoutMs);
+      drainUntilSettled().then(
+        () => {
+          if (settled) return;
+          settled = true;
+          clearTimeout(timer);
+          resolve();
+        },
+        (err) => {
+          if (settled) return;
+          settled = true;
+          clearTimeout(timer);
+          closeSubscription();
+          reject(err instanceof Error ? err : new Error(String(err)));
+        }
+      );
+    });
+  }
+}
+export {
+  TaskRunner,
+  applyHistoryStrategy,
+  isTaskSettled
+};
+//# sourceMappingURL=task-runner.js.map

package/dist/runtime/bridge/task-runner.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/task-runner.ts"],
+  "sourcesContent": ["import type { TaskStore } from '../../adapters/data/task-store/index.js';\nimport { isTerminalTaskState } from '../../adapters/data/task-store/index.js';\nimport type { BridgeSendMessageParams } from '../../domain/bridge-api.js';\nimport type { BackendName } from '../../domain/core-client.js';\nimport type { Message, Task, TaskState } from '../../domain/core-task.js';\nimport {\n  AgentTimeoutError,\n  BudgetExhaustedError,\n  QueueFullError,\n} from '../../domain/errors/index.js';\nimport { createMessage, textPart } from '../../utils/messages.js';\nimport { toErrorInfo } from '../../utils/operation-info.js';\nimport { nowIso } from '../../utils/time.js';\nimport type { ContextState, SessionLike } from '../sessions/context-manager.js';\nimport { createMetadata } from '../sessions/context-manager.js';\nimport { type TaskExecutorDeps } from './task-executor.js';\nimport { executeQueuedTask } from './task-runner-execution.js';\nimport type { TaskRunnerOptions } from './task-runner-types.js';\n\nexport { applyHistoryStrategy } from './task-executor.js';\nexport type {\n  ApprovalGateOptions,\n  TaskRunnerOptions,\n} from './task-runner-types.js';\n\nexport function isTaskSettled(state: TaskState): boolean {\n  return (\n    isTerminalTaskState(state) ||\n    state === 'input-required' ||\n    state === 'auth-required' ||\n    state === 'approval-required' ||\n    state === 'budget-exhausted'\n  );\n}\nfunction getTaskBackend(task: Task): BackendName | null {\n  const metadata = task.metadata?.bridge;\n  if (!metadata || typeof metadata !== 'object') return null;\n  const backend = (metadata as { backend?: unknown }).backend;\n  return typeof backend === 'string' ? (backend as BackendName) : null;\n}\n\nfunction getPendingApprovalId(task: Task): string | undefined {\n  const metadata = task.metadata?.bridge;\n  if (!metadata || typeof metadata !== 'object') return undefined;\n  const pendingApprovalId = (metadata as { pendingApprovalId?: unknown })\n    .pendingApprovalId;\n  return typeof pendingApprovalId === 'string' && pendingApprovalId.length > 0\n    ? pendingApprovalId\n    : undefined;\n}\n\nexport class TaskRunner {\n  private readonly abortControllers = new Map<string, AbortController>();\n  private readonly onContextDrained?: (\n    contextId: string,\n    tenant?: string\n  ) => void;\n  private readonly pendingApprovals = new Map<\n    string,\n    {\n      resolve: (approved: boolean) => void;\n      timer?: ReturnType<typeof setTimeout>;\n    }\n  >();\n  private readonly tasksByContext = new Map<string, Set<string>>();\n  private readonly opts: TaskRunnerOptions;\n  private readonly store: TaskStore;\n  private readonly getSessionFn: (\n    context: ContextState\n  ) => Promise<SessionLike>;\n  private readonly deps: TaskExecutorDeps;\n  private readonly emitEvent?: TaskRunnerOptions['emitEvent'];\n\n  constructor(\n    store: TaskStore,\n    getSession: (context: ContextState) => Promise<SessionLike>,\n    opts: TaskRunnerOptions = {}\n  ) {\n    this.store = store;\n    this.getSessionFn = getSession;\n    this.opts = opts;\n    this.onContextDrained = opts.onContextDrained;\n    this.emitEvent = opts.emitEvent;\n    this.deps = {\n      store,\n      abortControllers: this.abortControllers,\n      circuitBreaker: opts.circuitBreaker,\n      costAccumulator: opts.costAccumulator,\n      onSessionResolved: opts.onSessionResolved,\n      switchBackend: opts.switchBackend,\n      mobilityEnabled: opts.mobilityEnabled,\n      maxSwitchesPerContext: opts.maxSwitchesPerContext,\n      allowCrossFamilySwitch: opts.allowCrossFamilySwitch,\n      emitEvent: opts.emitEvent,\n    };\n  }\n\n  private ensureCanEnqueue(context: ContextState): void {\n    const max = this.opts.maxQueueDepth ?? 0;\n    if (max > 0 && context.queueDepth >= max) {\n      throw new QueueFullError(context.id, context.queueDepth);\n    }\n\n    if (this.opts.costAccumulator) {\n      const budgetCheck = this.opts.costAccumulator.checkBudget(\n        context.id,\n        context.tenant\n      );\n      if (budgetCheck.status === 'hard-limit') {\n        throw new BudgetExhaustedError(\n          context.id,\n          budgetCheck.info.spentUsd,\n          budgetCheck.info.limitUsd\n        );\n      }\n    }\n  }\n\n  assertCanEnqueue(context: ContextState): void {\n    this.ensureCanEnqueue(context);\n  }\n\n  enqueue(\n    context: ContextState,\n    taskId: string,\n    userMessage: Message,\n    params: BridgeSendMessageParams,\n    backend: BackendName\n  ): void {\n    this.ensureCanEnqueue(context);\n\n    context.queueDepth++;\n\n    if (!this.tasksByContext.has(context.id)) {\n      this.tasksByContext.set(context.id, new Set());\n    }\n    this.tasksByContext.get(context.id)!.add(taskId);\n\n    const run = async () => {\n      try {\n        await executeQueuedTask({\n          context,\n          taskId,\n          userMessage,\n          params,\n          backend,\n          store: this.store,\n          getSessionFn: this.getSessionFn,\n          opts: this.opts,\n          deps: this.deps,\n          emitEvent: this.emitEvent,\n          waitForApproval: (approvalId: string) =>\n            this.waitForApproval(approvalId),\n        });\n      } finally {\n        context.queueDepth--;\n        this.tasksByContext.get(context.id)?.delete(taskId);\n        if (context.queueDepth === 0 && context.pendingEviction) {\n          this.onContextDrained?.(context.id, context.tenant);\n        }\n      }\n    };\n\n    context.queue = context.queue.then(run).catch(async (err) => {\n      await params.onError?.(toErrorInfo('run', backend, err));\n    });\n  }\n\n  async cancel(\n    taskId: string,\n    task: Task,\n    context?: ContextState\n  ): Promise<void> {\n    const pendingApprovalId = getPendingApprovalId(task);\n    if (pendingApprovalId) {\n      this.resolveApproval(pendingApprovalId, false);\n    }\n\n    this.abortControllers.get(taskId)?.abort();\n    this.abortControllers.delete(taskId);\n\n    const backend = getTaskBackend(task);\n    const metadata =\n      context && backend ? createMetadata(context, backend) : undefined;\n\n    await this.store.updateStatus({\n      taskId,\n      status: {\n        state: 'canceled',\n        timestamp: nowIso(),\n        message: createMessage({\n          role: 'agent',\n          contextId: task.contextId,\n          taskId,\n          parts: [textPart('Task canceled')],\n          metadata,\n        }),\n      },\n      final: true,\n      metadata,\n    });\n    await this.emitEvent?.('task:canceled', {\n      taskId,\n      contextId: task.contextId,\n    });\n  }\n\n  abort(taskId: string): void {\n    this.abortControllers.get(taskId)?.abort();\n    this.abortControllers.delete(taskId);\n  }\n\n  abortAll(): void {\n    for (const [taskId, controller] of this.abortControllers) {\n      controller.abort();\n      this.abortControllers.delete(taskId);\n    }\n  }\n\n  resolveApproval(approvalId: string, approved: boolean): void {\n    const pending = this.pendingApprovals.get(approvalId);\n    if (!pending) return;\n    if (pending.timer) clearTimeout(pending.timer);\n    this.pendingApprovals.delete(approvalId);\n    pending.resolve(approved);\n  }\n\n  waitForApproval(approvalId: string): Promise<boolean> {\n    return new Promise<boolean>((resolve) => {\n      const timeoutMs = this.opts.approval?.approvalTimeoutMs;\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      if (timeoutMs) {\n        timer = setTimeout(() => {\n          this.pendingApprovals.delete(approvalId);\n          resolve(false);\n        }, timeoutMs);\n      }\n      this.pendingApprovals.set(approvalId, { resolve, timer });\n    });\n  }\n\n  getTasksForContext(contextId: string): Set<string> {\n    return this.tasksByContext.get(contextId) ?? new Set();\n  }\n\n  abortContext(contextId: string): void {\n    const tasks = this.tasksByContext.get(contextId);\n    if (!tasks) return;\n    for (const taskId of tasks) {\n      this.abort(taskId);\n    }\n  }\n\n  async waitForSettlement(taskId: string, timeoutMs?: number): Promise<void> {\n    const current = await this.store.getTask(taskId);\n    if (!current || isTaskSettled(current.status.state)) return;\n\n    const subscription = await this.store.subscribe(taskId);\n\n    const drainUntilSettled = async (): Promise<void> => {\n      for await (const event of subscription) {\n        if (event.kind === 'task' && isTaskSettled(event.task.status.state)) {\n          return;\n        }\n        if (\n          event.kind === 'status-update' &&\n          isTaskSettled(event.event.status.state)\n        ) {\n          return;\n        }\n      }\n    };\n\n    if (timeoutMs == null) {\n      return drainUntilSettled();\n    }\n\n    const closeSubscription = () => {\n      const iterator = subscription[Symbol.asyncIterator]();\n      if (typeof iterator.return === 'function') {\n        void iterator.return();\n      }\n    };\n\n    return new Promise<void>((resolve, reject) => {\n      let settled = false;\n\n      const timer = setTimeout(() => {\n        if (settled) return;\n        settled = true;\n        closeSubscription();\n        // Kill the underlying CLI process so it doesn't stay orphaned after\n        // the bridge stops waiting.\n        this.abort(taskId);\n        reject(new AgentTimeoutError(timeoutMs));\n      }, timeoutMs);\n\n      drainUntilSettled().then(\n        () => {\n          if (settled) return;\n          settled = true;\n          clearTimeout(timer);\n          resolve();\n        },\n        (err: unknown) => {\n          if (settled) return;\n          settled = true;\n          clearTimeout(timer);\n          closeSubscription();\n          reject(err instanceof Error ? err : new Error(String(err)));\n        }\n      );\n    });\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/runtime/bridge/topic-channel-resolve.d.ts

@@ -0,0 +1,26 @@
+import type { TopicChannelOptions, TopicDiagnostic } from './topic-types.js';
+export declare const MAX_REENTRANCY = 8;
+export declare const DEFAULT_MAX_PAYLOAD_BYTES = 65536;
+export declare const REPLAY_CEILING_EVENTS = 10000;
+export declare const REPLAY_CEILING_BYTES: number;
+export interface TopicResolvedOptions {
+    maxPayloadBytes: number;
+    rateLimit: {
+        publishesPerSec: number;
+        bytesPerSec: number;
+    } | null;
+    replay: false | {
+        maxEvents: number;
+        maxBytes: number;
+        maxAgeMs: number;
+    };
+    delivery: 'parallel' | 'serial-per-topic';
+    overflow: {
+        strategy: 'drop' | 'queue';
+        maxQueueSize: number;
+    };
+    onDiagnostic: ((event: TopicDiagnostic) => void) | null;
+}
+export declare function resolveTopicChannelOptions(opts?: TopicChannelOptions): TopicResolvedOptions;
+export declare function nextTopicEventId(): string;
+//# sourceMappingURL=topic-channel-resolve.d.ts.map

package/dist/runtime/bridge/topic-channel-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic-channel-resolve.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/topic-channel-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE7E,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAChD,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAC5C,eAAO,MAAM,oBAAoB,QAAmB,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnE,MAAM,EAAE,KAAK,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,QAAQ,EAAE,UAAU,GAAG,kBAAkB,CAAC;IAC1C,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,YAAY,EAAE,CAAC,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CACzD;AAED,wBAAgB,0BAA0B,CACxC,IAAI,CAAC,EAAE,mBAAmB,GACzB,oBAAoB,CA+BtB;AAGD,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/dist/runtime/bridge/topic-channel-resolve.js

@@ -0,0 +1,44 @@
+const MAX_REENTRANCY = 8;
+const DEFAULT_MAX_PAYLOAD_BYTES = 65536;
+const REPLAY_CEILING_EVENTS = 1e4;
+const REPLAY_CEILING_BYTES = 50 * 1024 * 1024;
+function resolveTopicChannelOptions(opts) {
+  const replay = opts?.replay === false || opts?.replay == null ? false : {
+    maxEvents: Math.min(
+      opts.replay.maxEvents ?? 100,
+      REPLAY_CEILING_EVENTS
+    ),
+    maxBytes: Math.min(
+      opts.replay.maxBytes ?? 1024 * 1024,
+      REPLAY_CEILING_BYTES
+    ),
+    maxAgeMs: opts.replay.maxAgeMs ?? 0
+  };
+  return {
+    maxPayloadBytes: opts?.maxPayloadBytes ?? DEFAULT_MAX_PAYLOAD_BYTES,
+    rateLimit: opts?.rateLimit ? {
+      publishesPerSec: opts.rateLimit.publishesPerSec ?? 0,
+      bytesPerSec: opts.rateLimit.bytesPerSec ?? 0
+    } : null,
+    replay,
+    delivery: opts?.delivery ?? "parallel",
+    overflow: {
+      strategy: opts?.overflow?.strategy ?? "drop",
+      maxQueueSize: opts?.overflow?.maxQueueSize ?? 1e3
+    },
+    onDiagnostic: opts?.onDiagnostic ?? null
+  };
+}
+let idCounter = 0;
+function nextTopicEventId() {
+  return `te_${Date.now().toString(36)}_${(idCounter++).toString(36)}`;
+}
+export {
+  DEFAULT_MAX_PAYLOAD_BYTES,
+  MAX_REENTRANCY,
+  REPLAY_CEILING_BYTES,
+  REPLAY_CEILING_EVENTS,
+  nextTopicEventId,
+  resolveTopicChannelOptions
+};
+//# sourceMappingURL=topic-channel-resolve.js.map

package/dist/runtime/bridge/topic-channel-resolve.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/topic-channel-resolve.ts"],
+  "sourcesContent": ["import type { TopicChannelOptions, TopicDiagnostic } from './topic-types.js';\n\nexport const MAX_REENTRANCY = 8;\nexport const DEFAULT_MAX_PAYLOAD_BYTES = 65_536;\nexport const REPLAY_CEILING_EVENTS = 10_000;\nexport const REPLAY_CEILING_BYTES = 50 * 1024 * 1024;\n\nexport interface TopicResolvedOptions {\n  maxPayloadBytes: number;\n  rateLimit: { publishesPerSec: number; bytesPerSec: number } | null;\n  replay: false | { maxEvents: number; maxBytes: number; maxAgeMs: number };\n  delivery: 'parallel' | 'serial-per-topic';\n  overflow: { strategy: 'drop' | 'queue'; maxQueueSize: number };\n  onDiagnostic: ((event: TopicDiagnostic) => void) | null;\n}\n\nexport function resolveTopicChannelOptions(\n  opts?: TopicChannelOptions\n): TopicResolvedOptions {\n  const replay =\n    opts?.replay === false || opts?.replay == null\n      ? false\n      : {\n          maxEvents: Math.min(\n            opts.replay.maxEvents ?? 100,\n            REPLAY_CEILING_EVENTS\n          ),\n          maxBytes: Math.min(\n            opts.replay.maxBytes ?? 1024 * 1024,\n            REPLAY_CEILING_BYTES\n          ),\n          maxAgeMs: opts.replay.maxAgeMs ?? 0,\n        };\n  return {\n    maxPayloadBytes: opts?.maxPayloadBytes ?? DEFAULT_MAX_PAYLOAD_BYTES,\n    rateLimit: opts?.rateLimit\n      ? {\n          publishesPerSec: opts.rateLimit.publishesPerSec ?? 0,\n          bytesPerSec: opts.rateLimit.bytesPerSec ?? 0,\n        }\n      : null,\n    replay,\n    delivery: opts?.delivery ?? 'parallel',\n    overflow: {\n      strategy: opts?.overflow?.strategy ?? 'drop',\n      maxQueueSize: opts?.overflow?.maxQueueSize ?? 1000,\n    },\n    onDiagnostic: opts?.onDiagnostic ?? null,\n  };\n}\n\nlet idCounter = 0;\nexport function nextTopicEventId(): string {\n  return `te_${Date.now().toString(36)}_${(idCounter++).toString(36)}`;\n}\n"],
+  "mappings": "AAEO,MAAM,iBAAiB;AACvB,MAAM,4BAA4B;AAClC,MAAM,wBAAwB;AAC9B,MAAM,uBAAuB,KAAK,OAAO;AAWzC,SAAS,2BACd,MACsB;AACtB,QAAM,SACJ,MAAM,WAAW,SAAS,MAAM,UAAU,OACtC,QACA;AAAA,IACE,WAAW,KAAK;AAAA,MACd,KAAK,OAAO,aAAa;AAAA,MACzB;AAAA,IACF;AAAA,IACA,UAAU,KAAK;AAAA,MACb,KAAK,OAAO,YAAY,OAAO;AAAA,MAC/B;AAAA,IACF;AAAA,IACA,UAAU,KAAK,OAAO,YAAY;AAAA,EACpC;AACN,SAAO;AAAA,IACL,iBAAiB,MAAM,mBAAmB;AAAA,IAC1C,WAAW,MAAM,YACb;AAAA,MACE,iBAAiB,KAAK,UAAU,mBAAmB;AAAA,MACnD,aAAa,KAAK,UAAU,eAAe;AAAA,IAC7C,IACA;AAAA,IACJ;AAAA,IACA,UAAU,MAAM,YAAY;AAAA,IAC5B,UAAU;AAAA,MACR,UAAU,MAAM,UAAU,YAAY;AAAA,MACtC,cAAc,MAAM,UAAU,gBAAgB;AAAA,IAChD;AAAA,IACA,cAAc,MAAM,gBAAgB;AAAA,EACtC;AACF;AAEA,IAAI,YAAY;AACT,SAAS,mBAA2B;AACzC,SAAO,MAAM,KAAK,IAAI,EAAE,SAAS,EAAE,CAAC,KAAK,aAAa,SAAS,EAAE,CAAC;AACpE;",
+  "names": []
+}

package/dist/runtime/bridge/topic-channel.d.ts

@@ -0,0 +1,40 @@
+import type { JsonValue, PublishAndWaitOptions, PublishResult, TopicChannelOptions, TopicEmitOptions, TopicEvent, TopicHandler, TopicSchema, TopicWaitForOptions } from './topic-types.js';
+export declare class TopicChannel {
+    private readonly handlers;
+    private readonly prefixHandlers;
+    private readonly replayBuffers;
+    private readonly schemas;
+    private readonly overflowQueue;
+    private readonly opts;
+    private readonly pendingWaiters;
+    private closed;
+    private reentrancyDepth;
+    private replayTotalBytes;
+    private publishCount;
+    private publishByteCount;
+    private rateLimitWindowStart;
+    constructor(options?: TopicChannelOptions);
+    registerSchema(topic: string, schema: TopicSchema): void;
+    unregisterSchema(topic: string): void;
+    emit(topic: string, payload: JsonValue, opts?: TopicEmitOptions): void;
+    publishAndWait(topic: string, payload: JsonValue, opts?: PublishAndWaitOptions): Promise<PublishResult>;
+    subscribe(topic: string, handler: TopicHandler): () => void;
+    subscribePrefix(prefix: string, handler: TopicHandler): () => void;
+    once(topic: string, handler: TopicHandler): () => void;
+    waitFor(topic: string, opts?: TopicWaitForOptions): Promise<TopicEvent>;
+    replay(topic: string, count?: number): TopicEvent[];
+    clear(): void;
+    subscriberCount(topic: string): number;
+    private buildEvent;
+    private validateTopic;
+    private validatePayload;
+    private checkRateLimit;
+    private deliverToHandlers;
+    private appendReplay;
+    private evictStaleReplay;
+    private validateSchema;
+    private emitDiagnostic;
+    private drainOverflowQueue;
+    private enqueueOverflow;
+}
+//# sourceMappingURL=topic-channel.d.ts.map

package/dist/runtime/bridge/topic-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic-channel.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/topic-channel.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,SAAS,EACT,qBAAqB,EACrB,aAAa,EACb,mBAAmB,EAEnB,gBAAgB,EAChB,UAAU,EACV,YAAY,EAEZ,WAAW,EACX,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAY1B,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqC;IACpE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmC;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAItB;IACR,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmC;IAClE,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,oBAAoB,CAAc;gBAE9B,OAAO,CAAC,EAAE,mBAAmB;IASzC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IAIxD,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIrC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAgBhE,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,EAClB,IAAI,CAAC,EAAE,qBAAqB,GAC3B,OAAO,CAAC,aAAa,CAAC;IAuBzB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAe3D,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAelE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAYtD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IA6CvE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE;IAQnD,KAAK,IAAI,IAAI;IAWb,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAItC,OAAO,CAAC,UAAU;IAkBlB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,cAAc;YA2BR,iBAAiB;IAuD/B,OAAO,CAAC,YAAY;IA4BpB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,eAAe;CAYxB"}