@nodetool-ai/agents 0.7.0-rc.11

package/dist/team/task-board.js

@@ -0,0 +1,370 @@
+/**
+ * TaskBoard — Shared task pool with atomic claiming, dependency DAG,
+ * and skill-based matching.
+ *
+ * Follows the A2A task lifecycle: open → claimed → working → done/failed.
+ * Agents pull tasks (claim-based) rather than being assigned (push-based).
+ */
+import { randomUUID } from "node:crypto";
+export class TaskBoard {
+    tasks = new Map();
+    listeners = [];
+    /** Lock set for atomic claiming — taskId currently being claimed. */
+    claimLocks = new Set();
+    /**
+     * Create a new task on the board.
+     */
+    create(opts) {
+        const now = Date.now();
+        const task = {
+            id: randomUUID(),
+            title: opts.title,
+            description: opts.description,
+            status: "open",
+            createdBy: opts.createdBy,
+            dependsOn: opts.dependsOn ?? [],
+            requiredSkills: opts.requiredSkills ?? [],
+            priority: opts.priority ?? 5,
+            artifacts: [],
+            parentTaskId: opts.parentTaskId,
+            createdAt: now,
+            updatedAt: now
+        };
+        // Validate dependencies exist
+        for (const depId of task.dependsOn) {
+            if (!this.tasks.has(depId)) {
+                throw new Error(`Dependency task ${depId} not found`);
+            }
+        }
+        // Cycle detection
+        if (task.dependsOn.length > 0) {
+            this.tasks.set(task.id, task); // temporarily add
+            if (this.hasCycle()) {
+                this.tasks.delete(task.id);
+                throw new Error(`Adding task ${task.id} would create a dependency cycle`);
+            }
+        }
+        else {
+            this.tasks.set(task.id, task);
+        }
+        this.emit({ type: "task_created", task: { ...task }, timestamp: now });
+        return { ...task };
+    }
+    /**
+     * Atomically claim an open task. Returns true if successful.
+     * Fails if task is not open, dependencies aren't met, or another agent claimed it first.
+     */
+    claim(taskId, agentId) {
+        // Atomic lock check
+        if (this.claimLocks.has(taskId))
+            return false;
+        this.claimLocks.add(taskId);
+        try {
+            const task = this.tasks.get(taskId);
+            if (!task || task.status !== "open")
+                return false;
+            // Check all dependencies are done
+            if (!this.dependenciesMet(taskId))
+                return false;
+            task.status = "claimed";
+            task.claimedBy = agentId;
+            task.updatedAt = Date.now();
+            this.emit({
+                type: "task_claimed",
+                taskId,
+                agentId,
+                timestamp: task.updatedAt
+            });
+            return true;
+        }
+        finally {
+            this.claimLocks.delete(taskId);
+        }
+    }
+    /**
+     * Mark a claimed task as actively being worked on.
+     */
+    startWork(taskId, agentId) {
+        const task = this.tasks.get(taskId);
+        if (!task || task.claimedBy !== agentId || task.status !== "claimed") {
+            return false;
+        }
+        task.status = "working";
+        task.updatedAt = Date.now();
+        this.emit({
+            type: "task_working",
+            taskId,
+            agentId,
+            timestamp: task.updatedAt
+        });
+        return true;
+    }
+    /**
+     * Complete a task with optional result and artifacts.
+     */
+    complete(taskId, opts) {
+        const task = this.tasks.get(taskId);
+        if (!task || (task.status !== "working" && task.status !== "claimed")) {
+            return false;
+        }
+        task.status = "done";
+        task.result = opts?.result;
+        if (opts?.artifacts) {
+            task.artifacts.push(...opts.artifacts);
+        }
+        task.updatedAt = Date.now();
+        this.emit({
+            type: "task_completed",
+            taskId,
+            artifacts: task.artifacts,
+            timestamp: task.updatedAt
+        });
+        return true;
+    }
+    /**
+     * Mark a task as failed.
+     */
+    fail(taskId, reason) {
+        const task = this.tasks.get(taskId);
+        if (!task || task.status === "done" || task.status === "failed") {
+            return false;
+        }
+        task.status = "failed";
+        task.failureReason = reason;
+        task.updatedAt = Date.now();
+        this.emit({
+            type: "task_failed",
+            taskId,
+            reason,
+            timestamp: task.updatedAt
+        });
+        return true;
+    }
+    /**
+     * Mark a task as blocked (waiting on external input or another agent).
+     */
+    block(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task || task.status === "done" || task.status === "failed") {
+            return false;
+        }
+        task.status = "blocked";
+        task.updatedAt = Date.now();
+        return true;
+    }
+    /**
+     * Unblock a task back to open (so it can be reclaimed).
+     */
+    unblock(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task || task.status !== "blocked")
+            return false;
+        task.status = "open";
+        task.claimedBy = undefined;
+        task.updatedAt = Date.now();
+        return true;
+    }
+    /**
+     * Decompose a task into subtasks. Parent task is marked blocked
+     * until all subtasks complete.
+     */
+    decompose(parentTaskId, subtasks) {
+        const parent = this.tasks.get(parentTaskId);
+        if (!parent)
+            throw new Error(`Parent task ${parentTaskId} not found`);
+        const created = [];
+        for (const sub of subtasks) {
+            created.push(this.create({
+                ...sub,
+                parentTaskId,
+                dependsOn: sub.dependsOn ?? []
+            }));
+        }
+        // Block parent until subtasks are done
+        parent.status = "blocked";
+        parent.updatedAt = Date.now();
+        return created;
+    }
+    /**
+     * Get tasks available for an agent to claim.
+     * Filters by: open status, dependencies met, skill match.
+     * Sorted by priority (lower number = higher priority).
+     */
+    getAvailable(agent) {
+        const available = [];
+        for (const task of this.tasks.values()) {
+            if (task.status !== "open")
+                continue;
+            if (!this.dependenciesMet(task.id))
+                continue;
+            // Skill matching: task requires skills the agent has
+            if (agent && task.requiredSkills.length > 0) {
+                const hasAllSkills = task.requiredSkills.every((s) => agent.skills.includes(s));
+                if (!hasAllSkills)
+                    continue;
+            }
+            available.push({ ...task });
+        }
+        return available.sort((a, b) => a.priority - b.priority);
+    }
+    /**
+     * Get a single task by ID.
+     */
+    get(taskId) {
+        const task = this.tasks.get(taskId);
+        return task ? { ...task } : undefined;
+    }
+    /**
+     * Get full board snapshot.
+     */
+    getSnapshot() {
+        return [...this.tasks.values()].map((t) => ({ ...t }));
+    }
+    /**
+     * Get subtasks of a parent task.
+     */
+    getSubtasks(parentTaskId) {
+        return [...this.tasks.values()]
+            .filter((t) => t.parentTaskId === parentTaskId)
+            .map((t) => ({ ...t }));
+    }
+    /**
+     * Check if all tasks are in terminal states (done/failed).
+     */
+    isComplete() {
+        if (this.tasks.size === 0)
+            return false;
+        for (const task of this.tasks.values()) {
+            if (task.status !== "done" && task.status !== "failed")
+                return false;
+        }
+        return true;
+    }
+    /**
+     * Check if there's a deadlock (no progress possible).
+     * Deadlock = tasks exist that aren't done/failed, but none are claimable or in-progress.
+     */
+    detectDeadlock() {
+        const active = [];
+        const stuck = [];
+        for (const task of this.tasks.values()) {
+            if (task.status === "done" || task.status === "failed")
+                continue;
+            if (task.status === "claimed" || task.status === "working") {
+                active.push(task.id);
+            }
+            else if (task.status === "open" && !this.dependenciesMet(task.id)) {
+                stuck.push(task.id);
+            }
+            else if (task.status === "blocked") {
+                stuck.push(task.id);
+            }
+        }
+        // Deadlock: stuck tasks exist but no one is working
+        if (stuck.length > 0 && active.length === 0) {
+            // Also check if any open tasks have met dependencies
+            const claimable = [...this.tasks.values()].filter((t) => t.status === "open" && this.dependenciesMet(t.id));
+            if (claimable.length === 0)
+                return stuck;
+        }
+        return null;
+    }
+    /**
+     * Auto-complete parent tasks when all subtasks are done.
+     */
+    resolveParents() {
+        for (const task of this.tasks.values()) {
+            if (task.status !== "blocked")
+                continue;
+            const subtasks = this.getSubtasks(task.id);
+            if (subtasks.length === 0)
+                continue;
+            const allFinished = subtasks.every((s) => s.status === "done" || s.status === "failed");
+            if (allFinished) {
+                const anyFailed = subtasks.some((s) => s.status === "failed");
+                task.status = anyFailed ? "failed" : "done";
+                task.result = subtasks.map((s) => s.result);
+                task.artifacts = subtasks.flatMap((s) => s.artifacts);
+                task.updatedAt = Date.now();
+                if (anyFailed) {
+                    const failedNames = subtasks
+                        .filter((s) => s.status === "failed")
+                        .map((s) => s.title)
+                        .join(", ");
+                    this.emit({
+                        type: "task_failed",
+                        taskId: task.id,
+                        reason: `Subtask(s) failed: ${failedNames}`,
+                        timestamp: task.updatedAt
+                    });
+                }
+                else {
+                    this.emit({
+                        type: "task_completed",
+                        taskId: task.id,
+                        artifacts: task.artifacts,
+                        timestamp: task.updatedAt
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Subscribe to board events.
+     */
+    onEvent(handler) {
+        this.listeners.push(handler);
+        return () => {
+            const idx = this.listeners.indexOf(handler);
+            if (idx >= 0)
+                this.listeners.splice(idx, 1);
+        };
+    }
+    // ─── Internal ───
+    dependenciesMet(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task)
+            return false;
+        return task.dependsOn.every((depId) => {
+            const dep = this.tasks.get(depId);
+            return dep?.status === "done";
+        });
+    }
+    hasCycle() {
+        const visited = new Set();
+        const stack = new Set();
+        const dfs = (id) => {
+            if (stack.has(id))
+                return true;
+            if (visited.has(id))
+                return false;
+            visited.add(id);
+            stack.add(id);
+            const task = this.tasks.get(id);
+            if (task) {
+                for (const depId of task.dependsOn) {
+                    if (dfs(depId))
+                        return true;
+                }
+            }
+            stack.delete(id);
+            return false;
+        };
+        for (const id of this.tasks.keys()) {
+            if (dfs(id))
+                return true;
+        }
+        return false;
+    }
+    emit(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Don't let listener errors break the board
+            }
+        }
+    }
+}
+//# sourceMappingURL=task-board.js.map

package/dist/team/task-board.js.map

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

package/dist/team/team-executor.d.ts

@@ -0,0 +1,72 @@
+/**
+ * TeamExecutor — Orchestrates a team of agents collaborating via
+ * a shared TaskBoard and MessageBus.
+ *
+ * Strategies:
+ * - coordinator: First agent decomposes the objective, others execute tasks.
+ * - autonomous: All agents see the objective and self-organize.
+ * - hybrid: Coordinator creates initial plan, agents can create subtasks.
+ */
+import type { ProcessingContext } from "@nodetool-ai/runtime";
+import { Tool } from "../tools/base-tool.js";
+import type { IMessageBus, ITaskBoard, TeamConfig, TeamEvent } from "./types.js";
+export interface TeamExecutorOptions {
+    config: TeamConfig;
+    context: ProcessingContext;
+    /** Extra tools available to all agents (search, code, etc.). */
+    sharedTools?: Tool[];
+    /** Pre-populated task board (optional). Defaults to in-memory TaskBoard. */
+    taskBoard?: ITaskBoard;
+    /** Pre-populated message bus (optional). Defaults to in-memory MessageBus. */
+    messageBus?: IMessageBus;
+}
+export declare class TeamExecutor {
+    private config;
+    private context;
+    private board;
+    private bus;
+    private sharedTools;
+    private agents;
+    private events;
+    private maxIterations;
+    private maxConcurrency;
+    private totalIterations;
+    private _result;
+    constructor(opts: TeamExecutorOptions);
+    get taskBoard(): ITaskBoard;
+    get messageBus(): IMessageBus;
+    getResult(): unknown;
+    getEvents(): TeamEvent[];
+    /**
+     * Main execution loop. Yields TeamEvents as the team works.
+     */
+    execute(): AsyncGenerator<TeamEvent>;
+    /**
+     * Coordinator phase: first agent decomposes the objective into tasks.
+     */
+    private runCoordinatorPhase;
+    /**
+     * Main work loop: agents check for tasks, claim them, execute, complete.
+     */
+    private runWorkLoop;
+    /**
+     * Single agent work cycle: check messages, check board, work on task.
+     */
+    private runAgentWorkCycle;
+    /**
+     * Run a single LLM iteration for an agent (may involve tool calls).
+     */
+    private runAgentIteration;
+    /**
+     * Agentic provider: single call with onToolCall handles the full loop.
+     */
+    private runAgenticIteration;
+    /**
+     * Standard provider: request-response loop with explicit tool execution.
+     */
+    private runStandardIteration;
+    private getWorkableAgents;
+    private buildSystemPrompt;
+    private getStrategyInstructions;
+}
+//# sourceMappingURL=team-executor.d.ts.map

package/dist/team/team-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-executor.d.ts","sourceRoot":"","sources":["../../src/team/team-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAEV,iBAAiB,EAGlB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAI7C,OAAO,KAAK,EAEV,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EAEV,MAAM,YAAY,CAAC;AAQpB,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,gEAAgE;IAChE,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC;IACrB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,WAAW,CAAC;CAC1B;AAYD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,OAAO,CAAiB;gBAEpB,IAAI,EAAE,mBAAmB;IAUrC,IAAI,SAAS,IAAI,UAAU,CAE1B;IAED,IAAI,UAAU,IAAI,WAAW,CAE5B;IAED,SAAS,IAAI,OAAO;IAIpB,SAAS,IAAI,SAAS,EAAE;IAIxB;;OAEG;IACI,OAAO,IAAI,cAAc,CAAC,SAAS,CAAC;IAkF3C;;OAEG;YACY,mBAAmB;IAkBlC;;OAEG;YACY,WAAW;IA+C1B;;OAEG;YACY,iBAAiB;IA8DhC;;OAEG;YACY,iBAAiB;IA+BhC;;OAEG;YACY,mBAAmB;IA8ClC;;OAEG;YACY,oBAAoB;IA+DnC,OAAO,CAAC,iBAAiB;IAiCzB,OAAO,CAAC,iBAAiB;IA2CzB,OAAO,CAAC,uBAAuB;CAmDhC"}