@clawswarm/core 0.1.0-alpha

package/dist/clawswarm.js

@@ -0,0 +1,224 @@
+"use strict";
+/**
+ * ClawSwarm — main orchestrator class.
+ *
+ * Creates and manages a swarm of specialist agents, decomposes goals
+ * into tasks, runs the chief review pipeline, and emits events throughout.
+ *
+ * @module @clawswarm/core/clawswarm
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClawSwarm = void 0;
+const eventemitter3_1 = __importDefault(require("eventemitter3"));
+const agent_js_1 = require("./agent.js");
+const goal_js_1 = require("./goal.js");
+const task_js_1 = require("./task.js");
+const chief_js_1 = require("./chief.js");
+// ─── ClawSwarm ────────────────────────────────────────────────────────────────
+/**
+ * The primary interface for the ClawSwarm framework.
+ *
+ * @example
+ * ```typescript
+ * const swarm = new ClawSwarm({
+ *   agents: [
+ *     Agent.research({ model: 'claude-sonnet-4' }),
+ *     Agent.code({ model: 'gpt-4o' }),
+ *     Agent.ops({ model: 'gemini-pro' }),
+ *   ],
+ *   chiefReview: { autoApproveThreshold: 8, humanReviewThreshold: 5 },
+ * });
+ *
+ * swarm.on('task:completed', (task) => console.log('✅', task.title));
+ *
+ * const result = await swarm.execute(goal);
+ * ```
+ */
+class ClawSwarm extends eventemitter3_1.default {
+    goalManager;
+    taskManager;
+    planner;
+    reviewer;
+    agents;
+    config;
+    constructor(config) {
+        super();
+        this.config = config;
+        this.goalManager = new goal_js_1.GoalManager();
+        this.taskManager = new task_js_1.TaskManager();
+        this.planner = new goal_js_1.GoalPlanner(config);
+        this.reviewer = new chief_js_1.ChiefReviewer(config.chiefReview);
+        this.agents = new Map();
+        // Register agents
+        for (const agentConfig of config.agents) {
+            const agent = new agent_js_1.Agent(agentConfig);
+            // Use last-registered agent if multiple of same type
+            this.agents.set(agentConfig.type, agent);
+        }
+    }
+    // ─── Public API ───────────────────────────────────────────────────────────
+    /**
+     * Create a new goal (without executing it).
+     * Use `execute()` to run the goal.
+     */
+    createGoal(input) {
+        const goal = this.goalManager.create(input);
+        this.emit('goal:created', goal);
+        return goal;
+    }
+    /**
+     * Execute a goal end-to-end:
+     * 1. Decompose into tasks (Planner)
+     * 2. Run each task with the appropriate specialist agent
+     * 3. Review each task with ChiefReviewer
+     * 4. Handle rework cycles
+     * 5. Return final result
+     */
+    async execute(goal) {
+        const startTime = Date.now();
+        let hadHumanReview = false;
+        // 1. Planning phase
+        this.goalManager.setStatus(goal.id, 'planning');
+        this.emit('goal:planning', goal);
+        const tasks = await this.planner.decompose(goal, this.taskManager);
+        this.goalManager.setTasks(goal.id, tasks);
+        // 2. Execution phase
+        this.goalManager.setStatus(goal.id, 'in_progress');
+        try {
+            // Process tasks in waves, respecting dependencies
+            let iterations = 0;
+            const maxIterations = tasks.length * 4; // safety valve
+            while (!this.taskManager.isGoalDone(goal.id) && iterations < maxIterations) {
+                iterations++;
+                const ready = this.taskManager.getReady(goal.id);
+                if (ready.length === 0)
+                    break;
+                // Run ready tasks concurrently
+                await Promise.all(ready.map(task => this._executeTask(task)));
+                // Check for human review requirement
+                const reviewTasks = this.taskManager
+                    .getByGoal(goal.id)
+                    .filter(t => t.status === 'review');
+                for (const task of reviewTasks) {
+                    const review = await this.reviewer.review(task);
+                    hadHumanReview = hadHumanReview || (review.decision === 'human_review');
+                    await this._handleReview(task, review);
+                }
+            }
+            // 3. Collect deliverables
+            const completedTasks = this.taskManager
+                .getByGoal(goal.id)
+                .filter(t => t.status === 'completed');
+            const allDeliverables = completedTasks.flatMap(t => t.deliverables);
+            const updatedGoal = this.goalManager.setStatus(goal.id, 'completed');
+            this.emit('goal:completed', updatedGoal);
+            return {
+                goal: updatedGoal,
+                deliverables: allDeliverables,
+                cost: updatedGoal.cost,
+                hadHumanReview,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            const failedGoal = this.goalManager.setStatus(goal.id, 'failed');
+            this.emit('goal:failed', failedGoal, err);
+            throw err;
+        }
+    }
+    /**
+     * Get a registered agent by type.
+     */
+    getAgent(type) {
+        return this.agents.get(type);
+    }
+    /**
+     * List all registered agents.
+     */
+    listAgents() {
+        return Array.from(this.agents.values());
+    }
+    /**
+     * Get the ChiefReviewer instance (for inspection or custom review logic).
+     */
+    getReviewer() {
+        return this.reviewer;
+    }
+    /**
+     * Get the TaskManager instance (for direct task inspection).
+     */
+    getTaskManager() {
+        return this.taskManager;
+    }
+    // ─── Private ──────────────────────────────────────────────────────────────
+    /**
+     * Execute a single task with the appropriate agent.
+     * @internal
+     */
+    async _executeTask(task) {
+        const agentType = task.assignedTo ?? 'code';
+        const agent = this.agents.get(agentType);
+        if (!agent) {
+            this.taskManager.fail(task.id, new Error(`No agent registered for type: ${agentType}`));
+            return;
+        }
+        try {
+            this.taskManager.assign(task.id, agentType);
+            this.emit('task:assigned', task, agentType);
+            this.taskManager.start(task.id);
+            this.emit('task:started', task);
+            const deliverables = await agent.execute(task);
+            this.taskManager.submitForReview(task.id, deliverables);
+            this.emit('task:completed', task);
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            this.taskManager.fail(task.id, err);
+            this.emit('task:failed', task, err);
+        }
+    }
+    /**
+     * Handle a chief review result for a task.
+     * @internal
+     */
+    async _handleReview(task, review) {
+        this.emit('task:review', task, review);
+        switch (review.decision) {
+            case 'approved': {
+                this.taskManager.approve(task.id);
+                this.taskManager.complete(task.id);
+                break;
+            }
+            case 'human_review': {
+                this.emit('human:review_required', task, review);
+                // In the default flow, human_review blocks until someone calls approve/reject
+                // For automated flows, we treat it as approved after emitting the event
+                this.taskManager.approve(task.id);
+                this.taskManager.complete(task.id);
+                break;
+            }
+            case 'rejected': {
+                this.emit('task:rejected', task, review);
+                try {
+                    // Attempt rework
+                    this.taskManager.rework(task.id, review.feedback);
+                    this.emit('task:rework', task, review);
+                    // Re-execute the task
+                    const updatedTask = this.taskManager.get(task.id);
+                    await this._executeTask(updatedTask);
+                }
+                catch {
+                    // Max rework exceeded — fail the task
+                    this.taskManager.reject(task.id, review.feedback);
+                }
+                break;
+            }
+        }
+    }
+}
+exports.ClawSwarm = ClawSwarm;
+//# sourceMappingURL=clawswarm.js.map

package/dist/clawswarm.js.map

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

package/dist/goal.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Goal decomposition and planning.
+ * @module @clawswarm/core/goal
+ */
+import { Goal, GoalStatus, CreateGoalInput, Task, SwarmConfig } from './types.js';
+import { TaskManager } from './task.js';
+/**
+ * Decomposes high-level goals into concrete, assignable tasks.
+ *
+ * The Planner analyzes a goal description and generates a task plan,
+ * assigns each task to the appropriate specialist agent, and sequences
+ * tasks based on their dependencies.
+ *
+ * @example
+ * ```typescript
+ * const planner = new GoalPlanner(swarmConfig);
+ * const tasks = await planner.decompose(goal, taskManager);
+ * ```
+ */
+export declare class GoalPlanner {
+    private readonly config;
+    constructor(config: SwarmConfig);
+    /**
+     * Decompose a goal into a list of tasks.
+     * Creates tasks via the TaskManager and returns them in execution order.
+     */
+    decompose(goal: Goal, taskManager: TaskManager): Promise<Task[]>;
+    /**
+     * Generate a task plan for a goal.
+     * In production, this calls an LLM with the planner system prompt.
+     * Returns structured step definitions.
+     */
+    private _generatePlan;
+    /**
+     * Infer the primary execution agent type from the goal description.
+     */
+    private _inferPrimaryAgent;
+}
+/**
+ * Manages the lifecycle of goals in a ClawSwarm instance.
+ */
+export declare class GoalManager {
+    private goals;
+    /**
+     * Create a new goal.
+     */
+    create(input: CreateGoalInput): Goal;
+    /**
+     * Get a goal by ID.
+     */
+    get(goalId: string): Goal | undefined;
+    /**
+     * Get all goals.
+     */
+    getAll(): Goal[];
+    /**
+     * Update a goal's status.
+     */
+    setStatus(goalId: string, status: GoalStatus): Goal;
+    /**
+     * Attach tasks to a goal.
+     */
+    setTasks(goalId: string, tasks: Goal['tasks']): Goal;
+    private _getOrThrow;
+}
+//# sourceMappingURL=goal.d.ts.map

package/dist/goal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal.d.ts","sourceRoot":"","sources":["../src/goal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,eAAe,EAAE,IAAI,EAAa,WAAW,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAIxC;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;OAGG;IACG,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAuBtE;;;;OAIG;YACW,aAAa;IAwB3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAe3B;AAID;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAgC;IAE7C;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAoBpC;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIrC;;OAEG;IACH,MAAM,IAAI,IAAI,EAAE;IAIhB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IASnD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI;IAMpD,OAAO,CAAC,WAAW;CAKpB"}

package/dist/goal.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * Goal decomposition and planning.
+ * @module @clawswarm/core/goal
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoalManager = exports.GoalPlanner = void 0;
+// ─── Goal Planner ─────────────────────────────────────────────────────────────
+/**
+ * Decomposes high-level goals into concrete, assignable tasks.
+ *
+ * The Planner analyzes a goal description and generates a task plan,
+ * assigns each task to the appropriate specialist agent, and sequences
+ * tasks based on their dependencies.
+ *
+ * @example
+ * ```typescript
+ * const planner = new GoalPlanner(swarmConfig);
+ * const tasks = await planner.decompose(goal, taskManager);
+ * ```
+ */
+class GoalPlanner {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Decompose a goal into a list of tasks.
+     * Creates tasks via the TaskManager and returns them in execution order.
+     */
+    async decompose(goal, taskManager) {
+        const plan = await this._generatePlan(goal);
+        const tasks = [];
+        // Create tasks from plan (maintaining dependency ordering)
+        for (const step of plan) {
+            const task = taskManager.create({
+                goalId: goal.id,
+                title: step.title,
+                description: step.description,
+                assignedTo: step.agentType,
+                dependsOn: step.dependsOnTitles
+                    ? tasks
+                        .filter(t => step.dependsOnTitles.includes(t.title))
+                        .map(t => t.id)
+                    : [],
+            });
+            tasks.push(task);
+        }
+        return tasks;
+    }
+    /**
+     * Generate a task plan for a goal.
+     * In production, this calls an LLM with the planner system prompt.
+     * Returns structured step definitions.
+     */
+    async _generatePlan(goal) {
+        // TODO: Replace with actual LLM call
+        // This stub returns a basic 3-step plan as an example
+        return [
+            {
+                title: `Research: ${goal.title}`,
+                description: `Research and gather background information for: ${goal.description}`,
+                agentType: 'research',
+            },
+            {
+                title: `Execute: ${goal.title}`,
+                description: `Based on research, implement the core work for: ${goal.description}`,
+                agentType: this._inferPrimaryAgent(goal),
+                dependsOnTitles: [`Research: ${goal.title}`],
+            },
+            {
+                title: `Review: ${goal.title}`,
+                description: `Verify and validate the output for: ${goal.description}`,
+                agentType: 'research',
+                dependsOnTitles: [`Execute: ${goal.title}`],
+            },
+        ];
+    }
+    /**
+     * Infer the primary execution agent type from the goal description.
+     */
+    _inferPrimaryAgent(goal) {
+        const desc = `${goal.title} ${goal.description}`.toLowerCase();
+        if (/deploy|infrastructure|k8s|docker|ci\/cd|monitoring|server/.test(desc)) {
+            return 'ops';
+        }
+        if (/code|build|implement|function|api|test|debug|refactor/.test(desc)) {
+            return 'code';
+        }
+        if (/research|analyze|report|summarize|find|investigate/.test(desc)) {
+            return 'research';
+        }
+        return 'code'; // default
+    }
+}
+exports.GoalPlanner = GoalPlanner;
+// ─── Goal Manager ─────────────────────────────────────────────────────────────
+/**
+ * Manages the lifecycle of goals in a ClawSwarm instance.
+ */
+class GoalManager {
+    goals = new Map();
+    /**
+     * Create a new goal.
+     */
+    create(input) {
+        const goal = {
+            ...input,
+            id: `goal-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`,
+            status: 'created',
+            tasks: [],
+            deliverables: [],
+            priority: input.priority ?? 0,
+            tags: input.tags ?? [],
+            cost: {
+                totalTokens: 0,
+                estimatedCostUsd: 0,
+                byAgent: {},
+            },
+            createdAt: new Date().toISOString(),
+        };
+        this.goals.set(goal.id, goal);
+        return goal;
+    }
+    /**
+     * Get a goal by ID.
+     */
+    get(goalId) {
+        return this.goals.get(goalId);
+    }
+    /**
+     * Get all goals.
+     */
+    getAll() {
+        return Array.from(this.goals.values());
+    }
+    /**
+     * Update a goal's status.
+     */
+    setStatus(goalId, status) {
+        const goal = this._getOrThrow(goalId);
+        goal.status = status;
+        if (status === 'completed') {
+            goal.completedAt = new Date().toISOString();
+        }
+        return goal;
+    }
+    /**
+     * Attach tasks to a goal.
+     */
+    setTasks(goalId, tasks) {
+        const goal = this._getOrThrow(goalId);
+        goal.tasks = tasks;
+        return goal;
+    }
+    _getOrThrow(goalId) {
+        const goal = this.goals.get(goalId);
+        if (!goal)
+            throw new Error(`Goal not found: ${goalId}`);
+        return goal;
+    }
+}
+exports.GoalManager = GoalManager;
+//# sourceMappingURL=goal.js.map

package/dist/goal.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @clawswarm/core — Public API
+ *
+ * The main entry point for the ClawSwarm framework.
+ * Import everything you need from this barrel export.
+ *
+ * @example
+ * ```typescript
+ * import { ClawSwarm, Agent, GoalManager, TaskManager, ChiefReviewer } from '@clawswarm/core';
+ * ```
+ *
+ * @module @clawswarm/core
+ */
+export { ClawSwarm } from './clawswarm.js';
+export { Agent } from './agent.js';
+export { GoalManager, GoalPlanner } from './goal.js';
+export { TaskManager } from './task.js';
+export { ChiefReviewer } from './chief.js';
+export type { AgentType, AgentStatus, AgentConfig, ModelId, TaskStatus, Task, Deliverable, GoalStatus, Goal, CreateGoalInput, ReviewResult, ChiefReviewConfig, TokenUsage, CostSummary, SwarmEvents, SwarmConfig, GoalResult, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGxC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,YAAY,EAEV,SAAS,EACT,WAAW,EACX,WAAW,EACX,OAAO,EAGP,UAAU,EACV,IAAI,EACJ,WAAW,EAGX,UAAU,EACV,IAAI,EACJ,eAAe,EAGf,YAAY,EACZ,iBAAiB,EAGjB,UAAU,EACV,WAAW,EAGX,WAAW,EAGX,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * @clawswarm/core — Public API
+ *
+ * The main entry point for the ClawSwarm framework.
+ * Import everything you need from this barrel export.
+ *
+ * @example
+ * ```typescript
+ * import { ClawSwarm, Agent, GoalManager, TaskManager, ChiefReviewer } from '@clawswarm/core';
+ * ```
+ *
+ * @module @clawswarm/core
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChiefReviewer = exports.TaskManager = exports.GoalPlanner = exports.GoalManager = exports.Agent = exports.ClawSwarm = void 0;
+// ─── Main Class ───────────────────────────────────────────────────────────────
+var clawswarm_js_1 = require("./clawswarm.js");
+Object.defineProperty(exports, "ClawSwarm", { enumerable: true, get: function () { return clawswarm_js_1.ClawSwarm; } });
+// ─── Agent ────────────────────────────────────────────────────────────────────
+var agent_js_1 = require("./agent.js");
+Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return agent_js_1.Agent; } });
+// ─── Goal ─────────────────────────────────────────────────────────────────────
+var goal_js_1 = require("./goal.js");
+Object.defineProperty(exports, "GoalManager", { enumerable: true, get: function () { return goal_js_1.GoalManager; } });
+Object.defineProperty(exports, "GoalPlanner", { enumerable: true, get: function () { return goal_js_1.GoalPlanner; } });
+// ─── Task ─────────────────────────────────────────────────────────────────────
+var task_js_1 = require("./task.js");
+Object.defineProperty(exports, "TaskManager", { enumerable: true, get: function () { return task_js_1.TaskManager; } });
+// ─── Chief Review ─────────────────────────────────────────────────────────────
+var chief_js_1 = require("./chief.js");
+Object.defineProperty(exports, "ChiefReviewer", { enumerable: true, get: function () { return chief_js_1.ChiefReviewer; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAEH,iFAAiF;AACjF,+CAA2C;AAAlC,yGAAA,SAAS,OAAA;AAElB,iFAAiF;AACjF,uCAAmC;AAA1B,iGAAA,KAAK,OAAA;AAEd,iFAAiF;AACjF,qCAAqD;AAA5C,sGAAA,WAAW,OAAA;AAAE,sGAAA,WAAW,OAAA;AAEjC,iFAAiF;AACjF,qCAAwC;AAA/B,sGAAA,WAAW,OAAA;AAEpB,iFAAiF;AACjF,uCAA2C;AAAlC,yGAAA,aAAa,OAAA"}

package/dist/swarm.d.ts

@@ -0,0 +1,67 @@
+/**
+ * ClawSwarm — the top-level orchestrator.
+ * @module @clawswarm/core/swarm
+ */
+import EventEmitter from 'eventemitter3';
+import { SwarmConfig, GoalResult, CreateGoalInput, Goal, AgentType, SwarmEvents } from './types.js';
+import { Agent } from './agent.js';
+/**
+ * ClawSwarm — deploy and orchestrate a team of AI agents.
+ *
+ * @example
+ * ```typescript
+ * const swarm = new ClawSwarm({
+ *   agents: [
+ *     Agent.research({ model: 'claude-sonnet-4' }),
+ *     Agent.code({ model: 'gpt-4o' }),
+ *     Agent.ops({ model: 'gemini-pro' }),
+ *   ],
+ *   chiefReview: {
+ *     autoApproveThreshold: 8,
+ *     humanReviewThreshold: 5,
+ *   },
+ * });
+ *
+ * swarm.on('task:completed', (task) => console.log('Done:', task.title));
+ *
+ * const goal = await swarm.createGoal({
+ *   title: 'Write a blog post about AI',
+ *   description: 'Research AI trends and write a 1000-word post',
+ * });
+ *
+ * const result = await swarm.execute(goal);
+ * ```
+ */
+export declare class ClawSwarm extends EventEmitter<SwarmEvents> {
+    private readonly config;
+    private readonly agents;
+    private readonly taskManager;
+    private readonly goalManager;
+    private readonly planner;
+    private readonly reviewer;
+    constructor(config: SwarmConfig);
+    /**
+     * Create a new goal. Does not start execution yet.
+     *
+     * @param input - Goal title, description, and optional metadata
+     * @returns The created goal
+     */
+    createGoal(input: CreateGoalInput): Promise<Goal>;
+    /**
+     * Execute a goal: plan, assign, run, review, and collect results.
+     *
+     * @param goal - The goal to execute (from createGoal)
+     * @returns Final result with deliverables and cost summary
+     */
+    execute(goal: Goal): Promise<GoalResult>;
+    /**
+     * Get all agents in this swarm.
+     */
+    getAgents(): Agent[];
+    /**
+     * Get an agent by type.
+     */
+    getAgent(type: AgentType): Agent | undefined;
+    private _executeTask;
+}
+//# sourceMappingURL=swarm.d.ts.map

package/dist/swarm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm.d.ts","sourceRoot":"","sources":["../src/swarm.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,YAAY,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,WAAW,EACX,UAAU,EACV,eAAe,EACf,IAAI,EAEJ,SAAS,EACT,WAAW,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAKnC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,SAAU,SAAQ,YAAY,CAAC,WAAW,CAAC;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;gBAE7B,MAAM,EAAE,WAAW;IAU/B;;;;;OAKG;IACG,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvD;;;;;OAKG;IACG,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IAuD9C;;OAEG;IACH,SAAS,IAAI,KAAK,EAAE;IAIpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,GAAG,SAAS;YAM9B,YAAY;CAsE3B"}