@morphllm/subagents 0.1.3 → 0.1.5

package/dist/docx/index.d.ts

@@ -1,5 +1,5 @@
-import { BaseClient, BaseAgent } from '../core/index.js';
-import { a as BaseClientOptions, B as BaseAgentOptions, T as Tool } from '../types-D9rS2MQq.js';
+import { B as BaseClient } from '../base-client-C6pbtqLX.js';
+import { a as BaseClientOptions } from '../types-D9rS2MQq.js';
 
 /**
  * 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 };