@helloxiaohu/plugin-mineru 0.0.17 → 0.0.19

package/dist/lib/integration.strategy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"integration.strategy.d.ts","sourceRoot":"","sources":["../../src/lib/integration.strategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAO3E,OAAO,EACL,mBAAmB,EAGnB,0BAA0B,EAC3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAgB,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEpE,qBAEa,yBACX,YAAW,mBAAmB,CAAC,wBAAwB,CAAC;IAExD,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAsEjC;IAGF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAExC,OAAO,CACX,WAAW,EAAE,YAAY,CAAC,wBAAwB,CAAC,EACnD,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,GAAG,CAAC;IAIT,cAAc,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;CA2BtE"}
+{"version":3,"file":"integration.strategy.d.ts","sourceRoot":"","sources":["../../src/lib/integration.strategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAO3E,OAAO,EACL,mBAAmB,EAGnB,0BAA0B,EAC3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAA2B,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE/E,qBAEa,yBACX,YAAW,mBAAmB,CAAC,wBAAwB,CAAC;IAExD,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAsEjC;IAGF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAExC,OAAO,CACX,WAAW,EAAE,YAAY,CAAC,wBAAwB,CAAC,EACnD,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,GAAG,CAAC;IAIT,cAAc,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;CA2BtE"}

package/dist/lib/integration.strategy.js

@@ -3,11 +3,11 @@ import { forwardRef, Inject, Injectable, } from '@nestjs/common';
 import { ConfigService } from '@nestjs/config';
 import { IntegrationStrategyKey, } from '@xpert-ai/plugin-sdk';
 import { MinerUClient } from './mineru.client.js';
-import { icon, MinerU } from './types.js';
+import { icon, MinerUIntegration } from './types.js';
 let MinerUIntegrationStrategy = class MinerUIntegrationStrategy {
     constructor() {
         this.meta = {
-            name: MinerU,
+            name: MinerUIntegration,
             label: {
                 en_US: 'MinerU',
             },
@@ -80,7 +80,7 @@ let MinerUIntegrationStrategy = class MinerUIntegrationStrategy {
     async validateConfig(config) {
         const mineruClient = new MinerUClient(this.configService, {
             integration: {
-                provider: MinerU,
+                provider: MinerUIntegration,
                 options: config,
             },
         });
@@ -113,6 +113,6 @@ __decorate([
 ], MinerUIntegrationStrategy.prototype, "configService", void 0);
 MinerUIntegrationStrategy = __decorate([
     Injectable(),
-    IntegrationStrategyKey(MinerU)
+    IntegrationStrategyKey(MinerUIntegration)
 ], MinerUIntegrationStrategy);
 export { MinerUIntegrationStrategy };

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

@@ -1,5 +1,5 @@
 import { ConfigService } from '@nestjs/config';
-import { BuiltinToolset, IToolsetStrategy, IntegrationPermission, FileSystemPermission } from '@xpert-ai/plugin-sdk';
+import { BuiltinToolset, IToolsetStrategy, FileSystemPermission, ISchemaSecretField } from '@xpert-ai/plugin-sdk';
 import { MinerUResultParserService } from './result-parser.service.js';
 import { MinerUToolsetConfig } from './mineru.toolset.js';
 /**
@@ -31,6 +31,52 @@ export declare class MinerUToolsetStrategy implements IToolsetStrategy<MinerUToo
         configSchema: {
             type: string;
             properties: {
+                /**
+                 * NOTE:
+                 * We intentionally keep MinerU as a "self-contained" toolset that stores its own API credentials,
+                 * instead of relying on the platform IntegrationPermission flow.
+                 *
+                 * Reason: during the built-in toolset authorization step, the platform may send `credentials = null`,
+                 * and backend may access `credentials.integration`, causing a 500 (`Cannot read properties of null (reading 'integration')`).
+                 * Defining API fields directly ensures the authorization UI renders fields and always submits an object.
+                 */
+                apiUrl: {
+                    type: string;
+                    title: {
+                        en_US: string;
+                        zh_Hans: string;
+                    };
+                    description: {
+                        en_US: string;
+                        zh_Hans: string;
+                    };
+                    default: string;
+                };
+                apiKey: {
+                    type: string;
+                    title: {
+                        en_US: string;
+                        zh_Hans: string;
+                    };
+                    description: {
+                        en_US: string;
+                        zh_Hans: string;
+                    };
+                    'x-ui': ISchemaSecretField;
+                };
+                serverType: {
+                    type: string;
+                    title: {
+                        en_US: string;
+                        zh_Hans: string;
+                    };
+                    description: {
+                        en_US: string;
+                        zh_Hans: string;
+                    };
+                    enum: string[];
+                    default: string;
+                };
                 isOcr: {
                     type: string;
                     title: {
@@ -94,19 +140,16 @@ export declare class MinerUToolsetStrategy implements IToolsetStrategy<MinerUToo
                     default: string;
                 };
             };
-            required: any[];
+            required: string[];
         };
     };
     /**
      * Permissions required by MinerU toolset
      */
-    readonly permissions: (IntegrationPermission | FileSystemPermission)[];
+    readonly permissions: FileSystemPermission[];
     constructor(configService: ConfigService, resultParser: MinerUResultParserService);
     /**
      * Validate toolset configuration
-     * Note: During authorization phase, config may be null/undefined or missing integration.
-     * Integration is injected by the permission system, so we don't validate it here.
-     * We only validate the optional parsing settings if provided.
      */
     validateConfig(config: MinerUToolsetConfig | null | undefined): Promise<void>;
     /**
@@ -117,7 +160,7 @@ export declare class MinerUToolsetStrategy implements IToolsetStrategy<MinerUToo
     /**
      * Create tools for MinerU toolset
      * Tools are created dynamically in MinerUToolset.initTools()
-     * based on the integration configuration
+     * based on the toolset credentials/configuration
      */
     createTools(): any[];
 }

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

@@ -1 +1 @@
-{"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,EACL,cAAc,EACd,gBAAgB,EAEhB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAiB,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAGzE;;;GAGG;AACH,qBAEa,qBAAsB,YAAW,gBAAgB,CAAC,mBAAmB,CAAC;IA+G/E,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAhH/B;;OAEG;IACH,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAuFF;IAEF;;OAEG;IACH,QAAQ,CAAC,WAAW,mDAWlB;gBAIiB,aAAa,EAAE,aAAa,EAE5B,YAAY,EAAE,yBAAyB;IAG1D;;;;;OAKG;IACH,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7E;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC;IAYrF;;;;OAIG;IACH,WAAW;CAKZ"}
+{"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,EACL,cAAc,EACd,gBAAgB,EAEhB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAiB,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAGzE;;;GAGG;AACH,qBAEa,qBAAsB,YAAW,gBAAgB,CAAC,mBAAmB,CAAC;IA8J/E,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,YAAY;IA/J/B;;OAEG;IACH,IAAI;;;;;;;;;;;;;;;;;;;gBAoBE;;;;;;;;mBAQG;;;;;;;;;;;;;;;;;;;;;;;4BAuBQ,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAwFjC;IAEF;;OAEG;IACH,QAAQ,CAAC,WAAW,yBAMlB;gBAIiB,aAAa,EAAE,aAAa,EAE5B,YAAY,EAAE,yBAAyB;IAG1D;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAY7E;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC;IAYrF;;;;OAIG;IACH,WAAW;CAKZ"}

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

@@ -35,7 +35,59 @@ let MinerUToolsetStrategy = class MinerUToolsetStrategy {
             configSchema: {
                 type: 'object',
                 properties: {
-                    // Note: integration is NOT defined here because it's injected by the permission system
+                    /**
+                     * NOTE:
+                     * We intentionally keep MinerU as a "self-contained" toolset that stores its own API credentials,
+                     * instead of relying on the platform IntegrationPermission flow.
+                     *
+                     * Reason: during the built-in toolset authorization step, the platform may send `credentials = null`,
+                     * and backend may access `credentials.integration`, causing a 500 (`Cannot read properties of null (reading 'integration')`).
+                     * Defining API fields directly ensures the authorization UI renders fields and always submits an object.
+                     */
+                    apiUrl: {
+                        type: 'string',
+                        title: {
+                            en_US: 'Base URL',
+                            zh_Hans: 'Base URL',
+                        },
+                        description: {
+                            en_US: 'MinerU API base url. Official: https://api.mineru.dev',
+                            zh_Hans: 'MinerU 服务地址。官方： https://api.mineru.dev',
+                        },
+                        default: 'https://api.mineru.dev',
+                    },
+                    apiKey: {
+                        type: 'string',
+                        title: {
+                            en_US: 'API Key',
+                            zh_Hans: 'API Key',
+                        },
+                        description: {
+                            en_US: 'The API Key of the MinerU server (required for official API)',
+                            zh_Hans: 'MinerU 服务令牌（官方 API 必填）',
+                        },
+                        'x-ui': {
+                            component: 'secretInput',
+                            label: 'API Key',
+                            placeholder: 'MinerU API Key',
+                            revealable: true,
+                            maskSymbol: '*',
+                            persist: true,
+                        },
+                    },
+                    serverType: {
+                        type: 'string',
+                        title: {
+                            en_US: 'Server Type',
+                            zh_Hans: '服务类型',
+                        },
+                        description: {
+                            en_US: 'Select MinerU service type: official API or self-hosted',
+                            zh_Hans: '选择 MinerU 服务类型：官方 API 或自部署',
+                        },
+                        enum: ['official', 'self-hosted'],
+                        default: 'official',
+                    },
                     // Default parsing settings (optional, can be overridden when calling the tool)
                     isOcr: {
                         type: 'boolean',
@@ -100,18 +152,13 @@ let MinerUToolsetStrategy = class MinerUToolsetStrategy {
                         default: 'pipeline',
                     },
                 },
-                required: [], // All settings are optional with defaults
+                required: ['serverType'], // apiKey required only for official, validated in validateConfig
             },
         };
         /**
          * Permissions required by MinerU toolset
          */
         this.permissions = [
-            {
-                type: 'integration',
-                service: MinerU,
-                description: 'Access to MinerU system integrations',
-            },
             {
                 type: 'filesystem',
                 operations: ['read', 'write', 'list'],
@@ -121,14 +168,15 @@ let MinerUToolsetStrategy = class MinerUToolsetStrategy {
     }
     /**
      * Validate toolset configuration
-     * Note: During authorization phase, config may be null/undefined or missing integration.
-     * Integration is injected by the permission system, so we don't validate it here.
-     * We only validate the optional parsing settings if provided.
      */
     validateConfig(config) {
-        // During authorization, config may be null/undefined or an empty object
-        // Integration will be injected by the permission system later, so we don't validate it here
-        // Optional parsing settings (isOcr, enableFormula, etc.) have defaults, so no validation needed
+        if (!config) {
+            return Promise.resolve();
+        }
+        const serverType = config.serverType ?? 'official';
+        if (serverType === 'official' && !config.apiKey) {
+            throw new Error('MinerU apiKey is required for official serverType');
+        }
         return Promise.resolve();
     }
     /**
@@ -137,7 +185,7 @@ let MinerUToolsetStrategy = class MinerUToolsetStrategy {
      */
     async create(config) {
         // Inject dependencies into config
-        // If config is null/undefined, create empty config (integration will be injected later)
+        // If config is null/undefined, create empty config
         const baseConfig = config || {};
         const configWithDependencies = {
             ...baseConfig,
@@ -149,11 +197,11 @@ let MinerUToolsetStrategy = class MinerUToolsetStrategy {
     /**
      * Create tools for MinerU toolset
      * Tools are created dynamically in MinerUToolset.initTools()
-     * based on the integration configuration
+     * based on the toolset credentials/configuration
      */
     createTools() {
         // Tools are created dynamically in MinerUToolset.initTools()
-        // based on the integration configuration
+        // based on the toolset credentials/configuration
         return [];
     }
 };

package/dist/lib/mineru.tool.d.ts

@@ -2,7 +2,6 @@ import { XpFileSystem } from '@xpert-ai/plugin-sdk';
 import { z } from 'zod';
 import { ConfigService } from '@nestjs/config';
 import { MinerUResultParserService } from './result-parser.service.js';
-import { IIntegration } from '@metad/contracts';
 import { MinerUIntegrationOptions } from './types.js';
 /**
  * Default parsing settings for MinerU tool
@@ -18,7 +17,7 @@ export interface MinerUToolDefaults {
  * Build MinerU PDF parser tool
  * This tool converts PDF files to markdown format using MinerU service
  */
-export declare function buildMinerUTool(configService: ConfigService, resultParser: MinerUResultParserService, integration?: Partial<IIntegration<MinerUIntegrationOptions>>, fileSystem?: XpFileSystem, defaults?: MinerUToolDefaults): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+export declare function buildMinerUTool(configService: ConfigService, resultParser: MinerUResultParserService, options?: MinerUIntegrationOptions, fileSystem?: XpFileSystem, defaults?: MinerUToolDefaults): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
     fileUrl: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     filePath: z.ZodNullable<z.ZodOptional<z.ZodString>>;
     fileName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
@@ -28,41 +27,41 @@ export declare function buildMinerUTool(configService: ConfigService, resultPars
     language: z.ZodNullable<z.ZodOptional<z.ZodEnum<["en", "ch"]>>>;
     modelVersion: z.ZodNullable<z.ZodOptional<z.ZodEnum<["pipeline", "vlm"]>>>;
 }, "strip", z.ZodTypeAny, {
-    fileUrl?: string;
     filePath?: string;
-    fileName?: string;
+    fileUrl?: string;
     isOcr?: boolean;
     enableFormula?: boolean;
     enableTable?: boolean;
     language?: "en" | "ch";
-    modelVersion?: "pipeline" | "vlm";
+    modelVersion?: "vlm" | "pipeline";
+    fileName?: string;
 }, {
-    fileUrl?: string;
     filePath?: string;
-    fileName?: string;
+    fileUrl?: string;
     isOcr?: boolean;
     enableFormula?: boolean;
     enableTable?: boolean;
     language?: "en" | "ch";
-    modelVersion?: "pipeline" | "vlm";
+    modelVersion?: "vlm" | "pipeline";
+    fileName?: string;
 }>, {
-    fileUrl?: string;
     filePath?: string;
-    fileName?: string;
+    fileUrl?: string;
     isOcr?: boolean;
     enableFormula?: boolean;
     enableTable?: boolean;
     language?: "en" | "ch";
-    modelVersion?: "pipeline" | "vlm";
+    modelVersion?: "vlm" | "pipeline";
+    fileName?: string;
 }, {
-    fileUrl?: string;
     filePath?: string;
-    fileName?: string;
+    fileUrl?: string;
     isOcr?: boolean;
     enableFormula?: boolean;
     enableTable?: boolean;
     language?: "en" | "ch";
-    modelVersion?: "pipeline" | "vlm";
+    modelVersion?: "vlm" | "pipeline";
+    fileName?: string;
 }, (string | {
     files: any[];
     taskId: string;

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

@@ -1 +1 @@
-{"version":3,"file":"mineru.tool.d.ts","sourceRoot":"","sources":["../../src/lib/mineru.tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAsB,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,yBAAyB,EACvC,WAAW,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,wBAAwB,CAAC,CAAC,EAC7D,UAAU,CAAC,EAAE,YAAY,EACzB,QAAQ,CAAC,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA2J9B"}
+{"version":3,"file":"mineru.tool.d.ts","sourceRoot":"","sources":["../../src/lib/mineru.tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAEvE,OAAO,EAAqB,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,yBAAyB,EACvC,OAAO,CAAC,EAAE,wBAAwB,EAClC,UAAU,CAAC,EAAE,YAAY,EACzB,QAAQ,CAAC,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAkK9B"}

package/dist/lib/mineru.tool.js

@@ -3,11 +3,12 @@ import { getCurrentTaskInput } from '@langchain/langgraph';
 import { getErrorMessage } from '@xpert-ai/plugin-sdk';
 import { z } from 'zod';
 import { MinerUClient } from './mineru.client.js';
+import { MinerUIntegration } from './types.js';
 /**
  * Build MinerU PDF parser tool
  * This tool converts PDF files to markdown format using MinerU service
  */
-export function buildMinerUTool(configService, resultParser, integration, fileSystem, defaults) {
+export function buildMinerUTool(configService, resultParser, options, fileSystem, defaults) {
     return tool(async (input) => {
         try {
             const { fileUrl, filePath, fileName, isOcr, enableFormula, enableTable, language, modelVersion } = input;
@@ -24,7 +25,13 @@ export function buildMinerUTool(configService, resultParser, integration, fileSy
             const currentState = getCurrentTaskInput();
             const workspacePath = currentState?.['sys']?.['volume'] ?? '/tmp/xpert';
             const baseUrl = currentState?.['sys']?.['workspace_url'];
-            // Create MinerU client with integration and file system permissions
+            // Create MinerU client with API options stored in toolset credentials
+            const integration = options
+                ? {
+                    provider: MinerUIntegration,
+                    options,
+                }
+                : undefined;
             const mineruClient = new MinerUClient(configService, {
                 fileSystem,
                 integration,

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

@@ -2,13 +2,17 @@ import { StructuredToolInterface, ToolSchemaBase } from '@langchain/core/tools';
 import { BuiltinToolset, XpFileSystem } from '@xpert-ai/plugin-sdk';
 import { ConfigService } from '@nestjs/config';
 import { MinerUResultParserService } from './result-parser.service.js';
-import { IIntegration } from '@metad/contracts';
 import { MinerUIntegrationOptions } from './types.js';
 /**
  * Configuration for MinerU Toolset
  */
 export interface MinerUToolsetConfig {
-    integration?: Partial<IIntegration<MinerUIntegrationOptions>>;
+    /**
+     * MinerU API options stored in toolset credentials
+     */
+    apiUrl?: string;
+    apiKey?: string;
+    serverType?: MinerUIntegrationOptions['serverType'];
     fileSystem?: XpFileSystem;
     configService?: ConfigService;
     resultParser?: MinerUResultParserService;
@@ -33,8 +37,7 @@ export declare class MinerUToolset extends BuiltinToolset<StructuredToolInterfac
     constructor(config: MinerUToolsetConfig);
     /**
      * Validate credentials for MinerU toolset
-     * Note: During authorization phase, credentials may not include integration yet.
-     * Integration is injected by the permission system after authorization is complete.
+     * Note: During authorization phase, credentials may be incomplete.
      * configService and resultParser are runtime dependencies injected by the strategy.
      * We don't validate anything here to allow authorization to proceed.
      */

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

@@ -1 +1 @@
-{"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,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,wBAAwB,CAAC,CAAC,CAAC;IAC9D,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,YAAY,CAAC,EAAE,yBAAyB,CAAC;IAEzC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;CACnC;AAED;;;GAGG;AACH,qBAAa,aAAc,SAAQ,cAAc,CAAC,uBAAuB,EAAE,mBAAmB,CAAC;IAC7F,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAE7C;;;;;OAKG;gBACS,MAAM,EAAE,mBAAmB;IAKvC;;;;;;OAMG;IACY,oBAAoB,CAAC,WAAW,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpF;;;OAGG;IACY,SAAS,IAAI,OAAO,CAAC,uBAAuB,CAAC,cAAc,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;CAsBzF"}
+{"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,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAEvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,wBAAwB,CAAC,YAAY,CAAC,CAAC;IACpD,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,YAAY,CAAC,EAAE,yBAAyB,CAAC;IAEzC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;CACnC;AAED;;;GAGG;AACH,qBAAa,aAAc,SAAQ,cAAc,CAAC,uBAAuB,EAAE,mBAAmB,CAAC;IAC7F,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAE7C;;;;;OAKG;gBACS,MAAM,EAAE,mBAAmB;IAKvC;;;;;OAKG;IACY,oBAAoB,CAAC,WAAW,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpF;;;OAGG;IACY,SAAS,IAAI,OAAO,CAAC,uBAAuB,CAAC,cAAc,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;CA0BzF"}

package/dist/lib/mineru.toolset.js

@@ -17,26 +17,29 @@ export class MinerUToolset extends BuiltinToolset {
     }
     /**
      * Validate credentials for MinerU toolset
-     * Note: During authorization phase, credentials may not include integration yet.
-     * Integration is injected by the permission system after authorization is complete.
+     * Note: During authorization phase, credentials may be incomplete.
      * configService and resultParser are runtime dependencies injected by the strategy.
      * We don't validate anything here to allow authorization to proceed.
      */
     async _validateCredentials(credentials) {
         // No validation needed during authorization phase
-        // Integration will be validated when tools are actually used
+        // API key validity will be enforced by MinerU server when tool is used
     }
     /**
      * Initialize tools for MinerU toolset
      * Creates the PDF parser tool with necessary dependencies
      */
     async initTools() {
-        const { configService, resultParser, integration, fileSystem, isOcr, enableFormula, enableTable, language, modelVersion } = this.config;
+        const { configService, resultParser, apiUrl, apiKey, serverType, fileSystem, isOcr, enableFormula, enableTable, language, modelVersion } = this.config;
         if (!configService || !resultParser) {
             throw new Error('ConfigService and MinerUResultParserService are required');
         }
         this.tools = [
-            buildMinerUTool(configService, resultParser, integration, fileSystem, {
+            buildMinerUTool(configService, resultParser, {
+                apiUrl,
+                apiKey,
+                serverType: serverType ?? 'official',
+            }, fileSystem, {
                 isOcr,
                 enableFormula,
                 enableTable,

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,EAA8C,wBAAwB,EAAE,MAAM,YAAY,CAAA;AAEjG,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"}

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

@@ -5,13 +5,13 @@ import { DocumentTransformerStrategy, } from '@xpert-ai/plugin-sdk';
 import { isNil, omitBy, pick } from 'lodash-es';
 import { MinerUClient } from './mineru.client.js';
 import { MinerUResultParserService } from './result-parser.service.js';
-import { icon, MinerU } from './types.js';
+import { icon, MinerUIntegration, MinerUTransformer } from './types.js';
 let MinerUTransformerStrategy = class MinerUTransformerStrategy {
     constructor() {
         this.permissions = [
             {
                 type: 'integration',
-                service: MinerU,
+                service: MinerUIntegration,
                 description: 'Access to MinerU system integrations'
             },
             {
@@ -21,7 +21,7 @@ let MinerUTransformerStrategy = class MinerUTransformerStrategy {
             }
         ];
         this.meta = {
-            name: MinerU,
+            name: MinerUTransformer,
             label: {
                 en_US: 'MinerU',
                 zh_Hans: 'MinerU'
@@ -158,6 +158,6 @@ __decorate([
 ], MinerUTransformerStrategy.prototype, "configService", void 0);
 MinerUTransformerStrategy = __decorate([
     Injectable(),
-    DocumentTransformerStrategy(MinerU)
+    DocumentTransformerStrategy(MinerUTransformer)
 ], MinerUTransformerStrategy);
 export { MinerUTransformerStrategy };

package/dist/lib/types.d.ts

@@ -1,5 +1,18 @@
 import { TDocumentAsset, TDocumentTransformerConfig } from "@xpert-ai/plugin-sdk";
 export declare const MinerU = "mineru";
+/**
+ * Integration provider key for MinerU API credentials.
+ *
+ * IMPORTANT:
+ * Keep this different from the builtin toolset provider key (`mineru`) to avoid the platform
+ * treating builtin toolset authorization as an "integration-backed" flow (which may read
+ * `credentials.integration` and crash when credentials is null).
+ */
+export declare const MinerUIntegration = "mineru_api";
+/**
+ * Document transformer provider key (distinct from toolset key).
+ */
+export declare const MinerUTransformer = "mineru_transformer";
 export declare const ENV_MINERU_API_BASE_URL = "MINERU_API_BASE_URL";
 export declare const ENV_MINERU_API_TOKEN = "MINERU_API_TOKEN";
 export declare const ENV_MINERU_SERVER_TYPE = "MINERU_SERVER_TYPE";

package/dist/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAA;AAEjF,eAAO,MAAM,MAAM,WAAW,CAAA;AAE9B,eAAO,MAAM,uBAAuB,wBAAwB,CAAA;AAC5D,eAAO,MAAM,oBAAoB,qBAAqB,CAAA;AACtD,eAAO,MAAM,sBAAsB,uBAAuB,CAAA;AAE1D,eAAO,MAAM,IAAI,m5GAsBhB,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG,0BAA0B,GAAG;IAClE,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IACtB,YAAY,CAAC,EAAE,KAAK,GAAG,UAAU,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,aAAa,CAAA;AAEzD,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,gBAAgB,CAAA;CAC9B,CAAA;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,GAAG,EAAE,GAAG,CAAC;IACT,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAA;AAEjF,eAAO,MAAM,MAAM,WAAW,CAAA;AAC9B;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,eAAe,CAAA;AAE7C;;GAEG;AACH,eAAO,MAAM,iBAAiB,uBAAuB,CAAA;AAErD,eAAO,MAAM,uBAAuB,wBAAwB,CAAA;AAC5D,eAAO,MAAM,oBAAoB,qBAAqB,CAAA;AACtD,eAAO,MAAM,sBAAsB,uBAAuB,CAAA;AAE1D,eAAO,MAAM,IAAI,m5GAsBhB,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG,0BAA0B,GAAG;IAClE,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IACtB,YAAY,CAAC,EAAE,KAAK,GAAG,UAAU,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,aAAa,CAAA;AAEzD,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,gBAAgB,CAAA;CAC9B,CAAA;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,GAAG,EAAE,GAAG,CAAC;IACT,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/lib/types.js

@@ -1,4 +1,17 @@
 export const MinerU = 'mineru';
+/**
+ * Integration provider key for MinerU API credentials.
+ *
+ * IMPORTANT:
+ * Keep this different from the builtin toolset provider key (`mineru`) to avoid the platform
+ * treating builtin toolset authorization as an "integration-backed" flow (which may read
+ * `credentials.integration` and crash when credentials is null).
+ */
+export const MinerUIntegration = 'mineru_api';
+/**
+ * Document transformer provider key (distinct from toolset key).
+ */
+export const MinerUTransformer = 'mineru_transformer';
 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';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helloxiaohu/plugin-mineru",
-  "version": "0.0.17",
+  "version": "0.0.19",
   "license": "AGPL-3.0",
   "description": "MinerU PDF to Markdown converter plugin for XpertAI platform with toolset support",
   "keywords": [