@oni.bot/core 0.6.1

package/dist/swarm/pool.d.ts

@@ -0,0 +1,27 @@
+import type { SwarmAgentDef } from "./types.js";
+import type { ONIConfig } from "../types.js";
+type PoolStrategy = "round-robin" | "least-busy" | "random";
+export declare class AgentPool<S extends Record<string, unknown>> {
+    private slots;
+    private strategy;
+    private rrIndex;
+    private queue;
+    private maxQueueDepth;
+    constructor(agents: SwarmAgentDef<S>[], opts?: {
+        strategy?: PoolStrategy;
+        maxQueueDepth?: number;
+    });
+    invoke(input: Partial<S>, config?: ONIConfig): Promise<S>;
+    /** Run N inputs across the pool in parallel */
+    batch(inputs: Partial<S>[], config?: ONIConfig): Promise<S[]>;
+    stats(): Array<{
+        agentId: string;
+        activeTasks: number;
+        totalRuns: number;
+    }>;
+    queueDepth(): number;
+    private pickSlot;
+    private runOnSlot;
+}
+export {};
+//# sourceMappingURL=pool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/swarm/pool.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAQ7C,KAAK,YAAY,GAAG,aAAa,GAAG,YAAY,GAAG,QAAQ,CAAC;AAE5D,qBAAa,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACtD,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,KAAK,CAKL;IACR,OAAO,CAAC,aAAa,CAAS;gBAG5B,MAAM,EAAK,aAAa,CAAC,CAAC,CAAC,EAAE,EAC7B,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,YAAY,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE;IAUtD,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC;IAiB/D,+CAA+C;IACzC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAMnE,KAAK,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ3E,UAAU,IAAI,MAAM;IAIpB,OAAO,CAAC,QAAQ;YAmBF,SAAS;CAyBxB"}

package/dist/swarm/pool.js

@@ -0,0 +1,87 @@
+// ============================================================
+// @oni.bot/core/swarm — AgentPool
+// ============================================================
+// Manages N instances of equivalent agents with load balancing.
+// Provides a unified invoke() that routes to the least-busy
+// agent or queues if all are at capacity.
+// ============================================================
+export class AgentPool {
+    slots;
+    strategy;
+    rrIndex = 0;
+    queue = [];
+    maxQueueDepth;
+    constructor(agents, opts) {
+        if (!agents.length)
+            throw new Error("AgentPool requires at least one agent.");
+        this.slots = agents.map((a) => ({ agent: a, activeTasks: 0, totalRuns: 0 }));
+        this.strategy = opts?.strategy ?? "least-busy";
+        this.maxQueueDepth = opts?.maxQueueDepth ?? 100;
+    }
+    // ---- Public API ----
+    async invoke(input, config) {
+        const slot = this.pickSlot();
+        if (slot) {
+            return this.runOnSlot(slot, input, config);
+        }
+        // All at capacity — queue with backpressure
+        if (this.queue.length >= this.maxQueueDepth) {
+            throw new Error(`AgentPool queue depth exceeded (max ${this.maxQueueDepth}). Apply backpressure.`);
+        }
+        return new Promise((resolve, reject) => {
+            this.queue.push({ input, config, resolve, reject });
+        });
+    }
+    /** Run N inputs across the pool in parallel */
+    async batch(inputs, config) {
+        return Promise.all(inputs.map((inp) => this.invoke(inp, config)));
+    }
+    // ---- Stats ----
+    stats() {
+        return this.slots.map((s) => ({
+            agentId: s.agent.id,
+            activeTasks: s.activeTasks,
+            totalRuns: s.totalRuns,
+        }));
+    }
+    queueDepth() { return this.queue.length; }
+    // ---- Internals ----
+    pickSlot() {
+        const available = this.slots.filter((s) => s.activeTasks < (s.agent.maxConcurrency ?? 1));
+        if (!available.length)
+            return null;
+        switch (this.strategy) {
+            case "least-busy":
+                return available.reduce((a, b) => (a.activeTasks <= b.activeTasks ? a : b));
+            case "round-robin": {
+                const slot = available[this.rrIndex % available.length];
+                this.rrIndex++;
+                return slot;
+            }
+            case "random":
+                return available[Math.floor(Math.random() * available.length)];
+        }
+    }
+    async runOnSlot(slot, input, config) {
+        slot.activeTasks++;
+        slot.totalRuns++;
+        try {
+            const result = await slot.agent.skeleton.invoke(input, {
+                ...config,
+                agentId: slot.agent.id,
+            });
+            return result;
+        }
+        finally {
+            slot.activeTasks--;
+            // Drain queue
+            if (this.queue.length > 0) {
+                const next = this.queue.shift();
+                this.runOnSlot(slot, next.input, next.config)
+                    .then(next.resolve)
+                    .catch(next.reject);
+            }
+        }
+    }
+}
+//# sourceMappingURL=pool.js.map

package/dist/swarm/pool.js.map

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

package/dist/swarm/registry.d.ts

@@ -0,0 +1,37 @@
+import type { SwarmAgentDef, AgentStatus } from "./types.js";
+export interface AgentRecord<S extends Record<string, unknown>> {
+    def: SwarmAgentDef<S>;
+    status: AgentStatus;
+    activeTasks: number;
+    totalRuns: number;
+    lastActive: number | null;
+    errors: number;
+}
+export declare class AgentRegistry<S extends Record<string, unknown> = Record<string, unknown>> {
+    private agents;
+    register(def: SwarmAgentDef<S>): this;
+    deregister(agentId: string): boolean;
+    get(agentId: string): AgentRecord<S> | null;
+    getDef(agentId: string): SwarmAgentDef<S> | null;
+    getAll(): AgentRecord<S>[];
+    /** Find agents by role (exact or partial match) */
+    findByRole(role: string): AgentRecord<S>[];
+    /** Find agents that have a specific capability by name */
+    findByCapability(capabilityName: string): AgentRecord<S>[];
+    /** Find idle agents ready to accept work */
+    findIdle(): AgentRecord<S>[];
+    /** Find the least-busy agent across all registered agents */
+    leastBusy(): AgentRecord<S> | null;
+    setStatus(agentId: string, status: AgentStatus): void;
+    markBusy(agentId: string): void;
+    markIdle(agentId: string): void;
+    markError(agentId: string): void;
+    toManifest(): string;
+    stats(): Record<string, {
+        status: AgentStatus;
+        activeTasks: number;
+        totalRuns: number;
+        errors: number;
+    }>;
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/swarm/registry.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAmB,MAAM,YAAY,CAAC;AAE9E,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D,GAAG,EAAU,aAAa,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,EAAO,WAAW,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAI,MAAM,CAAC;IACpB,UAAU,EAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAO,MAAM,CAAC;CACrB;AAED,qBAAa,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpF,OAAO,CAAC,MAAM,CAAqC;IAInD,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;IAerC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAMpC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAI3C,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;IAIhD,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE;IAI1B,mDAAmD;IACnD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE;IAM1C,0DAA0D;IAC1D,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE;IAQ1D,4CAA4C;IAC5C,QAAQ,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE;IAM5B,6DAA6D;IAC7D,SAAS,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAUlC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IAKrD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAU/B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAS/B,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAWhC,UAAU,IAAI,MAAM;IAcpB,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAYzG"}

package/dist/swarm/registry.js

@@ -0,0 +1,115 @@
+// ============================================================
+// @oni.bot/core/swarm — AgentRegistry
+// ============================================================
+// A live catalog of agents in the swarm. Runtime injectable —
+// register/deregister agents without recompiling the graph.
+// ============================================================
+export class AgentRegistry {
+    agents = new Map();
+    // ---- Registration ----
+    register(def) {
+        if (this.agents.has(def.id)) {
+            throw new Error(`Agent "${def.id}" is already registered.`);
+        }
+        this.agents.set(def.id, {
+            def,
+            status: "idle",
+            activeTasks: 0,
+            totalRuns: 0,
+            lastActive: null,
+            errors: 0,
+        });
+        return this;
+    }
+    deregister(agentId) {
+        return this.agents.delete(agentId);
+    }
+    // ---- Lookups ----
+    get(agentId) {
+        return this.agents.get(agentId) ?? null;
+    }
+    getDef(agentId) {
+        return this.agents.get(agentId)?.def ?? null;
+    }
+    getAll() {
+        return [...this.agents.values()];
+    }
+    /** Find agents by role (exact or partial match) */
+    findByRole(role) {
+        return [...this.agents.values()].filter((a) => a.def.role.toLowerCase().includes(role.toLowerCase()));
+    }
+    /** Find agents that have a specific capability by name */
+    findByCapability(capabilityName) {
+        return [...this.agents.values()].filter((a) => a.def.capabilities.some((c) => c.name.toLowerCase().includes(capabilityName.toLowerCase())));
+    }
+    /** Find idle agents ready to accept work */
+    findIdle() {
+        return [...this.agents.values()].filter((a) => a.status === "idle" || a.activeTasks < (a.def.maxConcurrency ?? 1));
+    }
+    /** Find the least-busy agent across all registered agents */
+    leastBusy() {
+        const available = [...this.agents.values()].filter((a) => a.status !== "terminated" && a.status !== "error");
+        if (!available.length)
+            return null;
+        return available.reduce((a, b) => (a.activeTasks <= b.activeTasks ? a : b));
+    }
+    // ---- Status management ----
+    setStatus(agentId, status) {
+        const rec = this.agents.get(agentId);
+        if (rec)
+            rec.status = status;
+    }
+    markBusy(agentId) {
+        const rec = this.agents.get(agentId);
+        if (rec) {
+            rec.status = "busy";
+            rec.activeTasks++;
+            rec.totalRuns++;
+            rec.lastActive = Date.now();
+        }
+    }
+    markIdle(agentId) {
+        const rec = this.agents.get(agentId);
+        if (rec) {
+            rec.activeTasks = Math.max(0, rec.activeTasks - 1);
+            if (rec.activeTasks === 0)
+                rec.status = "idle";
+            rec.lastActive = Date.now();
+        }
+    }
+    markError(agentId) {
+        const rec = this.agents.get(agentId);
+        if (rec) {
+            rec.errors++;
+            rec.activeTasks = Math.max(0, rec.activeTasks - 1);
+            if (rec.activeTasks === 0)
+                rec.status = "idle";
+        }
+    }
+    // ---- Capability manifest (for LLM routing prompt) ----
+    toManifest() {
+        return [...this.agents.values()]
+            .filter((a) => a.status !== "terminated")
+            .map((a) => {
+            const caps = a.def.capabilities
+                .map((c) => `    - ${c.name}: ${c.description}`)
+                .join("\n");
+            return `Agent ID: "${a.def.id}" | Role: ${a.def.role}\n  Capabilities:\n${caps}\n  Status: ${a.status} (active tasks: ${a.activeTasks})`;
+        })
+            .join("\n\n");
+    }
+    // ---- Stats ----
+    stats() {
+        const out = {};
+        for (const [id, rec] of this.agents) {
+            out[id] = {
+                status: rec.status,
+                activeTasks: rec.activeTasks,
+                totalRuns: rec.totalRuns,
+                errors: rec.errors,
+            };
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/swarm/registry.js.map

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

package/dist/swarm/supervisor.d.ts

@@ -0,0 +1,18 @@
+import type { NodeFn } from "../types.js";
+import type { SupervisorConfig } from "./types.js";
+import type { AgentRegistry } from "./registry.js";
+export interface SupervisorState {
+    task: string;
+    context: Record<string, unknown>;
+    supervisorRound: number;
+    currentAgent: string | null;
+    agentResults: Record<string, unknown>;
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
+    done: boolean;
+    [key: string]: unknown;
+}
+export declare function createSupervisorNode<S extends SupervisorState>(registry: AgentRegistry<S>, config: SupervisorConfig<S>): NodeFn<S>;
+//# sourceMappingURL=supervisor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../../src/swarm/supervisor.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,gBAAgB,EAAa,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAOnD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAa,MAAM,CAAC;IACxB,OAAO,EAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAK,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,EAAS,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,IAAI,EAAa,OAAO,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAK,OAAO,CAAC;CAC1B;AAMD,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,eAAe,EAC5D,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,MAAM,EAAI,gBAAgB,CAAC,CAAC,CAAC,GAC5B,MAAM,CAAC,CAAC,CAAC,CAiEX"}

package/dist/swarm/supervisor.js

@@ -0,0 +1,117 @@
+// ============================================================
+// @oni.bot/core/swarm — Supervisor
+// ============================================================
+// The orchestrating node in a hierarchical swarm.
+// Routes tasks to agents using LLM, rule-based, or round-robin
+// strategies. Collects results and decides when to END.
+// ============================================================
+import { END } from "../types.js";
+import { Command } from "../types.js";
+// ----------------------------------------------------------------
+// createSupervisorNode — factory that returns a NodeFn
+// ----------------------------------------------------------------
+export function createSupervisorNode(registry, config) {
+    const maxRounds = config.maxRounds ?? 10;
+    return async (state) => {
+        const round = state.supervisorRound ?? 0;
+        const task = String(state[config.taskField] ?? "");
+        // Guard: max rounds
+        if (round >= maxRounds || state.done) {
+            console.log(`[supervisor] round=${round} → END`);
+            return new Command({
+                update: { supervisorRound: round },
+                goto: END,
+            });
+        }
+        // Check if last agent marked task as done
+        if (state.done) {
+            return new Command({ update: {}, goto: END });
+        }
+        const rawCtx = (config.contextField ? state[config.contextField] : {});
+        // Enrich context with supervisorRound so rules/LLM can inspect the current round
+        const ctx = { ...rawCtx, supervisorRound: round };
+        // Route to next agent
+        let targetAgentId = null;
+        switch (config.strategy) {
+            case "llm":
+                targetAgentId = await routeViaLLM(task, ctx, registry, config.model, config.systemPrompt);
+                break;
+            case "rule":
+                targetAgentId = routeViaRules(task, ctx, config.rules ?? []);
+                break;
+            case "round-robin":
+                targetAgentId = routeRoundRobin(registry, round);
+                break;
+        }
+        if (!targetAgentId) {
+            console.warn(`[supervisor] No agent found for task. Going to END.`);
+            return new Command({ update: {}, goto: END });
+        }
+        const agentDef = registry.getDef(targetAgentId);
+        if (!agentDef) {
+            console.warn(`[supervisor] Agent "${targetAgentId}" not in registry.`);
+            return new Command({ update: {}, goto: END });
+        }
+        console.log(`[supervisor] round=${round} → routing to "${targetAgentId}" (${agentDef.role})`);
+        return new Command({
+            update: {
+                supervisorRound: round + 1,
+                currentAgent: targetAgentId,
+                messages: [
+                    ...state.messages,
+                    { role: "system", content: `Supervisor routing to: ${agentDef.role}` },
+                ],
+            },
+            goto: targetAgentId,
+        });
+    };
+}
+// ----------------------------------------------------------------
+// Routing strategies
+// ----------------------------------------------------------------
+async function routeViaLLM(task, context, registry, model, systemPrompt) {
+    const manifest = registry.toManifest();
+    const agentIds = registry.getAll().map((a) => a.def.id);
+    const prompt = [
+        `TASK: ${task}`,
+        context && Object.keys(context).length
+            ? `CONTEXT: ${JSON.stringify(context, null, 2)}`
+            : "",
+        "",
+        "AVAILABLE AGENTS:",
+        manifest,
+        "",
+        `Respond with ONLY the agent ID. Valid IDs: ${agentIds.join(", ")}`,
+    ]
+        .filter(Boolean)
+        .join("\n");
+    const response = await model.chat({
+        messages: [{ role: "user", content: prompt }],
+        systemPrompt: systemPrompt ?? "You are an agent router. Choose the best agent for the given task.",
+    });
+    const cleaned = response.content.trim().replace(/['"]/g, "");
+    // Validate the LLM returned a real agent ID
+    if (agentIds.includes(cleaned))
+        return cleaned;
+    // Fuzzy: find the first agent ID that appears in the response
+    return agentIds.find((id) => response.content.includes(id)) ?? null;
+}
+function routeViaRules(task, context, rules) {
+    for (const rule of rules) {
+        if (rule.condition(task, context))
+            return rule.agentId;
+    }
+    return null;
+}
+function routeRoundRobin(registry, round) {
+    const agents = registry.findIdle();
+    if (!agents.length) {
+        // Fall back to all agents if none idle
+        const all = registry.getAll().filter((a) => a.status !== "terminated");
+        if (!all.length)
+            return null;
+        return all[round % all.length].def.id;
+    }
+    return agents[round % agents.length].def.id;
+}
+//# sourceMappingURL=supervisor.js.map

package/dist/swarm/supervisor.js.map

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

package/dist/swarm/types.d.ts

@@ -0,0 +1,111 @@
+import type { ONISkeleton, ONICheckpointer } from "../types.js";
+import type { ONIModel } from "../models/types.js";
+export type AgentStatus = "idle" | "busy" | "terminated" | "error";
+export interface AgentCapability {
+    name: string;
+    description: string;
+    /** Examples of inputs this agent handles well */
+    examples?: string[];
+}
+export interface SwarmAgentDef<S extends Record<string, unknown> = Record<string, unknown>> {
+    /** Unique ID within the swarm */
+    id: string;
+    /** Human-readable role label */
+    role: string;
+    /** Describes what this agent can handle — used by Supervisor for routing */
+    capabilities: AgentCapability[];
+    /** The compiled skeleton backing this agent */
+    skeleton: ONISkeleton<S>;
+    /** Max simultaneous executions (default: 1) */
+    maxConcurrency?: number;
+    /** System prompt injected into routing context */
+    systemPrompt?: string;
+    /** Max retries before fallback to supervisor (default: 2) */
+    maxRetries?: number;
+}
+export interface HandoffOptions {
+    /** Target agent ID to hand off to */
+    to: string;
+    /** Human-readable instruction for the receiving agent */
+    message: string;
+    /** Additional context merged into the receiving agent's input */
+    context?: Record<string, unknown>;
+    /**
+     * Which agent to return to after the target completes.
+     * If omitted, control returns to the Supervisor (if present) or END.
+     */
+    resume?: string;
+    /** Priority hint for the AgentPool scheduler */
+    priority?: "low" | "normal" | "high" | "critical";
+}
+export declare class Handoff {
+    readonly opts: HandoffOptions;
+    readonly isHandoff = true;
+    constructor(opts: HandoffOptions);
+    get to(): string;
+    get message(): string;
+    get context(): Record<string, unknown> | undefined;
+    get resume(): string | undefined;
+    get priority(): string;
+}
+export interface SwarmMessage {
+    id: string;
+    from: string;
+    to: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+    timestamp: number;
+    replyTo?: string;
+}
+export interface HandoffRecord {
+    from: string;
+    to: string;
+    message: string;
+    step: number;
+    timestamp: number;
+    resume?: string;
+}
+export interface SwarmMeta {
+    activeAgents: string[];
+    completedAgents: string[];
+    handoffHistory: HandoffRecord[];
+    messages: SwarmMessage[];
+    currentAgent?: string;
+    supervisorRound: number;
+}
+export type SupervisorRoutingStrategy = "llm" | "rule" | "round-robin";
+export interface RuleRoute {
+    condition: (task: string, context: Record<string, unknown>) => boolean;
+    agentId: string;
+}
+export interface SupervisorConfig<S extends Record<string, unknown>> {
+    /** ONIModel for LLM-based routing (required if strategy === "llm") */
+    model?: ONIModel;
+    /** Routing strategy */
+    strategy: SupervisorRoutingStrategy;
+    /** Rule-based routes (required if strategy === "rule") */
+    rules?: RuleRoute[];
+    /** Field in state that contains the current task */
+    taskField: keyof S;
+    /** Field in state that contains routing context */
+    contextField?: keyof S;
+    /** Max rounds before Supervisor sends to END */
+    maxRounds?: number;
+    /** System prompt for LLM-based routing */
+    systemPrompt?: string;
+}
+export interface AgentPoolConfig<S extends Record<string, unknown>> {
+    /** Agents in the pool — all handle the same task type */
+    agents: SwarmAgentDef<S>[];
+    /** Load balancing strategy */
+    strategy?: "round-robin" | "least-busy" | "random";
+    /** Max queue depth before backpressure kicks in */
+    maxQueueDepth?: number;
+}
+export interface SwarmCompileOptions<S extends Record<string, unknown>> {
+    checkpointer?: ONICheckpointer<S>;
+    interruptBefore?: string[];
+    interruptAfter?: string[];
+}
+export type SwarmTopology = "hierarchical" | "peer-to-peer" | "pipeline" | "hierarchical-mesh" | "custom";
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/swarm/types.js

@@ -0,0 +1,16 @@
+// ============================================================
+// @oni.bot/core/swarm — Swarm Types
+// ============================================================
+export class Handoff {
+    opts;
+    isHandoff = true;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    get to() { return this.opts.to; }
+    get message() { return this.opts.message; }
+    get context() { return this.opts.context; }
+    get resume() { return this.opts.resume; }
+    get priority() { return this.opts.priority ?? "normal"; }
+}
+//# sourceMappingURL=types.js.map

package/dist/swarm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/swarm/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,oCAAoC;AACpC,+DAA+D;AAuD/D,MAAM,OAAO,OAAO;IAEU;IADnB,SAAS,GAAG,IAAI,CAAC;IAC1B,YAA4B,IAAoB;QAApB,SAAI,GAAJ,IAAI,CAAgB;IAAG,CAAC;IAEpD,IAAI,EAAE,KAAoB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,IAAI,OAAO,KAAe,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACrD,IAAI,OAAO,KAA2C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACjF,IAAI,MAAM,KAA2B,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/D,IAAI,QAAQ,KAAc,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC;CACnE"}

package/dist/tools/define.d.ts

@@ -0,0 +1,14 @@
+import type { ToolDefinition, DefineToolOptions } from "./types.js";
+export declare function defineTool<TInput = any, TOutput = any>(opts: DefineToolOptions<TInput, TOutput>): ToolDefinition<TInput, TOutput>;
+export declare function executeTool<TInput, TOutput>(tool: ToolDefinition<TInput, TOutput>, input: TInput): Promise<TOutput>;
+export declare function executeToolCalls(tools: ToolDefinition[], calls: Array<{
+    name: string;
+    args: Record<string, unknown>;
+    id: string;
+}>): Promise<Array<{
+    toolCallId: string;
+    name: string;
+    result: unknown;
+    isError?: boolean;
+}>>;
+//# sourceMappingURL=define.d.ts.map

package/dist/tools/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/tools/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAe,MAAM,YAAY,CAAC;AAGjF,wBAAgB,UAAU,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EACpD,IAAI,EAAE,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAOjC;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,OAAO,EAC/C,IAAI,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC,CAWlB;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,cAAc,EAAE,EACvB,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,GACxE,OAAO,CAAC,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,CAgB1F"}

package/dist/tools/define.js

@@ -0,0 +1,39 @@
+import { getConfig, getStore, getCurrentState, getStreamWriter } from "../context.js";
+export function defineTool(opts) {
+    return {
+        name: opts.name,
+        description: opts.description,
+        schema: opts.schema,
+        execute: opts.execute,
+    };
+}
+export async function executeTool(tool, input) {
+    const ctx = {
+        config: getConfig(),
+        store: getStore(),
+        state: getCurrentState(),
+        emit: (event, data) => {
+            const writer = getStreamWriter();
+            if (writer)
+                writer.emit(event, data);
+        },
+    };
+    return await tool.execute(input, ctx);
+}
+export async function executeToolCalls(tools, calls) {
+    const toolMap = new Map(tools.map(t => [t.name, t]));
+    return Promise.all(calls.map(async (call) => {
+        const tool = toolMap.get(call.name);
+        if (!tool) {
+            return { toolCallId: call.id, name: call.name, result: `Tool "${call.name}" not found`, isError: true };
+        }
+        try {
+            const result = await executeTool(tool, call.args);
+            return { toolCallId: call.id, name: call.name, result };
+        }
+        catch (err) {
+            return { toolCallId: call.id, name: call.name, result: String(err), isError: true };
+        }
+    }));
+}
+//# sourceMappingURL=define.js.map

package/dist/tools/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/tools/define.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEtF,MAAM,UAAU,UAAU,CACxB,IAAwC;IAExC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAqC,EACrC,KAAa;IAEb,MAAM,GAAG,GAAgB;QACvB,MAAM,EAAE,SAAS,EAAE;QACnB,KAAK,EAAE,QAAQ,EAAE;QACjB,KAAK,EAAE,eAAe,EAA2B;QACjD,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACpB,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;YACjC,IAAI,MAAM;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACvC,CAAC;KACF,CAAC;IACF,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAuB,EACvB,KAAyE;IAEzE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC,GAAG,CAChB,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,IAAI,CAAC,IAAI,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC1G,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAClD,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACtF,CAAC;IACH,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}