@morphllm/subagents 0.1.0

package/dist/core/index.mjs

@@ -0,0 +1,218 @@
+// 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;
+      }
+    }
+  }
+};
+
+export { BaseAgent, BaseClient };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/core/index.mjs.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.mjs","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"]}

package/dist/docx/index.d.mts

@@ -0,0 +1,110 @@
+import { BaseClient, BaseAgent } from '../core/index.mjs';
+import { a as BaseClientOptions, B as BaseAgentOptions, T as Tool } from '../types-D9rS2MQq.mjs';
+
+/**
+ * Types for DOCX subagent
+ */
+
+/** Document info returned after upload */
+interface DocumentInfo {
+    doc_id: string;
+    message: string;
+}
+/** Response from reading document content */
+interface ReadResponse {
+    content: string;
+    paragraphs: number;
+}
+/** Edit operation types */
+type EditOperationType = 'add_comment' | 'reply_comment' | 'resolve_comment' | 'delete_comment' | 'insert_text' | 'insert_paragraph' | 'propose_deletion';
+/** Edit operation payload */
+interface EditOperation {
+    type: EditOperationType;
+    para_text?: string;
+    comment?: string;
+    highlight?: string;
+    context?: string;
+    after?: string;
+    after_text?: string;
+    new_text?: string;
+    target?: string;
+    comment_id?: string;
+    reply?: string;
+    author?: string;
+}
+/** Response from edit operations */
+interface EditResponse {
+    results: string[];
+    doc_id: string;
+}
+/** Response from document validation */
+interface ValidateResponse {
+    result: string;
+    valid: boolean;
+    output: string;
+}
+/** DOCX client options */
+interface DocxClientOptions extends BaseClientOptions {
+    /** API URL. Defaults to Railway deployment */
+    apiUrl?: string;
+}
+/** DOCX agent options */
+interface DocxAgentOptions extends BaseAgentOptions {
+    /** Current document ID */
+    documentId?: string;
+}
+
+/**
+ * DocxClient - HTTP client for DOCX document API
+ */
+
+declare class DocxClient extends BaseClient {
+    constructor(options?: DocxClientOptions);
+    protected getDefaultApiUrl(): string;
+    /**
+     * Upload a DOCX document.
+     */
+    upload(file: File | Blob, filename?: string): Promise<DocumentInfo>;
+    /**
+     * Download a DOCX document.
+     */
+    download(docId: string): Promise<Blob>;
+    /**
+     * Read document content as plain text.
+     */
+    read(docId: string): Promise<ReadResponse>;
+    /**
+     * Execute edit operations on a document.
+     */
+    edit(docId: string, operations: EditOperation[]): Promise<EditResponse>;
+    /**
+     * Validate document structure.
+     */
+    validate(docId: string): Promise<ValidateResponse>;
+    /**
+     * Delete a document from storage.
+     */
+    deleteDocument(docId: string): Promise<void>;
+}
+
+/**
+ * DocxAgent - AI agent for DOCX document editing
+ *
+ * Uses OpenAI-compatible API to process requests and execute
+ * document editing operations.
+ */
+
+declare class DocxAgent extends BaseAgent<DocxClient> {
+    private documentId?;
+    constructor(options?: DocxAgentOptions);
+    protected getDefaultModel(): string;
+    protected getDefaultInstructions(): string;
+    protected getTools(): Tool[];
+    /** Set the current document ID */
+    setDocument(docId: string): void;
+    /** Get current document ID */
+    getDocumentId(): string | undefined;
+    protected executeTool(name: string, args: Record<string, unknown>): Promise<string>;
+}
+
+export { type DocumentInfo, DocxAgent, type DocxAgentOptions, DocxClient, type DocxClientOptions, type EditOperation, type EditOperationType, type EditResponse, type ReadResponse, type ValidateResponse };

package/dist/docx/index.d.ts

@@ -0,0 +1,110 @@
+import { BaseClient, BaseAgent } from '../core/index.js';
+import { a as BaseClientOptions, B as BaseAgentOptions, T as Tool } from '../types-D9rS2MQq.js';
+
+/**
+ * Types for DOCX subagent
+ */
+
+/** Document info returned after upload */
+interface DocumentInfo {
+    doc_id: string;
+    message: string;
+}
+/** Response from reading document content */
+interface ReadResponse {
+    content: string;
+    paragraphs: number;
+}
+/** Edit operation types */
+type EditOperationType = 'add_comment' | 'reply_comment' | 'resolve_comment' | 'delete_comment' | 'insert_text' | 'insert_paragraph' | 'propose_deletion';
+/** Edit operation payload */
+interface EditOperation {
+    type: EditOperationType;
+    para_text?: string;
+    comment?: string;
+    highlight?: string;
+    context?: string;
+    after?: string;
+    after_text?: string;
+    new_text?: string;
+    target?: string;
+    comment_id?: string;
+    reply?: string;
+    author?: string;
+}
+/** Response from edit operations */
+interface EditResponse {
+    results: string[];
+    doc_id: string;
+}
+/** Response from document validation */
+interface ValidateResponse {
+    result: string;
+    valid: boolean;
+    output: string;
+}
+/** DOCX client options */
+interface DocxClientOptions extends BaseClientOptions {
+    /** API URL. Defaults to Railway deployment */
+    apiUrl?: string;
+}
+/** DOCX agent options */
+interface DocxAgentOptions extends BaseAgentOptions {
+    /** Current document ID */
+    documentId?: string;
+}
+
+/**
+ * DocxClient - HTTP client for DOCX document API
+ */
+
+declare class DocxClient extends BaseClient {
+    constructor(options?: DocxClientOptions);
+    protected getDefaultApiUrl(): string;
+    /**
+     * Upload a DOCX document.
+     */
+    upload(file: File | Blob, filename?: string): Promise<DocumentInfo>;
+    /**
+     * Download a DOCX document.
+     */
+    download(docId: string): Promise<Blob>;
+    /**
+     * Read document content as plain text.
+     */
+    read(docId: string): Promise<ReadResponse>;
+    /**
+     * Execute edit operations on a document.
+     */
+    edit(docId: string, operations: EditOperation[]): Promise<EditResponse>;
+    /**
+     * Validate document structure.
+     */
+    validate(docId: string): Promise<ValidateResponse>;
+    /**
+     * Delete a document from storage.
+     */
+    deleteDocument(docId: string): Promise<void>;
+}
+
+/**
+ * DocxAgent - AI agent for DOCX document editing
+ *
+ * Uses OpenAI-compatible API to process requests and execute
+ * document editing operations.
+ */
+
+declare class DocxAgent extends BaseAgent<DocxClient> {
+    private documentId?;
+    constructor(options?: DocxAgentOptions);
+    protected getDefaultModel(): string;
+    protected getDefaultInstructions(): string;
+    protected getTools(): Tool[];
+    /** Set the current document ID */
+    setDocument(docId: string): void;
+    /** Get current document ID */
+    getDocumentId(): string | undefined;
+    protected executeTool(name: string, args: Record<string, unknown>): Promise<string>;
+}
+
+export { type DocumentInfo, DocxAgent, type DocxAgentOptions, DocxClient, type DocxClientOptions, type EditOperation, type EditOperationType, type EditResponse, type ReadResponse, type ValidateResponse };