@oni.bot/core 0.6.3 → 1.0.0

package/dist/config/types.d.ts

@@ -0,0 +1,74 @@
+/** Model provider + model ID pair. */
+export interface ModelConfig {
+    provider: string;
+    model: string;
+}
+/** Named agent definition (data-driven, composable into swarm slots). */
+export interface AgentConfig {
+    /** Override model for this agent */
+    model?: ModelConfig;
+    /** Tool names this agent can use (empty = all) */
+    tools?: string[];
+    /** Maximum turns for this agent's loop */
+    maxSteps?: number;
+    /** System prompt override or extension */
+    prompt?: string;
+    /** Per-agent permission overrides */
+    permissions?: PermissionRuleset;
+}
+/** Permission rules in config format (tool → action or tool → pattern map). */
+export type PermissionRuleset = Record<string, "allow" | "deny" | "ask" | Record<string, "allow" | "deny" | "ask">>;
+/** Compaction behavior config. */
+export interface CompactionConfig {
+    /** Enable auto-compaction on context overflow (default: true) */
+    auto?: boolean;
+    /** Usage fraction threshold (default: 0.68) */
+    threshold?: number;
+    /** Additional tool names whose output survives pruning */
+    protectedTools?: string[];
+}
+/** Swarm default settings. */
+export interface SwarmConfig {
+    /** Default topology when auto-select isn't used */
+    defaultTopology?: string;
+    /** Max concurrent agents in pool/fan-out topologies */
+    maxConcurrency?: number;
+    /** Per-agent timeout in ms */
+    agentTimeout?: number;
+    /** Default pool size */
+    poolSize?: number;
+}
+/** LSP server configuration. */
+export interface LSPServerConfig {
+    command: string;
+    args?: string[];
+    /** File extensions this server handles */
+    extensions?: string[];
+}
+/** Root configuration object — loaded from JSONC files. */
+export interface ONIConfig {
+    /** Default model for all agents */
+    model?: ModelConfig;
+    /** Named agent definitions */
+    agents?: Record<string, AgentConfig>;
+    /** Permission rules */
+    permissions?: PermissionRuleset;
+    /** Compaction settings */
+    compaction?: CompactionConfig;
+    /** Swarm defaults */
+    swarm?: SwarmConfig;
+    /** LSP server config. Set to false to disable all LSP. */
+    lsp?: Record<string, LSPServerConfig> | false;
+    /** Plugin paths (npm packages or local file paths) */
+    plugins?: string[];
+}
+/** Options for loadConfig(). */
+export interface LoadConfigOptions {
+    /** Override global config directory (default: ~/.oni) */
+    globalDir?: string;
+    /** Project directory to look for config files (default: process.cwd()) */
+    projectDir?: string;
+    /** Inline config to merge last (highest priority) */
+    inline?: Partial<ONIConfig>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAIA,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,yEAAyE;AACzE,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC;AAED,+EAA+E;AAC/E,MAAM,MAAM,iBAAiB,GAAG,MAAM,CACpC,MAAM,EACN,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,CACpE,CAAC;AAEF,kCAAkC;AAClC,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,8BAA8B;AAC9B,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,2DAA2D;AAC3D,MAAM,WAAW,SAAS;IACxB,mCAAmC;IACnC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,uBAAuB;IACvB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,0BAA0B;IAC1B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,qBAAqB;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,KAAK,CAAC;IAC9C,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,gCAAgC;AAChC,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CAC7B"}

package/dist/config/types.js

@@ -0,0 +1,5 @@
+// ============================================================
+// @oni.bot/core/config — Types
+// ============================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+BAA+B;AAC/B,+DAA+D"}

package/dist/coordination/pubsub.d.ts

@@ -13,6 +13,10 @@ export interface TopicMessage {
 export declare class PubSub {
     private subscribers;
     private buffer;
+    private maxBufferSize;
+    constructor(opts?: {
+        maxBufferSize?: number;
+    });
     /** Publish a message to a topic, notifying all matching subscribers. */
     publish(from: string, topic: string, data: unknown): void;
     /**

package/dist/coordination/pubsub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pubsub.d.ts","sourceRoot":"","sources":["../../src/coordination/pubsub.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,WAAW,CAAuD;IAC1E,OAAO,CAAC,MAAM,CAAsB;IAEpC,wEAAwE;IACxE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAUzD;;;OAGG;IACH,SAAS,CACP,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,GACnC,MAAM,IAAI;IASb,qEAAqE;IACrE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE;IAI5C,yDAAyD;IACzD,KAAK,IAAI,YAAY,EAAE;CAKxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAiBpE"}
+{"version":3,"file":"pubsub.d.ts","sourceRoot":"","sources":["../../src/coordination/pubsub.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,WAAW,CAAuD;IAC1E,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,aAAa,CAAqB;gBAE9B,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE;IAI7C,wEAAwE;IACxE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAczD;;;OAGG;IACH,SAAS,CACP,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,GACnC,MAAM,IAAI;IASb,qEAAqE;IACrE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE;IAI5C,yDAAyD;IACzD,KAAK,IAAI,YAAY,EAAE;CAKxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAiBpE"}

package/dist/coordination/pubsub.js

@@ -7,10 +7,18 @@
 export class PubSub {
     subscribers = new Map();
     buffer = [];
+    maxBufferSize;
+    constructor(opts) {
+        this.maxBufferSize = opts?.maxBufferSize;
+    }
     /** Publish a message to a topic, notifying all matching subscribers. */
     publish(from, topic, data) {
         const msg = { topic, data, from, timestamp: Date.now() };
         this.buffer.push(msg);
+        // Enforce buffer bounds by dropping oldest
+        if (this.maxBufferSize != null && this.buffer.length > this.maxBufferSize) {
+            this.buffer = this.buffer.slice(this.buffer.length - this.maxBufferSize);
+        }
         for (const [pattern, handlers] of this.subscribers) {
             if (topicMatches(pattern, topic)) {
                 for (const handler of handlers)

package/dist/coordination/pubsub.js.map

@@ -1 +1 @@
-{"version":3,"file":"pubsub.js","sourceRoot":"","sources":["../../src/coordination/pubsub.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,OAAO,MAAM;IACT,WAAW,GAAG,IAAI,GAAG,EAA4C,CAAC;IAClE,MAAM,GAAmB,EAAE,CAAC;IAEpC,wEAAwE;IACxE,OAAO,CAAC,IAAY,EAAE,KAAa,EAAE,IAAa;QAChD,MAAM,GAAG,GAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACvE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnD,IAAI,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;gBACjC,KAAK,MAAM,OAAO,IAAI,QAAQ;oBAAE,OAAO,CAAC,GAAG,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,SAAS,CACP,OAAe,EACf,OAAoC;QAEpC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC;YAChC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACjD,CAAC,CAAC;IACJ,CAAC;IAED,qEAAqE;IACrE,WAAW,CAAC,OAAe;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,yDAAyD;IACzD,KAAK;QACH,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,KAAa;IACzD,IAAI,OAAO,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAEjC,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAChC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAClB,IAAI,CAAC,KAAK,EAAE,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,MAAM,CAAC;YACxD,SAAS;QACX,CAAC;QACD,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IACpC,CAAC;IAED,OAAO,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,MAAM,CAAC;AACjC,CAAC"}
+{"version":3,"file":"pubsub.js","sourceRoot":"","sources":["../../src/coordination/pubsub.ts"],"names":[],"mappings":"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"}

package/dist/coordination/request-reply.d.ts

@@ -22,7 +22,9 @@ export declare class RequestReplyBroker {
      * Returns the request id, a promise that resolves with the reply,
      * and a message object suitable for routing through the graph.
      */
-    request(from: string, to: string, payload: unknown): {
+    request(from: string, to: string, payload: unknown, opts?: {
+        timeoutMs?: number;
+    }): {
         requestId: string;
         promise: Promise<unknown>;
         message: any;

package/dist/coordination/request-reply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-reply.d.ts","sourceRoot":"","sources":["../../src/coordination/request-reply.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,SAAS,CAA+C;IAEhE;;;;OAIG;IACH,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,GACf;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAAC,OAAO,EAAE,GAAG,CAAA;KAAE;IA4BjE;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,GAAG;IAuB/C,mEAAmE;IACnE,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAOpC,kEAAkE;IAClE,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE;CAK9C"}
+{"version":3,"file":"request-reply.d.ts","sourceRoot":"","sources":["../../src/coordination/request-reply.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,SAAS,CAA+C;IAEhE;;;;OAIG;IACH,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5B;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAAC,OAAO,EAAE,GAAG,CAAA;KAAE;IAsCjE;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,GAAG;IAuB/C,mEAAmE;IACnE,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAOpC,kEAAkE;IAClE,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE;CAK9C"}

package/dist/coordination/request-reply.js

@@ -13,7 +13,7 @@ export class RequestReplyBroker {
      * Returns the request id, a promise that resolves with the reply,
      * and a message object suitable for routing through the graph.
      */
-    request(from, to, payload) {
+    request(from, to, payload, opts) {
         const id = `req_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
         const req = {
             id,
@@ -24,8 +24,17 @@ export class RequestReplyBroker {
             resolved: false,
         };
         this.pending.set(id, req);
-        const promise = new Promise((resolve) => {
+        const promise = new Promise((resolve, reject) => {
             this.resolvers.set(id, resolve);
+            if (opts?.timeoutMs != null) {
+                setTimeout(() => {
+                    if (!req.resolved) {
+                        req.resolved = true;
+                        this.resolvers.delete(id);
+                        reject(new Error(`Request ${id} timed out after ${opts.timeoutMs}ms`));
+                    }
+                }, opts.timeoutMs);
+            }
         });
         const message = {
             id,

package/dist/coordination/request-reply.js.map

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

package/dist/dlq.d.ts

@@ -0,0 +1,17 @@
+export interface DeadLetter {
+    id: string;
+    node: string;
+    input: Record<string, unknown>;
+    error: Error;
+    attempts: number;
+    timestamp: number;
+}
+export declare class DeadLetterQueue {
+    private letters;
+    record(threadId: string, node: string, input: Record<string, unknown>, error: Error, attempts: number): DeadLetter;
+    getAll(threadId: string): DeadLetter[];
+    remove(threadId: string, dlId: string): boolean;
+    clear(threadId: string): void;
+    size(): number;
+}
+//# sourceMappingURL=dlq.d.ts.map

package/dist/dlq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dlq.d.ts","sourceRoot":"","sources":["../src/dlq.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAmC;IAElD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU;IAWlH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE;IAItC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAS/C,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI7B,IAAI,IAAI,MAAM;CAKf"}

package/dist/dlq.js

@@ -0,0 +1,41 @@
+// ============================================================
+// @oni.bot/core — Dead Letter Queue
+// ============================================================
+let _nextId = 1;
+export class DeadLetterQueue {
+    letters = new Map();
+    record(threadId, node, input, error, attempts) {
+        const dl = {
+            id: `dlq-${_nextId++}`,
+            node, input, error, attempts,
+            timestamp: Date.now(),
+        };
+        if (!this.letters.has(threadId))
+            this.letters.set(threadId, []);
+        this.letters.get(threadId).push(dl);
+        return dl;
+    }
+    getAll(threadId) {
+        return this.letters.get(threadId) ?? [];
+    }
+    remove(threadId, dlId) {
+        const list = this.letters.get(threadId);
+        if (!list)
+            return false;
+        const idx = list.findIndex((dl) => dl.id === dlId);
+        if (idx === -1)
+            return false;
+        list.splice(idx, 1);
+        return true;
+    }
+    clear(threadId) {
+        this.letters.delete(threadId);
+    }
+    size() {
+        let total = 0;
+        for (const list of this.letters.values())
+            total += list.length;
+        return total;
+    }
+}
+//# sourceMappingURL=dlq.js.map

package/dist/dlq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dlq.js","sourceRoot":"","sources":["../src/dlq.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,oCAAoC;AACpC,+DAA+D;AAE/D,IAAI,OAAO,GAAG,CAAC,CAAC;AAWhB,MAAM,OAAO,eAAe;IAClB,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAElD,MAAM,CAAC,QAAgB,EAAE,IAAY,EAAE,KAA8B,EAAE,KAAY,EAAE,QAAgB;QACnG,MAAM,EAAE,GAAe;YACrB,EAAE,EAAE,OAAO,OAAO,EAAE,EAAE;YACtB,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ;YAC5B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,CAAC,QAAgB;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,CAAC,QAAgB,EAAE,IAAY;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;QACnD,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,QAAgB;QACpB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,IAAI;QACF,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YAAE,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC;QAC/D,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/errors.d.ts

@@ -1,5 +1,19 @@
+export type ErrorCategory = "GRAPH" | "NODE" | "EDGE" | "CHECKPOINT" | "STREAM" | "HITL" | "SWARM" | "MODEL" | "STORE" | "CONFIG";
+export interface ONIErrorOptions {
+    code: string;
+    category: ErrorCategory;
+    recoverable: boolean;
+    suggestion?: string;
+    context?: Record<string, unknown>;
+}
 export declare class ONIError extends Error {
-    constructor(message: string);
+    readonly code: string;
+    readonly category: ErrorCategory;
+    readonly recoverable: boolean;
+    readonly suggestion: string;
+    readonly context: Record<string, unknown>;
+    constructor(message: string, opts?: ONIErrorOptions);
+    toJSON(): Record<string, unknown>;
 }
 export declare class InvalidSkeletonError extends ONIError {
     constructor(msg: string);
@@ -14,7 +28,34 @@ export declare class EdgeConflictError extends ONIError {
     constructor(from: string, to: string);
 }
 export declare class NodeExecutionError extends ONIError {
-    constructor(node: string, cause: Error);
+    constructor(node: string, cause: Error, extraContext?: Record<string, unknown>);
+}
+export declare class NodeTimeoutError extends ONIError {
+    constructor(node: string, timeoutMs: number);
+}
+export declare class CircuitBreakerOpenError extends ONIError {
+    constructor(node: string, resetAfterMs: number);
+}
+export declare class SwarmDeadlockError extends ONIError {
+    constructor(agents: string[]);
+}
+export declare class ModelAPIError extends ONIError {
+    constructor(provider: string, status: number, body: string, opts?: {
+        suggestion?: string;
+        messageBody?: string;
+    });
+}
+export declare class ModelRateLimitError extends ONIError {
+    constructor(provider: string, retryAfterMs?: number);
+}
+export declare class ModelContextLengthError extends ONIError {
+    constructor(provider: string, maxTokens: number);
+}
+export declare class CheckpointCorruptError extends ONIError {
+    constructor(threadId: string, detail: string);
+}
+export declare class StoreKeyNotFoundError extends ONIError {
+    constructor(namespace: string[], key: string);
 }
 /** Thrown at interrupt checkpoints — caught externally to pause/resume */
 export declare class ONIInterrupt {

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAIA,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAC5B;AACD,qBAAa,oBAAqB,SAAQ,QAAQ;gBACpC,GAAG,EAAE,MAAM;CACxB;AACD,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,KAAK,EAAE,MAAM;CAI1B;AACD,qBAAa,iBAAkB,SAAQ,QAAQ;gBACjC,IAAI,EAAE,MAAM;CACzB;AACD,qBAAa,iBAAkB,SAAQ,QAAQ;gBACjC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;CACrC;AACD,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAKvC;AAED,0EAA0E;AAC1E,qBAAa,YAAY;aAGL,IAAI,EAAI,MAAM;aACd,MAAM,EAAE,QAAQ,GAAG,OAAO;aAC1B,KAAK,EAAG,OAAO;IAJjC,QAAQ,CAAC,cAAc,QAAQ;gBAEb,IAAI,EAAI,MAAM,EACd,MAAM,EAAE,QAAQ,GAAG,OAAO,EAC1B,KAAK,EAAG,OAAO;CAElC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,MAAM,GACN,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,MAAM,GACN,OAAO,GACP,OAAO,GACP,OAAO,GACP,QAAQ,CAAC;AAEb,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAID,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE9B,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe;IAUnD,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYlC;AAID,qBAAa,oBAAqB,SAAQ,QAAQ;gBACpC,GAAG,EAAE,MAAM;CAUxB;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,KAAK,EAAE,MAAM;CAa1B;AAED,qBAAa,iBAAkB,SAAQ,QAAQ;gBACjC,IAAI,EAAE,MAAM;CAUzB;AAED,qBAAa,iBAAkB,SAAQ,QAAQ;gBACjC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;CAUrC;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAW/E;AAID,qBAAa,gBAAiB,SAAQ,QAAQ;gBAChC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAU5C;AAED,qBAAa,uBAAwB,SAAQ,QAAQ;gBACvC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;CAa/C;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,MAAM,EAAE,MAAM,EAAE;CAa7B;AAED,qBAAa,aAAc,SAAQ,QAAQ;gBAEvC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QACL,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;CAcJ;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CAapD;AAED,qBAAa,uBAAwB,SAAQ,QAAQ;gBACvC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAahD;AAED,qBAAa,sBAAuB,SAAQ,QAAQ;gBACtC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAU7C;AAED,qBAAa,qBAAsB,SAAQ,QAAQ;gBACrC,SAAS,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM;CAW7C;AAID,0EAA0E;AAC1E,qBAAa,YAAY;aAGL,IAAI,EAAI,MAAM;aACd,MAAM,EAAE,QAAQ,GAAG,OAAO;aAC1B,KAAK,EAAG,OAAO;IAJjC,QAAQ,CAAC,cAAc,QAAQ;gBAEb,IAAI,EAAI,MAAM,EACd,MAAM,EAAE,QAAQ,GAAG,OAAO,EAC1B,KAAK,EAAG,OAAO;CAElC"}

package/dist/errors.js

@@ -1,31 +1,202 @@
 // ============================================================
-// @oni.bot/core — Error Types v2
+// @oni.bot/core — Structured Error Types
 // ============================================================
+// ── Base class ────────────────────────────────────────────────
 export class ONIError extends Error {
-    constructor(message) { super(message); this.name = "ONIError"; }
+    code;
+    category;
+    recoverable;
+    suggestion;
+    context;
+    constructor(message, opts) {
+        super(message);
+        this.name = "ONIError";
+        this.code = opts?.code ?? "ONI_UNKNOWN";
+        this.category = opts?.category ?? "GRAPH";
+        this.recoverable = opts?.recoverable ?? false;
+        this.suggestion = opts?.suggestion ?? "";
+        this.context = opts?.context ?? {};
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            category: this.category,
+            message: this.message,
+            recoverable: this.recoverable,
+            suggestion: this.suggestion,
+            context: this.context,
+            stack: this.stack,
+        };
+    }
 }
+// ── Existing errors (backward-compatible constructors) ────────
 export class InvalidSkeletonError extends ONIError {
-    constructor(msg) { super(msg); this.name = "InvalidSkeletonError"; }
+    constructor(msg) {
+        super(msg, {
+            code: "ONI_GRAPH_INVALID",
+            category: "GRAPH",
+            recoverable: false,
+            suggestion: "Check your graph structure for missing nodes or invalid edges.",
+            context: {},
+        });
+        this.name = "InvalidSkeletonError";
+    }
 }
 export class RecursionLimitError extends ONIError {
     constructor(limit) {
-        super(`Recursion limit of ${limit} reached. Possible infinite loop in agent skeleton.`);
+        super(`Recursion limit of ${limit} reached. Possible infinite loop in agent skeleton.`, {
+            code: "ONI_RECURSION_LIMIT",
+            category: "GRAPH",
+            recoverable: false,
+            suggestion: "Increase recursionLimit in config or check for cycles in your graph.",
+            context: { limit },
+        });
         this.name = "RecursionLimitError";
     }
 }
 export class NodeNotFoundError extends ONIError {
-    constructor(name) { super(`Node "${name}" not found in skeleton.`); this.name = "NodeNotFoundError"; }
+    constructor(name) {
+        super(`Node "${name}" not found in skeleton.`, {
+            code: "ONI_NODE_MISSING",
+            category: "NODE",
+            recoverable: false,
+            suggestion: `Ensure node "${name}" has been added to the graph before referencing it.`,
+            context: { node: name },
+        });
+        this.name = "NodeNotFoundError";
+    }
 }
 export class EdgeConflictError extends ONIError {
-    constructor(from, to) { super(`Edge conflict: "${from}" → "${to}" already exists.`); this.name = "EdgeConflictError"; }
+    constructor(from, to) {
+        super(`Edge conflict: "${from}" → "${to}" already exists.`, {
+            code: "ONI_EDGE_CONFLICT",
+            category: "EDGE",
+            recoverable: false,
+            suggestion: "Remove the duplicate edge or use a conditional edge instead.",
+            context: { from, to },
+        });
+        this.name = "EdgeConflictError";
+    }
 }
 export class NodeExecutionError extends ONIError {
-    constructor(node, cause) {
-        super(`Node "${node}" failed after all retry attempts: ${cause.message}`);
+    constructor(node, cause, extraContext) {
+        super(`Node "${node}" failed: ${cause.message}`, {
+            code: "ONI_NODE_EXEC",
+            category: "NODE",
+            recoverable: false,
+            suggestion: "Inspect the cause error and consider adding a retry policy.",
+            context: { node, ...extraContext },
+        });
         this.name = "NodeExecutionError";
         this.cause = cause;
     }
 }
+// ── New errors ────────────────────────────────────────────────
+export class NodeTimeoutError extends ONIError {
+    constructor(node, timeoutMs) {
+        super(`Node "${node}" timed out after ${timeoutMs}ms.`, {
+            code: "ONI_NODE_TIMEOUT",
+            category: "NODE",
+            recoverable: true,
+            suggestion: "Increase the node timeout or optimize the node's execution time.",
+            context: { node, timeoutMs },
+        });
+        this.name = "NodeTimeoutError";
+    }
+}
+export class CircuitBreakerOpenError extends ONIError {
+    constructor(node, resetAfterMs) {
+        super(`Circuit breaker for node "${node}" is open. Resets after ${resetAfterMs}ms.`, {
+            code: "ONI_NODE_CIRCUIT_OPEN",
+            category: "NODE",
+            recoverable: true,
+            suggestion: "Wait for the circuit breaker to reset or fix the underlying failures.",
+            context: { node, resetAfterMs },
+        });
+        this.name = "CircuitBreakerOpenError";
+    }
+}
+export class SwarmDeadlockError extends ONIError {
+    constructor(agents) {
+        super(`Swarm deadlock detected among agents: ${agents.join(", ")}.`, {
+            code: "ONI_SWARM_DEADLOCK",
+            category: "SWARM",
+            recoverable: false,
+            suggestion: "Review agent handoff logic to break the circular dependency.",
+            context: { agents },
+        });
+        this.name = "SwarmDeadlockError";
+    }
+}
+export class ModelAPIError extends ONIError {
+    constructor(provider, status, body, opts) {
+        const recoverable = status >= 500;
+        super(`${provider} API error ${status}: ${opts?.messageBody ?? body}`, {
+            code: "ONI_MODEL_API",
+            category: "MODEL",
+            recoverable,
+            suggestion: opts?.suggestion ?? (recoverable
+                ? "Retry the request — the provider may be experiencing transient issues."
+                : "Check your request parameters, API key, and account status."),
+            context: { provider, status, body },
+        });
+        this.name = "ModelAPIError";
+    }
+}
+export class ModelRateLimitError extends ONIError {
+    constructor(provider, retryAfterMs) {
+        const retryMsg = retryAfterMs != null
+            ? ` Retry after ${retryAfterMs}ms.`
+            : "";
+        super(`Rate limit hit for model provider "${provider}".${retryMsg}`, {
+            code: "ONI_MODEL_RATE_LIMIT",
+            category: "MODEL",
+            recoverable: true,
+            suggestion: "Wait and retry, or switch to a different model provider.",
+            context: { provider, ...(retryAfterMs != null ? { retryAfterMs } : {}) },
+        });
+        this.name = "ModelRateLimitError";
+    }
+}
+export class ModelContextLengthError extends ONIError {
+    constructor(provider, maxTokens) {
+        super(`Context length exceeded for provider "${provider}" (max ${maxTokens} tokens).`, {
+            code: "ONI_MODEL_CONTEXT",
+            category: "MODEL",
+            recoverable: false,
+            suggestion: "Reduce the input size, trim messages, or use a model with a larger context window.",
+            context: { provider, maxTokens },
+        });
+        this.name = "ModelContextLengthError";
+    }
+}
+export class CheckpointCorruptError extends ONIError {
+    constructor(threadId, detail) {
+        super(`Checkpoint for thread "${threadId}" is corrupt: ${detail}`, {
+            code: "ONI_CHECKPOINT_CORRUPT",
+            category: "CHECKPOINT",
+            recoverable: false,
+            suggestion: "Delete the corrupt checkpoint and restart from a known-good state.",
+            context: { threadId, detail },
+        });
+        this.name = "CheckpointCorruptError";
+    }
+}
+export class StoreKeyNotFoundError extends ONIError {
+    constructor(namespace, key) {
+        const ns = namespace.join(".");
+        super(`Key "${key}" not found in store namespace [${ns}].`, {
+            code: "ONI_STORE_KEY",
+            category: "STORE",
+            recoverable: false,
+            suggestion: "Verify the namespace and key exist before accessing them.",
+            context: { namespace, key },
+        });
+        this.name = "StoreKeyNotFoundError";
+    }
+}
+// ── ONIInterrupt (not an Error — unchanged) ───────────────────
 /** Thrown at interrupt checkpoints — caught externally to pause/resume */
 export class ONIInterrupt {
     node;

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,iCAAiC;AACjC,+DAA+D;AAE/D,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC;CACzE;AACD,MAAM,OAAO,oBAAqB,SAAQ,QAAQ;IAChD,YAAY,GAAW,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC,CAAC,CAAC;CAC7E;AACD,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;IAC/C,YAAY,KAAa;QACvB,KAAK,CAAC,sBAAsB,KAAK,qDAAqD,CAAC,CAAC;QACxF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AACD,MAAM,OAAO,iBAAkB,SAAQ,QAAQ;IAC7C,YAAY,IAAY,IAAI,KAAK,CAAC,SAAS,IAAI,0BAA0B,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC,CAAC,CAAC;CAC/G;AACD,MAAM,OAAO,iBAAkB,SAAQ,QAAQ;IAC7C,YAAY,IAAY,EAAE,EAAU,IAAI,KAAK,CAAC,mBAAmB,IAAI,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC,CAAC,CAAC;CACxI;AACD,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9C,YAAY,IAAY,EAAE,KAAY;QACpC,KAAK,CAAC,SAAS,IAAI,sCAAsC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,0EAA0E;AAC1E,MAAM,OAAO,YAAY;IAGL;IACA;IACA;IAJT,cAAc,GAAG,IAAI,CAAC;IAC/B,YACkB,IAAc,EACd,MAA0B,EAC1B,KAAe;QAFf,SAAI,GAAJ,IAAI,CAAU;QACd,WAAM,GAAN,MAAM,CAAoB;QAC1B,UAAK,GAAL,KAAK,CAAU;IAC9B,CAAC;CACL"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/events/bridge.d.ts

@@ -0,0 +1,17 @@
+import type { SwarmTracer } from "../swarm/tracer.js";
+import type { EventBus } from "./bus.js";
+/**
+ * Bridge SwarmTracer events to an EventBus.
+ *
+ * Maps:
+ * - `agent_start`    → `swarm.agent.started`
+ * - `agent_complete`  → `swarm.agent.completed`
+ * - `agent_error`     → `swarm.agent.failed`
+ *
+ * @param tracer  The SwarmTracer to subscribe to
+ * @param bus     The EventBus to publish to
+ * @param swarmId Identifier for the swarm (included in all events)
+ * @returns Unsubscribe function — call to stop the bridge
+ */
+export declare function bridgeSwarmTracer(tracer: SwarmTracer, bus: EventBus, swarmId: string): () => void;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/events/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/events/bridge.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGzC;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,MAAM,GACd,MAAM,IAAI,CA+CZ"}