@open-multi-agent/core 1.4.0

package/dist/team/team.js

@@ -0,0 +1,293 @@
+/**
+ * @fileoverview Team — the central coordination object for a named group of agents.
+ *
+ * A {@link Team} owns the agent roster, the inter-agent {@link MessageBus},
+ * the {@link TaskQueue}, and (optionally) a {@link SharedMemory} instance.
+ * It also exposes a typed event bus so orchestrators can react to lifecycle
+ * events without polling.
+ */
+import { SharedMemory } from '../memory/shared.js';
+import { MessageBus } from './messaging.js';
+import { TaskQueue } from '../task/queue.js';
+import { createTask } from '../task/task.js';
+/** Minimal synchronous event emitter. */
+class EventBus {
+    listeners = new Map();
+    on(event, handler) {
+        let map = this.listeners.get(event);
+        if (!map) {
+            map = new Map();
+            this.listeners.set(event, map);
+        }
+        const id = Symbol();
+        map.set(id, handler);
+        return () => {
+            map.delete(id);
+        };
+    }
+    emit(event, data) {
+        const map = this.listeners.get(event);
+        if (!map)
+            return;
+        for (const handler of map.values()) {
+            handler(data);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Team
+// ---------------------------------------------------------------------------
+/**
+ * Coordinates a named group of agents with shared messaging, task queuing,
+ * and optional shared memory.
+ *
+ * @example
+ * ```ts
+ * const team = new Team({
+ *   name: 'research-team',
+ *   agents: [researcherConfig, writerConfig],
+ *   sharedMemory: true,
+ *   maxConcurrency: 2,
+ * })
+ *
+ * team.on('task:complete', (data) => {
+ *   const event = data as OrchestratorEvent
+ *   console.log(`Task done: ${event.task}`)
+ * })
+ *
+ * const task = team.addTask({
+ *   title: 'Research topic',
+ *   description: 'Gather background on quantum computing',
+ *   status: 'pending',
+ *   assignee: 'researcher',
+ * })
+ * ```
+ */
+export class Team {
+    name;
+    config;
+    agentMap;
+    bus;
+    queue;
+    memory;
+    events;
+    constructor(config) {
+        this.config = config;
+        this.name = config.name;
+        // Index agents by name for O(1) lookup.
+        this.agentMap = new Map(config.agents.map((a) => [a.name, a]));
+        this.bus = new MessageBus();
+        this.queue = new TaskQueue();
+        // Resolve shared memory:
+        //   - `sharedMemoryStore` takes precedence when present (enables memory regardless of boolean).
+        //   - `sharedMemory: true` with no custom store → default in-memory store.
+        //   - otherwise → no shared memory.
+        // Use `!== undefined` rather than a truthy check so that malformed falsy
+        // values (null, 0, '') still reach SharedMemory's shape validation and
+        // fail fast, instead of silently falling back and hiding the config bug.
+        this.memory = config.sharedMemoryStore !== undefined
+            ? new SharedMemory(config.sharedMemoryStore)
+            : config.sharedMemory
+                ? new SharedMemory()
+                : undefined;
+        this.events = new EventBus();
+        // Bridge queue events onto the team's event bus.
+        this.queue.on('task:ready', (task) => {
+            const event = {
+                type: 'task_start',
+                task: task.id,
+                data: task,
+            };
+            this.events.emit('task:ready', event);
+        });
+        this.queue.on('task:complete', (task) => {
+            const event = {
+                type: 'task_complete',
+                task: task.id,
+                data: task,
+            };
+            this.events.emit('task:complete', event);
+        });
+        this.queue.on('task:failed', (task) => {
+            const event = {
+                type: 'error',
+                task: task.id,
+                data: task,
+            };
+            this.events.emit('task:failed', event);
+        });
+        this.queue.on('all:complete', () => {
+            this.events.emit('all:complete', undefined);
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Agent roster
+    // ---------------------------------------------------------------------------
+    /** Returns a shallow copy of the agent configs in registration order. */
+    getAgents() {
+        return Array.from(this.agentMap.values());
+    }
+    /**
+     * Looks up an agent by name.
+     *
+     * @returns The {@link AgentConfig} or `undefined` when the name is not known.
+     */
+    getAgent(name) {
+        return this.agentMap.get(name);
+    }
+    // ---------------------------------------------------------------------------
+    // Messaging
+    // ---------------------------------------------------------------------------
+    /**
+     * Sends a point-to-point message from `from` to `to`.
+     *
+     * The message is persisted on the bus and any active subscribers for `to`
+     * are notified synchronously.
+     */
+    sendMessage(from, to, content) {
+        const message = this.bus.send(from, to, content);
+        const event = {
+            type: 'message',
+            agent: from,
+            data: message,
+        };
+        this.events.emit('message', event);
+    }
+    /**
+     * Returns all messages (read or unread) addressed to `agentName`, in
+     * chronological order.
+     */
+    getMessages(agentName) {
+        return this.bus.getAll(agentName);
+    }
+    /**
+     * Broadcasts `content` from `from` to every other agent.
+     *
+     * The `to` field of the resulting message is `'*'`.
+     */
+    broadcast(from, content) {
+        const message = this.bus.broadcast(from, content);
+        const event = {
+            type: 'message',
+            agent: from,
+            data: message,
+        };
+        this.events.emit('broadcast', event);
+    }
+    // ---------------------------------------------------------------------------
+    // Task management
+    // ---------------------------------------------------------------------------
+    /**
+     * Creates a new task, adds it to the queue, and returns the persisted
+     * {@link Task} (with generated `id`, `createdAt`, and `updatedAt`).
+     *
+     * @param task - Everything except the generated fields.
+     */
+    addTask(task) {
+        const created = createTask({
+            title: task.title,
+            description: task.description,
+            assignee: task.assignee,
+            dependsOn: task.dependsOn ? [...task.dependsOn] : undefined,
+        });
+        // Preserve any non-default status (e.g. 'blocked') supplied by the caller.
+        const finalTask = task.status !== 'pending'
+            ? { ...created, status: task.status, result: task.result }
+            : created;
+        this.queue.add(finalTask);
+        return finalTask;
+    }
+    /** Returns a snapshot of all tasks in the queue (any status). */
+    getTasks() {
+        return this.queue.list();
+    }
+    /** Returns all tasks whose `assignee` is `agentName`. */
+    getTasksByAssignee(agentName) {
+        return this.queue.list().filter((t) => t.assignee === agentName);
+    }
+    /**
+     * Applies a partial update to the task identified by `taskId`.
+     *
+     * @throws {Error} when the task is not found.
+     */
+    updateTask(taskId, update) {
+        // Extract only mutable fields accepted by the queue.
+        const { status, result, assignee } = update;
+        return this.queue.update(taskId, {
+            ...(status !== undefined && { status }),
+            ...(result !== undefined && { result }),
+            ...(assignee !== undefined && { assignee }),
+        });
+    }
+    /**
+     * Returns the next `'pending'` task for `agentName`, respecting dependencies.
+     *
+     * Tries to find a task explicitly assigned to the agent first; falls back to
+     * the first unassigned pending task.
+     *
+     * @returns `undefined` when no ready task exists for this agent.
+     */
+    getNextTask(agentName) {
+        // Prefer a task explicitly assigned to this agent.
+        const assigned = this.queue.next(agentName);
+        if (assigned)
+            return assigned;
+        // Fall back to any unassigned pending task.
+        return this.queue.nextAvailable();
+    }
+    // ---------------------------------------------------------------------------
+    // Memory
+    // ---------------------------------------------------------------------------
+    /**
+     * Returns the shared {@link MemoryStore} for this team, or `undefined` if
+     * `sharedMemory` was not enabled in {@link TeamConfig}.
+     *
+     * Note: the returned value satisfies the {@link MemoryStore} interface.
+     * Callers that need the full {@link SharedMemory} API can use the
+     * `as SharedMemory` cast, but depending on the concrete type is discouraged.
+     */
+    getSharedMemory() {
+        return this.memory?.getStore();
+    }
+    /**
+     * Returns the raw {@link SharedMemory} instance (team-internal accessor).
+     * Use this when you need the namespacing / `getSummary` features.
+     *
+     * @internal
+     */
+    getSharedMemoryInstance() {
+        return this.memory;
+    }
+    // ---------------------------------------------------------------------------
+    // Events
+    // ---------------------------------------------------------------------------
+    /**
+     * Subscribes to a team event.
+     *
+     * Built-in events:
+     * - `'task:ready'`   — emitted when a task becomes runnable.
+     * - `'task:complete'` — emitted when a task completes successfully.
+     * - `'task:failed'`  — emitted when a task fails.
+     * - `'all:complete'` — emitted when every task in the queue has terminated.
+     * - `'message'`      — emitted on point-to-point messages.
+     * - `'broadcast'`    — emitted on broadcast messages.
+     *
+     * `data` is typed as `unknown`; cast to {@link OrchestratorEvent} for
+     * structured access.
+     *
+     * @returns An unsubscribe function.
+     */
+    on(event, handler) {
+        return this.events.on(event, handler);
+    }
+    /**
+     * Emits a custom event on the team's event bus.
+     *
+     * Orchestrators can use this to signal domain-specific lifecycle milestones
+     * (e.g. `'phase:research:complete'`) without modifying the Team class.
+     */
+    emit(event, data) {
+        this.events.emit(event, data);
+    }
+}
+//# sourceMappingURL=team.js.map

package/dist/team/team.js.map

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

package/dist/tool/built-in/bash.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Built-in bash tool.
+ *
+ * Executes a shell command and returns its stdout + stderr.  Supports an
+ * optional timeout and a custom working directory.
+ */
+export declare const bashTool: import("../framework.js").ToolDefinition<{
+    command: string;
+    timeout?: number | undefined;
+    cwd?: string | undefined;
+}>;
+//# sourceMappingURL=bash.d.ts.map

package/dist/tool/built-in/bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/tool/built-in/bash.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,eAAO,MAAM,QAAQ;;;;EAyCnB,CAAA"}

package/dist/tool/built-in/bash.js

@@ -0,0 +1,133 @@
+/**
+ * Built-in bash tool.
+ *
+ * Executes a shell command and returns its stdout + stderr.  Supports an
+ * optional timeout and a custom working directory.
+ */
+import { spawn } from 'child_process';
+import { z } from 'zod';
+import { defineTool } from '../framework.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_TIMEOUT_MS = 30_000;
+// ---------------------------------------------------------------------------
+// Tool definition
+// ---------------------------------------------------------------------------
+export const bashTool = defineTool({
+    name: 'bash',
+    description: 'Execute a bash command and return its stdout and stderr. ' +
+        'Use this for file system operations, running scripts, installing packages, ' +
+        'and any task that requires shell access. ' +
+        'The command runs in a non-interactive shell (bash -c). ' +
+        'Long-running commands should use the timeout parameter.',
+    inputSchema: z.object({
+        command: z.string().describe('The bash command to execute.'),
+        timeout: z
+            .number()
+            .optional()
+            .describe(`Timeout in milliseconds before the command is forcibly killed. ` +
+            `Defaults to ${DEFAULT_TIMEOUT_MS} ms.`),
+        cwd: z
+            .string()
+            .optional()
+            .describe('Working directory in which to run the command.'),
+    }),
+    execute: async (input, context) => {
+        const timeoutMs = input.timeout ?? DEFAULT_TIMEOUT_MS;
+        const { stdout, stderr, exitCode } = await runCommand(input.command, { cwd: input.cwd, timeoutMs }, context.abortSignal);
+        const combined = buildOutput(stdout, stderr, exitCode);
+        const isError = exitCode !== 0;
+        return {
+            data: combined,
+            isError,
+        };
+    },
+});
+/**
+ * Spawn a bash subprocess, capture its output, and resolve when it exits or
+ * the abort signal fires.
+ */
+function runCommand(command, options, signal) {
+    return new Promise((resolve) => {
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        const child = spawn('bash', ['-c', command], {
+            cwd: options.cwd,
+            env: process.env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        child.stdout.on('data', (chunk) => stdoutChunks.push(chunk));
+        child.stderr.on('data', (chunk) => stderrChunks.push(chunk));
+        let timedOut = false;
+        let settled = false;
+        const done = (exitCode) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            if (signal !== undefined) {
+                signal.removeEventListener('abort', onAbort);
+            }
+            const stdout = Buffer.concat(stdoutChunks).toString('utf8');
+            const stderr = Buffer.concat(stderrChunks).toString('utf8');
+            resolve({ stdout, stderr, exitCode });
+        };
+        // Timeout handler
+        const timer = setTimeout(() => {
+            timedOut = true;
+            child.kill('SIGKILL');
+        }, options.timeoutMs);
+        // Abort-signal handler
+        const onAbort = () => {
+            child.kill('SIGKILL');
+        };
+        if (signal !== undefined) {
+            signal.addEventListener('abort', onAbort, { once: true });
+        }
+        child.on('close', (code) => {
+            const exitCode = code ?? (timedOut ? 124 : 1);
+            done(exitCode);
+        });
+        child.on('error', (err) => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timer);
+                if (signal !== undefined) {
+                    signal.removeEventListener('abort', onAbort);
+                }
+                resolve({
+                    stdout: '',
+                    stderr: err.message,
+                    exitCode: 127,
+                });
+            }
+        });
+    });
+}
+/**
+ * Format captured output into a single readable string.
+ * When only stdout is present its content is returned as-is.
+ * When stderr is also present both sections are labelled.
+ */
+function buildOutput(stdout, stderr, exitCode) {
+    const parts = [];
+    if (stdout.length > 0) {
+        parts.push(stdout);
+    }
+    if (stderr.length > 0) {
+        parts.push(stdout.length > 0
+            ? `--- stderr ---\n${stderr}`
+            : stderr);
+    }
+    if (parts.length === 0) {
+        return exitCode === 0
+            ? '(command completed with no output)'
+            : `(command exited with code ${exitCode}, no output)`;
+    }
+    if (exitCode !== 0 && parts.length > 0) {
+        parts.push(`\n(exit code: ${exitCode})`);
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=bash.js.map

package/dist/tool/built-in/bash.js.map

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

package/dist/tool/built-in/delegate.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Built-in `delegate_to_agent` tool for synchronous handoff to a roster agent.
+ */
+import { z } from 'zod';
+import type { ToolDefinition } from '../../types.js';
+declare const inputSchema: z.ZodObject<{
+    target_agent: z.ZodString;
+    prompt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    target_agent: string;
+    prompt: string;
+}, {
+    target_agent: string;
+    prompt: string;
+}>;
+/**
+ * Delegates a sub-task to another agent on the team and returns that agent's final text output.
+ *
+ * Only available when the orchestrator injects {@link ToolUseContext.team} with
+ * `runDelegatedAgent` (pool-backed `runTeam` / `runTasks`). Standalone `runAgent`
+ * does not register this tool by default.
+ *
+ * Nested {@link AgentRunResult.tokenUsage} from the delegated run is surfaced via
+ * {@link ToolResult.metadata} so the parent runner can aggregate it into its total
+ * (keeps `maxTokenBudget` accurate across delegation chains).
+ */
+export declare const delegateToAgentTool: ToolDefinition<z.infer<typeof inputSchema>>;
+export {};
+//# sourceMappingURL=delegate.d.ts.map

package/dist/tool/built-in/delegate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate.d.ts","sourceRoot":"","sources":["../../../src/tool/built-in/delegate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,cAAc,EAA8B,MAAM,gBAAgB,CAAA;AAEhF,QAAA,MAAM,WAAW;;;;;;;;;EAGf,CAAA;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAqF3E,CAAA"}

package/dist/tool/built-in/delegate.js

@@ -0,0 +1,92 @@
+/**
+ * @fileoverview Built-in `delegate_to_agent` tool for synchronous handoff to a roster agent.
+ */
+import { z } from 'zod';
+const inputSchema = z.object({
+    target_agent: z.string().min(1).describe('Name of the team agent to run the sub-task.'),
+    prompt: z.string().min(1).describe('Instructions / question for the target agent.'),
+});
+/**
+ * Delegates a sub-task to another agent on the team and returns that agent's final text output.
+ *
+ * Only available when the orchestrator injects {@link ToolUseContext.team} with
+ * `runDelegatedAgent` (pool-backed `runTeam` / `runTasks`). Standalone `runAgent`
+ * does not register this tool by default.
+ *
+ * Nested {@link AgentRunResult.tokenUsage} from the delegated run is surfaced via
+ * {@link ToolResult.metadata} so the parent runner can aggregate it into its total
+ * (keeps `maxTokenBudget` accurate across delegation chains).
+ */
+export const delegateToAgentTool = {
+    name: 'delegate_to_agent',
+    description: 'Run a sub-task on another agent from this team and return that agent\'s final answer as the tool result. ' +
+        'Use when you need a specialist teammate to produce output you will incorporate. ' +
+        'The target agent runs in a fresh conversation for this prompt only.',
+    inputSchema,
+    async execute({ target_agent: targetAgent, prompt }, context) {
+        const team = context.team;
+        if (!team?.runDelegatedAgent) {
+            return {
+                data: 'delegate_to_agent is only available during orchestrated team runs with the delegation tool enabled. ' +
+                    'Use SharedMemory or explicit tasks instead.',
+                isError: true,
+            };
+        }
+        if (targetAgent === context.agent.name) {
+            return {
+                data: 'Cannot delegate to yourself; use another team member.',
+                isError: true,
+            };
+        }
+        if (!team.agents.includes(targetAgent)) {
+            return {
+                data: `Unknown agent "${targetAgent}". Roster: ${team.agents.join(', ')}`,
+                isError: true,
+            };
+        }
+        const chain = team.delegationChain ?? [];
+        if (chain.includes(targetAgent)) {
+            return {
+                data: `Delegation cycle detected: ${[...chain, targetAgent].join(' -> ')}. ` +
+                    'Pick a different target or restructure the plan.',
+                isError: true,
+            };
+        }
+        const depth = team.delegationDepth ?? 0;
+        const maxDepth = team.maxDelegationDepth ?? 3;
+        if (depth >= maxDepth) {
+            return {
+                data: `Maximum delegation depth (${maxDepth}) reached; cannot delegate further.`,
+                isError: true,
+            };
+        }
+        if (team.delegationPool !== undefined && team.delegationPool.availableRunSlots < 1) {
+            return {
+                data: 'Agent pool has no free concurrency slot for a delegated run (nested run would block indefinitely). ' +
+                    'Increase orchestrator maxConcurrency, wait for parallel work to finish, or avoid delegating while the pool is saturated.',
+                isError: true,
+            };
+        }
+        const result = await team.runDelegatedAgent(targetAgent, prompt);
+        if (team.sharedMemory) {
+            const suffix = `${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+            const key = `delegation:${targetAgent}:${suffix}`;
+            try {
+                await team.sharedMemory.set(`${context.agent.name}/${key}`, result.output, {
+                    agent: context.agent.name,
+                    delegatedTo: targetAgent,
+                    success: String(result.success),
+                });
+            }
+            catch {
+                // Audit is best-effort; do not fail the tool on store errors.
+            }
+        }
+        return {
+            data: result.output,
+            isError: !result.success,
+            metadata: { tokenUsage: result.tokenUsage },
+        };
+    },
+};
+//# sourceMappingURL=delegate.js.map

package/dist/tool/built-in/delegate.js.map

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

package/dist/tool/built-in/file-edit.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Built-in file-edit tool.
+ *
+ * Performs a targeted string replacement inside an existing file.
+ * The uniqueness invariant (one match unless replace_all is set) prevents the
+ * common class of bugs where a generic pattern matches the wrong occurrence.
+ */
+export declare const fileEditTool: import("../framework.js").ToolDefinition<{
+    path: string;
+    old_string: string;
+    new_string: string;
+    replace_all?: boolean | undefined;
+}>;
+//# sourceMappingURL=file-edit.d.ts.map

package/dist/tool/built-in/file-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-edit.d.ts","sourceRoot":"","sources":["../../../src/tool/built-in/file-edit.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,eAAO,MAAM,YAAY;;;;;EA+FvB,CAAA"}