@morphllm/subagents 0.1.3 → 0.1.5

package/README.md

@@ -1,4 +1,4 @@
-# @morphllm/subagents
+# subagents
 
 Modular AI subagents for document processing. Built for use with OpenAI-compatible APIs.
 
@@ -38,7 +38,7 @@ The main agent handles orchestration and planning. When it encounters a speciali
 ## Installation
 
 ```bash
-npm install @morphllm/subagents
+npm install subagents
 ```
 
 ## Available Subagents
@@ -53,7 +53,7 @@ npm install @morphllm/subagents
 ### DOCX Client (Direct API Access)
 
 ```typescript
-import { DocxClient } from '@morphllm/subagents/docx';
+import { DocxClient } from 'subagents/docx';
 
 const client = new DocxClient();
 
@@ -77,19 +77,15 @@ const blob = await client.download(doc.doc_id);
 
 ```typescript
 import OpenAI from 'openai';
-import { DocxClient, DocxAgent } from '@morphllm/subagents/docx';
+import { DocxAgent } from 'subagents/docx';
 
-const openai = new OpenAI();
-const client = new DocxClient();
-
-// Upload a document first
-const file = new File([documentBuffer], 'contract.docx');
-const { doc_id } = await client.upload(file);
+const openai = new OpenAI({
+  apiKey: process.env.OPENAI_API_KEY,
+});
 
-// Create agent with the document
 const agent = new DocxAgent({
   openai,
-  documentId: doc_id,
+  documentId: 'your-doc-id',
 });
 
 // Run with natural language
@@ -97,13 +93,7 @@ const result = await agent.run('Review this contract and flag any issues');
 console.log(result.response);
 console.log(result.toolCalls);
 
-// Download the edited document
-const editedDoc = await client.download(doc_id);
-```
-
-### Streaming Responses
-
-```typescript
+// 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);
@@ -117,11 +107,11 @@ for await (const event of agent.runStream('Add comments to unclear sections')) {
 
 ```typescript
 // Import everything
-import { DocxClient, DocxAgent, BaseClient } from '@morphllm/subagents';
+import { DocxClient, DocxAgent, BaseClient } from 'subagents';
 
 // Import specific modules
-import { DocxClient, DocxAgent } from '@morphllm/subagents/docx';
-import { BaseClient, BaseAgent } from '@morphllm/subagents/core';
+import { DocxClient, DocxAgent } from 'subagents/docx';
+import { BaseClient, BaseAgent } from 'subagents/core';
 ```
 
 ## Building Custom Subagents
@@ -129,8 +119,8 @@ import { BaseClient, BaseAgent } from '@morphllm/subagents/core';
 Extend the base classes to create your own subagents:
 
 ```typescript
-import { BaseClient, BaseAgent } from '@morphllm/subagents/core';
-import type { Tool } from '@morphllm/subagents/core';
+import { BaseClient, BaseAgent } from 'subagents/core';
+import type { Tool } from 'subagents/core';
 
 class MyClient extends BaseClient {
   protected getDefaultApiUrl() {
@@ -165,7 +155,7 @@ class MyAgent extends BaseAgent<MyClient> {
 
 | Variable | Description | Default |
 |----------|-------------|---------|
-| `DOCX_API_URL` | DOCX service URL | https://docx.morphllm.com |
+| `DOCX_API_URL` | DOCX service URL | Railway deployment |
 
 ## License
 

package/dist/base-client-B7fgl_Wg.d.mts

@@ -0,0 +1,30 @@
+import { a as BaseClientOptions } 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;
+    }>;
+}
+
+export { BaseClient as B };

package/dist/base-client-C6pbtqLX.d.ts

@@ -0,0 +1,30 @@
+import { a as BaseClientOptions } 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;
+    }>;
+}
+
+export { BaseClient as B };

package/dist/core/index.d.mts

@@ -1,32 +1,6 @@
-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;
-    }>;
-}
+export { B as BaseClient } from '../base-client-B7fgl_Wg.mjs';
+import { B as BaseAgentOptions, T as Tool, C as ChatMessage, A as AgentRunResult, S as StreamEvent } from '../types-D9rS2MQq.mjs';
+export { a as BaseClientOptions, b as ToolCall } from '../types-D9rS2MQq.mjs';
 
 /**
  * BaseAgent - Abstract base class for AI subagents
@@ -65,4 +39,4 @@ declare abstract class BaseAgent<TClient> {
     runStream(userMessage: string, conversationHistory?: ChatMessage[]): AsyncGenerator<StreamEvent>;
 }
 
-export { AgentRunResult, BaseAgent, BaseAgentOptions, BaseClient, BaseClientOptions, ChatMessage, StreamEvent, Tool };
+export { AgentRunResult, BaseAgent, BaseAgentOptions, ChatMessage, StreamEvent, Tool };

package/dist/core/index.d.ts

@@ -1,32 +1,6 @@
-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;
-    }>;
-}
+export { B as BaseClient } from '../base-client-C6pbtqLX.js';
+import { B as BaseAgentOptions, T as Tool, C as ChatMessage, A as AgentRunResult, S as StreamEvent } from '../types-D9rS2MQq.js';
+export { a as BaseClientOptions, b as ToolCall } from '../types-D9rS2MQq.js';
 
 /**
  * BaseAgent - Abstract base class for AI subagents
@@ -65,4 +39,4 @@ declare abstract class BaseAgent<TClient> {
     runStream(userMessage: string, conversationHistory?: ChatMessage[]): AsyncGenerator<StreamEvent>;
 }
 
-export { AgentRunResult, BaseAgent, BaseAgentOptions, BaseClient, BaseClientOptions, ChatMessage, StreamEvent, Tool };
+export { AgentRunResult, BaseAgent, BaseAgentOptions, ChatMessage, StreamEvent, Tool };

package/dist/docx/index.d.mts

@@ -1,5 +1,5 @@
-import { BaseClient, BaseAgent } from '../core/index.mjs';
-import { a as BaseClientOptions, B as BaseAgentOptions, T as Tool } from '../types-D9rS2MQq.mjs';
+import { B as BaseClient } from '../base-client-B7fgl_Wg.mjs';
+import { a as BaseClientOptions } from '../types-D9rS2MQq.mjs';
 
 /**
  * Types for DOCX subagent
@@ -16,7 +16,61 @@ interface ReadResponse {
     paragraphs: number;
 }
 /** Edit operation types */
-type EditOperationType = 'add_comment' | 'reply_comment' | 'resolve_comment' | 'delete_comment' | 'insert_text' | 'insert_paragraph' | 'propose_deletion';
+type EditOperationType = 'add_comment' | 'reply_comment' | 'resolve_comment' | 'delete_comment' | 'insert_text' | 'insert_paragraph' | 'propose_deletion' | 'reject_insertion' | 'restore_deletion' | 'enable_track_changes';
+/** Build operation types (for document creation) */
+type BuildOperationType = 'add_heading' | 'add_paragraph' | 'add_table' | 'add_image' | 'add_list_item' | 'add_hyperlink' | 'add_page_break' | 'add_section_break' | 'add_header' | 'add_footer' | 'add_page_numbers' | 'setup_styles';
+/** Build operation payload */
+interface BuildOperation {
+    type: BuildOperationType;
+    text?: string;
+    level?: number;
+    style?: string;
+    alignment?: 'left' | 'center' | 'right' | 'justify';
+    bold?: boolean;
+    italic?: boolean;
+    font_size?: number;
+    font_name?: string;
+    color?: string;
+    space_before?: number;
+    space_after?: number;
+    headers?: string[];
+    rows?: string[][];
+    header_bg_color?: string;
+    image_url?: string;
+    image_data?: string;
+    width?: number;
+    height?: number;
+    list_type?: 'bullet' | 'number';
+    url?: string;
+    position?: 'header' | 'footer';
+    format_string?: string;
+    section_index?: number;
+    base_font?: string;
+    base_size?: number;
+    heading_font?: string;
+    primary_color?: string;
+    break_type?: 'next_page' | 'continuous' | 'even_page' | 'odd_page';
+}
+/** Response from create operations */
+interface CreateResponse {
+    doc_id: string;
+    message: string;
+}
+/** Response from build operations */
+interface BuildResponse {
+    results: string[];
+    doc_id: string;
+}
+/** Document info response */
+interface DocumentInfoResponse {
+    paragraphs: number;
+    tables: number;
+    sections: number;
+    title: string;
+    author: string;
+    created: string;
+    modified: string;
+}
 /** Edit operation payload */
 interface EditOperation {
     type: EditOperationType;
@@ -49,10 +103,76 @@ interface DocxClientOptions extends BaseClientOptions {
     apiUrl?: string;
 }
 /** DOCX agent options */
-interface DocxAgentOptions extends BaseAgentOptions {
+interface DocxAgentOptions {
+    /** Base URL for the API. Defaults to api.subagents.com/v1 */
+    baseUrl?: string;
+    /** API key (optional, not required for public endpoints) */
+    apiKey?: string;
     /** Current document ID */
     documentId?: string;
 }
+/** Chat message */
+interface Message {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    tool_call_id?: string;
+    tool_calls?: ToolCall[];
+}
+/** Tool call in a message */
+interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/** Chat completion response (non-streaming) */
+interface ChatCompletionResponse {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    choices: {
+        index: number;
+        message: {
+            role: 'assistant';
+            content: string | null;
+            tool_calls?: ToolCall[];
+        };
+        finish_reason: string;
+    }[];
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+/** Stream chunk */
+interface StreamChunk {
+    id?: string;
+    object?: string;
+    created?: number;
+    model?: string;
+    choices?: {
+        index: number;
+        delta: {
+            role?: string;
+            content?: string;
+            tool_calls?: {
+                index: number;
+                id?: string;
+                type?: string;
+                function?: {
+                    name?: string;
+                    arguments?: string;
+                };
+            }[];
+        };
+        finish_reason?: string | null;
+    }[];
+    error?: string;
+}
 
 /**
  * DocxClient - HTTP client for DOCX document API
@@ -85,26 +205,88 @@ declare class DocxClient extends BaseClient {
      * Delete a document from storage.
      */
     deleteDocument(docId: string): Promise<void>;
+    /**
+     * Create a new empty DOCX document.
+     */
+    create(title?: string): Promise<CreateResponse>;
+    /**
+     * Execute build operations on a document (add content).
+     */
+    build(docId: string, operations: BuildOperation[]): Promise<BuildResponse>;
+    /**
+     * Get document information.
+     */
+    getInfo(docId: string): Promise<DocumentInfoResponse>;
+    /**
+     * Add a heading to the document.
+     */
+    addHeading(docId: string, text: string, level?: number): Promise<BuildResponse>;
+    /**
+     * Add a paragraph to the document.
+     */
+    addParagraph(docId: string, text: string, options?: Partial<BuildOperation>): Promise<BuildResponse>;
+    /**
+     * Add a table to the document.
+     */
+    addTable(docId: string, headers: string[], rows: string[][]): Promise<BuildResponse>;
+    /**
+     * Add page numbers to the document.
+     */
+    addPageNumbers(docId: string, format?: string): Promise<BuildResponse>;
 }
 
 /**
  * DocxAgent - AI agent for DOCX document editing
  *
- * Uses OpenAI-compatible API to process requests and execute
- * document editing operations.
+ * OpenAI Agents SDK compatible client for morph-docx.
+ * Talks to api.subagents.com/v1/chat/completions with model "morph-docx".
  */
 
-declare class DocxAgent extends BaseAgent<DocxClient> {
+declare class DocxAgent {
+    private baseUrl;
+    private apiKey;
     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>;
+    /**
+     * Send a chat completion request (non-streaming).
+     * This runs the full agent loop on the server and returns the final response.
+     */
+    chat(messages: Message[]): Promise<ChatCompletionResponse>;
+    /**
+     * Send a streaming chat completion request.
+     * Returns an async generator that yields chunks as they arrive.
+     */
+    chatStream(messages: Message[]): AsyncGenerator<StreamChunk>;
+    /**
+     * Helper: Simple completion that returns just the content string.
+     */
+    complete(userMessage: string): Promise<string>;
+    /**
+     * Create an OpenAI-compatible client configuration.
+     * Use this with the OpenAI SDK or OpenAI Agents SDK.
+     *
+     * @example
+     * ```typescript
+     * import OpenAI from 'openai';
+     * import { DocxAgent } from 'subagents/docx';
+     *
+     * const agent = new DocxAgent();
+     * const openai = new OpenAI(agent.getOpenAIConfig());
+     *
+     * const response = await openai.chat.completions.create({
+     *   model: 'morph-docx',
+     *   messages: [{ role: 'user', content: 'Hello!' }],
+     * });
+     * ```
+     */
+    getOpenAIConfig(): {
+        baseURL: string;
+        apiKey: string;
+    };
 }
 
 export { type DocumentInfo, DocxAgent, type DocxAgentOptions, DocxClient, type DocxClientOptions, type EditOperation, type EditOperationType, type EditResponse, type ReadResponse, type ValidateResponse };