@open-multi-agent/core 1.4.0

package/dist/agent/agent.js

@@ -0,0 +1,559 @@
+/**
+ * @fileoverview High-level Agent class for open-multi-agent.
+ *
+ * {@link Agent} is the primary interface most consumers interact with.
+ * It wraps {@link AgentRunner} with:
+ *  - Persistent conversation history (`prompt()`)
+ *  - Fresh-conversation semantics (`run()`)
+ *  - Streaming support (`stream()`)
+ *  - Dynamic tool registration at runtime
+ *  - Full lifecycle state tracking (`idle → running → completed | error`)
+ *
+ * @example
+ * ```ts
+ * import { Agent, ToolRegistry, ToolExecutor, registerBuiltInTools } from '@open-multi-agent/core'
+ *
+ * const registry = new ToolRegistry()
+ * registerBuiltInTools(registry)
+ * const executor = new ToolExecutor(registry)
+ *
+ * const agent = new Agent(
+ *   {
+ *     name: 'researcher',
+ *     model: 'claude-sonnet-4-6',
+ *     systemPrompt: 'You are a rigorous research assistant.',
+ *     tools: ['file_read', 'grep'],
+ *   },
+ *   registry,
+ *   executor,
+ * )
+ *
+ * const result = await agent.run('Summarise the project README.')
+ * console.log(result.output)
+ *
+ * // For one-shot runs without managing the Agent instance, use
+ * // `new OpenMultiAgent().runAgent(config, prompt)` instead.
+ * ```
+ */
+import { emitTrace, generateRunId } from '../utils/trace.js';
+import { createAdapter } from '../llm/adapter.js';
+import { AgentRunner } from './runner.js';
+import { buildStructuredOutputInstruction, extractJSON, validateOutput, } from './structured-output.js';
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+const ZERO_USAGE = { input_tokens: 0, output_tokens: 0 };
+/**
+ * Combine two {@link AbortSignal}s so that aborting either one cancels the
+ * returned signal.  Works on Node 18+ (no `AbortSignal.any` required).
+ */
+function mergeAbortSignals(a, b) {
+    const controller = new AbortController();
+    if (a.aborted || b.aborted) {
+        controller.abort();
+        return controller.signal;
+    }
+    const abort = () => controller.abort();
+    a.addEventListener('abort', abort, { once: true });
+    b.addEventListener('abort', abort, { once: true });
+    return controller.signal;
+}
+function addUsage(a, b) {
+    return {
+        input_tokens: a.input_tokens + b.input_tokens,
+        output_tokens: a.output_tokens + b.output_tokens,
+    };
+}
+// ---------------------------------------------------------------------------
+// Agent
+// ---------------------------------------------------------------------------
+/**
+ * High-level wrapper around {@link AgentRunner} that manages conversation
+ * history, state transitions, and tool lifecycle.
+ */
+export class Agent {
+    name;
+    config;
+    runner = null;
+    state;
+    _toolRegistry;
+    _toolExecutor;
+    messageHistory = [];
+    /**
+     * @param config       - Static configuration for this agent.
+     * @param toolRegistry - Registry used to resolve and manage tools.
+     * @param toolExecutor - Executor that dispatches tool calls.
+     *
+     * `toolRegistry` and `toolExecutor` are injected rather than instantiated
+     * internally so that teams of agents can share a single registry.
+     */
+    constructor(config, toolRegistry, toolExecutor) {
+        this.name = config.name;
+        this.config = config;
+        this._toolRegistry = toolRegistry;
+        this._toolExecutor = toolExecutor;
+        this.state = {
+            status: 'idle',
+            messages: [],
+            tokenUsage: ZERO_USAGE,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Initialisation (async, called lazily)
+    // -------------------------------------------------------------------------
+    /**
+     * Lazily create the {@link AgentRunner}.
+     *
+     * The adapter is created asynchronously (it may lazy-import provider SDKs),
+     * so we defer construction until the first `run` / `prompt` / `stream` call.
+     */
+    async getRunner() {
+        if (this.runner !== null) {
+            return this.runner;
+        }
+        const provider = this.config.provider ?? 'anthropic';
+        const adapter = await createAdapter(provider, this.config.apiKey, this.config.baseURL, this.config.region);
+        // Append structured-output instructions when an outputSchema is configured.
+        let effectiveSystemPrompt = this.config.systemPrompt;
+        if (this.config.outputSchema) {
+            const instruction = buildStructuredOutputInstruction(this.config.outputSchema);
+            effectiveSystemPrompt = effectiveSystemPrompt
+                ? effectiveSystemPrompt + '\n' + instruction
+                : instruction;
+        }
+        const runnerOptions = {
+            model: this.config.model,
+            systemPrompt: effectiveSystemPrompt,
+            maxTurns: this.config.maxTurns,
+            maxTokens: this.config.maxTokens,
+            temperature: this.config.temperature,
+            topP: this.config.topP,
+            topK: this.config.topK,
+            minP: this.config.minP,
+            parallelToolCalls: this.config.parallelToolCalls,
+            frequencyPenalty: this.config.frequencyPenalty,
+            presencePenalty: this.config.presencePenalty,
+            extraBody: this.config.extraBody,
+            thinking: this.config.thinking,
+            toolPreset: this.config.toolPreset,
+            allowedTools: this.config.tools,
+            disallowedTools: this.config.disallowedTools,
+            agentName: this.name,
+            agentRole: this.config.systemPrompt?.slice(0, 50) ?? 'assistant',
+            loopDetection: this.config.loopDetection,
+            maxTokenBudget: this.config.maxTokenBudget,
+            contextStrategy: this.config.contextStrategy,
+            compressToolResults: this.config.compressToolResults,
+        };
+        this.runner = new AgentRunner(adapter, this._toolRegistry, this._toolExecutor, runnerOptions);
+        return this.runner;
+    }
+    // -------------------------------------------------------------------------
+    // Primary execution methods
+    // -------------------------------------------------------------------------
+    /**
+     * Run `prompt` in a fresh conversation (history is NOT used).
+     *
+     * Equivalent to constructing a brand-new messages array `[{ role:'user', … }]`
+     * and calling the runner once. The agent's persistent history is not modified.
+     *
+     * Use this for one-shot queries where past context is irrelevant.
+     */
+    async run(prompt, runOptions) {
+        const messages = [
+            { role: 'user', content: [{ type: 'text', text: prompt }] },
+        ];
+        return this.executeRun(messages, runOptions);
+    }
+    /**
+     * Run `prompt` as part of the ongoing conversation.
+     *
+     * Appends the user message to the persistent history, runs the agent, then
+     * appends the resulting messages to the history for the next call.
+     *
+     * Use this for multi-turn interactions.
+     */
+    // TODO(#18): accept optional RunOptions to forward trace context
+    async prompt(message) {
+        const userMessage = {
+            role: 'user',
+            content: [{ type: 'text', text: message }],
+        };
+        this.messageHistory.push(userMessage);
+        const result = await this.executeRun([...this.messageHistory]);
+        // Persist the new messages into history so the next `prompt` sees them.
+        for (const msg of result.messages) {
+            this.messageHistory.push(msg);
+        }
+        return result;
+    }
+    /**
+     * Stream a fresh-conversation response, yielding {@link StreamEvent}s.
+     *
+     * Like {@link run}, this does not use or update the persistent history.
+     */
+    async *stream(prompt, runOptions) {
+        const messages = [
+            { role: 'user', content: [{ type: 'text', text: prompt }] },
+        ];
+        yield* this.executeStream(messages, runOptions);
+    }
+    // -------------------------------------------------------------------------
+    // State management
+    // -------------------------------------------------------------------------
+    /** Return a snapshot of the current agent state (does not clone nested objects). */
+    getState() {
+        return { ...this.state, messages: [...this.state.messages] };
+    }
+    /** Return a copy of the persistent message history. */
+    getHistory() {
+        return [...this.messageHistory];
+    }
+    /**
+     * Clear the persistent conversation history and reset state to `idle`.
+     * Does NOT discard the runner instance — the adapter connection is reused.
+     */
+    reset() {
+        this.messageHistory = [];
+        this.state = {
+            status: 'idle',
+            messages: [],
+            tokenUsage: ZERO_USAGE,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Dynamic tool management
+    // -------------------------------------------------------------------------
+    /**
+     * Register a new tool with this agent's tool registry at runtime.
+     *
+     * The tool becomes available to the next LLM call — no restart required.
+     */
+    addTool(tool) {
+        this._toolRegistry.register(tool, { runtimeAdded: true });
+    }
+    /**
+     * Deregister a tool by name.
+     * If the tool is not registered this is a no-op (no error is thrown).
+     */
+    removeTool(name) {
+        this._toolRegistry.deregister(name);
+    }
+    /** Return the names of all currently registered tools. */
+    getTools() {
+        return this._toolRegistry.list().map((t) => t.name);
+    }
+    // -------------------------------------------------------------------------
+    // Private execution core
+    // -------------------------------------------------------------------------
+    /**
+     * Shared execution path used by both `run` and `prompt`.
+     * Handles state transitions and error wrapping.
+     */
+    async executeRun(messages, callerOptions) {
+        this.transitionTo('running');
+        const agentStartMs = Date.now();
+        try {
+            // --- beforeRun hook ---
+            if (this.config.beforeRun) {
+                const hookCtx = this.buildBeforeRunHookContext(messages);
+                const modified = await this.config.beforeRun(hookCtx);
+                this.applyHookContext(messages, modified, hookCtx.prompt);
+            }
+            const runner = await this.getRunner();
+            const internalOnMessage = (msg) => {
+                this.state.messages.push(msg);
+                callerOptions?.onMessage?.(msg);
+            };
+            // Auto-generate runId when onTrace is provided but runId is missing
+            const needsRunId = callerOptions?.onTrace && !callerOptions.runId;
+            // Create a fresh timeout signal per run (not per runner) so that
+            // each run() / prompt() call gets its own timeout window.
+            const timeoutSignal = this.config.timeoutMs !== undefined && this.config.timeoutMs > 0
+                ? AbortSignal.timeout(this.config.timeoutMs)
+                : undefined;
+            // Merge caller-provided abortSignal with the timeout signal so that
+            // either cancellation source is respected.
+            const callerAbort = callerOptions?.abortSignal;
+            const effectiveAbort = timeoutSignal && callerAbort
+                ? mergeAbortSignals(timeoutSignal, callerAbort)
+                : timeoutSignal ?? callerAbort;
+            const runOptions = {
+                ...callerOptions,
+                onMessage: internalOnMessage,
+                ...(needsRunId ? { runId: generateRunId() } : undefined),
+                ...(effectiveAbort ? { abortSignal: effectiveAbort } : undefined),
+            };
+            const result = await runner.run(messages, runOptions);
+            this.state.tokenUsage = addUsage(this.state.tokenUsage, result.tokenUsage);
+            if (result.budgetExceeded) {
+                let budgetResult = this.toAgentRunResult(result, false);
+                if (this.config.afterRun) {
+                    budgetResult = await this.config.afterRun(budgetResult);
+                }
+                this.transitionTo('completed');
+                this.emitAgentTrace(callerOptions, agentStartMs, budgetResult);
+                return budgetResult;
+            }
+            // --- Structured output validation ---
+            if (this.config.outputSchema) {
+                let validated = await this.validateStructuredOutput(messages, result, runner, runOptions);
+                // --- afterRun hook ---
+                if (this.config.afterRun) {
+                    validated = await this.config.afterRun(validated);
+                }
+                this.emitAgentTrace(callerOptions, agentStartMs, validated);
+                return validated;
+            }
+            let agentResult = this.toAgentRunResult(result, true);
+            // --- afterRun hook ---
+            if (this.config.afterRun) {
+                agentResult = await this.config.afterRun(agentResult);
+            }
+            this.transitionTo('completed');
+            this.emitAgentTrace(callerOptions, agentStartMs, agentResult);
+            return agentResult;
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.transitionToError(error);
+            const errorResult = {
+                success: false,
+                output: error.message,
+                messages: [],
+                tokenUsage: ZERO_USAGE,
+                toolCalls: [],
+                structured: undefined,
+            };
+            this.emitAgentTrace(callerOptions, agentStartMs, errorResult);
+            return errorResult;
+        }
+    }
+    /** Emit an `agent` trace event if `onTrace` is provided. */
+    emitAgentTrace(options, startMs, result) {
+        if (!options?.onTrace)
+            return;
+        const endMs = Date.now();
+        emitTrace(options.onTrace, {
+            type: 'agent',
+            runId: options.runId ?? '',
+            taskId: options.taskId,
+            agent: options.traceAgent ?? this.name,
+            turns: result.messages.filter(m => m.role === 'assistant').length,
+            tokens: result.tokenUsage,
+            toolCalls: result.toolCalls.length,
+            startMs,
+            endMs,
+            durationMs: endMs - startMs,
+        });
+    }
+    /**
+     * Validate agent output against the configured `outputSchema`.
+     * On first validation failure, retry once with error feedback.
+     */
+    async validateStructuredOutput(originalMessages, result, runner, runOptions) {
+        const schema = this.config.outputSchema;
+        // First attempt
+        let firstAttemptError;
+        try {
+            const parsed = extractJSON(result.output);
+            const validated = validateOutput(schema, parsed);
+            this.transitionTo('completed');
+            return this.toAgentRunResult(result, true, validated);
+        }
+        catch (e) {
+            firstAttemptError = e;
+        }
+        // Retry: send full context + error feedback
+        const errorMsg = firstAttemptError instanceof Error
+            ? firstAttemptError.message
+            : String(firstAttemptError);
+        const errorFeedbackMessage = {
+            role: 'user',
+            content: [{
+                    type: 'text',
+                    text: [
+                        'Your previous response did not produce valid JSON matching the required schema.',
+                        '',
+                        `Error: ${errorMsg}`,
+                        '',
+                        'Please try again. Respond with ONLY valid JSON, no other text.',
+                    ].join('\n'),
+                }],
+        };
+        const retryMessages = [
+            ...originalMessages,
+            ...result.messages,
+            errorFeedbackMessage,
+        ];
+        const retryResult = await runner.run(retryMessages, runOptions);
+        this.state.tokenUsage = addUsage(this.state.tokenUsage, retryResult.tokenUsage);
+        const mergedTokenUsage = addUsage(result.tokenUsage, retryResult.tokenUsage);
+        // Include the error feedback turn to maintain alternating user/assistant roles,
+        // which is required by Anthropic's API for subsequent prompt() calls.
+        const mergedMessages = [...result.messages, errorFeedbackMessage, ...retryResult.messages];
+        const mergedToolCalls = [...result.toolCalls, ...retryResult.toolCalls];
+        try {
+            const parsed = extractJSON(retryResult.output);
+            const validated = validateOutput(schema, parsed);
+            this.transitionTo('completed');
+            return {
+                success: true,
+                output: retryResult.output,
+                messages: mergedMessages,
+                tokenUsage: mergedTokenUsage,
+                toolCalls: mergedToolCalls,
+                structured: validated,
+                ...(retryResult.budgetExceeded ? { budgetExceeded: true } : {}),
+            };
+        }
+        catch {
+            // Retry also failed
+            this.transitionTo('completed');
+            return {
+                success: false,
+                output: retryResult.output,
+                messages: mergedMessages,
+                tokenUsage: mergedTokenUsage,
+                toolCalls: mergedToolCalls,
+                structured: undefined,
+                ...(retryResult.budgetExceeded ? { budgetExceeded: true } : {}),
+            };
+        }
+    }
+    /**
+     * Shared streaming path used by `stream`.
+     * Handles state transitions and error wrapping.
+     */
+    async *executeStream(messages, callerOptions) {
+        this.transitionTo('running');
+        try {
+            // --- beforeRun hook ---
+            if (this.config.beforeRun) {
+                const hookCtx = this.buildBeforeRunHookContext(messages);
+                const modified = await this.config.beforeRun(hookCtx);
+                this.applyHookContext(messages, modified, hookCtx.prompt);
+            }
+            const runner = await this.getRunner();
+            // Fresh timeout per stream call, same as executeRun.
+            const timeoutSignal = this.config.timeoutMs !== undefined && this.config.timeoutMs > 0
+                ? AbortSignal.timeout(this.config.timeoutMs)
+                : undefined;
+            const callerAbort = callerOptions?.abortSignal;
+            const effectiveAbort = timeoutSignal && callerAbort
+                ? mergeAbortSignals(timeoutSignal, callerAbort)
+                : timeoutSignal ?? callerAbort;
+            for await (const event of runner.stream(messages, {
+                ...callerOptions,
+                ...(effectiveAbort ? { abortSignal: effectiveAbort } : {}),
+            })) {
+                if (event.type === 'done') {
+                    const result = event.data;
+                    this.state.tokenUsage = addUsage(this.state.tokenUsage, result.tokenUsage);
+                    let agentResult = this.toAgentRunResult(result, !result.budgetExceeded);
+                    if (this.config.afterRun) {
+                        agentResult = await this.config.afterRun(agentResult);
+                    }
+                    this.transitionTo('completed');
+                    yield { type: 'done', data: agentResult };
+                    continue;
+                }
+                else if (event.type === 'error') {
+                    const error = event.data instanceof Error
+                        ? event.data
+                        : new Error(String(event.data));
+                    this.transitionToError(error);
+                }
+                yield event;
+            }
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.transitionToError(error);
+            yield { type: 'error', data: error };
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Hook helpers
+    // -------------------------------------------------------------------------
+    /** Extract the prompt text from the last user message to build hook context. */
+    buildBeforeRunHookContext(messages) {
+        let prompt = '';
+        for (let i = messages.length - 1; i >= 0; i--) {
+            if (messages[i].role === 'user') {
+                prompt = messages[i].content
+                    .filter((b) => b.type === 'text')
+                    .map(b => b.text)
+                    .join('');
+                break;
+            }
+        }
+        // Strip hook functions to avoid circular self-references in the context
+        const { beforeRun, afterRun, ...agentInfo } = this.config;
+        return { prompt, agent: agentInfo };
+    }
+    /**
+     * Apply a (possibly modified) hook context back to the messages array.
+     *
+     * Only text blocks in the last user message are replaced; non-text content
+     * (images, tool results) is preserved. The array element is replaced (not
+     * mutated in place) so that shallow copies of the original array (e.g. from
+     * `prompt()`) are not affected.
+     */
+    applyHookContext(messages, ctx, originalPrompt) {
+        if (ctx.prompt === originalPrompt)
+            return;
+        for (let i = messages.length - 1; i >= 0; i--) {
+            if (messages[i].role === 'user') {
+                const nonTextBlocks = messages[i].content.filter(b => b.type !== 'text');
+                messages[i] = {
+                    role: 'user',
+                    content: [{ type: 'text', text: ctx.prompt }, ...nonTextBlocks],
+                };
+                break;
+            }
+        }
+    }
+    // -------------------------------------------------------------------------
+    // State transition helpers
+    // -------------------------------------------------------------------------
+    transitionTo(status) {
+        this.state = { ...this.state, status };
+    }
+    transitionToError(error) {
+        this.state = { ...this.state, status: 'error', error };
+    }
+    // -------------------------------------------------------------------------
+    // Result mapping
+    // -------------------------------------------------------------------------
+    toAgentRunResult(result, success, structured) {
+        return {
+            success,
+            output: result.output,
+            messages: result.messages,
+            tokenUsage: result.tokenUsage,
+            toolCalls: result.toolCalls,
+            structured,
+            ...(result.loopDetected ? { loopDetected: true } : {}),
+            ...(result.budgetExceeded ? { budgetExceeded: true } : {}),
+        };
+    }
+    // -------------------------------------------------------------------------
+    // ToolUseContext builder (for direct use by subclasses or advanced callers)
+    // -------------------------------------------------------------------------
+    /**
+     * Build a {@link ToolUseContext} that identifies this agent.
+     * Exposed so team orchestrators can inject richer context (e.g. `TeamInfo`).
+     */
+    buildToolContext(abortSignal) {
+        return {
+            agent: {
+                name: this.name,
+                role: this.config.systemPrompt?.slice(0, 60) ?? 'assistant',
+                model: this.config.model,
+            },
+            abortSignal,
+        };
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent/agent.js.map

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

package/dist/agent/loop-detector.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Sliding-window loop detector for the agent conversation loop.
+ *
+ * Tracks tool-call signatures and text outputs across turns to detect when an
+ * agent is stuck repeating the same actions. Used by {@link AgentRunner} when
+ * {@link LoopDetectionConfig} is provided.
+ */
+import type { LoopDetectionConfig, LoopDetectionInfo } from '../types.js';
+export declare class LoopDetector {
+    private readonly maxRepeats;
+    private readonly windowSize;
+    private readonly toolSignatures;
+    private readonly textOutputs;
+    constructor(config?: LoopDetectionConfig);
+    /**
+     * Record a turn's tool calls. Returns detection info when a loop is found.
+     */
+    recordToolCalls(blocks: ReadonlyArray<{
+        name: string;
+        input: Record<string, unknown>;
+    }>): LoopDetectionInfo | null;
+    /**
+     * Record a turn's text output. Returns detection info when a loop is found.
+     */
+    recordText(text: string): LoopDetectionInfo | null;
+    /**
+     * Deterministic JSON signature for a set of tool calls.
+     * Sorts calls by name (for multi-tool turns) and keys within each input.
+     */
+    private computeToolSignature;
+    /** Push an entry and trim the buffer to `windowSize`. */
+    private push;
+    /**
+     * Count how many consecutive identical entries exist at the tail of `buffer`.
+     * Returns 1 when the last entry is unique.
+     */
+    private consecutiveRepeats;
+}
+//# sourceMappingURL=loop-detector.d.ts.map

package/dist/agent/loop-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-detector.d.ts","sourceRoot":"","sources":["../../src/agent/loop-detector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAwBzE,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IAEnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAe;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;gBAE/B,MAAM,GAAE,mBAAwB;IAO5C;;OAEG;IACH,eAAe,CACb,MAAM,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,GACtE,iBAAiB,GAAG,IAAI;IAoB3B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAuBlD;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAa5B,yDAAyD;IACzD,OAAO,CAAC,IAAI;IAOZ;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAU3B"}