@morphllm/subagents 0.1.0

package/dist/pdf/index.mjs

@@ -0,0 +1,7 @@
+// src/pdf/index.ts
+var PdfClient = null;
+var PdfAgent = null;
+
+export { PdfAgent, PdfClient };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/pdf/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/pdf/index.ts"],"names":[],"mappings":";AAqBO,IAAM,SAAA,GAAY;AAClB,IAAM,QAAA,GAAW","file":"index.mjs","sourcesContent":["/**\n * @morphllm/subagents/pdf\n *\n * PDF form filling subagent (coming soon).\n *\n * This module will provide:\n * - PdfClient: HTTP client for PDF form API\n * - PdfAgent: AI agent for filling PDF forms\n */\n\nexport type {\n  PdfDocumentInfo,\n  FormField,\n  ReadFieldsResponse,\n  FillOperation,\n  FillResponse,\n  PdfClientOptions,\n  PdfAgentOptions,\n} from './types';\n\n// Placeholder exports - will be implemented when PDF service is ready\nexport const PdfClient = null;\nexport const PdfAgent = null;\n"]}

package/dist/types-BEtL6Wum.d.ts

@@ -0,0 +1,48 @@
+import { B as BaseAgentOptions, a as BaseClientOptions } from './types-D9rS2MQq.js';
+
+/**
+ * Types for PDF subagent (placeholder for future implementation)
+ */
+
+/** PDF document info */
+interface PdfDocumentInfo {
+    doc_id: string;
+    page_count: number;
+    message: string;
+}
+/** Form field information */
+interface FormField {
+    name: string;
+    type: 'text' | 'checkbox' | 'radio' | 'dropdown' | 'signature';
+    value?: string;
+    options?: string[];
+    required?: boolean;
+    page: number;
+}
+/** Response from reading PDF form fields */
+interface ReadFieldsResponse {
+    fields: FormField[];
+    page_count: number;
+}
+/** Fill operation for a form field */
+interface FillOperation {
+    field_name: string;
+    value: string;
+}
+/** Response from fill operations */
+interface FillResponse {
+    results: string[];
+    doc_id: string;
+}
+/** PDF client options */
+interface PdfClientOptions extends BaseClientOptions {
+    /** API URL for PDF service */
+    apiUrl?: string;
+}
+/** PDF agent options */
+interface PdfAgentOptions extends BaseAgentOptions {
+    /** Current document ID */
+    documentId?: string;
+}
+
+export type { FillOperation as F, PdfAgentOptions as P, ReadFieldsResponse as R, FillResponse as a, FormField as b, PdfClientOptions as c, PdfDocumentInfo as d };

package/dist/types-D9rS2MQq.d.mts

@@ -0,0 +1,82 @@
+/**
+ * Core types shared across all subagents
+ */
+/** Tool definition for OpenAI-compatible APIs */
+interface Tool {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+/** Chat message for conversation history */
+interface ChatMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    name?: string;
+    tool_call_id?: string;
+}
+/** Tool call tracking */
+interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+    result?: string;
+    error?: string;
+    status: 'pending' | 'running' | 'completed' | 'error';
+}
+/** Stream events for real-time UI updates */
+type StreamEvent = {
+    type: 'message_start';
+    message: {
+        role: 'assistant';
+    };
+} | {
+    type: 'content_delta';
+    delta: {
+        text: string;
+    };
+} | {
+    type: 'tool_start';
+    tool: {
+        id: string;
+        name: string;
+        arguments: Record<string, unknown>;
+    };
+} | {
+    type: 'tool_end';
+    tool: {
+        id: string;
+        result?: string;
+        error?: string;
+    };
+} | {
+    type: 'message_end';
+} | {
+    type: 'error';
+    error: string;
+};
+/** Agent run result */
+interface AgentRunResult {
+    response: string;
+    toolCalls: ToolCall[];
+}
+/** Base client options */
+interface BaseClientOptions {
+    /** API base URL */
+    apiUrl?: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/** Base agent options */
+interface BaseAgentOptions extends BaseClientOptions {
+    /** OpenAI-compatible client instance */
+    openai?: any;
+    /** Model to use */
+    model?: string;
+    /** System instructions */
+    instructions?: string;
+}
+
+export type { AgentRunResult as A, BaseAgentOptions as B, ChatMessage as C, StreamEvent as S, Tool as T, BaseClientOptions as a, ToolCall as b };

package/dist/types-D9rS2MQq.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Core types shared across all subagents
+ */
+/** Tool definition for OpenAI-compatible APIs */
+interface Tool {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+/** Chat message for conversation history */
+interface ChatMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    name?: string;
+    tool_call_id?: string;
+}
+/** Tool call tracking */
+interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+    result?: string;
+    error?: string;
+    status: 'pending' | 'running' | 'completed' | 'error';
+}
+/** Stream events for real-time UI updates */
+type StreamEvent = {
+    type: 'message_start';
+    message: {
+        role: 'assistant';
+    };
+} | {
+    type: 'content_delta';
+    delta: {
+        text: string;
+    };
+} | {
+    type: 'tool_start';
+    tool: {
+        id: string;
+        name: string;
+        arguments: Record<string, unknown>;
+    };
+} | {
+    type: 'tool_end';
+    tool: {
+        id: string;
+        result?: string;
+        error?: string;
+    };
+} | {
+    type: 'message_end';
+} | {
+    type: 'error';
+    error: string;
+};
+/** Agent run result */
+interface AgentRunResult {
+    response: string;
+    toolCalls: ToolCall[];
+}
+/** Base client options */
+interface BaseClientOptions {
+    /** API base URL */
+    apiUrl?: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/** Base agent options */
+interface BaseAgentOptions extends BaseClientOptions {
+    /** OpenAI-compatible client instance */
+    openai?: any;
+    /** Model to use */
+    model?: string;
+    /** System instructions */
+    instructions?: string;
+}
+
+export type { AgentRunResult as A, BaseAgentOptions as B, ChatMessage as C, StreamEvent as S, Tool as T, BaseClientOptions as a, ToolCall as b };

package/dist/types-DBtV_NyH.d.mts

@@ -0,0 +1,48 @@
+import { B as BaseAgentOptions, a as BaseClientOptions } from './types-D9rS2MQq.mjs';
+
+/**
+ * Types for PDF subagent (placeholder for future implementation)
+ */
+
+/** PDF document info */
+interface PdfDocumentInfo {
+    doc_id: string;
+    page_count: number;
+    message: string;
+}
+/** Form field information */
+interface FormField {
+    name: string;
+    type: 'text' | 'checkbox' | 'radio' | 'dropdown' | 'signature';
+    value?: string;
+    options?: string[];
+    required?: boolean;
+    page: number;
+}
+/** Response from reading PDF form fields */
+interface ReadFieldsResponse {
+    fields: FormField[];
+    page_count: number;
+}
+/** Fill operation for a form field */
+interface FillOperation {
+    field_name: string;
+    value: string;
+}
+/** Response from fill operations */
+interface FillResponse {
+    results: string[];
+    doc_id: string;
+}
+/** PDF client options */
+interface PdfClientOptions extends BaseClientOptions {
+    /** API URL for PDF service */
+    apiUrl?: string;
+}
+/** PDF agent options */
+interface PdfAgentOptions extends BaseAgentOptions {
+    /** Current document ID */
+    documentId?: string;
+}
+
+export type { FillOperation as F, PdfAgentOptions as P, ReadFieldsResponse as R, FillResponse as a, FormField as b, PdfClientOptions as c, PdfDocumentInfo as d };

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@morphllm/subagents",
+  "version": "0.1.0",
+  "description": "Modular AI subagents for document processing - DOCX editing, PDF filling, and more",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.mjs",
+      "require": "./dist/core/index.js"
+    },
+    "./docx": {
+      "types": "./dist/docx/index.d.ts",
+      "import": "./dist/docx/index.mjs",
+      "require": "./dist/docx/index.js"
+    },
+    "./pdf": {
+      "types": "./dist/pdf/index.d.ts",
+      "import": "./dist/pdf/index.mjs",
+      "require": "./dist/pdf/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "subagent",
+    "docx",
+    "pdf",
+    "document",
+    "editing",
+    "openai",
+    "morphllm"
+  ],
+  "author": "MorphLLM",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/morphllm/subagents"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^2.0.0"
+  },
+  "peerDependencies": {
+    "openai": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "openai": {
+      "optional": true
+    }
+  }
+}

package/src/core/base-agent.ts

@@ -0,0 +1,230 @@
+/**
+ * BaseAgent - Abstract base class for AI subagents
+ *
+ * Provides common functionality for tool-using agents with
+ * OpenAI-compatible API support.
+ */
+
+import type {
+  Tool,
+  ChatMessage,
+  ToolCall,
+  StreamEvent,
+  AgentRunResult,
+  BaseAgentOptions,
+} from './types';
+
+export abstract class BaseAgent<TClient> {
+  protected openai: any;
+  protected model: string;
+  protected instructions: string;
+  protected client: TClient;
+
+  constructor(options: BaseAgentOptions & { client: TClient }) {
+    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(): TClient {
+    return this.client;
+  }
+
+  /** 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.
+   */
+  async run(
+    userMessage: string,
+    conversationHistory: ChatMessage[] = []
+  ): Promise<AgentRunResult> {
+    if (!this.openai) {
+      throw new Error('OpenAI client is required for agent.run(). Pass it in the constructor options.');
+    }
+
+    const messages: ChatMessage[] = [
+      { role: 'system', content: this.instructions },
+      ...conversationHistory,
+      { role: 'user', content: userMessage },
+    ];
+
+    const toolCalls: ToolCall[] = [];
+    let response = '';
+    const tools = this.getTools();
+
+    // Agent loop - keep running until no more tool calls
+    while (true) {
+      const completion = await this.openai.chat.completions.create({
+        model: this.model,
+        messages: messages as any,
+        tools: tools as any,
+        tool_choice: 'auto',
+      });
+
+      const assistantMessage = completion.choices[0].message;
+
+      // Check if there are tool calls
+      if (assistantMessage.tool_calls && assistantMessage.tool_calls.length > 0) {
+        // Add assistant message with tool calls
+        messages.push({
+          role: 'assistant',
+          content: assistantMessage.content || '',
+        });
+
+        // Execute each tool call
+        for (const tc of assistantMessage.tool_calls) {
+          const fn = (tc as any).function;
+          const args = JSON.parse(fn.arguments);
+
+          const toolCall: ToolCall = {
+            id: tc.id,
+            name: fn.name,
+            arguments: args,
+            status: 'running',
+          };
+          toolCalls.push(toolCall);
+
+          // Execute the tool
+          const result = await this.executeTool(fn.name, args);
+
+          // Update tool call status
+          if (result.startsWith('Error:')) {
+            toolCall.error = result;
+            toolCall.status = 'error';
+          } else {
+            toolCall.result = result;
+            toolCall.status = 'completed';
+          }
+
+          // Add tool result to messages
+          messages.push({
+            role: 'tool',
+            content: result,
+            tool_call_id: tc.id,
+          });
+        }
+      } else {
+        // No more tool calls - return the final response
+        response = assistantMessage.content || '';
+        break;
+      }
+    }
+
+    return { response, toolCalls };
+  }
+
+  /**
+   * Run the agent with streaming output.
+   * Yields events for real-time UI updates.
+   */
+  async *runStream(
+    userMessage: string,
+    conversationHistory: ChatMessage[] = []
+  ): AsyncGenerator<StreamEvent> {
+    if (!this.openai) {
+      throw new Error('OpenAI client is required for agent.runStream(). Pass it in the constructor options.');
+    }
+
+    const messages: ChatMessage[] = [
+      { role: 'system', content: this.instructions },
+      ...conversationHistory,
+      { role: 'user', content: userMessage },
+    ];
+
+    const tools = this.getTools();
+
+    // Agent loop
+    while (true) {
+      yield { type: 'message_start', message: { role: 'assistant' } };
+
+      const stream = await this.openai.chat.completions.create({
+        model: this.model,
+        messages: messages as any,
+        tools: tools as any,
+        tool_choice: 'auto',
+        stream: true,
+      });
+
+      let contentBuffer = '';
+      const toolCallBuffers: Map<number, { id: string; name: string; arguments: string }> =
+        new Map();
+
+      for await (const chunk of stream) {
+        const delta = chunk.choices[0]?.delta;
+
+        // Handle content
+        if (delta?.content) {
+          contentBuffer += delta.content;
+          yield { type: 'content_delta', delta: { text: delta.content } };
+        }
+
+        // Handle tool calls
+        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;
+          }
+        }
+      }
+
+      // Process tool calls if any
+      if (toolCallBuffers.size > 0) {
+        // Add assistant message to history
+        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 },
+          };
+
+          // Execute the tool
+          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 } };
+          }
+
+          // Add tool result to messages
+          messages.push({
+            role: 'tool',
+            content: result,
+            tool_call_id: buffer.id,
+          });
+        }
+      } else {
+        // No more tool calls - done
+        yield { type: 'message_end' };
+        break;
+      }
+    }
+  }
+}

package/src/core/base-client.ts

@@ -0,0 +1,93 @@
+/**
+ * BaseClient - Abstract HTTP client for subagent APIs
+ */
+
+import type { BaseClientOptions } from './types';
+
+export abstract class BaseClient {
+  protected apiUrl: string;
+  protected timeout: number;
+
+  constructor(options: BaseClientOptions = {}) {
+    this.apiUrl = options.apiUrl || this.getDefaultApiUrl();
+    this.timeout = options.timeout || 60000;
+  }
+
+  /** Override in subclasses to provide default API URL */
+  protected abstract getDefaultApiUrl(): string;
+
+  /** Make a GET request */
+  protected async get<T>(path: string): Promise<T> {
+    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 */
+  protected async post<T>(path: string, body?: unknown): Promise<T> {
+    const response = await fetch(`${this.apiUrl}${path}`, {
+      method: 'POST',
+      headers: body ? { 'Content-Type': 'application/json' } : undefined,
+      body: body ? JSON.stringify(body) : undefined,
+      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 */
+  protected async postFormData<T>(path: string, formData: FormData): Promise<T> {
+    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 */
+  protected async delete(path: string): Promise<void> {
+    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 */
+  protected async downloadBlob(path: string): Promise<Blob> {
+    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(): Promise<{ status: string; service: string }> {
+    return this.get('/health');
+  }
+}

package/src/core/index.ts

@@ -0,0 +1,17 @@
+/**
+ * @morphllm/subagents/core
+ *
+ * Core utilities and base classes for building subagents.
+ */
+
+export { BaseClient } from './base-client';
+export { BaseAgent } from './base-agent';
+export type {
+  Tool,
+  ChatMessage,
+  ToolCall,
+  StreamEvent,
+  AgentRunResult,
+  BaseClientOptions,
+  BaseAgentOptions,
+} from './types';