@cogitator-ai/swarms 0.4.19 → 0.5.1

package/dist/assessor/task-analyzer.js

@@ -7,10 +7,6 @@ const VISION_KEYWORDS = [
     'chart',
     'graph',
     'visual',
-    'see',
-    'look at',
-    'analyze this',
-    'show me',
     'drawing',
     'illustration',
     'png',
@@ -23,17 +19,12 @@ const TOOL_KEYWORDS = [
     'search',
     'calculate',
     'execute',
-    'run',
     'fetch',
     'api',
     'database',
-    'file',
-    'code',
     'browse',
     'query',
-    'call',
     'invoke',
-    'request',
     'download',
     'upload',
     'scrape',
@@ -96,10 +87,10 @@ export class TaskAnalyzer {
         };
     }
     detectVision(task) {
-        return VISION_KEYWORDS.some((k) => task.includes(k));
+        return VISION_KEYWORDS.some((k) => new RegExp(`\\b${k}\\b`, 'i').test(task));
     }
     detectToolNeeds(task) {
-        return TOOL_KEYWORDS.some((k) => task.includes(k));
+        return TOOL_KEYWORDS.some((k) => new RegExp(`\\b${k}\\b`, 'i').test(task));
     }
     detectLongContext(task) {
         const wordCount = task.split(/\s+/).length;
@@ -107,14 +98,9 @@ export class TaskAnalyzer {
             return true;
         const longContextIndicators = [
             'document',
-            'file',
             'codebase',
             'repository',
-            'large',
             'entire',
-            'full',
-            'complete',
-            'all of',
             'whole',
             'multiple files',
             'many pages',
@@ -141,11 +127,10 @@ export class TaskAnalyzer {
         return 'balanced';
     }
     detectCostSensitivity(task) {
-        const lower = task;
-        if (/\b(cheap|free|budget|low.?cost|economical)\b/.test(lower)) {
+        if (/\b(cheap|free|budget|low.?cost|economical)\b/.test(task)) {
             return 'high';
         }
-        if (/\b(best|premium|quality|accurate|precise)\b/.test(lower)) {
+        if (/\b(best|premium|quality|accurate|precise)\b/.test(task)) {
             return 'low';
         }
         return 'medium';

package/dist/assessor/task-analyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-analyzer.js","sourceRoot":"","sources":["../../src/assessor/task-analyzer.ts"],"names":[],"mappings":"AAQA,MAAM,eAAe,GAAG;IACtB,OAAO;IACP,OAAO;IACP,SAAS;IACT,YAAY;IACZ,SAAS;IACT,OAAO;IACP,OAAO;IACP,QAAQ;IACR,KAAK;IACL,SAAS;IACT,cAAc;IACd,SAAS;IACT,SAAS;IACT,cAAc;IACd,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;CACN,CAAC;AAEF,MAAM,aAAa,GAAG;IACpB,QAAQ;IACR,WAAW;IACX,SAAS;IACT,KAAK;IACL,OAAO;IACP,KAAK;IACL,UAAU;IACV,MAAM;IACN,MAAM;IACN,QAAQ;IACR,OAAO;IACP,MAAM;IACN,QAAQ;IACR,SAAS;IACT,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,OAAO;CACR,CAAC;AAEF,MAAM,2BAA2B,GAAG;IAClC,SAAS;IACT,SAAS;IACT,UAAU;IACV,YAAY;IACZ,UAAU;IACV,QAAQ;IACR,WAAW;IACX,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,OAAO;IACP,QAAQ;IACR,eAAe;IACf,YAAY;IACZ,WAAW;CACZ,CAAC;AAEF,MAAM,2BAA2B,GAAG;IAClC,SAAS;IACT,WAAW;IACX,UAAU;IACV,SAAS;IACT,MAAM;IACN,YAAY;IACZ,UAAU;IACV,UAAU;IACV,MAAM;CACP,CAAC;AAEF,MAAM,cAAc,GAAG;IACrB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC;IAC1E,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,CAAC;CACpF,CAAC;AAEF,MAAM,eAAe,GAA2B;IAC9C,IAAI,EAAE,oIAAoI;IAC1I,IAAI,EAAE,kGAAkG;IACxG,QAAQ,EACN,+FAA+F;IACjG,QAAQ,EAAE,sFAAsF;IAChG,KAAK,EAAE,gFAAgF;IACvF,OAAO,EAAE,sFAAsF;IAC/F,OAAO,EAAE,oFAAoF;CAC9F,CAAC;AAEF,MAAM,OAAO,YAAY;IACvB,OAAO,CAAC,IAAY;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAEjC,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;YACrC,gBAAgB,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;YAC7C,gBAAgB,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC;YAC9C,cAAc,EAAE,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC;YAChD,UAAU,EAAE,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC;YACxC,eAAe,EAAE,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC;YAClD,UAAU,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;YACvC,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;SAClC,CAAC;IACJ,CAAC;IAEO,YAAY,CAAC,IAAY;QAC/B,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IAEO,eAAe,CAAC,IAAY;QAClC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IAEO,iBAAiB,CAAC,IAAY;QACpC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;QAC3C,IAAI,SAAS,GAAG,GAAG;YAAE,OAAO,IAAI,CAAC;QAEjC,MAAM,qBAAqB,GAAG;YAC5B,UAAU;YACV,MAAM;YACN,UAAU;YACV,YAAY;YACZ,OAAO;YACP,QAAQ;YACR,MAAM;YACN,UAAU;YACV,QAAQ;YACR,OAAO;YACP,gBAAgB;YAChB,YAAY;SACb,CAAC;QACF,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACjC,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC;IAEO,oBAAoB,CAAC,IAAY;QACvC,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,gBAAgB,CAAC,IAAY;QACnC,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,qBAAqB,CAAC,IAAY;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC;QACnB,IAAI,8CAA8C,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/D,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,6CAA6C,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9D,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,gBAAgB,CAAC,IAAY;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;QAC3C,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QAC1E,MAAM,gBAAgB,GAAG,wDAAwD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7F,MAAM,aAAa,GAAG,2CAA2C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE7E,IAAI,eAAe,GAAG,CAAC,CAAC;QACxB,IAAI,SAAS,GAAG,GAAG;YAAE,eAAe,EAAE,CAAC;QACvC,IAAI,SAAS,GAAG,GAAG;YAAE,eAAe,EAAE,CAAC;QACvC,IAAI,aAAa,GAAG,CAAC;YAAE,eAAe,EAAE,CAAC;QACzC,IAAI,gBAAgB;YAAE,eAAe,EAAE,CAAC;QACxC,IAAI,aAAa;YAAE,eAAe,EAAE,CAAC;QAErC,IAAI,eAAe,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3C,IAAI,eAAe,IAAI,CAAC;YAAE,OAAO,UAAU,CAAC;QAC5C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,aAAa,CAAC,IAAY;QAChC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;YAChE,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}
+{"version":3,"file":"task-analyzer.js","sourceRoot":"","sources":["../../src/assessor/task-analyzer.ts"],"names":[],"mappings":"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"}

package/dist/base-coordinator.d.ts

@@ -0,0 +1,117 @@
+import type { Agent, SwarmConfig, SwarmAgent, SwarmAgentMetadata, SwarmAgentRunOptions, SwarmResourceUsage, RunResult, SwarmEventEmitter, SwarmCoordinatorInterface, Tool } from '@cogitator-ai/types';
+import type { ReadTrackingMessageBus } from './communication/message-bus.js';
+import type { ObservableBlackboard } from './communication/blackboard.js';
+import { ResourceTracker } from './resources/tracker.js';
+type RetryConfig = NonNullable<NonNullable<SwarmConfig['errorHandling']>['retry']>;
+export interface SwarmRunScope {
+    /** Base thread id; each agent gets its own `${threadId}:${agentName}` thread */
+    threadId?: string;
+    /** Signal that cancels every agent run of the current swarm run */
+    signal?: AbortSignal;
+}
+export interface SwarmCommunication<Bus extends ReadTrackingMessageBus = ReadTrackingMessageBus, Board extends ObservableBlackboard = ObservableBlackboard, Events extends SwarmEventEmitter = SwarmEventEmitter> {
+    messageBus: Bus;
+    blackboard: Board;
+    events: Events;
+}
+/**
+ * Everything an execution engine needs to run one agent turn.
+ */
+export interface AgentRunRequest {
+    swarmAgent: SwarmAgent;
+    /** Agent to execute, with `resources.perAgent` limits applied */
+    agent: Agent;
+    input: string;
+    /** Full run context including swarm, message and negotiation context */
+    context: Record<string, unknown>;
+    signal: AbortSignal;
+    threadId?: string;
+    timeout?: number;
+    saveHistory: boolean;
+}
+/**
+ * Shared coordination logic for local and distributed swarms: agent registry, budgets,
+ * circuit breaking, error recovery, pause/abort, parallel scheduling and observability.
+ * Subclasses only decide how a single agent turn is executed.
+ */
+export declare abstract class BaseSwarmCoordinator<Bus extends ReadTrackingMessageBus = ReadTrackingMessageBus, Board extends ObservableBlackboard = ObservableBlackboard, Events extends SwarmEventEmitter = SwarmEventEmitter> implements SwarmCoordinatorInterface {
+    protected readonly config: SwarmConfig;
+    protected readonly swarmId: string;
+    protected readonly agents: Map<string, SwarmAgent>;
+    protected readonly communication: SwarmCommunication<Bus, Board, Events>;
+    protected resourceTracker: ResourceTracker;
+    protected saveHistory: boolean;
+    private circuitBreaker?;
+    private limitedAgents;
+    private injectedTools;
+    private abortController;
+    private runScope;
+    private paused;
+    protected constructor(config: SwarmConfig, swarmId: string, communication: SwarmCommunication<Bus, Board, Events>);
+    /**
+     * Execute a single agent turn. Implementations must honour `request.signal`.
+     */
+    protected abstract executeRun(request: AgentRunRequest): Promise<RunResult>;
+    /**
+     * Hook for engines that need asynchronous setup before the first agent run.
+     */
+    protected prepare(): Promise<void>;
+    get messageBus(): Bus;
+    get blackboard(): Board;
+    get events(): Events;
+    setSaveHistory(value: boolean): void;
+    getSwarmId(): string;
+    getAgent(name: string): SwarmAgent | undefined;
+    getAgents(): SwarmAgent[];
+    getAgentsByRole(role: SwarmAgentMetadata['role']): SwarmAgent[];
+    getResourceUsage(): SwarmResourceUsage;
+    /**
+     * Start a new swarm run: resource budgets are per run, so usage counters restart here.
+     */
+    beginRun(scope?: SwarmRunScope): void;
+    endRun(): void;
+    pause(): void;
+    resume(): void;
+    /**
+     * Abort the swarm: pending agent runs are rejected and in-flight runs are cancelled.
+     */
+    abort(): void;
+    isAborted(): boolean;
+    isPaused(): boolean;
+    reset(): void;
+    runAgent(agentName: string, input: string, context?: Record<string, unknown>, options?: SwarmAgentRunOptions): Promise<RunResult>;
+    runAgentsParallel(agents: {
+        name: string;
+        input: string;
+        context?: Record<string, unknown>;
+    }[], maxConcurrency?: number): Promise<Map<string, RunResult>>;
+    private runAgentWithRecovery;
+    private requireAgent;
+    private ensureRunnable;
+    protected isCancelled(): boolean;
+    private currentSignal;
+    private executeAgent;
+    /**
+     * Tools a strategy needs an agent to have: the supervisor of a hierarchical swarm gets the
+     * delegation tools, negotiating agents get the negotiation tools. Tools the agent already
+     * defines (by name) are left untouched. Engines that cannot ship tool implementations
+     * (e.g. remote workers) override this.
+     */
+    protected strategyTools(swarmAgent: SwarmAgent): Tool[];
+    private missingStrategyTools;
+    /**
+     * The agent actually executed for a turn: a cached clone when strategy tools,
+     * `resources.perAgent` limits or per-turn token caps apply, otherwise the agent itself.
+     */
+    private getRunnableAgent;
+    private handleAgentError;
+    private retryAgentRun;
+    private setAgentState;
+    private wireObservability;
+    private collectIncomingMessages;
+    private buildNegotiationContext;
+}
+export declare function computeBackoffDelay(backoff: RetryConfig['backoff'], attempt: number, initialDelay: number, maxDelay: number): number;
+export declare function toError(error: unknown): Error;
+export {};
+//# sourceMappingURL=base-coordinator.d.ts.map

package/dist/base-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-coordinator.d.ts","sourceRoot":"","sources":["../src/base-coordinator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,KAAK,EAEL,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EAEpB,kBAAkB,EAClB,SAAS,EACT,iBAAiB,EACjB,yBAAyB,EAIzB,IAAI,EACL,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAOtD,KAAK,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AAEnF,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB,CACjC,GAAG,SAAS,sBAAsB,GAAG,sBAAsB,EAC3D,KAAK,SAAS,oBAAoB,GAAG,oBAAoB,EACzD,MAAM,SAAS,iBAAiB,GAAG,iBAAiB;IAEpD,UAAU,EAAE,GAAG,CAAC;IAChB,UAAU,EAAE,KAAK,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,UAAU,CAAC;IACvB,iEAAiE;IACjE,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,8BAAsB,oBAAoB,CACxC,GAAG,SAAS,sBAAsB,GAAG,sBAAsB,EAC3D,KAAK,SAAS,oBAAoB,GAAG,oBAAoB,EACzD,MAAM,SAAS,iBAAiB,GAAG,iBAAiB,CACpD,YAAW,yBAAyB;IACpC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IACvC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACnC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnD,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACzE,SAAS,CAAC,eAAe,EAAE,eAAe,CAAC;IAC3C,SAAS,CAAC,WAAW,UAAQ;IAC7B,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,MAAM,CAAS;IAEvB,SAAS,aACP,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,kBAAkB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC;IAkBvD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAE3E;;OAEG;cACa,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAExC,IAAI,UAAU,IAAI,GAAG,CAEpB;IAED,IAAI,UAAU,IAAI,KAAK,CAEtB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAIpC,UAAU,IAAI,MAAM;IAIpB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI9C,SAAS,IAAI,UAAU,EAAE;IAIzB,eAAe,CAAC,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAAG,UAAU,EAAE;IAI/D,gBAAgB,IAAI,kBAAkB;IAItC;;OAEG;IACH,QAAQ,CAAC,KAAK,GAAE,aAAkB,GAAG,IAAI;IAKzC,MAAM,IAAI,IAAI;IAId,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb,SAAS,IAAI,OAAO;IAIpB,QAAQ,IAAI,OAAO;IAInB,KAAK,IAAI,IAAI;IAkBP,QAAQ,CACZ,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,SAAS,CAAC;IAIf,iBAAiB,CACrB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE,EAC5E,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAkCpB,oBAAoB;IA2BlC,OAAO,CAAC,YAAY;YAQN,cAAc;IAoB5B,SAAS,CAAC,WAAW,IAAI,OAAO;IAIhC,OAAO,CAAC,aAAa;YAOP,YAAY;IAsD1B;;;;;OAKG;IACH,SAAS,CAAC,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,EAAE;IAyBvD,OAAO,CAAC,oBAAoB;IAU5B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;YAuBV,gBAAgB;YA6ChB,aAAa;IA6B3B,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,iBAAiB;IAyDzB,OAAO,CAAC,uBAAuB;IAoB/B,OAAO,CAAC,uBAAuB;CAoChC;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,EAC/B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,CASR;AAYD,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAE7C"}

package/dist/base-coordinator.js

@@ -0,0 +1,455 @@
+import { nanoid } from 'nanoid';
+import { getLogger } from '@cogitator-ai/core';
+import { ResourceTracker } from './resources/tracker.js';
+import { CircuitBreaker } from './resources/circuit-breaker.js';
+import { buildSwarmAgents } from './agents.js';
+import { runWithConcurrency } from './utils/concurrency.js';
+import { createDelegationTools } from './tools/delegation.js';
+import { createNegotiationTools } from './tools/negotiation.js';
+/**
+ * Shared coordination logic for local and distributed swarms: agent registry, budgets,
+ * circuit breaking, error recovery, pause/abort, parallel scheduling and observability.
+ * Subclasses only decide how a single agent turn is executed.
+ */
+export class BaseSwarmCoordinator {
+    config;
+    swarmId;
+    agents;
+    communication;
+    resourceTracker;
+    saveHistory = true;
+    circuitBreaker;
+    limitedAgents = new Map();
+    injectedTools = new Map();
+    abortController = new AbortController();
+    runScope = {};
+    paused = false;
+    constructor(config, swarmId, communication) {
+        this.config = config;
+        this.swarmId = swarmId;
+        this.communication = communication;
+        this.agents = buildSwarmAgents(config);
+        this.resourceTracker = new ResourceTracker(config.resources ?? {});
+        if (config.errorHandling?.circuitBreaker?.enabled) {
+            this.circuitBreaker = new CircuitBreaker({
+                threshold: config.errorHandling.circuitBreaker.threshold,
+                resetTimeout: config.errorHandling.circuitBreaker.resetTimeout,
+            });
+        }
+        this.wireObservability();
+    }
+    /**
+     * Hook for engines that need asynchronous setup before the first agent run.
+     */
+    async prepare() { }
+    get messageBus() {
+        return this.communication.messageBus;
+    }
+    get blackboard() {
+        return this.communication.blackboard;
+    }
+    get events() {
+        return this.communication.events;
+    }
+    setSaveHistory(value) {
+        this.saveHistory = value;
+    }
+    getSwarmId() {
+        return this.swarmId;
+    }
+    getAgent(name) {
+        return this.agents.get(name);
+    }
+    getAgents() {
+        return Array.from(this.agents.values());
+    }
+    getAgentsByRole(role) {
+        return this.getAgents().filter((a) => a.metadata.role === role);
+    }
+    getResourceUsage() {
+        return this.resourceTracker.getUsage();
+    }
+    /**
+     * Start a new swarm run: resource budgets are per run, so usage counters restart here.
+     */
+    beginRun(scope = {}) {
+        this.runScope = scope;
+        this.resourceTracker.reset();
+    }
+    endRun() {
+        this.runScope = {};
+    }
+    pause() {
+        this.paused = true;
+    }
+    resume() {
+        this.paused = false;
+    }
+    /**
+     * Abort the swarm: pending agent runs are rejected and in-flight runs are cancelled.
+     */
+    abort() {
+        this.abortController.abort(new Error('Swarm execution aborted'));
+    }
+    isAborted() {
+        return this.abortController.signal.aborted;
+    }
+    isPaused() {
+        return this.paused;
+    }
+    reset() {
+        this.abortController = new AbortController();
+        this.paused = false;
+        this.runScope = {};
+        this.resourceTracker.reset();
+        this.circuitBreaker?.reset();
+        for (const agent of this.agents.values()) {
+            agent.state = 'idle';
+            agent.lastResult = undefined;
+            agent.messageCount = 0;
+            agent.tokenCount = 0;
+        }
+        this.messageBus.clear();
+        this.blackboard.clear();
+    }
+    async runAgent(agentName, input, context, options) {
+        return this.runAgentWithRecovery(agentName, input, context, options ?? {}, new Set());
+    }
+    async runAgentsParallel(agents, maxConcurrency) {
+        const concurrency = Math.max(1, maxConcurrency ?? this.config.resources?.maxConcurrency ?? 4);
+        const tolerateFailures = this.config.errorHandling?.onAgentFailure === 'skip' ||
+            this.config.errorHandling?.partialResults === true;
+        const outcomes = await runWithConcurrency(agents, concurrency, ({ name, input, context }) => this.runAgent(name, input, context), { stopOnFailure: !tolerateFailures });
+        const results = new Map();
+        let firstError;
+        let failures = 0;
+        outcomes.forEach((outcome, index) => {
+            if (!outcome)
+                return;
+            if (outcome.status === 'fulfilled') {
+                results.set(agents[index].name, outcome.value);
+            }
+            else {
+                failures++;
+                firstError ??= outcome.reason;
+            }
+        });
+        if (failures > 0 && (!tolerateFailures || results.size === 0)) {
+            throw firstError;
+        }
+        return results;
+    }
+    async runAgentWithRecovery(agentName, input, context, options, failoverChain) {
+        const swarmAgent = this.requireAgent(agentName);
+        await this.ensureRunnable();
+        try {
+            return await this.executeAgent(swarmAgent, input, context, options);
+        }
+        catch (error) {
+            if (!this.config.errorHandling || this.isCancelled()) {
+                throw error;
+            }
+            return this.handleAgentError(swarmAgent, input, context, options, toError(error), failoverChain);
+        }
+    }
+    requireAgent(agentName) {
+        const swarmAgent = this.agents.get(agentName);
+        if (!swarmAgent) {
+            throw new Error(`Agent '${agentName}' not found in swarm`);
+        }
+        return swarmAgent;
+    }
+    async ensureRunnable() {
+        await this.prepare();
+        if (this.circuitBreaker && !this.circuitBreaker.canExecute()) {
+            throw new Error(`Circuit breaker is open for swarm '${this.config.name}'`);
+        }
+        if (!this.resourceTracker.isWithinBudget()) {
+            throw new Error('Swarm resource budget exceeded');
+        }
+        while (this.paused && !this.isCancelled()) {
+            await new Promise((r) => setTimeout(r, 100));
+        }
+        if (this.isCancelled()) {
+            throw new Error('Swarm execution aborted');
+        }
+    }
+    isCancelled() {
+        return this.abortController.signal.aborted || this.runScope.signal?.aborted === true;
+    }
+    currentSignal() {
+        const runSignal = this.runScope.signal;
+        return runSignal
+            ? AbortSignal.any([this.abortController.signal, runSignal])
+            : this.abortController.signal;
+    }
+    async executeAgent(swarmAgent, input, context, options) {
+        const agentName = swarmAgent.agent.name;
+        this.setAgentState(agentName, 'running');
+        this.messageBus.resetTurnCounts(agentName);
+        this.events.emit('agent:start', { agentName, input }, agentName);
+        try {
+            const incomingMessages = this.collectIncomingMessages(agentName);
+            const negotiationContext = this.buildNegotiationContext(agentName);
+            const result = await this.executeRun({
+                swarmAgent,
+                agent: this.getRunnableAgent(swarmAgent, options.maxTokens),
+                input,
+                signal: this.currentSignal(),
+                saveHistory: this.saveHistory,
+                threadId: this.runScope.threadId ? `${this.runScope.threadId}:${agentName}` : undefined,
+                timeout: minDefined(this.config.resources?.perAgent?.timeout, options.timeout),
+                context: {
+                    ...context,
+                    swarmContext: {
+                        swarmId: this.swarmId,
+                        swarmName: this.config.name,
+                        agentRole: swarmAgent.metadata.role,
+                        availableAgents: Array.from(this.agents.keys()).filter((n) => n !== agentName),
+                    },
+                    ...(incomingMessages && { _incomingMessages: incomingMessages }),
+                    ...(negotiationContext && { _negotiation: negotiationContext }),
+                },
+            });
+            this.setAgentState(agentName, 'completed');
+            swarmAgent.lastResult = result;
+            swarmAgent.tokenCount += result.usage.totalTokens;
+            this.resourceTracker.trackAgentRun(agentName, result);
+            this.circuitBreaker?.recordSuccess();
+            this.events.emit('agent:complete', { agentName, result }, agentName);
+            return result;
+        }
+        catch (error) {
+            this.setAgentState(agentName, 'failed');
+            this.circuitBreaker?.recordFailure();
+            this.events.emit('agent:error', { agentName, error }, agentName);
+            throw error;
+        }
+    }
+    /**
+     * Tools a strategy needs an agent to have: the supervisor of a hierarchical swarm gets the
+     * delegation tools, negotiating agents get the negotiation tools. Tools the agent already
+     * defines (by name) are left untouched. Engines that cannot ship tool implementations
+     * (e.g. remote workers) override this.
+     */
+    strategyTools(swarmAgent) {
+        const name = swarmAgent.agent.name;
+        const role = swarmAgent.metadata.role;
+        switch (this.config.strategy) {
+            case 'hierarchical':
+                return role === 'supervisor'
+                    ? Object.values(createDelegationTools(this, this.blackboard, name))
+                    : [];
+            case 'negotiation':
+                return role === 'supervisor' || role === 'moderator'
+                    ? []
+                    : Object.values(createNegotiationTools(this.blackboard, this.events, name, swarmAgent.metadata.weight ?? this.config.negotiation?.weights?.[name] ?? 1));
+            default:
+                return [];
+        }
+    }
+    missingStrategyTools(swarmAgent) {
+        let tools = this.injectedTools.get(swarmAgent.agent.name);
+        if (!tools) {
+            const existing = new Set(swarmAgent.agent.tools.map((t) => t.name));
+            tools = this.strategyTools(swarmAgent).filter((t) => !existing.has(t.name));
+            this.injectedTools.set(swarmAgent.agent.name, tools);
+        }
+        return tools;
+    }
+    /**
+     * The agent actually executed for a turn: a cached clone when strategy tools,
+     * `resources.perAgent` limits or per-turn token caps apply, otherwise the agent itself.
+     */
+    getRunnableAgent(swarmAgent, turnMaxTokens) {
+        const perAgent = this.config.resources?.perAgent;
+        const { maxIterations, maxTokens } = swarmAgent.agent.config;
+        const iterationLimit = minDefined(maxIterations, perAgent?.maxIterations);
+        const tokenLimit = minDefined(maxTokens, perAgent?.maxTokens, turnMaxTokens);
+        const extraTools = this.missingStrategyTools(swarmAgent);
+        const overrides = {};
+        if (iterationLimit !== maxIterations)
+            overrides.maxIterations = iterationLimit;
+        if (tokenLimit !== maxTokens)
+            overrides.maxTokens = tokenLimit;
+        if (extraTools.length > 0)
+            overrides.tools = [...swarmAgent.agent.tools, ...extraTools];
+        if (Object.keys(overrides).length === 0)
+            return swarmAgent.agent;
+        const cacheKey = `${swarmAgent.agent.name}|${iterationLimit ?? ''}|${tokenLimit ?? ''}`;
+        let runnable = this.limitedAgents.get(cacheKey);
+        if (!runnable) {
+            runnable = swarmAgent.agent.clone(overrides);
+            this.limitedAgents.set(cacheKey, runnable);
+        }
+        return runnable;
+    }
+    async handleAgentError(swarmAgent, input, context, options, error, failoverChain) {
+        const errorConfig = this.config.errorHandling;
+        const agentName = swarmAgent.agent.name;
+        switch (errorConfig.onAgentFailure) {
+            case 'retry':
+                if (errorConfig.retry && errorConfig.retry.maxRetries > 0) {
+                    return this.retryAgentRun(swarmAgent, input, context, options, errorConfig.retry, error);
+                }
+                throw error;
+            case 'failover': {
+                failoverChain.add(agentName);
+                const backupAgentName = errorConfig.failover?.[agentName];
+                if (backupAgentName && !failoverChain.has(backupAgentName)) {
+                    return this.runAgentWithRecovery(backupAgentName, input, context, options, failoverChain);
+                }
+                throw error;
+            }
+            case 'skip':
+                return {
+                    output: '',
+                    runId: `run_skipped_${nanoid(8)}`,
+                    agentId: swarmAgent.agent.id,
+                    threadId: '',
+                    usage: { inputTokens: 0, outputTokens: 0, totalTokens: 0, cost: 0, duration: 0 },
+                    toolCalls: [],
+                    messages: [],
+                    trace: { traceId: `trace_${nanoid(12)}`, spans: [] },
+                };
+            case 'abort':
+            default:
+                throw error;
+        }
+    }
+    async retryAgentRun(swarmAgent, input, context, options, retryConfig, initialError) {
+        const { maxRetries, backoff, initialDelay = 1000, maxDelay = 30000 } = retryConfig;
+        let lastError = initialError;
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            await sleep(computeBackoffDelay(backoff, attempt, initialDelay, maxDelay));
+            await this.ensureRunnable();
+            try {
+                return await this.executeAgent(swarmAgent, input, context, options);
+            }
+            catch (error) {
+                lastError = toError(error);
+                if (this.isCancelled())
+                    throw lastError;
+            }
+        }
+        throw new Error(`Agent '${swarmAgent.agent.name}' failed after ${maxRetries} retries: ${lastError.message}`, { cause: lastError });
+    }
+    setAgentState(agentName, state) {
+        const agent = this.agents.get(agentName);
+        if (agent) {
+            agent.state = state;
+        }
+    }
+    wireObservability() {
+        const observability = this.config.observability;
+        const logger = getLogger();
+        this.messageBus.onMessage((message) => {
+            const sender = this.agents.get(message.from);
+            if (sender)
+                sender.messageCount++;
+            this.events.emit('message:sent', {
+                id: message.id,
+                from: message.from,
+                to: message.to,
+                type: message.type,
+                channel: message.channel,
+                content: message.content,
+            }, message.from);
+            if (observability?.messageLogging) {
+                logger.info('[Swarm] message', {
+                    swarm: this.config.name,
+                    from: message.from,
+                    to: message.to,
+                    type: message.type,
+                    channel: message.channel,
+                    content: message.content,
+                });
+            }
+        });
+        this.blackboard.onWrite((write) => {
+            this.events.emit('blackboard:write', {
+                section: write.section,
+                version: write.version,
+                writtenBy: write.agentName,
+                deleted: write.deleted ?? false,
+            }, write.agentName);
+            if (observability?.blackboardLogging) {
+                logger.info('[Swarm] blackboard write', {
+                    swarm: this.config.name,
+                    section: write.section,
+                    version: write.version,
+                    writtenBy: write.agentName,
+                    deleted: write.deleted ?? false,
+                });
+            }
+        });
+    }
+    collectIncomingMessages(agentName) {
+        const unread = this.messageBus.getUnreadMessages(agentName);
+        if (unread.length === 0)
+            return null;
+        const ids = unread.map((m) => m.id);
+        this.messageBus.markAsRead(agentName, ids);
+        this.events.emit('message:received', { agentName, count: unread.length, messageIds: ids }, agentName);
+        const formatted = unread.map((m) => {
+            const timestamp = new Date(m.timestamp).toISOString();
+            return `[${timestamp}] ${m.from} → ${m.to}: ${m.content}`;
+        });
+        return `\n--- Incoming Messages ---\n${formatted.join('\n')}\n---`;
+    }
+    buildNegotiationContext(agentName) {
+        if (!this.blackboard.has('negotiation'))
+            return null;
+        const state = this.blackboard.read('negotiation');
+        const pendingOffers = state.offers.filter((o) => o.status === 'pending');
+        const offersToMe = pendingOffers.filter((o) => {
+            const recipients = Array.isArray(o.to) ? o.to : [o.to];
+            return recipients.includes(agentName);
+        });
+        const myOffers = pendingOffers.filter((o) => o.from === agentName);
+        return {
+            phase: state.phase,
+            round: state.round,
+            maxRounds: state.maxRounds,
+            isMyTurn: state.currentTurn === agentName || state.currentTurn === null,
+            currentTurn: state.currentTurn,
+            offersAwaitingMyResponse: offersToMe.map((o) => ({
+                id: o.id,
+                from: o.from,
+                reasoning: o.reasoning,
+                terms: o.terms,
+            })),
+            myPendingOffers: myOffers.map((o) => ({
+                id: o.id,
+                to: o.to,
+                status: o.status,
+            })),
+            myInterests: state.interests[agentName],
+            coalitions: state.coalitions.filter((c) => c.members.includes(agentName) || c.status === 'forming'),
+            hasAgreement: !!state.agreement,
+        };
+    }
+}
+export function computeBackoffDelay(backoff, attempt, initialDelay, maxDelay) {
+    switch (backoff) {
+        case 'exponential':
+            return Math.min(initialDelay * Math.pow(2, attempt - 1), maxDelay);
+        case 'linear':
+            return Math.min(initialDelay * attempt, maxDelay);
+        default:
+            return Math.min(initialDelay, maxDelay);
+    }
+}
+function minDefined(...values) {
+    const defined = values.filter((v) => v !== undefined);
+    return defined.length > 0 ? Math.min(...defined) : undefined;
+}
+function sleep(ms) {
+    if (ms <= 0)
+        return Promise.resolve();
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export function toError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+//# sourceMappingURL=base-coordinator.js.map