@retab/node 1.0.80 → 1.0.81

package/dist/api/edit/agent/client.d.ts

@@ -0,0 +1,29 @@
+import { CompositionClient, RequestOptions } from "../../../client.js";
+import { EditRequest, EditResponse } from "../../../types.js";
+export default class APIEditAgent extends CompositionClient {
+    constructor(client: CompositionClient);
+    /**
+     * Edit a document by detecting and filling form fields with provided instructions.
+     *
+     * This method performs:
+     * 1. Detection to identify form field bounding boxes
+     * 2. LLM inference to name and describe detected fields
+     * 3. LLM-based form filling using the provided instructions
+     * 4. Returns the filled document with form field values populated
+     *
+     * Supported document formats:
+     * - PDF: Native form field detection and filling
+     * - DOCX/DOC: Native editing to preserve styles and formatting
+     * - PPTX/PPT: Native editing for presentations
+     * - XLSX/XLS: Native editing for spreadsheets
+     *
+     * @param params - EditRequest containing:
+     *   - instructions: Natural language instructions for filling (required)
+     *   - document: MIMEData object with filename and base64 data URI (required)
+     *   - model: LLM model for inference (default: "retab-small")
+     * @param options - Optional request options
+     * @returns EditResponse containing form_data (filled fields) and filled_document (MIMEData)
+     */
+    fill(params: EditRequest, options?: RequestOptions): Promise<EditResponse>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/api/edit/agent/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/api/edit/agent/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EACH,WAAW,EACX,YAAY,EAGf,MAAM,mBAAmB,CAAC;AAE3B,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,iBAAiB;gBAC3C,MAAM,EAAE,iBAAiB;IAIrC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;CASnF"}

package/dist/api/edit/agent/client.js

@@ -0,0 +1,38 @@
+import { CompositionClient } from "../../../client.js";
+import { ZEditRequest, ZEditResponse, } from "../../../types.js";
+export default class APIEditAgent extends CompositionClient {
+    constructor(client) {
+        super(client);
+    }
+    /**
+     * Edit a document by detecting and filling form fields with provided instructions.
+     *
+     * This method performs:
+     * 1. Detection to identify form field bounding boxes
+     * 2. LLM inference to name and describe detected fields
+     * 3. LLM-based form filling using the provided instructions
+     * 4. Returns the filled document with form field values populated
+     *
+     * Supported document formats:
+     * - PDF: Native form field detection and filling
+     * - DOCX/DOC: Native editing to preserve styles and formatting
+     * - PPTX/PPT: Native editing for presentations
+     * - XLSX/XLS: Native editing for spreadsheets
+     *
+     * @param params - EditRequest containing:
+     *   - instructions: Natural language instructions for filling (required)
+     *   - document: MIMEData object with filename and base64 data URI (required)
+     *   - model: LLM model for inference (default: "retab-small")
+     * @param options - Optional request options
+     * @returns EditResponse containing form_data (filled fields) and filled_document (MIMEData)
+     */
+    async fill(params, options) {
+        return this._fetchJson(ZEditResponse, {
+            url: "/v1/edit/agent/fill",
+            method: "POST",
+            body: { ...(await ZEditRequest.parseAsync(params)), ...(options?.body || {}) },
+            params: options?.params,
+            headers: options?.headers,
+        });
+    }
+}

package/dist/api/edit/client.d.ts

@@ -1,34 +1,16 @@
-import { CompositionClient, RequestOptions } from "../../client.js";
-import { EditRequest, EditResponse } from "../../types.js";
+import { CompositionClient } from "../../client.js";
 import APIEditTemplates from "./templates/client.js";
+import APIEditAgent from "./agent/client.js";
+/**
+ * Edit API client for document editing functionality.
+ *
+ * Sub-clients:
+ * - agent: Agent-based document editing (fill any document with AI)
+ * - templates: Template-based PDF form filling (for batch processing)
+ */
 export default class APIEdit extends CompositionClient {
+    agent: APIEditAgent;
     templates: APIEditTemplates;
     constructor(client: CompositionClient);
-    /**
-     * Edit a document by detecting and filling form fields with provided instructions.
-     *
-     * This method performs:
-     * 1. Detection to identify form field bounding boxes
-     * 2. LLM inference to name and describe detected fields
-     * 3. LLM-based form filling using the provided instructions
-     * 4. Returns the filled document with form field values populated
-     *
-     * Either `document` OR `template_id` must be provided, but not both.
-     *
-     * Supported document formats:
-     * - PDF: Native form field detection and filling
-     * - DOCX/DOC: Native editing to preserve styles and formatting
-     * - PPTX/PPT: Native editing for presentations
-     * - XLSX/XLS: Native editing for spreadsheets
-     *
-     * @param params - EditRequest containing:
-     *   - instructions: Natural language instructions for filling (required)
-     *   - document: MIMEData object, file path, Buffer, or Readable stream (optional, mutually exclusive with template_id)
-     *   - model: LLM model for inference (default: "retab-small")
-     *   - template_id: Template ID to use for filling with pre-defined form fields (optional, mutually exclusive with document)
-     * @param options - Optional request options
-     * @returns EditResponse containing form_data (filled fields) and filled_document (MIMEData)
-     */
-    fill_document(params: EditRequest, options?: RequestOptions): Promise<EditResponse>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/api/edit/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/api/edit/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EACH,WAAW,EACX,YAAY,EAGf,MAAM,gBAAgB,CAAC;AACxB,OAAO,gBAAgB,MAAM,uBAAuB,CAAC;AAErD,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,iBAAiB;IAC3C,SAAS,EAAE,gBAAgB,CAAC;gBAEvB,MAAM,EAAE,iBAAiB;IAKrC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;CAS5F"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/api/edit/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,gBAAgB,MAAM,uBAAuB,CAAC;AACrD,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,iBAAiB;IAC3C,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,gBAAgB,CAAC;gBAEvB,MAAM,EAAE,iBAAiB;CAKxC"}

package/dist/api/edit/client.js

@@ -1,43 +1,17 @@
 import { CompositionClient } from "../../client.js";
-import { ZEditRequest, ZEditResponse, } from "../../types.js";
 import APIEditTemplates from "./templates/client.js";
+import APIEditAgent from "./agent/client.js";
+/**
+ * Edit API client for document editing functionality.
+ *
+ * Sub-clients:
+ * - agent: Agent-based document editing (fill any document with AI)
+ * - templates: Template-based PDF form filling (for batch processing)
+ */
 export default class APIEdit extends CompositionClient {
     constructor(client) {
         super(client);
+        this.agent = new APIEditAgent(this);
         this.templates = new APIEditTemplates(this);
     }
-    /**
-     * Edit a document by detecting and filling form fields with provided instructions.
-     *
-     * This method performs:
-     * 1. Detection to identify form field bounding boxes
-     * 2. LLM inference to name and describe detected fields
-     * 3. LLM-based form filling using the provided instructions
-     * 4. Returns the filled document with form field values populated
-     *
-     * Either `document` OR `template_id` must be provided, but not both.
-     *
-     * Supported document formats:
-     * - PDF: Native form field detection and filling
-     * - DOCX/DOC: Native editing to preserve styles and formatting
-     * - PPTX/PPT: Native editing for presentations
-     * - XLSX/XLS: Native editing for spreadsheets
-     *
-     * @param params - EditRequest containing:
-     *   - instructions: Natural language instructions for filling (required)
-     *   - document: MIMEData object, file path, Buffer, or Readable stream (optional, mutually exclusive with template_id)
-     *   - model: LLM model for inference (default: "retab-small")
-     *   - template_id: Template ID to use for filling with pre-defined form fields (optional, mutually exclusive with document)
-     * @param options - Optional request options
-     * @returns EditResponse containing form_data (filled fields) and filled_document (MIMEData)
-     */
-    async fill_document(params, options) {
-        return this._fetchJson(ZEditResponse, {
-            url: "/v1/edit/fill-document",
-            method: "POST",
-            body: { ...(await ZEditRequest.parseAsync(params)), ...(options?.body || {}) },
-            params: options?.params,
-            headers: options?.headers,
-        });
-    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retab/node",
-  "version": "1.0.80",
+  "version": "1.0.81",
   "description": "Retab official Node.js library",
   "main": "dist/index.js",
   "exports": {