@chenchaolong/plugin-mineru 0.0.12 → 1.1.0

package/README.md

@@ -1,113 +1,101 @@
-# Xpert Plugin: MinerU
-
-`@chenchaolong/plugin-mineru` is a MinerU document converter plugin for the [Xpert AI](https://github.com/xpert-ai/xpert) platform, providing extraction capabilities from PDF to Markdown and structured JSON. The plugin includes built-in MinerU integration strategies, document conversion strategies, and result parsing services, enabling secure access to the MinerU API in automated workflows, polling task status, and writing parsed content and attachment resources to the platform file system.
-
-## Installation
-
-```bash
-pnpm add @chenchaolong/plugin-mineru
-# or
-npm install @chenchaolong/plugin-mineru
-```
-
-> **Note**: This plugin depends on `@xpert-ai/plugin-sdk`, `@nestjs/common@^11`, `@nestjs/config@^4`, `@metad/contracts`, `axios@1`, `chalk@4`, `@langchain/core@^0.3.72`, and `uuid@8` as peerDependencies. Please ensure these packages are installed in your host project.
-
-## Quick Start
-
-1. **Prepare MinerU Credentials**  
-    Obtain a valid API Key from the MinerU dashboard and confirm the service address (default: `https://mineru.net/api/v4`).
-
-2. **Configure Integration in Xpert**  
-    - Via Xpert Console: Create a MinerU integration and fill in the following fields.  
-    - Or set environment variables in your deployment environment:
-      - `MINERU_API_BASE_URL`: Optional, defaults to `https://mineru.net/api/v4`.
-      - `MINERU_API_TOKEN`: Required, used as a fallback credential if no integration is configured.
-
-    Example integration configuration (JSON):
-
-    ```json
-    {
-      "provider": "mineru",
-      "options": {
-         "apiUrl": "https://mineru.net/api/v4",
-         "apiKey": "your-mineru-api-key"
-      }
-    }
-    ```
-
-3. **Register the Plugin**  
-    Configure the plugin in your host service's plugin registration process:
-
-    ```sh .env
-    PLUGINS=@chenchaolong/plugin-mineru
-    ```
-
-    The plugin returns the NestJS module `MinerUPlugin` in the `register` hook and logs messages during the `onStart`/`onStop` lifecycle.
-
-## MinerU Integration Options
-
-| Field    | Type   | Description                           | Required | Default                      |
-| -------- | ------ | ------------------------------------- | -------- | ---------------------------- |
-| apiUrl   | string | MinerU API base URL                   | No       | `https://mineru.net/api/v4`  |
-| apiKey   | string | MinerU service API Key (keep secret)  | Yes      | —                            |
-
-> If both integration configuration and environment variables are provided, options from the integration configuration take precedence.
-
-## Document Conversion Parameters
-
-`MinerUTransformerStrategy` supports the following configuration options (passed to the MinerU API when starting a workflow):
-
-| Field            | Type    | Default      | Description                                         |
-| ---------------- | ------- | ------------ | --------------------------------------------------- |
-| `isOcr`          | boolean | `true`       | Enable OCR for image-based PDFs.                    |
-| `enableFormula`  | boolean | `true`       | Recognize mathematical formulas and output tags.    |
-| `enableTable`    | boolean | `true`       | Recognize tables and output structured tags.        |
-| `language`       | string  | `"ch"`       | Main document language, per MinerU API (`en`/`ch`). |
-| `modelVersion`   | string  | `"pipeline"` | MinerU model version (`pipeline`, `vlm`, etc.).     |
-
-By default, the plugin creates MinerU tasks for each file to be processed, polls until `full_zip_url` is returned, then downloads and parses the zip package in memory.
-
-## Permissions
-
-- **Integration**: Access MinerU integration configuration to read API address and credentials.
-- **File System**: Perform `read/write/list` on `XpFileSystem` to store image resources from MinerU results.
-
-Ensure the plugin is granted these permissions in your authorization policy, or it will not be able to retrieve results or write attachments.
-
-## Output Content
-
-The parser generates:
-
-- Full Markdown: Resource links are automatically replaced to point to actual URLs written via `XpFileSystem`.
-- Structured metadata: Includes MinerU task ID, layout JSON (`layout.json`), content list (`content_list.json`), original PDF filename, etc.
-- Attachment asset list: Records written image resources for easy association by callers.
-
-The returned `Document<ChunkMetadata>` array currently defaults to a single chunk containing the full Markdown; you can split it as needed.
-
-## Local Deployment
-
-For self-hosted MinerU deployments, see [LOCAL_SETUP.md](./LOCAL_SETUP.md) for detailed instructions on:
-- Starting MinerU server using Docker
-- Installing from source code
-- Configuration and troubleshooting
-
-Quick start with Docker:
-```bash
-docker run -d --name mineru -p 9960:9960 opendatalab/mineru:latest
-```
-
-## Development & Debugging
-
-Run the following commands in the repository root to build and test locally:
-
-```bash
-npm install
-npx nx build @chenchaolong/plugin-mineru
-npx nx test @chenchaolong/plugin-mineru
-```
-
-TypeScript build artifacts are output to `packages/mineru/dist`. Before publishing, ensure `package.json`, type declarations, and runtime files are in sync.
-
-## License
-
-This project follows the [AGPL-3.0 License](../../../LICENSE) in the repository root.
+# Xpert Plugin: MinerU
+
+`@chenchaolong/plugin-mineru` is a MinerU document converter plugin for the [Xpert AI](https://github.com/xpert-ai/xpert) platform, providing extraction capabilities from PDF to Markdown and structured JSON. The plugin includes built-in MinerU integration strategies, document conversion strategies, and result parsing services, enabling secure access to the MinerU API in automated workflows, polling task status, and writing parsed content and attachment resources to the platform file system.
+
+## Installation
+
+```bash
+pnpm add @chenchaolong/plugin-mineru
+# or
+npm install @chenchaolong/plugin-mineru
+```
+
+> **Note**: This plugin depends on `@xpert-ai/plugin-sdk`, `@nestjs/common@^11`, `@nestjs/config@^4`, `@metad/contracts`, `axios@1`, `chalk@4`, `@langchain/core@^0.3.72`, and `uuid@8` as peerDependencies. Please ensure these packages are installed in your host project.
+
+## Quick Start
+
+1. **Prepare MinerU Credentials**  
+    Obtain a valid API Key from the MinerU dashboard and confirm the service address (default: `https://mineru.net/api/v4`).
+
+2. **Configure Integration in Xpert**  
+    - Via Xpert Console: Create a MinerU integration and fill in the following fields.  
+    - Or set environment variables in your deployment environment:
+      - `MINERU_API_BASE_URL`: Optional, defaults to `https://mineru.net/api/v4`.
+      - `MINERU_API_TOKEN`: Required, used as a fallback credential if no integration is configured.
+
+    Example integration configuration (JSON):
+
+    ```json
+    {
+      "provider": "mineru",
+      "options": {
+         "apiUrl": "https://mineru.net/api/v4",
+         "apiKey": "your-mineru-api-key"
+      }
+    }
+    ```
+
+3. **Register the Plugin**  
+    Configure the plugin in your host service's plugin registration process:
+
+    ```sh .env
+    PLUGINS=@chenchaolong/plugin-mineru
+    ```
+
+    The plugin returns the NestJS module `MinerUPlugin` in the `register` hook and logs messages during the `onStart`/`onStop` lifecycle.
+
+## MinerU Integration Options
+
+| Field    | Type   | Description                           | Required | Default                      |
+| -------- | ------ | ------------------------------------- | -------- | ---------------------------- |
+| apiUrl   | string | MinerU API base URL                   | No       | `https://mineru.net/api/v4`  |
+| apiKey   | string | MinerU service API Key (keep secret)  | Yes      | —                            |
+
+> If both integration configuration and environment variables are provided, options from the integration configuration take precedence.
+
+## Document Conversion Parameters
+
+`MinerUTransformerStrategy` supports the following configuration options (passed to the MinerU API when starting a workflow):
+
+| Field            | Type    | Default      | Description                                         |
+| ---------------- | ------- | ------------ | --------------------------------------------------- |
+| `isOcr`          | boolean | `true`       | Enable OCR for image-based PDFs.                    |
+| `enableFormula`  | boolean | `true`       | Recognize mathematical formulas and output tags.    |
+| `enableTable`    | boolean | `true`       | Recognize tables and output structured tags.        |
+| `language`       | string  | `"ch"`       | Main document language, per MinerU API (`en`/`ch`). |
+| `modelVersion`   | string  | `"pipeline"` | MinerU model version (`pipeline`, `vlm`, etc.).     |
+
+By default, the plugin creates MinerU tasks for each file to be processed, polls until `full_zip_url` is returned, then downloads and parses the zip package in memory.
+
+## Permissions
+
+- **Integration**: Access MinerU integration configuration to read API address and credentials.
+- **File System**: Perform `read/write/list` on `XpFileSystem` to store image resources from MinerU results.
+
+Ensure the plugin is granted these permissions in your authorization policy, or it will not be able to retrieve results or write attachments.
+
+## Output Content
+
+The parser generates:
+
+- Full Markdown: Resource links are automatically replaced to point to actual URLs written via `XpFileSystem`.
+- Structured metadata: Includes MinerU task ID, layout JSON (`layout.json`), content list (`content_list.json`), original PDF filename, etc.
+- Attachment asset list: Records written image resources for easy association by callers.
+
+The returned `Document<ChunkMetadata>` array currently defaults to a single chunk containing the full Markdown; you can split it as needed.
+
+## Development & Debugging
+
+Run the following commands in the repository root to build and test locally:
+
+```bash
+npm install
+npx nx build @chenchaolong/plugin-mineru
+npx nx test @chenchaolong/plugin-mineru
+```
+
+TypeScript build artifacts are output to `packages/mineru/dist`. Before publishing, ensure `package.json`, type declarations, and runtime files are in sync.
+
+## License
+
+This project follows the [AGPL-3.0 License](../../../LICENSE) in the repository root.

package/dist/lib/mineru.client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mineru.client.d.ts","sourceRoot":"","sources":["../../src/lib/mineru.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAmB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAc,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAK7C,OAAO,EAIL,wBAAwB,EAExB,0BAA0B,EAC1B,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAIpB,UAAU,iBAAiB;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,UAAU,mBAAmB;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,sBAAsB;IAC9B,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,iBAAiB;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AASD,qBAAa,YAAY;IAWrB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAX/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAChC,SAAgB,UAAU,EAAE,gBAAgB,CAAC;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiD;IAE5E,IAAI,UAAU,IAAI,YAAY,GAAG,SAAS,CAEzC;gBAEkB,aAAa,EAAE,aAAa,EAC5B,WAAW,CAAC,EAAE;QACvB,UAAU,CAAC,EAAE,YAAY,CAAC;QAC1B,WAAW,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,wBAAwB,CAAC,CAAC,CAAC;KACjE;IAkBP;;;OAGG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAYzE;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IA+CzG,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS;IAOzE;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC;QACxE,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAoBF;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAiBnD;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,SAAgB,EAAE,UAAU,SAAO,GAAG,OAAO,CAAC,GAAG,CAAC;IAsB7F,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,kBAAkB;IAyB1B,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,oBAAoB;YAYd,kBAAkB;YAmClB,oBAAoB;YASpB,qBAAqB;YA0DrB,uBAAuB;IA+CrC,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,2BAA2B;IAenC,OAAO,CAAC,6BAA6B;IAcrC,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,eAAe;YAIT,YAAY;IAkB1B,OAAO,CAAC,eAAe;IA0BvB,wBAAwB,IAAI,OAAO,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAKtD,wBAAwB;CAU/B"}
+{"version":3,"file":"mineru.client.d.ts","sourceRoot":"","sources":["../../src/lib/mineru.client.ts"],"names":[],"mappings":"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"}

package/dist/lib/mineru.client.js

@@ -46,10 +46,6 @@ export class MinerUClient {
      */
     async createBatchTask(options) {
         this.ensureOfficial('createBatchTask');
-        // Validate files is an array
-        if (!Array.isArray(options.files)) {
-            throw new Error('MinerU createBatchTask requires files to be an array');
-        }
         const url = this.buildApiUrl('extract', 'task', 'batch');
         const body = {
             files: options.files.map((file) => {
@@ -71,15 +67,8 @@ export class MinerUClient {
             body.language = options.language;
         if (options.modelVersion)
             body.model_version = options.modelVersion;
-        // Ensure extraFormats is an array if provided
-        if (options.extraFormats) {
-            if (Array.isArray(options.extraFormats)) {
-                body.extra_formats = options.extraFormats;
-            }
-            else {
-                this.logger.warn('extraFormats is not an array, ignoring');
-            }
-        }
+        if (options.extraFormats)
+            body.extra_formats = options.extraFormats;
         if (options.callbackUrl)
             body.callback = options.callbackUrl;
         if (options.seed)
@@ -242,15 +231,8 @@ export class MinerUClient {
             body.data_id = options.dataId;
         if (options.pageRanges)
             body.page_ranges = options.pageRanges;
-        // Ensure extraFormats is an array if provided
-        if (options.extraFormats) {
-            if (Array.isArray(options.extraFormats)) {
-                body.extra_formats = options.extraFormats;
-            }
-            else {
-                this.logger.warn('extraFormats is not an array, ignoring');
-            }
-        }
+        if (options.extraFormats)
+            body.extra_formats = options.extraFormats;
         if (options.callbackUrl)
             body.callback = options.callbackUrl;
         if (options.seed)
@@ -269,15 +251,33 @@ export class MinerUClient {
         }
     }
     async createSelfHostedTask(options) {
+        // Validate fileSystem is available for self-hosted mode
+        if (!this.fileSystem) {
+            throw new Error('MinerU self-hosted mode requires fileSystem permission');
+        }
+        // Validate filePath is provided
+        if (!options.filePath) {
+            throw new Error('MinerU self-hosted mode requires filePath to be provided');
+        }
+        // Get absolute file path from fileSystem
         const filePath = this.fileSystem.fullPath(options.filePath);
+        // Validate file exists before attempting to parse
+        try {
+            await fs.promises.access(filePath, fs.constants.F_OK);
+        }
+        catch (error) {
+            this.logger.error(`File not found: ${filePath}`, error instanceof Error ? error.stack : error);
+            throw new Error(`File not found: ${filePath}`);
+        }
         const taskId = randomUUID();
-        const result = await this.invokeSelfHostedParse(filePath, options.fileName, options);
+        const result = await this.invokeSelfHostedParse(filePath, options.fileName || basename(filePath), options);
         this.localTasks.set(taskId, { ...result, sourceUrl: options.url });
         return { taskId };
     }
     async invokeSelfHostedParse(filePath, fileName, options) {
         const parseUrl = this.buildApiUrl('file_parse');
         const form = new FormData();
+        // Create file read stream (file existence is already validated in createSelfHostedTask)
         form.append('files', fs.createReadStream(filePath), {
             filename: fileName,
         });
@@ -308,11 +308,14 @@ export class MinerUClient {
             return this.invokeSelfHostedParseV1(filePath, fileName, options);
         }
         if (response.status === 400) {
-            throw new BadRequestException(`MinerU self-hosted parse failed: ${response.status} ${getErrorMessage(response.data)}`);
+            const errorMessage = getErrorMessage(response.data);
+            this.logger.error(`MinerU self-hosted parse failed with 400: ${errorMessage}`, JSON.stringify(response.data));
+            throw new BadRequestException(`MinerU self-hosted parse failed: ${response.status} ${errorMessage}`);
         }
         if (response.status !== 200) {
-            console.error(response.data);
-            throw new Error(`MinerU self-hosted parse failed: ${response.status} ${response.statusText}`);
+            const errorMessage = getErrorMessage(response.data) || response.statusText;
+            this.logger.error(`MinerU self-hosted parse failed with ${response.status}: ${errorMessage}`, JSON.stringify(response.data));
+            throw new Error(`MinerU self-hosted parse failed: ${response.status} ${response.statusText}. ${errorMessage}`);
         }
         return this.normalizeSelfHostedResponse(response.data);
     }
@@ -341,7 +344,9 @@ export class MinerUClient {
                 validateStatus: () => true,
             });
             if (response.status !== 200) {
-                throw new Error(`MinerU self-hosted legacy parse failed: ${response.status} ${response.statusText}`);
+                const errorMessage = getErrorMessage(response.data) || response.statusText;
+                this.logger.error(`MinerU self-hosted legacy parse failed with ${response.status}: ${errorMessage}`, JSON.stringify(response.data));
+                throw new Error(`MinerU self-hosted legacy parse failed: ${response.status} ${response.statusText}. ${errorMessage}`);
             }
             return this.normalizeSelfHostedResponse(response.data);
         }

package/dist/lib/result-parser.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"result-parser.service.d.ts","sourceRoot":"","sources":["../../src/lib/result-parser.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EACL,aAAa,EAEb,YAAY,EACb,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAEL,sBAAsB,EACtB,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAEpB,qBACa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;IAE/D,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,CAAC,kBAAkB,CAAC,EACrC,UAAU,EAAE,YAAY,GACvB,OAAO,CAAC;QACT,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,QAAQ,EAAE,sBAAsB,CAAC;KAClC,CAAC;IAqFI,cAAc,CAClB,MAAM,EAAE,0BAA0B,EAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,CAAC,kBAAkB,CAAC,EACrC,UAAU,EAAE,YAAY,GACvB,OAAO,CAAC;QACT,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,QAAQ,EAAE,sBAAsB,CAAC;KAClC,CAAC;CAoDH"}
+{"version":3,"file":"result-parser.service.d.ts","sourceRoot":"","sources":["../../src/lib/result-parser.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EACL,aAAa,EAEb,YAAY,EACb,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAEL,sBAAsB,EACtB,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAEpB,qBACa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;IAE/D,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,CAAC,kBAAkB,CAAC,EACrC,UAAU,EAAE,YAAY,GACvB,OAAO,CAAC;QACT,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,QAAQ,EAAE,sBAAsB,CAAC;KAClC,CAAC;IAqFI,cAAc,CAClB,MAAM,EAAE,0BAA0B,EAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,CAAC,kBAAkB,CAAC,EACrC,UAAU,EAAE,YAAY,GACvB,OAAO,CAAC;QACT,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,QAAQ,EAAE,sBAAsB,CAAC;KAClC,CAAC;CAkDH"}

package/dist/lib/result-parser.service.js

@@ -99,9 +99,7 @@ let MinerUResultParserService = MinerUResultParserService_1 = class MinerUResult
         };
         const assets = [];
         const pathMap = new Map();
-        // Ensure images is an array before iterating
-        const images = Array.isArray(result.images) ? result.images : [];
-        for (const image of images) {
+        for (const image of result.images) {
             const filePath = join(document.folder || '', 'images', image.name);
             const url = await fileSystem.writeFile(filePath, Buffer.from(image.dataUrl.split(',')[1], 'base64'));
             pathMap.set(`images/${image.name}`, url);

package/dist/lib/transformer-mineru.strategy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transformer-mineru.strategy.d.ts","sourceRoot":"","sources":["../../src/lib/transformer-mineru.strategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAG/D,OAAO,EACL,aAAa,EAEb,oBAAoB,EACpB,4BAA4B,EAC5B,qBAAqB,EACtB,MAAM,sBAAsB,CAAA;AAI7B,OAAO,EAAgB,wBAAwB,EAAE,MAAM,YAAY,CAAA;AAEnE,qBAEa,yBAA0B,YAAW,4BAA4B,CAAC,wBAAwB,CAAC;IAEtG,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2B;IAGxD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAE7C,QAAQ,CAAC,WAAW,mDAWnB;IAED,QAAQ,CAAC,IAAI;;;;;;;;;;;kBAWM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAwE1B;IAED,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC,kBAAkB,CACtB,SAAS,EAAE,OAAO,CAAC,kBAAkB,CAAC,EAAE,EACxC,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;CAsDzD"}
+{"version":3,"file":"transformer-mineru.strategy.d.ts","sourceRoot":"","sources":["../../src/lib/transformer-mineru.strategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAG/D,OAAO,EACL,aAAa,EAEb,oBAAoB,EACpB,4BAA4B,EAC5B,qBAAqB,EACtB,MAAM,sBAAsB,CAAA;AAI7B,OAAO,EAAgB,wBAAwB,EAAE,MAAM,YAAY,CAAA;AAEnE,qBAEa,yBAA0B,YAAW,4BAA4B,CAAC,wBAAwB,CAAC;IAEtG,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2B;IAGxD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAE7C,QAAQ,CAAC,WAAW,mDAWnB;IAED,QAAQ,CAAC,IAAI;;;;;;;;;;;kBAWM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAwE1B;IAED,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC,kBAAkB,CACtB,SAAS,EAAE,OAAO,CAAC,kBAAkB,CAAC,EAAE,EACxC,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;CA8DzD"}

package/dist/lib/transformer-mineru.strategy.js

@@ -125,8 +125,12 @@ let MinerUTransformerStrategy = class MinerUTransformerStrategy {
                 });
                 const result = mineru.getSelfHostedTask(taskId);
                 const parsedResult = await this.resultParser.parseLocalTask(result, taskId, document, config.permissions.fileSystem);
-                parsedResult.id = document.id;
-                parsedResults.push(parsedResult);
+                // Convert parsedResult to IKnowledgeDocument format
+                parsedResults.push({
+                    id: document.id,
+                    chunks: parsedResult.chunks,
+                    metadata: parsedResult.metadata
+                });
             }
             else {
                 const { taskId } = await mineru.createTask({
@@ -141,8 +145,12 @@ let MinerUTransformerStrategy = class MinerUTransformerStrategy {
                 // Waiting for completion
                 const result = await mineru.waitForTask(taskId, 5 * 60 * 1000, 5000);
                 const parsedResult = await this.resultParser.parseFromUrl(result.full_zip_url, taskId, document, config.permissions.fileSystem);
-                parsedResult.id = document.id;
-                parsedResults.push(parsedResult);
+                // Convert parsedResult to IKnowledgeDocument format
+                parsedResults.push({
+                    id: document.id,
+                    chunks: parsedResult.chunks,
+                    metadata: parsedResult.metadata
+                });
             }
         }
         return parsedResults;

package/dist/lib/types.js

@@ -2,26 +2,26 @@ export const MinerU = 'mineru';
 export const ENV_MINERU_API_BASE_URL = 'MINERU_API_BASE_URL';
 export const ENV_MINERU_API_TOKEN = 'MINERU_API_TOKEN';
 export const ENV_MINERU_SERVER_TYPE = 'MINERU_SERVER_TYPE';
-export const icon = `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
-<path d="M19.7238 3.86898C19.7238 4.57597 19.1502 5.1491 18.4427 5.1491C17.7352 5.1491 17.1616 4.57597 17.1616 3.86898C17.1616 3.16199 17.7352 2.58887 18.4427 2.58887C19.1502 2.58887 19.7238 3.16199 19.7238 3.86898Z" fill="url(#paint0_linear_8609_1645)"/>
-<path d="M19.7238 3.86898C19.7238 4.57597 19.1502 5.1491 18.4427 5.1491C17.7352 5.1491 17.1616 4.57597 17.1616 3.86898C17.1616 3.16199 17.7352 2.58887 18.4427 2.58887C19.1502 2.58887 19.7238 3.16199 19.7238 3.86898Z" fill="#010101"/>
-<path d="M15.3681 5.1491C15.3681 5.85609 14.7945 6.42921 14.087 6.42921C13.3794 6.42921 12.8059 5.85609 12.8059 5.1491C12.8059 4.44211 13.3794 3.86898 14.087 3.86898C14.7945 3.86898 15.3681 4.44211 15.3681 5.1491Z" fill="url(#paint1_linear_8609_1645)"/>
-<path d="M15.3681 5.1491C15.3681 5.85609 14.7945 6.42921 14.087 6.42921C13.3794 6.42921 12.8059 5.85609 12.8059 5.1491C12.8059 4.44211 13.3794 3.86898 14.087 3.86898C14.7945 3.86898 15.3681 4.44211 15.3681 5.1491Z" fill="#010101"/>
-<path fill-rule="evenodd" clip-rule="evenodd" d="M8.05175 11.2368C8.05175 13.4605 9.14375 15.4293 10.8211 16.6371C11.8241 15.7389 12.4551 14.4345 12.4551 12.9828V9.39673C12.4551 8.85661 12.8197 8.38448 13.3426 8.24757L19.8924 6.53265C20.6459 6.33534 21.3826 6.90341 21.3826 7.6818L21.3826 12.0452C21.3826 17.2179 17.1861 21.4111 12.0095 21.4111L11.9942 21.4111C6.81758 21.4111 2.62109 17.2179 2.62109 12.0452V9.03388C2.62109 8.49175 2.9884 8.01839 3.51385 7.88336L6.56677 7.09882C7.31904 6.9055 8.05175 7.47318 8.05175 8.24934V11.2368ZM3.9798 12.0452C3.9798 13.8476 4.57565 15.5108 5.58124 16.849C6.04996 17.4728 6.7655 17.8884 7.54573 17.8884V17.8884C8.28848 17.8884 8.9927 17.7236 9.62376 17.4286C7.83439 15.9596 6.69304 13.7314 6.69304 11.2368V8.46821L3.9798 9.16546V12.0452Z" fill="url(#paint2_linear_8609_1645)"/>
-<path fill-rule="evenodd" clip-rule="evenodd" d="M8.05175 11.2368C8.05175 13.4605 9.14375 15.4293 10.8211 16.6371C11.8241 15.7389 12.4551 14.4345 12.4551 12.9828V9.39673C12.4551 8.85661 12.8197 8.38448 13.3426 8.24757L19.8924 6.53265C20.6459 6.33534 21.3826 6.90341 21.3826 7.6818L21.3826 12.0452C21.3826 17.2179 17.1861 21.4111 12.0095 21.4111L11.9942 21.4111C6.81758 21.4111 2.62109 17.2179 2.62109 12.0452V9.03388C2.62109 8.49175 2.9884 8.01839 3.51385 7.88336L6.56677 7.09882C7.31904 6.9055 8.05175 7.47318 8.05175 8.24934V11.2368ZM3.9798 12.0452C3.9798 13.8476 4.57565 15.5108 5.58124 16.849C6.04996 17.4728 6.7655 17.8884 7.54573 17.8884V17.8884C8.28848 17.8884 8.9927 17.7236 9.62376 17.4286C7.83439 15.9596 6.69304 13.7314 6.69304 11.2368V8.46821L3.9798 9.16546V12.0452Z" fill="#010101"/>
-<defs>
-<linearGradient id="paint0_linear_8609_1645" x1="14.3898" y1="8.36821" x2="13.1876" y2="19.4461" gradientUnits="userSpaceOnUse">
-<stop stop-color="white"/>
-<stop offset="1" stop-color="#2E2E2E"/>
-</linearGradient>
-<linearGradient id="paint1_linear_8609_1645" x1="14.3898" y1="8.36821" x2="13.1876" y2="19.4461" gradientUnits="userSpaceOnUse">
-<stop stop-color="white"/>
-<stop offset="1" stop-color="#2E2E2E"/>
-</linearGradient>
-<linearGradient id="paint2_linear_8609_1645" x1="14.3898" y1="8.36821" x2="13.1876" y2="19.4461" gradientUnits="userSpaceOnUse">
-<stop stop-color="white"/>
-<stop offset="1" stop-color="#2E2E2E"/>
-</linearGradient>
-</defs>
-</svg>
+export const icon = `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M19.7238 3.86898C19.7238 4.57597 19.1502 5.1491 18.4427 5.1491C17.7352 5.1491 17.1616 4.57597 17.1616 3.86898C17.1616 3.16199 17.7352 2.58887 18.4427 2.58887C19.1502 2.58887 19.7238 3.16199 19.7238 3.86898Z" fill="url(#paint0_linear_8609_1645)"/>
+<path d="M19.7238 3.86898C19.7238 4.57597 19.1502 5.1491 18.4427 5.1491C17.7352 5.1491 17.1616 4.57597 17.1616 3.86898C17.1616 3.16199 17.7352 2.58887 18.4427 2.58887C19.1502 2.58887 19.7238 3.16199 19.7238 3.86898Z" fill="#010101"/>
+<path d="M15.3681 5.1491C15.3681 5.85609 14.7945 6.42921 14.087 6.42921C13.3794 6.42921 12.8059 5.85609 12.8059 5.1491C12.8059 4.44211 13.3794 3.86898 14.087 3.86898C14.7945 3.86898 15.3681 4.44211 15.3681 5.1491Z" fill="url(#paint1_linear_8609_1645)"/>
+<path d="M15.3681 5.1491C15.3681 5.85609 14.7945 6.42921 14.087 6.42921C13.3794 6.42921 12.8059 5.85609 12.8059 5.1491C12.8059 4.44211 13.3794 3.86898 14.087 3.86898C14.7945 3.86898 15.3681 4.44211 15.3681 5.1491Z" fill="#010101"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M8.05175 11.2368C8.05175 13.4605 9.14375 15.4293 10.8211 16.6371C11.8241 15.7389 12.4551 14.4345 12.4551 12.9828V9.39673C12.4551 8.85661 12.8197 8.38448 13.3426 8.24757L19.8924 6.53265C20.6459 6.33534 21.3826 6.90341 21.3826 7.6818L21.3826 12.0452C21.3826 17.2179 17.1861 21.4111 12.0095 21.4111L11.9942 21.4111C6.81758 21.4111 2.62109 17.2179 2.62109 12.0452V9.03388C2.62109 8.49175 2.9884 8.01839 3.51385 7.88336L6.56677 7.09882C7.31904 6.9055 8.05175 7.47318 8.05175 8.24934V11.2368ZM3.9798 12.0452C3.9798 13.8476 4.57565 15.5108 5.58124 16.849C6.04996 17.4728 6.7655 17.8884 7.54573 17.8884V17.8884C8.28848 17.8884 8.9927 17.7236 9.62376 17.4286C7.83439 15.9596 6.69304 13.7314 6.69304 11.2368V8.46821L3.9798 9.16546V12.0452Z" fill="url(#paint2_linear_8609_1645)"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M8.05175 11.2368C8.05175 13.4605 9.14375 15.4293 10.8211 16.6371C11.8241 15.7389 12.4551 14.4345 12.4551 12.9828V9.39673C12.4551 8.85661 12.8197 8.38448 13.3426 8.24757L19.8924 6.53265C20.6459 6.33534 21.3826 6.90341 21.3826 7.6818L21.3826 12.0452C21.3826 17.2179 17.1861 21.4111 12.0095 21.4111L11.9942 21.4111C6.81758 21.4111 2.62109 17.2179 2.62109 12.0452V9.03388C2.62109 8.49175 2.9884 8.01839 3.51385 7.88336L6.56677 7.09882C7.31904 6.9055 8.05175 7.47318 8.05175 8.24934V11.2368ZM3.9798 12.0452C3.9798 13.8476 4.57565 15.5108 5.58124 16.849C6.04996 17.4728 6.7655 17.8884 7.54573 17.8884V17.8884C8.28848 17.8884 8.9927 17.7236 9.62376 17.4286C7.83439 15.9596 6.69304 13.7314 6.69304 11.2368V8.46821L3.9798 9.16546V12.0452Z" fill="#010101"/>
+<defs>
+<linearGradient id="paint0_linear_8609_1645" x1="14.3898" y1="8.36821" x2="13.1876" y2="19.4461" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="#2E2E2E"/>
+</linearGradient>
+<linearGradient id="paint1_linear_8609_1645" x1="14.3898" y1="8.36821" x2="13.1876" y2="19.4461" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="#2E2E2E"/>
+</linearGradient>
+<linearGradient id="paint2_linear_8609_1645" x1="14.3898" y1="8.36821" x2="13.1876" y2="19.4461" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="#2E2E2E"/>
+</linearGradient>
+</defs>
+</svg>
 `;

package/package.json

@@ -1,52 +1,49 @@
-{
-  "name": "@chenchaolong/plugin-mineru",
-  "version": "0.0.12",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/xpert-ai/xpert-plugins.git"
-  },
-  "bugs": {
-    "url": "https://github.com/xpert-ai/xpert-plugins/issues"
-  },
-  "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    "./package.json": "./package.json",
-    ".": {
-      "@xpert-plugins-starter/source": "./src/index.ts",
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "!**/*.tsbuildinfo"
-  ],
-  "dependencies": {
-    "form-data": "^4.0.0",
-    "tslib": "^2.3.0",
-    "unzipper": "0.12.3"
-  },
-  "peerDependencies": {
-    "@nestjs/config": "^4.0.2",
-    "zod": "3.25.67",
-    "@xpert-ai/plugin-sdk": "^3.6.2",
-    "@metad/contracts": "^3.6.2",
-    "@nestjs/common": "^11.1.6",
-    "axios": "1.12.2",
-    "nestjs-i18n": "10.5.1",
-    "chalk": "4.1.2",
-    "@langchain/core": "^0.3.72",
-    "lodash-es": "4.17.21",
-    "uuid": "8.3.2"
-  },
-  "devDependencies": {
-    "@types/unzipper": "^0.10.11"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "@chenchaolong/plugin-mineru",
+  "version": "1.1.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/xpert-ai/xpert-plugins.git"
+  },
+  "bugs": {
+    "url": "https://github.com/xpert-ai/xpert-plugins/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@xpert-plugins-starter/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "dependencies": {
+    "form-data": "^4.0.0",
+    "tslib": "^2.3.0",
+    "unzipper": "0.12.3"
+  },
+  "peerDependencies": {
+    "@nestjs/config": "^4.0.2",
+    "zod": "3.25.67",
+    "@xpert-ai/plugin-sdk": "^3.6.2",
+    "@metad/contracts": "^3.6.2",
+    "@nestjs/common": "^11.1.6",
+    "axios": "1.12.2",
+    "nestjs-i18n": "10.5.1",
+    "chalk": "4.1.2",
+    "@langchain/core": "^0.3.72",
+    "lodash-es": "4.17.21",
+    "uuid": "8.3.2"
+  },
+  "devDependencies": {
+    "@types/unzipper": "^0.10.11"
+  }
+}

package/dist/lib/mineru-toolset.d.ts

@@ -1,10 +0,0 @@
-import { StructuredToolInterface, ToolSchemaBase } from '@langchain/core/tools';
-import { BuiltinToolset } from '@xpert-ai/plugin-sdk';
-import { ConfigService } from '@nestjs/config';
-import { MinerUResultParserService } from './result-parser.service.js';
-export declare function setMinerUToolsetServices(configService: ConfigService, resultParser: MinerUResultParserService): void;
-export declare class MinerUToolset extends BuiltinToolset<StructuredToolInterface, Record<string, never>> {
-    _validateCredentials(credentials: Record<string, never>): Promise<void>;
-    initTools(): Promise<StructuredToolInterface<ToolSchemaBase, any, any>[]>;
-}
-//# sourceMappingURL=mineru-toolset.d.ts.map

package/dist/lib/mineru-toolset.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mineru-toolset.d.ts","sourceRoot":"","sources":["../../src/lib/mineru-toolset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAOvE,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,yBAAyB,QAIxC;AAED,qBAAa,aAAc,SAAQ,cAAc,CAAC,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAChF,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE,SAAS,IAAI,OAAO,CAAC,uBAAuB,CAAC,cAAc,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;CASzF"}

package/dist/lib/mineru-toolset.js

@@ -1,23 +0,0 @@
-import { BuiltinToolset } from '@xpert-ai/plugin-sdk';
-import { buildPdfToMarkdownTool } from './pdf-to-markdown.tool.js';
-// Store services globally for tool access
-let globalConfigService;
-let globalResultParser;
-export function setMinerUToolsetServices(configService, resultParser) {
-    globalConfigService = configService;
-    globalResultParser = resultParser;
-}
-export class MinerUToolset extends BuiltinToolset {
-    async _validateCredentials(credentials) {
-        // No credentials needed for mineru toolset (uses integration permissions)
-    }
-    async initTools() {
-        if (!globalConfigService || !globalResultParser) {
-            throw new Error('MinerU services not initialized. Call setMinerUToolsetServices first.');
-        }
-        this.tools = [
-            buildPdfToMarkdownTool(globalConfigService, globalResultParser),
-        ];
-        return this.tools;
-    }
-}

package/dist/lib/mineru-toolset.strategy.d.ts

@@ -1,34 +0,0 @@
-import { ConfigService } from '@nestjs/config';
-import { BuiltinToolset, IToolsetStrategy } from '@xpert-ai/plugin-sdk';
-import { MinerUResultParserService } from './result-parser.service.js';
-export declare class MinerUToolsetStrategy implements IToolsetStrategy<any> {
-    private readonly configService;
-    private readonly resultParser;
-    constructor(configService: ConfigService, resultParser: MinerUResultParserService);
-    meta: {
-        author: string;
-        tags: string[];
-        name: string;
-        label: {
-            en_US: string;
-            zh_Hans: string;
-        };
-        description: {
-            en_US: string;
-            zh_Hans: string;
-        };
-        icon: {
-            svg: string;
-            color: string;
-        };
-        configSchema: {
-            type: string;
-            properties: {};
-            required: any[];
-        };
-    };
-    validateConfig(config: any): Promise<void>;
-    create(config: any): Promise<BuiltinToolset>;
-    createTools(): any[];
-}
-//# sourceMappingURL=mineru-toolset.strategy.d.ts.map

package/dist/lib/mineru-toolset.strategy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mineru-toolset.strategy.d.ts","sourceRoot":"","sources":["../../src/lib/mineru-toolset.strategy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAmB,MAAM,sBAAsB,CAAC;AAGzF,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAEvE,qBAEa,qBAAsB,YAAW,gBAAgB,CAAC,GAAG,CAAC;IAG/D,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAFZ,aAAa,EAAE,aAAa,EAE5B,YAAY,EAAE,yBAAyB;IAM1D,IAAI;;;;;;;;;;;;;;;;;;;;;MAqBF;IAEF,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpC,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC;IAIlD,WAAW;CAKZ"}

package/dist/lib/mineru-toolset.strategy.js

@@ -1,58 +0,0 @@
-import { __decorate, __metadata, __param } from "tslib";
-import { Injectable, forwardRef, Inject } from '@nestjs/common';
-import { ConfigService } from '@nestjs/config';
-import { ToolsetStrategy } from '@xpert-ai/plugin-sdk';
-import { MinerU, icon } from './types.js';
-import { MinerUToolset, setMinerUToolsetServices } from './mineru-toolset.js';
-import { MinerUResultParserService } from './result-parser.service.js';
-let MinerUToolsetStrategy = class MinerUToolsetStrategy {
-    constructor(configService, resultParser) {
-        this.configService = configService;
-        this.resultParser = resultParser;
-        this.meta = {
-            author: 'Xpert AI',
-            tags: ['mineru', 'pdf', 'markdown', 'conversion', 'tool'],
-            name: MinerU,
-            label: {
-                en_US: 'MinerU',
-                zh_Hans: 'MinerU',
-            },
-            description: {
-                en_US: 'Convert PDF files to Markdown and JSON format using MinerU. Supports OCR, formula recognition, and table extraction.',
-                zh_Hans: '使用MinerU将PDF文件转换为Markdown和JSON格式。支持OCR、公式识别和表格提取。',
-            },
-            icon: {
-                svg: icon,
-                color: '#14b8a6',
-            },
-            configSchema: {
-                type: 'object',
-                properties: {},
-                required: [],
-            },
-        };
-        // Initialize global services for tool access
-        setMinerUToolsetServices(this.configService, this.resultParser);
-    }
-    validateConfig(config) {
-        // No validation needed - uses integration permissions
-        return Promise.resolve();
-    }
-    async create(config) {
-        return new MinerUToolset(config || {});
-    }
-    createTools() {
-        // Tools are created dynamically in MinerUToolset.initTools()
-        // This method is not used when using BuiltinToolset
-        return [];
-    }
-};
-MinerUToolsetStrategy = __decorate([
-    Injectable(),
-    ToolsetStrategy(MinerU),
-    __param(0, Inject(forwardRef(() => ConfigService))),
-    __param(1, Inject(MinerUResultParserService)),
-    __metadata("design:paramtypes", [ConfigService,
-        MinerUResultParserService])
-], MinerUToolsetStrategy);
-export { MinerUToolsetStrategy };

package/dist/lib/pdf-to-markdown.tool.d.ts

@@ -1,90 +0,0 @@
-import { z } from 'zod';
-import { ConfigService } from '@nestjs/config';
-import { MinerUResultParserService } from './result-parser.service.js';
-export declare function buildPdfToMarkdownTool(configService: ConfigService, resultParser: MinerUResultParserService): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
-    file: z.ZodObject<{
-        name: z.ZodOptional<z.ZodString>;
-        filename: z.ZodOptional<z.ZodString>;
-        content: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodType<Buffer<ArrayBufferLike>, z.ZodTypeDef, Buffer<ArrayBufferLike>>, z.ZodType<Uint8Array<ArrayBuffer>, z.ZodTypeDef, Uint8Array<ArrayBuffer>>]>>;
-        filePath: z.ZodOptional<z.ZodString>;
-        fileUrl: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        name?: string;
-        filePath?: string;
-        fileUrl?: string;
-        filename?: string;
-        content?: string | Uint8Array<ArrayBuffer> | Buffer<ArrayBufferLike>;
-    }, {
-        name?: string;
-        filePath?: string;
-        fileUrl?: string;
-        filename?: string;
-        content?: string | Uint8Array<ArrayBuffer> | Buffer<ArrayBufferLike>;
-    }>;
-    isOcr: z.ZodOptional<z.ZodBoolean>;
-    enableFormula: z.ZodOptional<z.ZodBoolean>;
-    enableTable: z.ZodOptional<z.ZodBoolean>;
-    language: z.ZodOptional<z.ZodEnum<["en", "ch"]>>;
-    modelVersion: z.ZodOptional<z.ZodEnum<["pipeline", "vlm"]>>;
-}, "strip", z.ZodTypeAny, {
-    isOcr?: boolean;
-    enableFormula?: boolean;
-    enableTable?: boolean;
-    language?: "ch" | "en";
-    modelVersion?: "pipeline" | "vlm";
-    file?: {
-        name?: string;
-        filePath?: string;
-        fileUrl?: string;
-        filename?: string;
-        content?: string | Uint8Array<ArrayBuffer> | Buffer<ArrayBufferLike>;
-    };
-}, {
-    isOcr?: boolean;
-    enableFormula?: boolean;
-    enableTable?: boolean;
-    language?: "ch" | "en";
-    modelVersion?: "pipeline" | "vlm";
-    file?: {
-        name?: string;
-        filePath?: string;
-        fileUrl?: string;
-        filename?: string;
-        content?: string | Uint8Array<ArrayBuffer> | Buffer<ArrayBufferLike>;
-    };
-}>, {
-    isOcr?: boolean;
-    enableFormula?: boolean;
-    enableTable?: boolean;
-    language?: "ch" | "en";
-    modelVersion?: "pipeline" | "vlm";
-    file?: {
-        name?: string;
-        filePath?: string;
-        fileUrl?: string;
-        filename?: string;
-        content?: string | Uint8Array<ArrayBuffer> | Buffer<ArrayBufferLike>;
-    };
-}, {
-    isOcr?: boolean;
-    enableFormula?: boolean;
-    enableTable?: boolean;
-    language?: "ch" | "en";
-    modelVersion?: "pipeline" | "vlm";
-    file?: {
-        name?: string;
-        filePath?: string;
-        fileUrl?: string;
-        filename?: string;
-        content?: string | Uint8Array<ArrayBuffer> | Buffer<ArrayBufferLike>;
-    };
-}, (string | {
-    files: {
-        mimeType: string;
-        fileName: string;
-        filePath: string;
-        fileUrl: string;
-        extension: string;
-    }[];
-})[]>;
-//# sourceMappingURL=pdf-to-markdown.tool.d.ts.map

package/dist/lib/pdf-to-markdown.tool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pdf-to-markdown.tool.d.ts","sourceRoot":"","sources":["../../src/lib/pdf-to-markdown.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAIvE,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAqKxC"}

package/dist/lib/pdf-to-markdown.tool.js

@@ -1,146 +0,0 @@
-import { tool } from '@langchain/core/tools';
-import { getCurrentTaskInput } from '@langchain/langgraph';
-import { getErrorMessage } from '@xpert-ai/plugin-sdk';
-import { z } from 'zod';
-import { MinerUClient } from './mineru.client.js';
-export function buildPdfToMarkdownTool(configService, resultParser) {
-    return tool(async (input) => {
-        try {
-            const { file, isOcr, enableFormula, enableTable, language, modelVersion } = input;
-            if (!file) {
-                throw new Error('No file provided');
-            }
-            const currentState = getCurrentTaskInput();
-            const workspacePath = currentState?.[`sys`]?.['volume'] ?? '/tmp/xpert';
-            const baseUrl = currentState?.[`sys`]?.['workspace_url'] ?? 'http://localhost:3000';
-            // Get permissions from current state
-            const permissions = currentState?.[`sys`]?.['permissions'];
-            if (!permissions?.fileSystem) {
-                throw new Error('File system permission is required for MinerU tool');
-            }
-            // Get file content
-            let fileContent;
-            let fileName;
-            let filePath;
-            let fileUrl;
-            if (file.content) {
-                if (typeof file.content === 'string') {
-                    // Base64 string
-                    fileContent = Buffer.from(file.content, 'base64');
-                }
-                else if (Buffer.isBuffer(file.content)) {
-                    fileContent = file.content;
-                }
-                else if (file.content instanceof Uint8Array) {
-                    fileContent = Buffer.from(file.content);
-                }
-                else {
-                    throw new Error('Invalid file content format');
-                }
-                fileName = file.name || file.filename || 'document.pdf';
-            }
-            else if (file.filePath) {
-                filePath = file.filePath;
-                fileContent = await permissions.fileSystem.readFile(filePath);
-                fileName = file.name || file.filename || filePath.split('/').pop() || 'document.pdf';
-            }
-            else if (file.fileUrl) {
-                fileUrl = file.fileUrl;
-                const response = await fetch(fileUrl);
-                if (!response.ok) {
-                    throw new Error(`Failed to download file from URL: ${response.statusText}`);
-                }
-                const arrayBuffer = await response.arrayBuffer();
-                fileContent = Buffer.from(arrayBuffer);
-                fileName = file.name || file.filename || fileUrl.split('/').pop() || 'document.pdf';
-            }
-            else {
-                throw new Error('File must provide content, filePath, or fileUrl');
-            }
-            // Save file to workspace if not already there
-            if (!filePath) {
-                const relativePath = `mineru-input/${fileName}`;
-                filePath = relativePath;
-                fileUrl = await permissions.fileSystem.writeFile(relativePath, fileContent);
-            }
-            // Create MinerU client
-            const mineruClient = new MinerUClient(configService, {
-                fileSystem: permissions.fileSystem,
-                integration: permissions.integration,
-            });
-            // Create task
-            const { taskId } = await mineruClient.createTask({
-                url: fileUrl || file.fileUrl,
-                filePath: filePath,
-                fileName: fileName,
-                isOcr: isOcr ?? true,
-                enableFormula: enableFormula ?? true,
-                enableTable: enableTable ?? true,
-                language: language || 'ch',
-                modelVersion: modelVersion || 'pipeline',
-            });
-            // Get result
-            let result;
-            if (mineruClient.serverType === 'self-hosted') {
-                result = mineruClient.getSelfHostedTask(taskId);
-                if (!result) {
-                    throw new Error('Failed to get MinerU task result');
-                }
-            }
-            else {
-                result = await mineruClient.waitForTask(taskId, 5 * 60 * 1000, 5000);
-            }
-            // Parse result
-            const parsedResult = mineruClient.serverType === 'self-hosted'
-                ? await resultParser.parseLocalTask(result, taskId, { folder: 'mineru-output', name: fileName }, permissions.fileSystem)
-                : await resultParser.parseFromUrl(result.full_zip_url, taskId, { folder: 'mineru-output', name: fileName }, permissions.fileSystem);
-            // Get markdown content
-            const markdownContent = parsedResult.chunks[0]?.pageContent || '';
-            const outputFileName = fileName.replace(/\.pdf$/i, '.md');
-            const outputPath = `mineru-output/${outputFileName}`;
-            const outputUrl = await permissions.fileSystem.writeFile(outputPath, Buffer.from(markdownContent, 'utf-8'));
-            return [
-                `Successfully converted PDF to Markdown: ${outputFileName}`,
-                {
-                    files: [
-                        {
-                            mimeType: 'text/markdown',
-                            fileName: outputPath,
-                            filePath: permissions.fileSystem.fullPath(outputPath),
-                            fileUrl: outputUrl,
-                            extension: 'md',
-                        },
-                        ...(parsedResult.metadata.assets || []).map((asset) => ({
-                            mimeType: asset.type === 'image' ? 'image/png' : 'application/json',
-                            fileName: asset.filePath,
-                            filePath: permissions.fileSystem.fullPath(asset.filePath),
-                            fileUrl: asset.url,
-                            extension: asset.type === 'image' ? 'png' : 'json',
-                        })),
-                    ],
-                },
-            ];
-        }
-        catch (error) {
-            throw new Error(`Error converting PDF to Markdown: ${getErrorMessage(error)}`);
-        }
-    }, {
-        name: 'pdf_to_markdown',
-        description: `Convert PDF file to Markdown format using MinerU. Supports OCR, formula recognition, and table extraction.`,
-        schema: z.object({
-            file: z.object({
-                name: z.string().optional(),
-                filename: z.string().optional(),
-                content: z.union([z.string(), z.instanceof(Buffer), z.instanceof(Uint8Array)]).optional(),
-                filePath: z.string().optional(),
-                fileUrl: z.string().optional(),
-            }),
-            isOcr: z.boolean().optional().describe('Enable OCR for image-based PDFs'),
-            enableFormula: z.boolean().optional().describe('Enable recognition of mathematical formulas'),
-            enableTable: z.boolean().optional().describe('Enable recognition of tables'),
-            language: z.enum(['en', 'ch']).optional().describe('Document language (en for English, ch for Chinese)'),
-            modelVersion: z.enum(['pipeline', 'vlm']).optional().describe('MinerU model version'),
-        }),
-        responseFormat: 'content_and_artifact',
-    });
-}