@jackchen_me/open-multi-agent 0.1.0

package/dist/team/team.js

@@ -0,0 +1,282 @@
+/**
+ * @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();
+        this.memory = 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/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"}

package/dist/tool/built-in/file-edit.js

@@ -0,0 +1,130 @@
+/**
+ * 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.
+ */
+import { readFile, writeFile } from 'fs/promises';
+import { z } from 'zod';
+import { defineTool } from '../framework.js';
+// ---------------------------------------------------------------------------
+// Tool definition
+// ---------------------------------------------------------------------------
+export const fileEditTool = defineTool({
+    name: 'file_edit',
+    description: 'Edit a file by replacing a specific string with new content. ' +
+        'The `old_string` must appear verbatim in the file. ' +
+        'By default the tool errors if `old_string` appears more than once — ' +
+        'use `replace_all: true` to replace every occurrence. ' +
+        'Use file_write when you need to create a new file or rewrite it entirely.',
+    inputSchema: z.object({
+        path: z
+            .string()
+            .describe('Absolute path to the file to edit.'),
+        old_string: z
+            .string()
+            .describe('The exact string to find and replace. ' +
+            'Must match character-for-character including whitespace and newlines.'),
+        new_string: z
+            .string()
+            .describe('The replacement string that will be inserted in place of `old_string`.'),
+        replace_all: z
+            .boolean()
+            .optional()
+            .describe('When true, replace every occurrence of `old_string` instead of requiring it ' +
+            'to be unique. Defaults to false.'),
+    }),
+    execute: async (input) => {
+        // Read the existing file.
+        let original;
+        try {
+            const buffer = await readFile(input.path);
+            original = buffer.toString('utf8');
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error reading file.';
+            return {
+                data: `Could not read "${input.path}": ${message}`,
+                isError: true,
+            };
+        }
+        const occurrences = countOccurrences(original, input.old_string);
+        if (occurrences === 0) {
+            return {
+                data: `The string to replace was not found in "${input.path}".\n` +
+                    'Make sure `old_string` matches the file contents exactly, ' +
+                    'including indentation and line endings.',
+                isError: true,
+            };
+        }
+        const replaceAll = input.replace_all ?? false;
+        if (occurrences > 1 && !replaceAll) {
+            return {
+                data: `\`old_string\` appears ${occurrences} times in "${input.path}". ` +
+                    'Provide a more specific string to uniquely identify the section you want ' +
+                    'to replace, or set `replace_all: true` to replace every occurrence.',
+                isError: true,
+            };
+        }
+        // Perform the replacement.
+        const updated = replaceAll
+            ? replaceAllOccurrences(original, input.old_string, input.new_string)
+            : original.replace(input.old_string, input.new_string);
+        // Persist the result.
+        try {
+            await writeFile(input.path, updated, 'utf8');
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error writing file.';
+            return {
+                data: `Failed to write "${input.path}": ${message}`,
+                isError: true,
+            };
+        }
+        const replacedCount = replaceAll ? occurrences : 1;
+        return {
+            data: `Replaced ${replacedCount} occurrence${replacedCount === 1 ? '' : 's'} ` +
+                `in "${input.path}".`,
+            isError: false,
+        };
+    },
+});
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Count how many times `needle` appears in `haystack`.
+ * Uses a plain loop to avoid constructing a potentially large regex from
+ * untrusted input.
+ */
+function countOccurrences(haystack, needle) {
+    if (needle.length === 0)
+        return 0;
+    let count = 0;
+    let pos = 0;
+    while ((pos = haystack.indexOf(needle, pos)) !== -1) {
+        count++;
+        pos += needle.length;
+    }
+    return count;
+}
+/**
+ * Replace all occurrences of `needle` in `haystack` with `replacement`
+ * without using a regex (avoids regex-special-character escaping issues).
+ */
+function replaceAllOccurrences(haystack, needle, replacement) {
+    if (needle.length === 0)
+        return haystack;
+    const parts = [];
+    let pos = 0;
+    let next;
+    while ((next = haystack.indexOf(needle, pos)) !== -1) {
+        parts.push(haystack.slice(pos, next));
+        parts.push(replacement);
+        pos = next + needle.length;
+    }
+    parts.push(haystack.slice(pos));
+    return parts.join('');
+}
+//# sourceMappingURL=file-edit.js.map

package/dist/tool/built-in/file-edit.js.map

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

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

@@ -0,0 +1,12 @@
+/**
+ * Built-in file-read tool.
+ *
+ * Reads a file from disk and returns its contents with 1-based line numbers.
+ * Supports reading a slice of lines via `offset` and `limit` for large files.
+ */
+export declare const fileReadTool: import("../framework.js").ToolDefinition<{
+    path: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}>;
+//# sourceMappingURL=file-read.d.ts.map

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

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