@morphllm/subagents 0.1.0

package/README.md

@@ -0,0 +1,146 @@
+# @morphllm/subagents
+
+Modular AI subagents for document processing. Built for use with OpenAI-compatible APIs.
+
+## Installation
+
+```bash
+npm install @morphllm/subagents
+```
+
+## Available Subagents
+
+| Subagent | Description | Status |
+|----------|-------------|--------|
+| **DOCX** | Track changes, comments, and document editing | Available |
+| **PDF** | Form filling and annotations | Coming Soon |
+
+## Quick Start
+
+### DOCX Client (Direct API Access)
+
+```typescript
+import { DocxClient } from '@morphllm/subagents/docx';
+
+const client = new DocxClient();
+
+// Upload a document
+const doc = await client.upload(file);
+
+// Read content
+const content = await client.read(doc.doc_id);
+
+// Add comments and track changes
+await client.edit(doc.doc_id, [
+  { type: 'add_comment', para_text: 'Introduction', comment: 'Needs citation' },
+  { type: 'insert_text', para_text: 'Introduction', after: '.', new_text: ' [1]' },
+]);
+
+// Download the edited document
+const blob = await client.download(doc.doc_id);
+```
+
+### DOCX Agent (AI-Powered)
+
+```typescript
+import OpenAI from 'openai';
+import { DocxAgent } from '@morphllm/subagents/docx';
+
+const openai = new OpenAI({
+  apiKey: process.env.OPENAI_API_KEY,
+});
+
+const agent = new DocxAgent({
+  openai,
+  documentId: 'your-doc-id',
+});
+
+// Run with natural language
+const result = await agent.run('Review this contract and flag any issues');
+console.log(result.response);
+console.log(result.toolCalls);
+
+// Or stream for real-time UI
+for await (const event of agent.runStream('Add comments to unclear sections')) {
+  if (event.type === 'content_delta') {
+    process.stdout.write(event.delta.text);
+  } else if (event.type === 'tool_start') {
+    console.log(`\nExecuting: ${event.tool.name}`);
+  }
+}
+```
+
+### Using with Kimi/Moonshot API
+
+```typescript
+import OpenAI from 'openai';
+import { DocxAgent } from '@morphllm/subagents/docx';
+
+const openai = new OpenAI({
+  apiKey: process.env.KIMI_API_KEY,
+  baseURL: 'https://api.moonshot.cn/v1',
+});
+
+const agent = new DocxAgent({
+  openai,
+  model: 'moonshot-v1-32k',
+});
+```
+
+## Module Imports
+
+```typescript
+// Import everything
+import { DocxClient, DocxAgent, BaseClient } from '@morphllm/subagents';
+
+// Import specific modules
+import { DocxClient, DocxAgent } from '@morphllm/subagents/docx';
+import { BaseClient, BaseAgent } from '@morphllm/subagents/core';
+```
+
+## Building Custom Subagents
+
+Extend the base classes to create your own subagents:
+
+```typescript
+import { BaseClient, BaseAgent } from '@morphllm/subagents/core';
+import type { Tool } from '@morphllm/subagents/core';
+
+class MyClient extends BaseClient {
+  protected getDefaultApiUrl() {
+    return 'https://my-api.example.com';
+  }
+
+  async myMethod() {
+    return this.get('/my-endpoint');
+  }
+}
+
+class MyAgent extends BaseAgent<MyClient> {
+  protected getDefaultModel() {
+    return 'gpt-4';
+  }
+
+  protected getDefaultInstructions() {
+    return 'You are a helpful assistant.';
+  }
+
+  protected getTools(): Tool[] {
+    return [/* your tools */];
+  }
+
+  protected async executeTool(name: string, args: Record<string, unknown>) {
+    // Execute tool calls
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `DOCX_API_URL` | DOCX service URL | Railway deployment |
+
+## License
+
+MIT

package/dist/core/index.d.mts

@@ -0,0 +1,68 @@
+import { a as BaseClientOptions, B as BaseAgentOptions, T as Tool, C as ChatMessage, A as AgentRunResult, S as StreamEvent } from '../types-D9rS2MQq.mjs';
+export { b as ToolCall } from '../types-D9rS2MQq.mjs';
+
+/**
+ * BaseClient - Abstract HTTP client for subagent APIs
+ */
+
+declare abstract class BaseClient {
+    protected apiUrl: string;
+    protected timeout: number;
+    constructor(options?: BaseClientOptions);
+    /** Override in subclasses to provide default API URL */
+    protected abstract getDefaultApiUrl(): string;
+    /** Make a GET request */
+    protected get<T>(path: string): Promise<T>;
+    /** Make a POST request with JSON body */
+    protected post<T>(path: string, body?: unknown): Promise<T>;
+    /** Make a POST request with FormData */
+    protected postFormData<T>(path: string, formData: FormData): Promise<T>;
+    /** Make a DELETE request */
+    protected delete(path: string): Promise<void>;
+    /** Download a file as Blob */
+    protected downloadBlob(path: string): Promise<Blob>;
+    /** Health check */
+    health(): Promise<{
+        status: string;
+        service: string;
+    }>;
+}
+
+/**
+ * BaseAgent - Abstract base class for AI subagents
+ *
+ * Provides common functionality for tool-using agents with
+ * OpenAI-compatible API support.
+ */
+
+declare abstract class BaseAgent<TClient> {
+    protected openai: any;
+    protected model: string;
+    protected instructions: string;
+    protected client: TClient;
+    constructor(options: BaseAgentOptions & {
+        client: TClient;
+    });
+    /** Get the underlying client */
+    getClient(): TClient;
+    /** Override to provide default model */
+    protected abstract getDefaultModel(): string;
+    /** Override to provide default instructions */
+    protected abstract getDefaultInstructions(): string;
+    /** Override to provide tool definitions */
+    protected abstract getTools(): Tool[];
+    /** Override to execute a tool call */
+    protected abstract executeTool(name: string, args: Record<string, unknown>): Promise<string>;
+    /**
+     * Run the agent with a user message.
+     * Returns the final response and all tool calls made.
+     */
+    run(userMessage: string, conversationHistory?: ChatMessage[]): Promise<AgentRunResult>;
+    /**
+     * Run the agent with streaming output.
+     * Yields events for real-time UI updates.
+     */
+    runStream(userMessage: string, conversationHistory?: ChatMessage[]): AsyncGenerator<StreamEvent>;
+}
+
+export { AgentRunResult, BaseAgent, BaseAgentOptions, BaseClient, BaseClientOptions, ChatMessage, StreamEvent, Tool };

package/dist/core/index.d.ts

@@ -0,0 +1,68 @@
+import { a as BaseClientOptions, B as BaseAgentOptions, T as Tool, C as ChatMessage, A as AgentRunResult, S as StreamEvent } from '../types-D9rS2MQq.js';
+export { b as ToolCall } from '../types-D9rS2MQq.js';
+
+/**
+ * BaseClient - Abstract HTTP client for subagent APIs
+ */
+
+declare abstract class BaseClient {
+    protected apiUrl: string;
+    protected timeout: number;
+    constructor(options?: BaseClientOptions);
+    /** Override in subclasses to provide default API URL */
+    protected abstract getDefaultApiUrl(): string;
+    /** Make a GET request */
+    protected get<T>(path: string): Promise<T>;
+    /** Make a POST request with JSON body */
+    protected post<T>(path: string, body?: unknown): Promise<T>;
+    /** Make a POST request with FormData */
+    protected postFormData<T>(path: string, formData: FormData): Promise<T>;
+    /** Make a DELETE request */
+    protected delete(path: string): Promise<void>;
+    /** Download a file as Blob */
+    protected downloadBlob(path: string): Promise<Blob>;
+    /** Health check */
+    health(): Promise<{
+        status: string;
+        service: string;
+    }>;
+}
+
+/**
+ * BaseAgent - Abstract base class for AI subagents
+ *
+ * Provides common functionality for tool-using agents with
+ * OpenAI-compatible API support.
+ */
+
+declare abstract class BaseAgent<TClient> {
+    protected openai: any;
+    protected model: string;
+    protected instructions: string;
+    protected client: TClient;
+    constructor(options: BaseAgentOptions & {
+        client: TClient;
+    });
+    /** Get the underlying client */
+    getClient(): TClient;
+    /** Override to provide default model */
+    protected abstract getDefaultModel(): string;
+    /** Override to provide default instructions */
+    protected abstract getDefaultInstructions(): string;
+    /** Override to provide tool definitions */
+    protected abstract getTools(): Tool[];
+    /** Override to execute a tool call */
+    protected abstract executeTool(name: string, args: Record<string, unknown>): Promise<string>;
+    /**
+     * Run the agent with a user message.
+     * Returns the final response and all tool calls made.
+     */
+    run(userMessage: string, conversationHistory?: ChatMessage[]): Promise<AgentRunResult>;
+    /**
+     * Run the agent with streaming output.
+     * Yields events for real-time UI updates.
+     */
+    runStream(userMessage: string, conversationHistory?: ChatMessage[]): AsyncGenerator<StreamEvent>;
+}
+
+export { AgentRunResult, BaseAgent, BaseAgentOptions, BaseClient, BaseClientOptions, ChatMessage, StreamEvent, Tool };

package/dist/core/index.js

@@ -0,0 +1,221 @@
+'use strict';
+
+// src/core/base-client.ts
+var BaseClient = class {
+  constructor(options = {}) {
+    this.apiUrl = options.apiUrl || this.getDefaultApiUrl();
+    this.timeout = options.timeout || 6e4;
+  }
+  /** Make a GET request */
+  async get(path) {
+    const response = await fetch(`${this.apiUrl}${path}`, {
+      method: "GET",
+      signal: AbortSignal.timeout(this.timeout)
+    });
+    if (!response.ok) {
+      throw new Error(`GET ${path} failed: ${response.statusText}`);
+    }
+    return response.json();
+  }
+  /** Make a POST request with JSON body */
+  async post(path, body) {
+    const response = await fetch(`${this.apiUrl}${path}`, {
+      method: "POST",
+      headers: body ? { "Content-Type": "application/json" } : void 0,
+      body: body ? JSON.stringify(body) : void 0,
+      signal: AbortSignal.timeout(this.timeout)
+    });
+    if (!response.ok) {
+      throw new Error(`POST ${path} failed: ${response.statusText}`);
+    }
+    return response.json();
+  }
+  /** Make a POST request with FormData */
+  async postFormData(path, formData) {
+    const response = await fetch(`${this.apiUrl}${path}`, {
+      method: "POST",
+      body: formData,
+      signal: AbortSignal.timeout(this.timeout)
+    });
+    if (!response.ok) {
+      throw new Error(`POST ${path} failed: ${response.statusText}`);
+    }
+    return response.json();
+  }
+  /** Make a DELETE request */
+  async delete(path) {
+    const response = await fetch(`${this.apiUrl}${path}`, {
+      method: "DELETE",
+      signal: AbortSignal.timeout(this.timeout)
+    });
+    if (!response.ok) {
+      throw new Error(`DELETE ${path} failed: ${response.statusText}`);
+    }
+  }
+  /** Download a file as Blob */
+  async downloadBlob(path) {
+    const response = await fetch(`${this.apiUrl}${path}`, {
+      signal: AbortSignal.timeout(this.timeout)
+    });
+    if (!response.ok) {
+      throw new Error(`Download ${path} failed: ${response.statusText}`);
+    }
+    return response.blob();
+  }
+  /** Health check */
+  async health() {
+    return this.get("/health");
+  }
+};
+
+// src/core/base-agent.ts
+var BaseAgent = class {
+  constructor(options) {
+    this.openai = options.openai;
+    this.model = options.model || this.getDefaultModel();
+    this.instructions = options.instructions || this.getDefaultInstructions();
+    this.client = options.client;
+  }
+  /** Get the underlying client */
+  getClient() {
+    return this.client;
+  }
+  /**
+   * Run the agent with a user message.
+   * Returns the final response and all tool calls made.
+   */
+  async run(userMessage, conversationHistory = []) {
+    if (!this.openai) {
+      throw new Error("OpenAI client is required for agent.run(). Pass it in the constructor options.");
+    }
+    const messages = [
+      { role: "system", content: this.instructions },
+      ...conversationHistory,
+      { role: "user", content: userMessage }
+    ];
+    const toolCalls = [];
+    let response = "";
+    const tools = this.getTools();
+    while (true) {
+      const completion = await this.openai.chat.completions.create({
+        model: this.model,
+        messages,
+        tools,
+        tool_choice: "auto"
+      });
+      const assistantMessage = completion.choices[0].message;
+      if (assistantMessage.tool_calls && assistantMessage.tool_calls.length > 0) {
+        messages.push({
+          role: "assistant",
+          content: assistantMessage.content || ""
+        });
+        for (const tc of assistantMessage.tool_calls) {
+          const fn = tc.function;
+          const args = JSON.parse(fn.arguments);
+          const toolCall = {
+            id: tc.id,
+            name: fn.name,
+            arguments: args,
+            status: "running"
+          };
+          toolCalls.push(toolCall);
+          const result = await this.executeTool(fn.name, args);
+          if (result.startsWith("Error:")) {
+            toolCall.error = result;
+            toolCall.status = "error";
+          } else {
+            toolCall.result = result;
+            toolCall.status = "completed";
+          }
+          messages.push({
+            role: "tool",
+            content: result,
+            tool_call_id: tc.id
+          });
+        }
+      } else {
+        response = assistantMessage.content || "";
+        break;
+      }
+    }
+    return { response, toolCalls };
+  }
+  /**
+   * Run the agent with streaming output.
+   * Yields events for real-time UI updates.
+   */
+  async *runStream(userMessage, conversationHistory = []) {
+    if (!this.openai) {
+      throw new Error("OpenAI client is required for agent.runStream(). Pass it in the constructor options.");
+    }
+    const messages = [
+      { role: "system", content: this.instructions },
+      ...conversationHistory,
+      { role: "user", content: userMessage }
+    ];
+    const tools = this.getTools();
+    while (true) {
+      yield { type: "message_start", message: { role: "assistant" } };
+      const stream = await this.openai.chat.completions.create({
+        model: this.model,
+        messages,
+        tools,
+        tool_choice: "auto",
+        stream: true
+      });
+      let contentBuffer = "";
+      const toolCallBuffers = /* @__PURE__ */ new Map();
+      for await (const chunk of stream) {
+        const delta = chunk.choices[0]?.delta;
+        if (delta?.content) {
+          contentBuffer += delta.content;
+          yield { type: "content_delta", delta: { text: delta.content } };
+        }
+        if (delta?.tool_calls) {
+          for (const tc of delta.tool_calls) {
+            const idx = tc.index;
+            if (!toolCallBuffers.has(idx)) {
+              toolCallBuffers.set(idx, { id: "", name: "", arguments: "" });
+            }
+            const buffer = toolCallBuffers.get(idx);
+            if (tc.id) buffer.id = tc.id;
+            if (tc.function?.name) buffer.name = tc.function.name;
+            if (tc.function?.arguments) buffer.arguments += tc.function.arguments;
+          }
+        }
+      }
+      if (toolCallBuffers.size > 0) {
+        messages.push({
+          role: "assistant",
+          content: contentBuffer
+        });
+        for (const [_, buffer] of toolCallBuffers) {
+          const args = JSON.parse(buffer.arguments);
+          yield {
+            type: "tool_start",
+            tool: { id: buffer.id, name: buffer.name, arguments: args }
+          };
+          const result = await this.executeTool(buffer.name, args);
+          if (result.startsWith("Error:")) {
+            yield { type: "tool_end", tool: { id: buffer.id, error: result } };
+          } else {
+            yield { type: "tool_end", tool: { id: buffer.id, result } };
+          }
+          messages.push({
+            role: "tool",
+            content: result,
+            tool_call_id: buffer.id
+          });
+        }
+      } else {
+        yield { type: "message_end" };
+        break;
+      }
+    }
+  }
+};
+
+exports.BaseAgent = BaseAgent;
+exports.BaseClient = BaseClient;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/base-client.ts","../../src/core/base-agent.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * BaseClient - Abstract HTTP client for subagent APIs\n */\n\nimport type { BaseClientOptions } from './types';\n\nexport abstract class BaseClient {\n  protected apiUrl: string;\n  protected timeout: number;\n\n  constructor(options: BaseClientOptions = {}) {\n    this.apiUrl = options.apiUrl || this.getDefaultApiUrl();\n    this.timeout = options.timeout || 60000;\n  }\n\n  /** Override in subclasses to provide default API URL */\n  protected abstract getDefaultApiUrl(): string;\n\n  /** Make a GET request */\n  protected async get<T>(path: string): Promise<T> {\n    const response = await fetch(`${this.apiUrl}${path}`, {\n      method: 'GET',\n      signal: AbortSignal.timeout(this.timeout),\n    });\n\n    if (!response.ok) {\n      throw new Error(`GET ${path} failed: ${response.statusText}`);\n    }\n\n    return response.json();\n  }\n\n  /** Make a POST request with JSON body */\n  protected async post<T>(path: string, body?: unknown): Promise<T> {\n    const response = await fetch(`${this.apiUrl}${path}`, {\n      method: 'POST',\n      headers: body ? { 'Content-Type': 'application/json' } : undefined,\n      body: body ? JSON.stringify(body) : undefined,\n      signal: AbortSignal.timeout(this.timeout),\n    });\n\n    if (!response.ok) {\n      throw new Error(`POST ${path} failed: ${response.statusText}`);\n    }\n\n    return response.json();\n  }\n\n  /** Make a POST request with FormData */\n  protected async postFormData<T>(path: string, formData: FormData): Promise<T> {\n    const response = await fetch(`${this.apiUrl}${path}`, {\n      method: 'POST',\n      body: formData,\n      signal: AbortSignal.timeout(this.timeout),\n    });\n\n    if (!response.ok) {\n      throw new Error(`POST ${path} failed: ${response.statusText}`);\n    }\n\n    return response.json();\n  }\n\n  /** Make a DELETE request */\n  protected async delete(path: string): Promise<void> {\n    const response = await fetch(`${this.apiUrl}${path}`, {\n      method: 'DELETE',\n      signal: AbortSignal.timeout(this.timeout),\n    });\n\n    if (!response.ok) {\n      throw new Error(`DELETE ${path} failed: ${response.statusText}`);\n    }\n  }\n\n  /** Download a file as Blob */\n  protected async downloadBlob(path: string): Promise<Blob> {\n    const response = await fetch(`${this.apiUrl}${path}`, {\n      signal: AbortSignal.timeout(this.timeout),\n    });\n\n    if (!response.ok) {\n      throw new Error(`Download ${path} failed: ${response.statusText}`);\n    }\n\n    return response.blob();\n  }\n\n  /** Health check */\n  async health(): Promise<{ status: string; service: string }> {\n    return this.get('/health');\n  }\n}\n","/**\n * BaseAgent - Abstract base class for AI subagents\n *\n * Provides common functionality for tool-using agents with\n * OpenAI-compatible API support.\n */\n\nimport type {\n  Tool,\n  ChatMessage,\n  ToolCall,\n  StreamEvent,\n  AgentRunResult,\n  BaseAgentOptions,\n} from './types';\n\nexport abstract class BaseAgent<TClient> {\n  protected openai: any;\n  protected model: string;\n  protected instructions: string;\n  protected client: TClient;\n\n  constructor(options: BaseAgentOptions & { client: TClient }) {\n    this.openai = options.openai;\n    this.model = options.model || this.getDefaultModel();\n    this.instructions = options.instructions || this.getDefaultInstructions();\n    this.client = options.client;\n  }\n\n  /** Get the underlying client */\n  getClient(): TClient {\n    return this.client;\n  }\n\n  /** Override to provide default model */\n  protected abstract getDefaultModel(): string;\n\n  /** Override to provide default instructions */\n  protected abstract getDefaultInstructions(): string;\n\n  /** Override to provide tool definitions */\n  protected abstract getTools(): Tool[];\n\n  /** Override to execute a tool call */\n  protected abstract executeTool(name: string, args: Record<string, unknown>): Promise<string>;\n\n  /**\n   * Run the agent with a user message.\n   * Returns the final response and all tool calls made.\n   */\n  async run(\n    userMessage: string,\n    conversationHistory: ChatMessage[] = []\n  ): Promise<AgentRunResult> {\n    if (!this.openai) {\n      throw new Error('OpenAI client is required for agent.run(). Pass it in the constructor options.');\n    }\n\n    const messages: ChatMessage[] = [\n      { role: 'system', content: this.instructions },\n      ...conversationHistory,\n      { role: 'user', content: userMessage },\n    ];\n\n    const toolCalls: ToolCall[] = [];\n    let response = '';\n    const tools = this.getTools();\n\n    // Agent loop - keep running until no more tool calls\n    while (true) {\n      const completion = await this.openai.chat.completions.create({\n        model: this.model,\n        messages: messages as any,\n        tools: tools as any,\n        tool_choice: 'auto',\n      });\n\n      const assistantMessage = completion.choices[0].message;\n\n      // Check if there are tool calls\n      if (assistantMessage.tool_calls && assistantMessage.tool_calls.length > 0) {\n        // Add assistant message with tool calls\n        messages.push({\n          role: 'assistant',\n          content: assistantMessage.content || '',\n        });\n\n        // Execute each tool call\n        for (const tc of assistantMessage.tool_calls) {\n          const fn = (tc as any).function;\n          const args = JSON.parse(fn.arguments);\n\n          const toolCall: ToolCall = {\n            id: tc.id,\n            name: fn.name,\n            arguments: args,\n            status: 'running',\n          };\n          toolCalls.push(toolCall);\n\n          // Execute the tool\n          const result = await this.executeTool(fn.name, args);\n\n          // Update tool call status\n          if (result.startsWith('Error:')) {\n            toolCall.error = result;\n            toolCall.status = 'error';\n          } else {\n            toolCall.result = result;\n            toolCall.status = 'completed';\n          }\n\n          // Add tool result to messages\n          messages.push({\n            role: 'tool',\n            content: result,\n            tool_call_id: tc.id,\n          });\n        }\n      } else {\n        // No more tool calls - return the final response\n        response = assistantMessage.content || '';\n        break;\n      }\n    }\n\n    return { response, toolCalls };\n  }\n\n  /**\n   * Run the agent with streaming output.\n   * Yields events for real-time UI updates.\n   */\n  async *runStream(\n    userMessage: string,\n    conversationHistory: ChatMessage[] = []\n  ): AsyncGenerator<StreamEvent> {\n    if (!this.openai) {\n      throw new Error('OpenAI client is required for agent.runStream(). Pass it in the constructor options.');\n    }\n\n    const messages: ChatMessage[] = [\n      { role: 'system', content: this.instructions },\n      ...conversationHistory,\n      { role: 'user', content: userMessage },\n    ];\n\n    const tools = this.getTools();\n\n    // Agent loop\n    while (true) {\n      yield { type: 'message_start', message: { role: 'assistant' } };\n\n      const stream = await this.openai.chat.completions.create({\n        model: this.model,\n        messages: messages as any,\n        tools: tools as any,\n        tool_choice: 'auto',\n        stream: true,\n      });\n\n      let contentBuffer = '';\n      const toolCallBuffers: Map<number, { id: string; name: string; arguments: string }> =\n        new Map();\n\n      for await (const chunk of stream) {\n        const delta = chunk.choices[0]?.delta;\n\n        // Handle content\n        if (delta?.content) {\n          contentBuffer += delta.content;\n          yield { type: 'content_delta', delta: { text: delta.content } };\n        }\n\n        // Handle tool calls\n        if (delta?.tool_calls) {\n          for (const tc of delta.tool_calls) {\n            const idx = tc.index;\n            if (!toolCallBuffers.has(idx)) {\n              toolCallBuffers.set(idx, { id: '', name: '', arguments: '' });\n            }\n\n            const buffer = toolCallBuffers.get(idx)!;\n            if (tc.id) buffer.id = tc.id;\n            if (tc.function?.name) buffer.name = tc.function.name;\n            if (tc.function?.arguments) buffer.arguments += tc.function.arguments;\n          }\n        }\n      }\n\n      // Process tool calls if any\n      if (toolCallBuffers.size > 0) {\n        // Add assistant message to history\n        messages.push({\n          role: 'assistant',\n          content: contentBuffer,\n        });\n\n        for (const [_, buffer] of toolCallBuffers) {\n          const args = JSON.parse(buffer.arguments);\n\n          yield {\n            type: 'tool_start',\n            tool: { id: buffer.id, name: buffer.name, arguments: args },\n          };\n\n          // Execute the tool\n          const result = await this.executeTool(buffer.name, args);\n\n          if (result.startsWith('Error:')) {\n            yield { type: 'tool_end', tool: { id: buffer.id, error: result } };\n          } else {\n            yield { type: 'tool_end', tool: { id: buffer.id, result } };\n          }\n\n          // Add tool result to messages\n          messages.push({\n            role: 'tool',\n            content: result,\n            tool_call_id: buffer.id,\n          });\n        }\n      } else {\n        // No more tool calls - done\n        yield { type: 'message_end' };\n        break;\n      }\n    }\n  }\n}\n"]}