@strands-agents/sdk 0.0.1

package/dist/src/agent/agent.js

@@ -0,0 +1,481 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import { AgentResult, BedrockModel, McpClient, Message, TextBlock, ToolResultBlock, } from '../index.js';
+import { systemPromptFromData } from '../types/messages.js';
+import { normalizeError, ConcurrentInvocationError } from '../errors.js';
+import { ToolRegistry } from '../registry/tool-registry.js';
+import { AgentState } from './state.js';
+import { AgentPrinter, getDefaultAppender } from './printer.js';
+import { SlidingWindowConversationManager } from '../conversation-manager/sliding-window-conversation-manager.js';
+import { HookRegistryImplementation } from '../hooks/registry.js';
+import { HookEvent, AfterInvocationEvent, AfterModelCallEvent, AfterToolCallEvent, AfterToolsEvent, BeforeInvocationEvent, BeforeModelCallEvent, BeforeToolCallEvent, BeforeToolsEvent, MessageAddedEvent, ModelStreamEventHook, } from '../hooks/events.js';
+/**
+ * Orchestrates the interaction between a model, a set of tools, and MCP clients.
+ * The Agent is responsible for managing the lifecycle of tools and clients
+ * and invoking the core decision-making loop.
+ */
+export class Agent {
+    /**
+     * The conversation history of messages between user and assistant.
+     */
+    messages;
+    /**
+     * Agent state storage accessible to tools and application logic.
+     * State is not passed to the model during inference.
+     */
+    state;
+    /**
+     * Conversation manager for handling message history and context overflow.
+     */
+    conversationManager;
+    /**
+     * Hook registry for managing event callbacks.
+     * Hooks enable observing and extending agent behavior.
+     */
+    hooks;
+    /**
+     * The model provider used by the agent for inference.
+     */
+    model;
+    _toolRegistry;
+    _mcpClients;
+    _systemPrompt;
+    _initialized;
+    _isInvoking = false;
+    _printer;
+    /**
+     * Creates an instance of the Agent.
+     * @param config - The configuration for the agent.
+     */
+    constructor(config) {
+        // Initialize public fields
+        this.messages = (config?.messages ?? []).map((msg) => (msg instanceof Message ? msg : Message.fromMessageData(msg)));
+        this.state = new AgentState(config?.state);
+        this.conversationManager = config?.conversationManager ?? new SlidingWindowConversationManager({ windowSize: 40 });
+        // Initialize hooks and register conversation manager hooks
+        this.hooks = new HookRegistryImplementation();
+        this.hooks.addHook(this.conversationManager);
+        this.hooks.addAllHooks(config?.hooks ?? []);
+        this.model = config?.model ?? new BedrockModel();
+        const { tools, mcpClients } = flattenTools(config?.tools ?? []);
+        this._toolRegistry = new ToolRegistry(tools);
+        this._mcpClients = mcpClients;
+        if (config?.systemPrompt !== undefined) {
+            this._systemPrompt = systemPromptFromData(config.systemPrompt);
+        }
+        // Create printer if printer is enabled (default: true)
+        const printer = config?.printer ?? true;
+        if (printer) {
+            this._printer = new AgentPrinter(getDefaultAppender());
+        }
+        this._initialized = false;
+    }
+    async initialize() {
+        if (this._initialized) {
+            return;
+        }
+        await Promise.all(this._mcpClients.map(async (client) => {
+            const tools = await client.listTools();
+            this._toolRegistry.addAll(tools);
+        }));
+        this._initialized = true;
+    }
+    /**
+     * Acquires a lock to prevent concurrent invocations.
+     * Returns a Disposable that releases the lock when disposed.
+     */
+    acquireLock() {
+        if (this._isInvoking) {
+            throw new ConcurrentInvocationError('Agent is already processing an invocation. Wait for the current invoke() or stream() call to complete before invoking again.');
+        }
+        this._isInvoking = true;
+        return {
+            [Symbol.dispose]: () => {
+                this._isInvoking = false;
+            },
+        };
+    }
+    /**
+     * The tools this agent can use.
+     */
+    get tools() {
+        return this._toolRegistry.values();
+    }
+    /**
+     * The tool registry for managing the agent's tools.
+     */
+    get toolRegistry() {
+        return this._toolRegistry;
+    }
+    /**
+     * Invokes the agent and returns the final result.
+     *
+     * This is a convenience method that consumes the stream() method and returns
+     * only the final AgentResult. Use stream() if you need access to intermediate
+     * streaming events.
+     *
+     * @param args - Arguments for invoking the agent
+     * @returns Promise that resolves to the final AgentResult
+     *
+     * @example
+     * ```typescript
+     * const agent = new Agent({ model, tools })
+     * const result = await agent.invoke('What is 2 + 2?')
+     * console.log(result.lastMessage) // Agent's response
+     * ```
+     */
+    async invoke(args) {
+        const gen = this.stream(args);
+        let result = await gen.next();
+        while (!result.done) {
+            result = await gen.next();
+        }
+        return result.value;
+    }
+    /**
+     * Streams the agent execution, yielding events and returning the final result.
+     *
+     * The agent loop manages the conversation flow by:
+     * 1. Streaming model responses and yielding all events
+     * 2. Executing tools when the model requests them
+     * 3. Continuing the loop until the model completes without tool use
+     *
+     * Use this method when you need access to intermediate streaming events.
+     * For simple request/response without streaming, use invoke() instead.
+     *
+     * An explicit goal of this method is to always leave the message array in a way that
+     * the agent can be reinvoked with a user prompt after this method completes. To that end
+     * assistant messages containing tool uses are only added after tool execution succeeds
+     * with valid toolResponses
+     *
+     * @param args - Arguments for invoking the agent
+     * @returns Async generator that yields AgentStreamEvent objects and returns AgentResult
+     *
+     * @example
+     * ```typescript
+     * const agent = new Agent({ model, tools })
+     *
+     * for await (const event of agent.stream('Hello')) {
+     *   console.log('Event:', event.type)
+     * }
+     * // Messages array is mutated in place and contains the full conversation
+     * ```
+     */
+    async *stream(args) {
+        const env_1 = { stack: [], error: void 0, hasError: false };
+        try {
+            const _lock = __addDisposableResource(env_1, this.acquireLock(), false);
+            await this.initialize();
+            // Delegate to _stream and process events through printer and hooks
+            const streamGenerator = this._stream(args);
+            let result = await streamGenerator.next();
+            while (!result.done) {
+                const event = result.value;
+                // Invoke hook callbacks for Hook Events (except MessageAddedEvent which invokes in _appendMessage)
+                if (event instanceof HookEvent && !(event instanceof MessageAddedEvent)) {
+                    await this.hooks.invokeCallbacks(event);
+                }
+                this._printer?.processEvent(event);
+                yield event;
+                result = await streamGenerator.next();
+            }
+            // Yield final result as last event
+            yield result.value;
+            return result.value;
+        }
+        catch (e_1) {
+            env_1.error = e_1;
+            env_1.hasError = true;
+        }
+        finally {
+            __disposeResources(env_1);
+        }
+    }
+    /**
+     * Internal implementation of the agent streaming logic.
+     * Separated to centralize printer event processing in the public stream method.
+     *
+     * @param args - Arguments for invoking the agent
+     * @returns Async generator that yields AgentStreamEvent objects and returns AgentResult
+     */
+    async *_stream(args) {
+        let currentArgs = args;
+        // Emit event before the loop starts
+        yield new BeforeInvocationEvent({ agent: this });
+        try {
+            // Main agent loop - continues until model stops without requesting tools
+            while (true) {
+                const modelResult = yield* this.invokeModel(currentArgs);
+                currentArgs = undefined; // Only pass args on first invocation
+                if (modelResult.stopReason !== 'toolUse') {
+                    // Loop terminates - no tool use requested
+                    // Add assistant message now that we're returning
+                    yield await this._appendMessage(modelResult.message);
+                    return new AgentResult({
+                        stopReason: modelResult.stopReason,
+                        lastMessage: modelResult.message,
+                    });
+                }
+                // Execute tools sequentially
+                const toolResultMessage = yield* this.executeTools(modelResult.message, this._toolRegistry);
+                // Add assistant message with tool uses right before adding tool results
+                // This ensures we don't have dangling tool use messages if tool execution fails
+                yield await this._appendMessage(modelResult.message);
+                yield await this._appendMessage(toolResultMessage);
+                // Continue loop
+            }
+        }
+        finally {
+            // Always emit final event
+            yield new AfterInvocationEvent({ agent: this });
+        }
+    }
+    /**
+     * Invokes the model provider and streams all events.
+     *
+     * @param args - Optional arguments for invoking the model
+     * @returns Object containing the assistant message and stop reason
+     */
+    async *invokeModel(args) {
+        if (args !== undefined && typeof args === 'string') {
+            // Add user message from args
+            yield await this._appendMessage(new Message({
+                role: 'user',
+                content: [new TextBlock(args)],
+            }));
+        }
+        const toolSpecs = this._toolRegistry.values().map((tool) => tool.toolSpec);
+        const streamOptions = { toolSpecs };
+        if (this._systemPrompt !== undefined) {
+            streamOptions.systemPrompt = this._systemPrompt;
+        }
+        yield new BeforeModelCallEvent({ agent: this });
+        try {
+            const { message, stopReason } = yield* this._streamFromModel(this.messages, streamOptions);
+            yield new AfterModelCallEvent({ agent: this, stopData: { message, stopReason } });
+            return { message, stopReason };
+        }
+        catch (error) {
+            const modelError = normalizeError(error);
+            // Create error event
+            const errorEvent = new AfterModelCallEvent({ agent: this, error: modelError });
+            // Yield error event - stream will invoke hooks
+            yield errorEvent;
+            // After yielding, hooks have been invoked and may have set retryModelCall
+            if (errorEvent.retryModelCall) {
+                return yield* this.invokeModel(args);
+            }
+            // Re-throw error
+            throw error;
+        }
+    }
+    /**
+     * Streams events from the model and fires ModelStreamEventHook for each event.
+     *
+     * @param messages - Messages to send to the model
+     * @param streamOptions - Options for streaming
+     * @returns Object containing the assistant message and stop reason
+     */
+    async *_streamFromModel(messages, streamOptions) {
+        const streamGenerator = this.model.streamAggregated(messages, streamOptions);
+        let result = await streamGenerator.next();
+        while (!result.done) {
+            const event = result.value;
+            // Yield hook event for observability
+            yield new ModelStreamEventHook({ agent: this, event });
+            // Yield the actual model event
+            yield event;
+            result = await streamGenerator.next();
+        }
+        // result.done is true, result.value contains the return value
+        return result.value;
+    }
+    /**
+     * Executes tools sequentially and streams all tool events.
+     *
+     * @param assistantMessage - The assistant message containing tool use blocks
+     * @param toolRegistry - Registry containing available tools
+     * @returns User message containing tool results
+     */
+    async *executeTools(assistantMessage, toolRegistry) {
+        yield new BeforeToolsEvent({ agent: this, message: assistantMessage });
+        // Extract tool use blocks from assistant message
+        const toolUseBlocks = assistantMessage.content.filter((block) => block.type === 'toolUseBlock');
+        if (toolUseBlocks.length === 0) {
+            // No tool use blocks found even though stopReason is toolUse
+            throw new Error('Model indicated toolUse but no tool use blocks found in message');
+        }
+        const toolResultBlocks = [];
+        for (const toolUseBlock of toolUseBlocks) {
+            const toolResultBlock = yield* this.executeTool(toolUseBlock, toolRegistry);
+            toolResultBlocks.push(toolResultBlock);
+            // Yield the tool result block as it's created
+            yield toolResultBlock;
+        }
+        // Create user message with tool results
+        const toolResultMessage = new Message({
+            role: 'user',
+            content: toolResultBlocks,
+        });
+        yield new AfterToolsEvent({ agent: this, message: toolResultMessage });
+        return toolResultMessage;
+    }
+    /**
+     * Executes a single tool and returns the result.
+     * If the tool is not found or fails to return a result, returns an error ToolResult
+     * instead of throwing an exception. This allows the agent loop to continue and
+     * let the model handle the error gracefully.
+     *
+     * @param toolUseBlock - Tool use block to execute
+     * @param toolRegistry - Registry containing available tools
+     * @returns Tool result block
+     */
+    async *executeTool(toolUseBlock, toolRegistry) {
+        const tool = toolRegistry.find((t) => t.name === toolUseBlock.name);
+        // Create toolUse object for hook events
+        const toolUse = {
+            name: toolUseBlock.name,
+            toolUseId: toolUseBlock.toolUseId,
+            input: toolUseBlock.input,
+        };
+        yield new BeforeToolCallEvent({ agent: this, toolUse, tool });
+        if (!tool) {
+            // Tool not found - return error result instead of throwing
+            const errorResult = new ToolResultBlock({
+                toolUseId: toolUseBlock.toolUseId,
+                status: 'error',
+                content: [new TextBlock(`Tool '${toolUseBlock.name}' not found in registry`)],
+            });
+            yield new AfterToolCallEvent({ agent: this, toolUse, tool, result: errorResult });
+            return errorResult;
+        }
+        // Execute tool and collect result
+        const toolContext = {
+            toolUse: {
+                name: toolUseBlock.name,
+                toolUseId: toolUseBlock.toolUseId,
+                input: toolUseBlock.input,
+            },
+            agent: this,
+        };
+        try {
+            const toolGenerator = tool.stream(toolContext);
+            // Use yield* to delegate to the tool generator and capture the return value
+            const toolResult = yield* toolGenerator;
+            if (!toolResult) {
+                // Tool didn't return a result - return error result instead of throwing
+                const errorResult = new ToolResultBlock({
+                    toolUseId: toolUseBlock.toolUseId,
+                    status: 'error',
+                    content: [new TextBlock(`Tool '${toolUseBlock.name}' did not return a result`)],
+                });
+                yield new AfterToolCallEvent({ agent: this, toolUse, tool, result: errorResult });
+                return errorResult;
+            }
+            yield new AfterToolCallEvent({ agent: this, toolUse, tool, result: toolResult });
+            // Tool already returns ToolResultBlock directly
+            return toolResult;
+        }
+        catch (error) {
+            // Tool execution failed with error
+            const toolError = normalizeError(error);
+            const errorResult = new ToolResultBlock({
+                toolUseId: toolUseBlock.toolUseId,
+                status: 'error',
+                content: [new TextBlock(toolError.message)],
+                error: toolError,
+            });
+            yield new AfterToolCallEvent({ agent: this, toolUse, tool, result: errorResult, error: toolError });
+            return errorResult;
+        }
+    }
+    /**
+     * Appends a message to the conversation history, invokes MessageAddedEvent hook,
+     * and returns the event for yielding.
+     *
+     * @param message - The message to append
+     * @returns MessageAddedEvent to be yielded (hook already invoked)
+     */
+    async _appendMessage(message) {
+        this.messages.push(message);
+        const event = new MessageAddedEvent({ agent: this, message });
+        // Invoke hooks immediately for message tracking
+        await this.hooks.invokeCallbacks(event);
+        // Return event for yielding (stream will skip hook invocation for MessageAddedEvent)
+        return event;
+    }
+}
+/**
+ * Recursively flattens nested arrays of tools into a single flat array.
+ * @param tools - Tools or nested arrays of tools
+ * @returns Flat array of tools and MCP clients
+ */
+function flattenTools(toolList) {
+    const tools = [];
+    const mcpClients = [];
+    for (const item of toolList) {
+        if (Array.isArray(item)) {
+            const { tools: nestedTools, mcpClients: nestedMcpClients } = flattenTools(item);
+            tools.push(...nestedTools);
+            mcpClients.push(...nestedMcpClients);
+        }
+        else if (item instanceof McpClient) {
+            mcpClients.push(item);
+        }
+        else {
+            tools.push(item);
+        }
+    }
+    return { tools, mcpClients };
+}
+//# sourceMappingURL=agent.js.map

package/dist/src/agent/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../src/agent/agent.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EACL,WAAW,EAEX,YAAY,EAEZ,SAAS,EACT,OAAO,EAIP,SAAS,EAGT,eAAe,GAEhB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AAExE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAgB,MAAM,cAAc,CAAA;AAE7E,OAAO,EAAE,gCAAgC,EAAE,MAAM,gEAAgE,CAAA;AACjH,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,EACL,SAAS,EACT,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,oBAAoB,CAAA;AAoD3B;;;;GAIG;AACH,MAAM,OAAO,KAAK;IAChB;;OAEG;IACa,QAAQ,CAAW;IACnC;;;OAGG;IACa,KAAK,CAAY;IACjC;;OAEG;IACa,mBAAmB,CAAc;IACjD;;;OAGG;IACa,KAAK,CAA4B;IAEjD;;OAEG;IACI,KAAK,CAAO;IAEX,aAAa,CAAc;IAC3B,WAAW,CAAa;IACxB,aAAa,CAAe;IAC5B,YAAY,CAAS;IACrB,WAAW,GAAY,KAAK,CAAA;IAC5B,QAAQ,CAAU;IAE1B;;;OAGG;IACH,YAAY,MAAoB;QAC9B,2BAA2B;QAC3B,IAAI,CAAC,QAAQ,GAAG,CAAC,MAAM,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,YAAY,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACpH,IAAI,CAAC,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QAC1C,IAAI,CAAC,mBAAmB,GAAG,MAAM,EAAE,mBAAmB,IAAI,IAAI,gCAAgC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAA;QAElH,2DAA2D;QAC3D,IAAI,CAAC,KAAK,GAAG,IAAI,0BAA0B,EAAE,CAAA;QAC7C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;QAC5C,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAA;QAE3C,IAAI,CAAC,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,IAAI,YAAY,EAAE,CAAA;QAChD,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAA;QAC/D,IAAI,CAAC,aAAa,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,CAAA;QAC5C,IAAI,CAAC,WAAW,GAAG,UAAU,CAAA;QAE7B,IAAI,MAAM,EAAE,YAAY,KAAK,SAAS,EAAE,CAAC;YACvC,IAAI,CAAC,aAAa,GAAG,oBAAoB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;QAChE,CAAC;QAED,uDAAuD;QACvD,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,IAAI,CAAA;QACvC,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,QAAQ,GAAG,IAAI,YAAY,CAAC,kBAAkB,EAAE,CAAC,CAAA;QACxD,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,KAAK,CAAA;IAC3B,CAAC;IAEM,KAAK,CAAC,UAAU;QACrB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAM;QACR,CAAC;QAED,MAAM,OAAO,CAAC,GAAG,CACf,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YACpC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAA;YACtC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAClC,CAAC,CAAC,CACH,CAAA;QAED,IAAI,CAAC,YAAY,GAAG,IAAI,CAAA;IAC1B,CAAC;IAED;;;OAGG;IACK,WAAW;QACjB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,IAAI,yBAAyB,CACjC,8HAA8H,CAC/H,CAAA;QACH,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;QAEvB,OAAO;YACL,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,GAAS,EAAE;gBAC3B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAA;YAC1B,CAAC;SACF,CAAA;IACH,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAA;IACpC,CAAC;IAED;;OAEG;IACH,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAA;IAC3B,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACI,KAAK,CAAC,MAAM,CAAC,IAAgB;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAC7B,IAAI,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC7B,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;QAC3B,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAA;IACrB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACI,KAAK,CAAC,CAAC,MAAM,CAAC,IAAgB;;;YACnC,MAAM,KAAK,kCAAG,IAAI,CAAC,WAAW,EAAE,QAAA,CAAA;YAEhC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;YAEvB,mEAAmE;YACnE,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YAC1C,IAAI,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,CAAA;YAEzC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACpB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;gBAE1B,mGAAmG;gBACnG,IAAI,KAAK,YAAY,SAAS,IAAI,CAAC,CAAC,KAAK,YAAY,iBAAiB,CAAC,EAAE,CAAC;oBACxE,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;gBACzC,CAAC;gBAED,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,CAAA;gBAClC,MAAM,KAAK,CAAA;gBACX,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,CAAA;YACvC,CAAC;YAED,mCAAmC;YACnC,MAAM,MAAM,CAAC,KAAK,CAAA;YAElB,OAAO,MAAM,CAAC,KAAK,CAAA;;;;;;;;;KACpB;IAED;;;;;;OAMG;IACK,KAAK,CAAC,CAAC,OAAO,CAAC,IAAgB;QACrC,IAAI,WAAW,GAA2B,IAAI,CAAA;QAE9C,oCAAoC;QACpC,MAAM,IAAI,qBAAqB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAEhD,IAAI,CAAC;YACH,yEAAyE;YACzE,OAAO,IAAI,EAAE,CAAC;gBACZ,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAA;gBACxD,WAAW,GAAG,SAAS,CAAA,CAAC,qCAAqC;gBAC7D,IAAI,WAAW,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;oBACzC,0CAA0C;oBAC1C,iDAAiD;oBACjD,MAAM,MAAM,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;oBACpD,OAAO,IAAI,WAAW,CAAC;wBACrB,UAAU,EAAE,WAAW,CAAC,UAAU;wBAClC,WAAW,EAAE,WAAW,CAAC,OAAO;qBACjC,CAAC,CAAA;gBACJ,CAAC;gBAED,6BAA6B;gBAC7B,MAAM,iBAAiB,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,CAAA;gBAE3F,wEAAwE;gBACxE,gFAAgF;gBAChF,MAAM,MAAM,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;gBACpD,MAAM,MAAM,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAA;gBAElD,gBAAgB;YAClB,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,0BAA0B;YAC1B,MAAM,IAAI,oBAAoB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QACjD,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,CAAC,WAAW,CACxB,IAAiB;QAEjB,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnD,6BAA6B;YAC7B,MAAM,MAAM,IAAI,CAAC,cAAc,CAC7B,IAAI,OAAO,CAAC;gBACV,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;aAC/B,CAAC,CACH,CAAA;QACH,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC1E,MAAM,aAAa,GAAkB,EAAE,SAAS,EAAE,CAAA;QAClD,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACrC,aAAa,CAAC,YAAY,GAAG,IAAI,CAAC,aAAa,CAAA;QACjD,CAAC;QAED,MAAM,IAAI,oBAAoB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAE/C,IAAI,CAAC;YACH,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAA;YAE1F,MAAM,IAAI,mBAAmB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,CAAC,CAAA;YAEjF,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAA;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;YAExC,qBAAqB;YACrB,MAAM,UAAU,GAAG,IAAI,mBAAmB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAA;YAE9E,+CAA+C;YAC/C,MAAM,UAAU,CAAA;YAEhB,0EAA0E;YAC1E,IAAI,UAAU,CAAC,cAAc,EAAE,CAAC;gBAC9B,OAAO,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;YACtC,CAAC;YAED,iBAAiB;YACjB,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,CAAC,gBAAgB,CAC7B,QAAmB,EACnB,aAA4B;QAE5B,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAA;QAC5E,IAAI,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,CAAA;QAEzC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;YAE1B,qCAAqC;YACrC,MAAM,IAAI,oBAAoB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;YAEtD,+BAA+B;YAC/B,MAAM,KAAK,CAAA;YACX,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,CAAA;QACvC,CAAC;QAED,8DAA8D;QAC9D,OAAO,MAAM,CAAC,KAAK,CAAA;IACrB,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,CAAC,YAAY,CACzB,gBAAyB,EACzB,YAA0B;QAE1B,MAAM,IAAI,gBAAgB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAA;QAEtE,iDAAiD;QACjD,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,MAAM,CACnD,CAAC,KAAK,EAAyB,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,cAAc,CAChE,CAAA;QAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,6DAA6D;YAC7D,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAA;QACpF,CAAC;QAED,MAAM,gBAAgB,GAAsB,EAAE,CAAA;QAE9C,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;YACzC,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;YAC3E,gBAAgB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;YAEtC,8CAA8C;YAC9C,MAAM,eAAe,CAAA;QACvB,CAAC;QAED,wCAAwC;QACxC,MAAM,iBAAiB,GAAY,IAAI,OAAO,CAAC;YAC7C,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,gBAAgB;SAC1B,CAAC,CAAA;QAEF,MAAM,IAAI,eAAe,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAA;QAEtE,OAAO,iBAAiB,CAAA;IAC1B,CAAC;IAED;;;;;;;;;OASG;IACK,KAAK,CAAC,CAAC,WAAW,CACxB,YAA0B,EAC1B,YAA0B;QAE1B,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,IAAI,CAAC,CAAA;QAEnE,wCAAwC;QACxC,MAAM,OAAO,GAAG;YACd,IAAI,EAAE,YAAY,CAAC,IAAI;YACvB,SAAS,EAAE,YAAY,CAAC,SAAS;YACjC,KAAK,EAAE,YAAY,CAAC,KAAK;SAC1B,CAAA;QAED,MAAM,IAAI,mBAAmB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;QAE7D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,2DAA2D;YAC3D,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC;gBACtC,SAAS,EAAE,YAAY,CAAC,SAAS;gBACjC,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,CAAC,IAAI,SAAS,CAAC,SAAS,YAAY,CAAC,IAAI,yBAAyB,CAAC,CAAC;aAC9E,CAAC,CAAA;YAEF,MAAM,IAAI,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAA;YAEjF,OAAO,WAAW,CAAA;QACpB,CAAC;QAED,kCAAkC;QAClC,MAAM,WAAW,GAAgB;YAC/B,OAAO,EAAE;gBACP,IAAI,EAAE,YAAY,CAAC,IAAI;gBACvB,SAAS,EAAE,YAAY,CAAC,SAAS;gBACjC,KAAK,EAAE,YAAY,CAAC,KAAK;aAC1B;YACD,KAAK,EAAE,IAAI;SACZ,CAAA;QAED,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;YAE9C,4EAA4E;YAC5E,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,aAAa,CAAA;YAEvC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,wEAAwE;gBACxE,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC;oBACtC,SAAS,EAAE,YAAY,CAAC,SAAS;oBACjC,MAAM,EAAE,OAAO;oBACf,OAAO,EAAE,CAAC,IAAI,SAAS,CAAC,SAAS,YAAY,CAAC,IAAI,2BAA2B,CAAC,CAAC;iBAChF,CAAC,CAAA;gBAEF,MAAM,IAAI,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAA;gBAEjF,OAAO,WAAW,CAAA;YACpB,CAAC;YAED,MAAM,IAAI,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;YAEhF,gDAAgD;YAChD,OAAO,UAAU,CAAA;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,mCAAmC;YACnC,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;YACvC,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC;gBACtC,SAAS,EAAE,YAAY,CAAC,SAAS;gBACjC,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,CAAC,IAAI,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBAC3C,KAAK,EAAE,SAAS;aACjB,CAAC,CAAA;YAEF,MAAM,IAAI,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;YAEnG,OAAO,WAAW,CAAA;QACpB,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,cAAc,CAAC,OAAgB;QAC3C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC3B,MAAM,KAAK,GAAG,IAAI,iBAAiB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;QAC7D,gDAAgD;QAChD,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;QACvC,qFAAqF;QACrF,OAAO,KAAK,CAAA;IACd,CAAC;CACF;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,QAAkB;IACtC,MAAM,KAAK,GAAW,EAAE,CAAA;IACxB,MAAM,UAAU,GAAgB,EAAE,CAAA;IAElC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;YAC/E,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAA;YAC1B,UAAU,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,CAAA;QACtC,CAAC;aAAM,IAAI,IAAI,YAAY,SAAS,EAAE,CAAC;YACrC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvB,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAA;AAC9B,CAAC"}

package/dist/src/agent/printer.d.ts

@@ -0,0 +1,73 @@
+import type { AgentStreamEvent } from '../types/agent.js';
+/**
+ * Creates a default appender function for the current environment.
+ * Uses process.stdout.write in Node.js and console.log in browsers.
+ * @returns Appender function that writes text to the output destination
+ */
+export declare function getDefaultAppender(): (text: string) => void;
+/**
+ * Interface for printing agent activity to a destination.
+ * Implementations can output to stdout, console, HTML elements, etc.
+ */
+export interface Printer {
+    /**
+     * Write content to the output destination.
+     * @param content - The content to write
+     */
+    write(content: string): void;
+    /**
+     * Process a streaming event from the agent.
+     * @param event - The event to process
+     */
+    processEvent(event: AgentStreamEvent): void;
+}
+/**
+ * Default implementation of the Printer interface.
+ * Outputs text, reasoning, and tool execution activity to the configured appender.
+ */
+export declare class AgentPrinter implements Printer {
+    private readonly _appender;
+    private _inReasoningBlock;
+    private _toolCount;
+    private _needReasoningIndent;
+    /**
+     * Creates a new AgentPrinter.
+     * @param appender - Function that writes text to the output destination
+     */
+    constructor(appender: (text: string) => void);
+    /**
+     * Write content to the output destination.
+     * @param content - The content to write
+     */
+    write(content: string): void;
+    /**
+     * Process a streaming event from the agent.
+     * Handles text deltas, reasoning content, and tool execution events.
+     * @param event - The event to process
+     */
+    processEvent(event: AgentStreamEvent): void;
+    /**
+     * Handle content block delta events (text or reasoning).
+     */
+    private handleContentBlockDelta;
+    /**
+     * Write reasoning text with proper indentation after newlines.
+     */
+    private writeReasoningText;
+    /**
+     * Handle content block start events.
+     * Detects tool use starts.
+     */
+    private handleContentBlockStart;
+    /**
+     * Handle content block stop events.
+     * Closes reasoning blocks if we were in one.
+     */
+    private handleContentBlockStop;
+    /**
+     * Handle tool result events.
+     * Outputs completion status.
+     */
+    private handleToolResult;
+}
+//# sourceMappingURL=printer.d.ts.map

package/dist/src/agent/printer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"printer.d.ts","sourceRoot":"","sources":["../../../src/agent/printer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAO3D;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAE5B;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAC5C;AAED;;;GAGG;AACH,qBAAa,YAAa,YAAW,OAAO;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,iBAAiB,CAAiB;IAC1C,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,oBAAoB,CAAiB;IAE7C;;;OAGG;gBACS,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;IAI5C;;;OAGG;IACI,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAInC;;;;OAIG;IACI,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAwBlD;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAwB/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuB1B;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAS/B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAW9B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;CAOzB"}