@oni.bot/core 1.0.2 → 1.1.0

package/dist/swarm/compile-ext.js

@@ -0,0 +1,126 @@
+// ============================================================
+// src/swarm/compile-ext.ts — buildSwarmExtensions factory
+// Extracted from SwarmGraph.compile() to keep graph.ts thin.
+// ============================================================
+import { END, Send } from "../types.js";
+import { createAgentNode } from "./agent-node.js";
+export function buildSwarmExtensions(skeleton, registry, inner, hasSupervisor, supervisorNodeName, onErrorPolicy) {
+    return {
+        registry,
+        agentStats: () => registry.stats(),
+        toMermaid: () => {
+            // Read from the live runner's edge map so the diagram reflects
+            // agents added/removed via spawnAgent()/removeAgent() after compile.
+            const runner = skeleton._runner;
+            const edgesBySource = runner?._edgesBySource;
+            if (!edgesBySource)
+                return inner.toMermaid(); // safe fallback
+            const lines = ["graph TD"];
+            for (const [from, edges] of edgesBySource) {
+                for (const edge of edges) {
+                    if (edge.type === "static" && edge.to !== undefined) {
+                        lines.push(`    ${from} --> ${edge.to}`);
+                    }
+                    else {
+                        lines.push(`    ${from} -->|?| conditional_${from}`);
+                    }
+                }
+            }
+            return lines.join("\n");
+        },
+        spawnAgent(def) {
+            // spawnAgent requires a supervisor to route the spawned agent back into the graph.
+            // In unsupervised topologies there is no return path, so the agent would never execute.
+            if (!hasSupervisor) {
+                throw new Error(`spawnAgent() requires a supervisor node. ` +
+                    `Use SwarmGraph.hierarchical() to add a supervisor, or call addAgent() before compile() for static topologies.`);
+            }
+            // Register in the registry
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            registry.register(def); // SAFE: external boundary — generic registry accepts narrower S
+            // Use the same createAgentNode path as static agents so dynamic agents get
+            // inbox tracking, timeout clamping, handoff handling, retry backoff, and
+            // structured error context — identical behavior to compile-time addAgent().
+            const swarmLiveState = { hasSupervisor, supervisorNodeName, onErrorPolicy };
+            const agentNode = createAgentNode(def, registry, swarmLiveState);
+            // Add node to the compiled runner's nodes map
+            const runner = skeleton._runner;
+            if (runner?.nodes) {
+                runner.nodes.set(def.id, { name: def.id, fn: agentNode });
+            }
+            // In supervised swarms, add a conditional return edge so the runner
+            // knows to send this agent's output back to the supervisor (or END).
+            if (hasSupervisor && runner) {
+                const returnEdge = {
+                    type: "conditional",
+                    from: def.id,
+                    condition: (st) => st.done ? END : supervisorNodeName,
+                };
+                const edgesBySource = runner._edgesBySource;
+                const list = edgesBySource.get(def.id) ?? [];
+                list.push(returnEdge);
+                edgesBySource.set(def.id, list);
+            }
+        },
+        removeAgent(agentId) {
+            registry.deregister(agentId);
+            const runner = skeleton._runner;
+            // If the agent is not in the compiled node map it was never part of the graph —
+            // no edges can reference it, so there is nothing structural to clean up.
+            if (!runner?.nodes?.has(agentId))
+                return;
+            runner.nodes.delete(agentId);
+            // Remove stale edges pointing TO the removed agent so Pregel doesn't try to route to it.
+            // Also remove edges FROM the agent (it won't execute, but keeps _edgesBySource clean).
+            const edgesBySource = runner._edgesBySource;
+            if (edgesBySource) {
+                for (const [from, edges] of edgesBySource) {
+                    let changed = false;
+                    const updated = edges
+                        .filter((e) => {
+                        // Drop static edges that target the removed agent
+                        if (e.type === "static" && e.to === agentId) {
+                            changed = true;
+                            return false;
+                        }
+                        return true;
+                    })
+                        .map((e) => {
+                        if (e.type !== "conditional")
+                            return e;
+                        // (a) Remap any pathMap entry whose value is the removed agentId → END
+                        let newPathMap = e.pathMap;
+                        if (newPathMap) {
+                            const stale = Object.values(newPathMap).some((v) => v === agentId);
+                            if (stale) {
+                                newPathMap = Object.fromEntries(Object.entries(newPathMap).map(([k, v]) => [k, v === agentId ? END : v]));
+                            }
+                        }
+                        // (b) Wrap the condition so any runtime return of agentId is replaced with END.
+                        //     We cannot introspect the closure, so we always wrap for safety.
+                        const orig = e.condition;
+                        const wrapped = (state, cfg) => {
+                            const result = orig(state, cfg);
+                            if (!Array.isArray(result)) {
+                                // Single NodeName — replace agentId with END
+                                return result === agentId ? END : result;
+                            }
+                            if (result.length > 0 && result[0] instanceof Send) {
+                                // Send[] — filter out Sends targeting the removed agent
+                                return result.filter((r) => r.node !== agentId);
+                            }
+                            // NodeName[] — replace agentId entries with END
+                            return result.map((r) => (r === agentId ? END : r));
+                        };
+                        changed = true;
+                        return { ...e, condition: wrapped, pathMap: newPathMap };
+                    });
+                    if (changed)
+                        edgesBySource.set(from, updated);
+                }
+                edgesBySource.delete(agentId);
+            }
+        },
+    };
+}
+//# sourceMappingURL=compile-ext.js.map

package/dist/swarm/compile-ext.js.map

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

package/dist/swarm/config.d.ts

@@ -0,0 +1,147 @@
+import { END } from "../types.js";
+import type { ChannelSchema, NodeDefinition, Edge, ONICheckpointer } from "../types.js";
+import type { BaseStore } from "../store/index.js";
+import type { GuardrailsConfig } from "../guardrails/types.js";
+import type { EventListeners } from "../events/types.js";
+import type { TracerLike } from "../telemetry.js";
+import type { ONIModel } from "../models/types.js";
+import type { SwarmAgentDef, HandoffRecord, SwarmMessage } from "./types.js";
+import type { AgentRegistry } from "./registry.js";
+export interface PregelRunnerInternals<S extends Record<string, unknown>> {
+    nodes: Map<string, NodeDefinition<S>>;
+    _edgesBySource: Map<string, Edge<S>[]>;
+}
+export type BaseSwarmState = {
+    task: string;
+    context: Record<string, unknown>;
+    agentResults: Record<string, unknown>;
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
+    swarmMessages: SwarmMessage[];
+    supervisorRound: number;
+    currentAgent: string | null;
+    done: boolean;
+    handoffHistory: HandoffRecord[];
+    [key: string]: unknown;
+};
+export declare const baseSwarmChannels: {
+    task: import("../types.js").Channel<string>;
+    context: import("../types.js").Channel<{}>;
+    agentResults: import("../types.js").Channel<{}>;
+    messages: import("../types.js").Channel<{
+        role: string;
+        content: string;
+    }[]>;
+    swarmMessages: import("../types.js").Channel<SwarmMessage[]>;
+    supervisorRound: import("../types.js").Channel<number>;
+    currentAgent: import("../types.js").Channel<string | null>;
+    done: import("../types.js").Channel<boolean>;
+    handoffHistory: import("../types.js").Channel<HandoffRecord[]>;
+};
+export interface HierarchicalConfig<S extends BaseSwarmState> {
+    supervisor: {
+        model?: ONIModel;
+        strategy: "llm" | "rule" | "round-robin";
+        rules?: Array<{
+            condition: (task: string, context: Record<string, unknown>) => boolean;
+            agentId: string;
+        }>;
+        systemPrompt?: string;
+        maxRounds?: number;
+        /** Whole-swarm deadline in ms, computed from invoke-time (not compile-time). */
+        deadlineMs?: number;
+        /** Auto-recover: when an agent errors, route to an idle agent with matching capability. */
+        autoRecover?: boolean;
+    };
+    agents: SwarmAgentDef<S>[];
+    channels?: Partial<ChannelSchema<S>>;
+    onError?: "fallback" | "throw";
+}
+export interface FanOutConfig<S extends BaseSwarmState> {
+    agents: SwarmAgentDef<S>[];
+    reducer: (agentResults: Record<string, unknown>, weights?: Record<string, number>) => Partial<S>;
+    channels?: Partial<ChannelSchema<S>>;
+    /** Max agents to run simultaneously (default: all). */
+    maxConcurrency?: number;
+    /** Per-agent timeout in ms. Agents that exceed this are marked with _error. */
+    timeoutMs?: number;
+    /** Per-agent weights passed to the reducer as second argument. */
+    weights?: Record<string, number>;
+}
+export interface PipelineConfig<S extends BaseSwarmState> {
+    stages: SwarmAgentDef<S>[];
+    transitions?: Record<string, (state: S) => string | typeof END>;
+    channels?: Partial<ChannelSchema<S>>;
+}
+export interface PeerNetworkConfig<S extends BaseSwarmState> {
+    agents: SwarmAgentDef<S>[];
+    entrypoint: string;
+    handoffs: Record<string, (state: S) => string | typeof END>;
+    channels?: Partial<ChannelSchema<S>>;
+}
+export interface MapReduceConfig<S extends BaseSwarmState> {
+    mapper: SwarmAgentDef<S>;
+    poolSize?: number;
+    poolStrategy?: "round-robin" | "least-busy" | "random";
+    inputField: keyof S;
+    reducer: (agentResults: Record<string, unknown>) => Partial<S>;
+    channels?: Partial<ChannelSchema<S>>;
+}
+export interface DebateConfig<S extends BaseSwarmState> {
+    debaters: SwarmAgentDef<S>[];
+    judge: {
+        model: ONIModel;
+        systemPrompt?: string;
+        maxRounds: number;
+        consensusKeyword?: string;
+        /** Enable per-round scoring of debaters (scores stored in context.debateScores). */
+        scoreDebaters?: boolean;
+        /** Auto-consensus when score spread is within this threshold. */
+        consensusThreshold?: number;
+    };
+    topic: keyof S;
+    channels?: Partial<ChannelSchema<S>>;
+}
+export interface HierarchicalMeshConfig<S extends BaseSwarmState> {
+    coordinator: {
+        model: ONIModel;
+        strategy: "llm" | "rule" | "round-robin";
+        rules?: Array<{
+            condition: (task: string, context: Record<string, unknown>) => boolean;
+            agentId: string;
+        }>;
+        systemPrompt?: string;
+        maxRounds?: number;
+    };
+    teams: Record<string, {
+        topology: "pipeline" | "peerNetwork";
+        agents: SwarmAgentDef<S>[];
+        handoffs?: Record<string, (state: S) => string | typeof END>;
+    }>;
+    channels?: Partial<ChannelSchema<S>>;
+}
+export interface SwarmCompileOpts<S> {
+    checkpointer?: ONICheckpointer<S>;
+    interruptBefore?: string[];
+    interruptAfter?: string[];
+    store?: BaseStore;
+    guardrails?: GuardrailsConfig;
+    listeners?: EventListeners;
+    defaults?: {
+        nodeTimeout?: number;
+    };
+    deadLetterQueue?: boolean;
+    tracer?: TracerLike;
+}
+export interface SwarmExtensions<S extends Record<string, unknown>> {
+    registry: AgentRegistry<S>;
+    agentStats: () => ReturnType<AgentRegistry<S>["stats"]>;
+    toMermaid: () => string;
+    /** Dynamically spawn a new agent into the compiled swarm */
+    spawnAgent: (def: SwarmAgentDef<S>) => void;
+    /** Remove an agent from the compiled swarm (marks as terminated) */
+    removeAgent: (agentId: string) => void;
+}
+//# sourceMappingURL=config.d.ts.map

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

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

package/dist/swarm/config.js

@@ -0,0 +1,17 @@
+// ============================================================
+// src/swarm/config.ts — SwarmGraph topology config types
+// Extracted from graph.ts to keep SwarmGraph class focused.
+// ============================================================
+import { appendList, lastValue, mergeObject } from "../types.js";
+export const baseSwarmChannels = {
+    task: lastValue(() => ""),
+    context: mergeObject(() => ({})),
+    agentResults: mergeObject(() => ({})),
+    messages: appendList(() => []),
+    swarmMessages: appendList(() => []),
+    supervisorRound: lastValue(() => 0),
+    currentAgent: lastValue(() => null),
+    done: lastValue(() => false),
+    handoffHistory: appendList(() => []),
+};
+//# sourceMappingURL=config.js.map

package/dist/swarm/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/swarm/config.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,yDAAyD;AACzD,4DAA4D;AAC5D,+DAA+D;AAE/D,OAAO,EAAO,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAqCtE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAa,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;IACpC,OAAO,EAAU,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACxC,YAAY,EAAK,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACxC,QAAQ,EAAS,UAAU,CAAC,GAAG,EAAE,CAAC,EAA8C,CAAC;IACjF,aAAa,EAAI,UAAU,CAAC,GAAG,EAAE,CAAC,EAAoB,CAAC;IACvD,eAAe,EAAE,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACnC,YAAY,EAAK,SAAS,CAAC,GAAkB,EAAE,CAAC,IAAI,CAAC;IACrD,IAAI,EAAa,SAAS,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC;IACvC,cAAc,EAAG,UAAU,CAAC,GAAG,EAAE,CAAC,EAAqB,CAAC;CACzD,CAAC"}

package/dist/swarm/factories.d.ts

@@ -0,0 +1,37 @@
+import type { ChannelSchema } from "../types.js";
+import type { SwarmAgentDef } from "./types.js";
+import type { BaseSwarmState, HierarchicalConfig, FanOutConfig, PipelineConfig, PeerNetworkConfig, MapReduceConfig, DebateConfig, HierarchicalMeshConfig } from "./config.js";
+import type { SwarmGraph } from "./graph.js";
+export declare function buildHierarchical<S extends BaseSwarmState>(config: HierarchicalConfig<S>, swarm: SwarmGraph<S>): SwarmGraph<S>;
+export declare function buildFanOut<S extends BaseSwarmState>(config: FanOutConfig<S>, swarm: SwarmGraph<S>): SwarmGraph<S>;
+export declare function buildPipeline<S extends BaseSwarmState>(config: PipelineConfig<S>, swarm: SwarmGraph<S>): SwarmGraph<S>;
+export declare function buildPeerNetwork<S extends BaseSwarmState>(config: PeerNetworkConfig<S>, swarm: SwarmGraph<S>): SwarmGraph<S>;
+export declare function buildMapReduce<S extends BaseSwarmState>(config: MapReduceConfig<S>, swarm: SwarmGraph<S>): SwarmGraph<S>;
+export declare function buildDebate<S extends BaseSwarmState>(config: DebateConfig<S>, swarm: SwarmGraph<S>): SwarmGraph<S>;
+export declare function buildHierarchicalMesh<S extends BaseSwarmState>(config: HierarchicalMeshConfig<S>, swarm: SwarmGraph<S>, makeSwarm: (channels?: Partial<ChannelSchema<S>>) => SwarmGraph<S>): SwarmGraph<S>;
+export declare function buildRace<S extends BaseSwarmState>(config: {
+    agents: SwarmAgentDef<S>[];
+    accept?: (result: unknown) => boolean;
+    timeoutMs?: number;
+    channels?: Partial<ChannelSchema<S>>;
+}, swarm: SwarmGraph<S>): SwarmGraph<S>;
+export declare function buildDag<S extends BaseSwarmState>(config: {
+    agents: SwarmAgentDef<S>[];
+    dependencies: Record<string, string[]>;
+    channels?: Partial<ChannelSchema<S>>;
+}, swarm: SwarmGraph<S>): SwarmGraph<S>;
+export declare function buildPool<S extends BaseSwarmState>(config: {
+    agent: SwarmAgentDef<S>;
+    poolSize: number;
+    inputField: keyof S;
+    reducer: (results: Record<string, unknown>) => Partial<S>;
+    channels?: Partial<ChannelSchema<S>>;
+}, swarm: SwarmGraph<S>): SwarmGraph<S>;
+export declare function buildCompose<S extends BaseSwarmState>(config: {
+    stages: Array<{
+        id: string;
+        swarm: SwarmGraph<S>;
+    }>;
+    channels?: Partial<ChannelSchema<S>>;
+}, swarm: SwarmGraph<S>): SwarmGraph<S>;
+//# sourceMappingURL=factories.d.ts.map

package/dist/swarm/factories.d.ts.map

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