@morphllm/subagents 0.1.3 → 0.1.4

package/src/docx/client.ts

@@ -10,9 +10,13 @@ import type {
   EditOperation,
   EditResponse,
   ValidateResponse,
+  BuildOperation,
+  BuildResponse,
+  CreateResponse,
+  DocumentInfoResponse,
 } from './types';
 
-const DEFAULT_API_URL = 'https://docx-api-service-production.up.railway.app';
+const DEFAULT_API_URL = 'https://subagents.morphllm.com/v1/morph-docx';
 
 export class DocxClient extends BaseClient {
   constructor(options: DocxClientOptions = {}) {
@@ -66,4 +70,57 @@ export class DocxClient extends BaseClient {
   async deleteDocument(docId: string): Promise<void> {
     return this.delete(`/documents/${docId}`);
   }
+
+  // --- Creation Operations ---
+
+  /**
+   * Create a new empty DOCX document.
+   */
+  async create(title?: string): Promise<CreateResponse> {
+    return this.post('/documents/create', { title });
+  }
+
+  /**
+   * Execute build operations on a document (add content).
+   */
+  async build(docId: string, operations: BuildOperation[]): Promise<BuildResponse> {
+    return this.post(`/documents/${docId}/build`, { operations });
+  }
+
+  /**
+   * Get document information.
+   */
+  async getInfo(docId: string): Promise<DocumentInfoResponse> {
+    return this.get(`/documents/${docId}/info`);
+  }
+
+  // --- Convenience Methods ---
+
+  /**
+   * Add a heading to the document.
+   */
+  async addHeading(docId: string, text: string, level = 1): Promise<BuildResponse> {
+    return this.build(docId, [{ type: 'add_heading', text, level }]);
+  }
+
+  /**
+   * Add a paragraph to the document.
+   */
+  async addParagraph(docId: string, text: string, options?: Partial<BuildOperation>): Promise<BuildResponse> {
+    return this.build(docId, [{ type: 'add_paragraph', text, ...options }]);
+  }
+
+  /**
+   * Add a table to the document.
+   */
+  async addTable(docId: string, headers: string[], rows: string[][]): Promise<BuildResponse> {
+    return this.build(docId, [{ type: 'add_table', headers, rows }]);
+  }
+
+  /**
+   * Add page numbers to the document.
+   */
+  async addPageNumbers(docId: string, format = 'Page {PAGE} of {NUMPAGES}'): Promise<BuildResponse> {
+    return this.build(docId, [{ type: 'add_page_numbers', format_string: format }]);
+  }
 }

package/src/docx/types.ts

@@ -24,7 +24,81 @@ export type EditOperationType =
   | 'delete_comment'
   | 'insert_text'
   | 'insert_paragraph'
-  | 'propose_deletion';
+  | 'propose_deletion'
+  | 'reject_insertion'
+  | 'restore_deletion'
+  | 'enable_track_changes';
+
+/** Build operation types (for document creation) */
+export 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 */
+export 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 */
+export interface CreateResponse {
+  doc_id: string;
+  message: string;
+}
+
+/** Response from build operations */
+export interface BuildResponse {
+  results: string[];
+  doc_id: string;
+}
+
+/** Document info response */
+export interface DocumentInfoResponse {
+  paragraphs: number;
+  tables: number;
+  sections: number;
+  title: string;
+  author: string;
+  created: string;
+  modified: string;
+}
 
 /** Edit operation payload */
 export interface EditOperation {
@@ -62,7 +136,77 @@ export interface DocxClientOptions extends BaseClientOptions {
 }
 
 /** DOCX agent options */
-export interface DocxAgentOptions extends BaseAgentOptions {
+export interface DocxAgentOptions {
+  /** Base URL for the API. Defaults to subagents.morphllm.com/v1 */
+  baseUrl?: string;
+  /** API key (optional, not required for public endpoints) */
+  apiKey?: string;
   /** Current document ID */
   documentId?: string;
 }
+
+/** Chat message */
+export interface Message {
+  role: 'system' | 'user' | 'assistant' | 'tool';
+  content: string;
+  tool_call_id?: string;
+  tool_calls?: ToolCall[];
+}
+
+/** Tool call in a message */
+export interface ToolCall {
+  id: string;
+  type: 'function';
+  function: {
+    name: string;
+    arguments: string;
+  };
+}
+
+/** Chat completion response (non-streaming) */
+export 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 */
+export 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;
+}