@oni.bot/core 0.6.3 → 1.0.0

package/dist/swarm/scaling.d.ts

@@ -0,0 +1,95 @@
+import type { SwarmTracer } from "./tracer.js";
+export interface ScalingConfig {
+    /** Minimum number of agents to maintain (default: 1) */
+    minAgents?: number;
+    /** Maximum number of agents allowed (default: 10) */
+    maxAgents?: number;
+    /**
+     * Error rate threshold to trigger scale-up (0-1, default: 0.25 = 25%).
+     * Rationale: 25% catches systemic issues (API degradation, bad prompts)
+     * early without over-reacting to transient single-agent failures.
+     * Lower than 20% would trigger on 1-of-5 agents failing once.
+     */
+    scaleUpErrorRate?: number;
+    /**
+     * Max latency (ms) before triggering scale-up (default: 15000).
+     * Rationale: multi-turn LLM agents (think→act→observe cycles) typically
+     * take 15-120s per full lifecycle. Opus inference alone is ~10s/call.
+     * 5s was far too aggressive — normal Opus agents would constantly trigger.
+     */
+    scaleUpLatencyMs?: number;
+    /**
+     * Seconds of no activity before triggering scale-down (default: 60).
+     * Rationale: agents actively running may go 30-60s between tracer events
+     * (no events emitted mid-execution). 30s caused false scale-downs while
+     * agents were still working. 60s gives a full agent lifecycle to complete.
+     */
+    scaleDownIdleSeconds?: number;
+    /**
+     * Minimum ms between scaling decisions (default: 10000).
+     * Rationale: 10s prevents oscillation in reactive mode where error
+     * and complete events fire in rapid succession. 5s was too short when
+     * multiple agents complete simultaneously.
+     */
+    cooldownMs?: number;
+}
+export interface ScalingDecision {
+    /** What action to take */
+    action: "scale_up" | "scale_down" | "idle";
+    /** Number of agents to add (scale_up) or remove (scale_down) */
+    count: number;
+    /** Human-readable reason for the decision */
+    reason: string;
+}
+export interface ScalingHistoryEntry {
+    decision: ScalingDecision;
+    timestamp: number;
+}
+type ScalingCallback = (decision: ScalingDecision) => void;
+export declare class DynamicScalingMonitor {
+    private readonly tracer;
+    private readonly config;
+    private currentAgentCount;
+    private lastDecision;
+    private lastDecisionTime;
+    private history;
+    private callbacks;
+    private unsubscribeTracer;
+    constructor(tracer: SwarmTracer, config?: ScalingConfig);
+    getConfig(): Readonly<Required<ScalingConfig>>;
+    setCurrentAgentCount(count: number): void;
+    getState(): {
+        currentAgentCount: number;
+        lastDecision: ScalingDecision | null;
+    };
+    /**
+     * Evaluate current tracer metrics and return a scaling decision.
+     * Call this periodically or after significant events.
+     */
+    evaluate(): ScalingDecision;
+    private checkScaleUp;
+    private checkScaleDown;
+    /**
+     * Record a decision (for cooldown tracking and history).
+     * Call this after applying the decision from evaluate().
+     */
+    recordDecision(decision: ScalingDecision): void;
+    getHistory(): ScalingHistoryEntry[];
+    /**
+     * Register a callback that fires on non-idle scaling decisions.
+     */
+    onScaleDecision(callback: ScalingCallback): () => void;
+    /**
+     * Enable reactive mode: subscribe to tracer events and auto-evaluate
+     * on error events. Non-idle decisions fire registered callbacks.
+     */
+    enableReactive(): void;
+    /**
+     * Disable reactive mode. Stops listening to tracer events.
+     */
+    disableReactive(): void;
+    /** Clean up — disables reactive mode. */
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=scaling.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scaling.d.ts","sourceRoot":"","sources":["../../src/swarm/scaling.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,aAAa,CAAC;AAI3D,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,MAAM,CAAC;IAC3C,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,KAAK,eAAe,GAAG,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;AAe3D,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,iBAAiB,CAA6B;gBAE1C,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,aAAa;IAcvD,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAI9C,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIzC,QAAQ,IAAI;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,eAAe,GAAG,IAAI,CAAA;KAAE;IAS/E;;;OAGG;IACH,QAAQ,IAAI,eAAe;IAyC3B,OAAO,CAAC,YAAY;IA0CpB,OAAO,CAAC,cAAc;IA4BtB;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAQ/C,UAAU,IAAI,mBAAmB,EAAE;IAMnC;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;IAKtD;;;OAGG;IACH,cAAc,IAAI,IAAI;IAsBtB;;OAEG;IACH,eAAe,IAAI,IAAI;IAOvB,yCAAyC;IACzC,OAAO,IAAI,IAAI;CAIhB"}

package/dist/swarm/scaling.js

@@ -0,0 +1,214 @@
+// ============================================================
+// @oni.bot/core/swarm — DynamicScalingMonitor
+// ============================================================
+// Reactive scaling decisions based on SwarmTracer events.
+// Monitors agent error rates, latencies, and idle periods to
+// recommend scale-up or scale-down actions.
+//
+// Two modes:
+// 1. Polling — call evaluate() periodically to get decisions
+// 2. Reactive — enableReactive() subscribes to tracer events
+//    and fires callback on actionable decisions
+// ============================================================
+// ── Defaults ──────────────────────────────────────────────
+const DEFAULT_CONFIG = {
+    minAgents: 1,
+    maxAgents: 10,
+    scaleUpErrorRate: 0.25,
+    scaleUpLatencyMs: 15000,
+    scaleDownIdleSeconds: 60,
+    cooldownMs: 10000,
+};
+// ── DynamicScalingMonitor ─────────────────────────────────
+export class DynamicScalingMonitor {
+    tracer;
+    config;
+    currentAgentCount = 0;
+    lastDecision = null;
+    lastDecisionTime = 0;
+    history = [];
+    callbacks = new Set();
+    unsubscribeTracer = null;
+    constructor(tracer, config) {
+        this.tracer = tracer;
+        this.config = {
+            minAgents: config?.minAgents ?? DEFAULT_CONFIG.minAgents,
+            maxAgents: config?.maxAgents ?? DEFAULT_CONFIG.maxAgents,
+            scaleUpErrorRate: config?.scaleUpErrorRate ?? DEFAULT_CONFIG.scaleUpErrorRate,
+            scaleUpLatencyMs: config?.scaleUpLatencyMs ?? DEFAULT_CONFIG.scaleUpLatencyMs,
+            scaleDownIdleSeconds: config?.scaleDownIdleSeconds ?? DEFAULT_CONFIG.scaleDownIdleSeconds,
+            cooldownMs: config?.cooldownMs ?? DEFAULT_CONFIG.cooldownMs,
+        };
+    }
+    // ── Configuration ─────────────────────────────────────
+    getConfig() {
+        return this.config;
+    }
+    setCurrentAgentCount(count) {
+        this.currentAgentCount = count;
+    }
+    getState() {
+        return {
+            currentAgentCount: this.currentAgentCount,
+            lastDecision: this.lastDecision,
+        };
+    }
+    // ── Core evaluation ───────────────────────────────────
+    /**
+     * Evaluate current tracer metrics and return a scaling decision.
+     * Call this periodically or after significant events.
+     */
+    evaluate() {
+        // Check cooldown
+        if (this.lastDecisionTime > 0) {
+            const elapsed = Date.now() - this.lastDecisionTime;
+            if (elapsed < this.config.cooldownMs) {
+                return { action: "idle", count: 0, reason: "cooldown active" };
+            }
+        }
+        // No agents to evaluate
+        if (this.currentAgentCount === 0) {
+            return { action: "idle", count: 0, reason: "no agents registered" };
+        }
+        const timeline = this.tracer.getTimeline();
+        if (timeline.length === 0) {
+            return { action: "idle", count: 0, reason: "no events to evaluate" };
+        }
+        // Single-pass count of starts and errors (used by checkScaleUp)
+        let starts = 0;
+        let errors = 0;
+        for (const e of timeline) {
+            if (e.type === "agent_start")
+                starts++;
+            else if (e.type === "agent_error")
+                errors++;
+        }
+        // Check scale-up conditions first (more urgent than scale-down)
+        const scaleUp = this.checkScaleUp(starts, errors);
+        if (scaleUp)
+            return scaleUp;
+        // Check scale-down — last event is most recent (timeline is append-only)
+        const lastActivity = timeline[timeline.length - 1].timestamp;
+        const scaleDown = this.checkScaleDown(lastActivity);
+        if (scaleDown)
+            return scaleDown;
+        return { action: "idle", count: 0, reason: "metrics within normal range" };
+    }
+    // ── Scale-up checks ───────────────────────────────────
+    checkScaleUp(starts, errors) {
+        // Already at max
+        if (this.currentAgentCount >= this.config.maxAgents)
+            return null;
+        // Error rate check
+        if (starts > 0) {
+            const errorRate = errors / starts;
+            if (errorRate >= this.config.scaleUpErrorRate) {
+                const headroom = this.config.maxAgents - this.currentAgentCount;
+                // Scale by ceil(currentCount * 0.5), capped by headroom
+                const addCount = Math.min(Math.max(1, Math.ceil(this.currentAgentCount * 0.5)), headroom);
+                return {
+                    action: "scale_up",
+                    count: addCount,
+                    reason: `error rate ${(errorRate * 100).toFixed(0)}% exceeds ${(this.config.scaleUpErrorRate * 100).toFixed(0)}% threshold`,
+                };
+            }
+        }
+        // Latency check
+        const metrics = this.tracer.metrics();
+        if (metrics.maxLatencyMs > this.config.scaleUpLatencyMs) {
+            const headroom = this.config.maxAgents - this.currentAgentCount;
+            const addCount = Math.min(Math.max(1, Math.ceil(this.currentAgentCount * 0.25)), headroom);
+            return {
+                action: "scale_up",
+                count: addCount,
+                reason: `max latency ${metrics.maxLatencyMs}ms exceeds ${this.config.scaleUpLatencyMs}ms threshold`,
+            };
+        }
+        return null;
+    }
+    // ── Scale-down checks ─────────────────────────────────
+    checkScaleDown(lastActivity) {
+        // Already at minimum
+        if (this.currentAgentCount <= this.config.minAgents)
+            return null;
+        // Check if all agents have been idle for scaleDownIdleSeconds
+        const now = Date.now();
+        const idleThresholdMs = this.config.scaleDownIdleSeconds * 1000;
+        if (lastActivity > 0 && now - lastActivity > idleThresholdMs) {
+            // All agents idle — reduce by half, respecting minAgents
+            const removeCount = Math.min(Math.max(1, Math.floor(this.currentAgentCount / 2)), this.currentAgentCount - this.config.minAgents);
+            if (removeCount > 0) {
+                return {
+                    action: "scale_down",
+                    count: removeCount,
+                    reason: `all agents idle for ${Math.round((now - lastActivity) / 1000)}s (threshold: ${this.config.scaleDownIdleSeconds}s)`,
+                };
+            }
+        }
+        return null;
+    }
+    // ── Decision recording ────────────────────────────────
+    /**
+     * Record a decision (for cooldown tracking and history).
+     * Call this after applying the decision from evaluate().
+     */
+    recordDecision(decision) {
+        this.lastDecision = decision;
+        if (decision.action !== "idle") {
+            this.lastDecisionTime = Date.now();
+        }
+        this.history.push({ decision, timestamp: Date.now() });
+    }
+    getHistory() {
+        return [...this.history];
+    }
+    // ── Reactive mode ─────────────────────────────────────
+    /**
+     * Register a callback that fires on non-idle scaling decisions.
+     */
+    onScaleDecision(callback) {
+        this.callbacks.add(callback);
+        return () => this.callbacks.delete(callback);
+    }
+    /**
+     * Enable reactive mode: subscribe to tracer events and auto-evaluate
+     * on error events. Non-idle decisions fire registered callbacks.
+     */
+    enableReactive() {
+        if (this.unsubscribeTracer)
+            return; // already enabled
+        this.unsubscribeTracer = this.tracer.subscribe((event) => {
+            // Only react to error events (scale-up signal)
+            // and complete events (potential scale-down signal)
+            if (event.type !== "agent_error" && event.type !== "agent_complete")
+                return;
+            const decision = this.evaluate();
+            if (decision.action !== "idle") {
+                this.recordDecision(decision);
+                for (const cb of this.callbacks) {
+                    try {
+                        cb(decision);
+                    }
+                    catch {
+                        // Callback errors must not disrupt monitoring
+                    }
+                }
+            }
+        });
+    }
+    /**
+     * Disable reactive mode. Stops listening to tracer events.
+     */
+    disableReactive() {
+        if (this.unsubscribeTracer) {
+            this.unsubscribeTracer();
+            this.unsubscribeTracer = null;
+        }
+    }
+    /** Clean up — disables reactive mode. */
+    dispose() {
+        this.disableReactive();
+        this.callbacks.clear();
+    }
+}
+//# sourceMappingURL=scaling.js.map

package/dist/swarm/scaling.js.map

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

package/dist/swarm/snapshot.d.ts

@@ -0,0 +1,51 @@
+import type { AgentRegistry, AgentManifestEntry } from "./registry.js";
+import type { SwarmTracer, SwarmEvent } from "./tracer.js";
+export interface SwarmSnapshot {
+    /** Unique snapshot ID. */
+    id: string;
+    /** Capture timestamp (ms since epoch). */
+    timestamp: number;
+    /** Deep copy of swarm state at capture time. */
+    state: Record<string, unknown>;
+    /** Agent statuses from registry (if provided at capture). */
+    agents?: AgentManifestEntry[];
+    /** Tracer event timeline (if provided at capture). */
+    timeline?: SwarmEvent[];
+    /** User-provided metadata. */
+    metadata?: Record<string, unknown>;
+}
+export interface SwarmSnapshotDiff {
+    /** Keys present in snapshot B but not A. */
+    added: string[];
+    /** Keys present in both but with different values. */
+    changed: string[];
+    /** Keys present in A but not B. */
+    removed: string[];
+    /** Keys present in both with identical values. */
+    unchanged: string[];
+}
+export interface SnapshotCaptureOptions {
+    registry?: AgentRegistry;
+    tracer?: SwarmTracer;
+    metadata?: Record<string, unknown>;
+}
+export declare class SwarmSnapshotStore {
+    private snapshots;
+    /**
+     * Capture a point-in-time snapshot of the swarm state.
+     * Returns the snapshot ID for later retrieval.
+     */
+    capture(state: Record<string, unknown>, opts?: SnapshotCaptureOptions): string;
+    /** Retrieve a snapshot by ID. Returns null if not found. */
+    restore(id: string): SwarmSnapshot | null;
+    /** List all snapshots ordered by timestamp ascending. */
+    list(): SwarmSnapshot[];
+    /**
+     * Compare state between two snapshots.
+     * Returns null if either snapshot ID is not found.
+     */
+    diff(idA: string, idB: string): SwarmSnapshotDiff | null;
+    /** Remove all stored snapshots. */
+    clear(): void;
+}
+//# sourceMappingURL=snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/swarm/snapshot.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM3D,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,EAAE,EAAU,MAAM,CAAC;IACnB,0CAA0C;IAC1C,SAAS,EAAG,MAAM,CAAC;IACnB,gDAAgD;IAChD,KAAK,EAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,6DAA6D;IAC7D,MAAM,CAAC,EAAK,kBAAkB,EAAE,CAAC;IACjC,sDAAsD;IACtD,QAAQ,CAAC,EAAG,UAAU,EAAE,CAAC;IACzB,8BAA8B;IAC9B,QAAQ,CAAC,EAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,KAAK,EAAM,MAAM,EAAE,CAAC;IACpB,sDAAsD;IACtD,OAAO,EAAI,MAAM,EAAE,CAAC;IACpB,mCAAmC;IACnC,OAAO,EAAI,MAAM,EAAE,CAAC;IACpB,kDAAkD;IAClD,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAG,aAAa,CAAC;IAC1B,MAAM,CAAC,EAAK,WAAW,CAAC;IACxB,QAAQ,CAAC,EAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAQD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,SAAS,CAAoC;IAErD;;;OAGG;IACH,OAAO,CACL,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,CAAC,EAAE,sBAAsB,GAC5B,MAAM;IAsBT,4DAA4D;IAC5D,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAIzC,yDAAyD;IACzD,IAAI,IAAI,aAAa,EAAE;IAIvB;;;OAGG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAgCxD,mCAAmC;IACnC,KAAK,IAAI,IAAI;CAGd"}

package/dist/swarm/snapshot.js

@@ -0,0 +1,115 @@
+// ============================================================
+// @oni.bot/core/swarm — SwarmSnapshotStore
+// ============================================================
+// Point-in-time capture of swarm state for debugging.
+// Captures state, agent statuses, tracer timeline, and metadata.
+// Supports listing, restoring, diffing, and clearing snapshots.
+// ============================================================
+// ----------------------------------------------------------------
+// SwarmSnapshotStore
+// ----------------------------------------------------------------
+let _counter = 0;
+export class SwarmSnapshotStore {
+    snapshots = new Map();
+    /**
+     * Capture a point-in-time snapshot of the swarm state.
+     * Returns the snapshot ID for later retrieval.
+     */
+    capture(state, opts) {
+        const id = `snap_${Date.now()}_${++_counter}`;
+        const snapshot = {
+            id,
+            timestamp: Date.now(),
+            state: structuredClone(state),
+        };
+        if (opts?.registry) {
+            snapshot.agents = opts.registry.manifest();
+        }
+        if (opts?.tracer) {
+            snapshot.timeline = opts.tracer.getTimeline();
+        }
+        if (opts?.metadata) {
+            snapshot.metadata = structuredClone(opts.metadata);
+        }
+        this.snapshots.set(id, snapshot);
+        return id;
+    }
+    /** Retrieve a snapshot by ID. Returns null if not found. */
+    restore(id) {
+        return this.snapshots.get(id) ?? null;
+    }
+    /** List all snapshots ordered by timestamp ascending. */
+    list() {
+        return [...this.snapshots.values()].sort((a, b) => a.timestamp - b.timestamp);
+    }
+    /**
+     * Compare state between two snapshots.
+     * Returns null if either snapshot ID is not found.
+     */
+    diff(idA, idB) {
+        const a = this.snapshots.get(idA);
+        const b = this.snapshots.get(idB);
+        if (!a || !b)
+            return null;
+        const keysA = new Set(Object.keys(a.state));
+        const keysB = new Set(Object.keys(b.state));
+        const added = [];
+        const changed = [];
+        const removed = [];
+        const unchanged = [];
+        for (const k of keysB) {
+            if (!keysA.has(k)) {
+                added.push(k);
+            }
+            else if (!deepEqual(a.state[k], b.state[k])) {
+                changed.push(k);
+            }
+            else {
+                unchanged.push(k);
+            }
+        }
+        for (const k of keysA) {
+            if (!keysB.has(k)) {
+                removed.push(k);
+            }
+        }
+        return { added, changed, removed, unchanged };
+    }
+    /** Remove all stored snapshots. */
+    clear() {
+        this.snapshots.clear();
+    }
+}
+// ----------------------------------------------------------------
+// Helpers
+// ----------------------------------------------------------------
+function deepEqual(a, b, seen = new WeakSet()) {
+    if (a === b)
+        return true;
+    if (a === null || b === null)
+        return false;
+    if (typeof a !== typeof b)
+        return false;
+    if (typeof a !== "object")
+        return false;
+    // Cycle guard: if we've already started comparing this object, assume equal
+    // (the non-cyclic portions have already matched at earlier recursion levels)
+    if (seen.has(a))
+        return true;
+    seen.add(a);
+    if (Array.isArray(a)) {
+        if (!Array.isArray(b))
+            return false;
+        if (a.length !== b.length)
+            return false;
+        return a.every((v, i) => deepEqual(v, b[i], seen));
+    }
+    const objA = a;
+    const objB = b;
+    const keysA = Object.keys(objA);
+    const keysB = Object.keys(objB);
+    if (keysA.length !== keysB.length)
+        return false;
+    return keysA.every((k) => deepEqual(objA[k], objB[k], seen));
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/swarm/snapshot.js.map

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

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

@@ -1 +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"}
+{"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;AAQnD,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,CA6HX"}

package/dist/swarm/supervisor.js

@@ -7,17 +7,42 @@
 // ============================================================
 import { END } from "../types.js";
 import { Command } from "../types.js";
+import { ONIError } from "../errors.js";
 // ----------------------------------------------------------------
 // createSupervisorNode — factory that returns a NodeFn
 // ----------------------------------------------------------------
 export function createSupervisorNode(registry, config) {
+    // Validate config
+    if (config.strategy === "llm" && !config.model) {
+        throw new ONIError('Strategy "llm" requires a model to be provided.', { code: "ONI_SWARM_CONFIG", category: "SWARM", recoverable: false });
+    }
     const maxRounds = config.maxRounds ?? 10;
+    const deadlineMs = config.deadlineMs;
+    const autoRecover = config.autoRecover ?? false;
     return async (state) => {
         const round = state.supervisorRound ?? 0;
         const task = String(state[config.taskField] ?? "");
+        // Deadline is computed at invoke-time: on round 0, set the absolute deadline in context.
+        // On subsequent rounds, read it from context. This ensures each invoke() gets a fresh deadline.
+        let deadlineAbsolute = null;
+        if (deadlineMs != null) {
+            const ctx = (state.context ?? {});
+            if (round === 0 || ctx.__deadlineAbsolute === undefined) {
+                deadlineAbsolute = Date.now() + deadlineMs;
+            }
+            else {
+                deadlineAbsolute = ctx.__deadlineAbsolute;
+            }
+        }
+        // Guard: deadline expired
+        if (deadlineAbsolute != null && Date.now() >= deadlineAbsolute) {
+            return new Command({
+                update: { supervisorRound: round },
+                goto: END,
+            });
+        }
         // Guard: max rounds
         if (round >= maxRounds || state.done) {
-            console.log(`[supervisor] round=${round} → END`);
             return new Command({
                 update: { supervisorRound: round },
                 goto: END,
@@ -30,6 +55,34 @@ export function createSupervisorNode(registry, config) {
         const rawCtx = (config.contextField ? state[config.contextField] : {});
         // Enrich context with supervisorRound so rules/LLM can inspect the current round
         const ctx = { ...rawCtx, supervisorRound: round };
+        // Auto-recovery: if lastAgentError exists and autoRecover is enabled,
+        // find an idle agent with matching capabilities
+        if (autoRecover && ctx.lastAgentError) {
+            const errorCtx = ctx.lastAgentError;
+            const failedAgent = registry.get(errorCtx.agent);
+            if (failedAgent) {
+                const failedCaps = new Set(failedAgent.def.capabilities.map((c) => c.name.toLowerCase()));
+                if (failedCaps.size > 0) {
+                    // Find an idle agent with matching capability (not the failed agent)
+                    const idle = registry.findIdle().filter((a) => a.def.id !== errorCtx.agent);
+                    const match = idle.find((a) => a.def.capabilities.some((c) => failedCaps.has(c.name.toLowerCase())));
+                    if (match) {
+                        return new Command({
+                            update: {
+                                supervisorRound: round + 1,
+                                currentAgent: match.def.id,
+                                context: { ...rawCtx, lastAgentError: undefined },
+                                messages: [
+                                    ...state.messages,
+                                    { role: "system", content: `Supervisor auto-recovering to: ${match.def.role}` },
+                                ],
+                            },
+                            goto: match.def.id,
+                        });
+                    }
+                }
+            }
+        }
         // Route to next agent
         let targetAgentId = null;
         switch (config.strategy) {
@@ -42,21 +95,22 @@ export function createSupervisorNode(registry, config) {
             case "round-robin":
                 targetAgentId = routeRoundRobin(registry, round);
                 break;
+            case "capability":
+                targetAgentId = routeViaCapability(ctx, registry);
+                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,
+                ...(deadlineAbsolute != null ? { context: { ...rawCtx, __deadlineAbsolute: deadlineAbsolute } } : {}),
                 messages: [
                     ...state.messages,
                     { role: "system", content: `Supervisor routing to: ${agentDef.role}` },
@@ -114,4 +168,28 @@ function routeRoundRobin(registry, round) {
     }
     return agents[round % agents.length].def.id;
 }
+function routeViaCapability(context, registry) {
+    const required = context.requiredCapabilities;
+    if (!required || required.length === 0)
+        return null;
+    const all = registry.getAll().filter((a) => a.status !== "terminated");
+    if (!all.length)
+        return null;
+    // Score each agent by how many required capabilities it matches
+    let bestId = null;
+    let bestScore = 0;
+    for (const agent of all) {
+        const capNames = new Set(agent.def.capabilities.map((c) => c.name.toLowerCase()));
+        let score = 0;
+        for (const req of required) {
+            if (capNames.has(req.toLowerCase()))
+                score++;
+        }
+        if (score > bestScore) {
+            bestScore = score;
+            bestId = agent.def.id;
+        }
+    }
+    return bestScore > 0 ? bestId : null;
+}
 //# sourceMappingURL=supervisor.js.map