@helloxiaohu/plugin-mineru 0.0.19 → 0.1.0

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

@@ -5,6 +5,7 @@ import { ToolsetStrategy, } from '@xpert-ai/plugin-sdk';
 import { MinerUResultParserService } from './result-parser.service.js';
 import { MinerUToolset } from './mineru.toolset.js';
 import { MinerU, icon } from './types.js';
+import { buildMinerUTool } from './mineru.tool.js';
 /**
  * ToolsetStrategy for MinerU PDF parser tool
  * Registers MinerU as a toolset that can be used in agent workflows
@@ -29,6 +30,11 @@ let MinerUToolsetStrategy = class MinerUToolsetStrategy {
                 zh_Hans: '使用 MinerU 将 PDF 文件转换为 Markdown 格式。支持 OCR、公式识别和表格提取。',
             },
             icon: {
+                // Provide both shapes to maximize compatibility with different platform icon resolvers
+                // - builtin-provider icon endpoints may look for `type/value`
+                // - toolset registries may look for `svg`
+                type: 'svg',
+                value: icon,
                 svg: icon,
                 color: '#14b8a6',
             },
@@ -51,10 +57,11 @@ let MinerUToolsetStrategy = class MinerUToolsetStrategy {
                             zh_Hans: 'Base URL',
                         },
                         description: {
-                            en_US: 'MinerU API base url. Official: https://api.mineru.dev',
-                            zh_Hans: 'MinerU 服务地址。官方： https://api.mineru.dev',
+                            en_US: 'MinerU API base url. Official: https://mineru.net/api/v4',
+                            zh_Hans: 'MinerU 服务地址。官方： https://mineru.net/api/v4',
                         },
-                        default: 'https://api.mineru.dev',
+                        default: 'https://mineru.net/api/v4',
+                        // Note: apiUrl is not in required array because it's optional with a default value
                     },
                     apiKey: {
                         type: 'string',
@@ -63,8 +70,8 @@ let MinerUToolsetStrategy = class MinerUToolsetStrategy {
                             zh_Hans: 'API Key',
                         },
                         description: {
-                            en_US: 'The API Key of the MinerU server (required for official API)',
-                            zh_Hans: 'MinerU 服务令牌（官方 API 必填）',
+                            en_US: 'The API Key of the MinerU server (required)',
+                            zh_Hans: 'MinerU 服务令牌（必填）',
                         },
                         'x-ui': {
                             component: 'secretInput',
@@ -75,55 +82,84 @@ let MinerUToolsetStrategy = class MinerUToolsetStrategy {
                             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)
+                    // Changed isOcr from boolean to string enum
                     isOcr: {
-                        type: 'boolean',
+                        type: 'string',
                         title: {
                             en_US: 'Enable OCR',
                             zh_Hans: '启用 OCR',
                         },
                         description: {
-                            en_US: 'Enable OCR for image-based PDFs (default: true)',
-                            zh_Hans: '为基于图像的 PDF 启用 OCR（默认：true）',
+                            en_US: 'Enable OCR for image-based PDFs',
+                            zh_Hans: '为基于图像的 PDF 启用 OCR',
+                        },
+                        enum: ['true', 'false'],
+                        default: 'true',
+                        'x-ui': {
+                            enumLabels: {
+                                'true': {
+                                    en_US: 'Enabled',
+                                    zh_Hans: '启用',
+                                },
+                                'false': {
+                                    en_US: 'Disabled',
+                                    zh_Hans: '禁用',
+                                },
+                            },
                         },
-                        default: true,
                     },
+                    // Changed enableFormula from boolean to string enum
                     enableFormula: {
-                        type: 'boolean',
+                        type: 'string',
                         title: {
                             en_US: 'Enable Formula Recognition',
                             zh_Hans: '启用公式识别',
                         },
                         description: {
-                            en_US: 'Enable formula recognition (default: true)',
-                            zh_Hans: '启用公式识别（默认：true）',
+                            en_US: 'Enable formula recognition',
+                            zh_Hans: '启用公式识别',
+                        },
+                        enum: ['true', 'false'],
+                        default: 'true',
+                        'x-ui': {
+                            enumLabels: {
+                                'true': {
+                                    en_US: 'Enabled',
+                                    zh_Hans: '启用',
+                                },
+                                'false': {
+                                    en_US: 'Disabled',
+                                    zh_Hans: '禁用',
+                                },
+                            },
                         },
-                        default: true,
                     },
+                    // Changed enableTable from boolean to string enum
                     enableTable: {
-                        type: 'boolean',
+                        type: 'string',
                         title: {
                             en_US: 'Enable Table Recognition',
                             zh_Hans: '启用表格识别',
                         },
                         description: {
-                            en_US: 'Enable table recognition (default: true)',
-                            zh_Hans: '启用表格识别（默认：true）',
+                            en_US: 'Enable table recognition',
+                            zh_Hans: '启用表格识别',
+                        },
+                        enum: ['true', 'false'],
+                        default: 'true',
+                        'x-ui': {
+                            enumLabels: {
+                                'true': {
+                                    en_US: 'Enabled',
+                                    zh_Hans: '启用',
+                                },
+                                'false': {
+                                    en_US: 'Disabled',
+                                    zh_Hans: '禁用',
+                                },
+                            },
                         },
-                        default: true,
                     },
                     language: {
                         type: 'string',
@@ -137,6 +173,18 @@ let MinerUToolsetStrategy = class MinerUToolsetStrategy {
                         },
                         enum: ['en', 'ch'],
                         default: 'ch',
+                        'x-ui': {
+                            enumLabels: {
+                                'en': {
+                                    en_US: 'en',
+                                    zh_Hans: '英文',
+                                },
+                                'ch': {
+                                    en_US: 'ch',
+                                    zh_Hans: '中文',
+                                },
+                            },
+                        },
                     },
                     modelVersion: {
                         type: 'string',
@@ -150,9 +198,21 @@ let MinerUToolsetStrategy = class MinerUToolsetStrategy {
                         },
                         enum: ['pipeline', 'vlm'],
                         default: 'pipeline',
+                        'x-ui': {
+                            enumLabels: {
+                                'pipeline': {
+                                    en_US: 'pipeline',
+                                    zh_Hans: 'pipeline',
+                                },
+                                'vlm': {
+                                    en_US: 'vlm',
+                                    zh_Hans: 'vlm',
+                                },
+                            },
+                        },
                     },
                 },
-                required: ['serverType'], // apiKey required only for official, validated in validateConfig
+                required: ['apiKey'],
             },
         };
         /**
@@ -173,22 +233,33 @@ let MinerUToolsetStrategy = class MinerUToolsetStrategy {
         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');
+        // apiKey is now a required field, validated by schema.required
+        if (!config.apiKey) {
+            throw new Error('MinerU apiKey is required');
         }
         return Promise.resolve();
     }
     /**
      * Create MinerU toolset instance
      * Note: config may be null/undefined during authorization phase
+     * Modified to read from toolset.credentials (like @searchapi/@email)
      */
     async create(config) {
-        // Inject dependencies into config
-        // If config is null/undefined, create empty config
-        const baseConfig = config || {};
+        // Check if config is an IXpertToolset object with credentials property
+        const toolset = (config && typeof config === 'object' && 'credentials' in config)
+            ? config
+            : null;
+        // Priority: toolset.credentials > config (flat structure) > empty object
+        const creds = toolset?.credentials ?? config ?? {};
+        // Build config with dependencies
         const configWithDependencies = {
-            ...baseConfig,
+            apiUrl: creds.apiUrl,
+            apiKey: creds.apiKey,
+            isOcr: creds.isOcr,
+            enableFormula: creds.enableFormula,
+            enableTable: creds.enableTable,
+            language: creds.language,
+            modelVersion: creds.modelVersion,
             configService: this.configService,
             resultParser: this.resultParser,
         };
@@ -200,9 +271,28 @@ let MinerUToolsetStrategy = class MinerUToolsetStrategy {
      * based on the toolset credentials/configuration
      */
     createTools() {
-        // Tools are created dynamically in MinerUToolset.initTools()
-        // based on the toolset credentials/configuration
-        return [];
+        /**
+         * IMPORTANT:
+         * The console UI requires builtin providers to expose at least one tool so users can
+         * enable it (otherwise it fails the "Enable at least one tool" validation).
+         *
+         * The returned tools here are used for listing/preview & toggling in UI. Actual execution
+         * will use the toolset instance created by `create()` -> `MinerUToolset.initTools()`,
+         * which wires credentials (apiUrl/apiKey/serverType) correctly.
+         */
+        return [
+            buildMinerUTool(this.configService, this.resultParser, 
+            // No credentials at listing time
+            undefined, undefined, 
+            // Defaults used if user doesn't pass tool-call parameters
+            {
+                isOcr: true,
+                enableFormula: true,
+                enableTable: true,
+                language: 'ch',
+                modelVersion: 'pipeline',
+            }),
+        ];
     }
 };
 MinerUToolsetStrategy = __decorate([

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

@@ -93,7 +93,11 @@ export declare class MinerUClient {
      */
     waitForTask(taskId: string, timeoutMs?: number, intervalMs?: number): Promise<any>;
     private ensureOfficial;
-    private resolveServerType;
+    /**
+     * Automatically determine serverType from URL
+     * Returns 'official' if URL is the official address (https://mineru.net/api/v4), otherwise 'self-hosted'
+     */
+    private resolveServerTypeFromUrl;
     private resolveCredentials;
     private readIntegrationOptions;
     private normalizeBaseUrl;

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":"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"}
+{"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

@@ -17,13 +17,26 @@ export class MinerUClient {
         this.logger = new Logger(MinerUClient.name);
         this.localTasks = new Map();
         const integration = this.permissions?.integration;
-        this.serverType = this.resolveServerType(integration);
+        // First, resolve credentials without depending on serverType
         const { baseUrl, token } = this.resolveCredentials(integration);
+        const maskedToken = token && token.length > 8
+            ? `${token.slice(0, 4)}***${token.slice(-4)}`
+            : token
+                ? 'provided'
+                : 'missing';
+        this.logger.debug('[MinerU] MinerUClient credentials resolved', {
+            hasIntegration: Boolean(integration),
+            apiUrl: baseUrl,
+            token: maskedToken,
+            serverTypeFromUrl: this.resolveServerTypeFromUrl(baseUrl || '', integration),
+        });
         if (!baseUrl) {
             throw new Error('MinerU base URL is required');
         }
         this.baseUrl = this.normalizeBaseUrl(baseUrl);
         this.token = token;
+        // Automatically determine serverType from URL: official if it's the official URL, otherwise self-hosted
+        this.serverType = this.resolveServerTypeFromUrl(this.baseUrl, integration);
         if (this.serverType === 'official' && !this.token) {
             throw new Error('MinerU official API requires an access token');
         }
@@ -146,7 +159,13 @@ export class MinerUClient {
         const start = Date.now();
         while (true) {
             const result = await this.getTaskResult(taskId);
-            this.logger.debug(`MinerU waiting task result: ${JSON.stringify(result)}`);
+            this.logger.debug('[MinerU] waiting task result', {
+                taskId,
+                hasZip: Boolean(result?.full_zip_url),
+                hasUrl: Boolean(result?.full_url),
+                hasContent: Boolean(result?.content),
+                status: result?.status,
+            });
             if (result?.full_zip_url || result?.full_url || result?.content || result?.status === 'done') {
                 return result;
             }
@@ -161,28 +180,41 @@ export class MinerUClient {
             throw new Error(`${feature} is only supported for official MinerU deployments`);
         }
     }
-    resolveServerType(integration) {
+    /**
+     * Automatically determine serverType from URL
+     * Returns 'official' if URL is the official address (https://mineru.net/api/v4), otherwise 'self-hosted'
+     */
+    resolveServerTypeFromUrl(baseUrl, integration) {
+        // Prefer explicitly specified serverType (backward compatibility)
         const integrationType = this.readIntegrationOptions(integration)?.serverType;
         if (integrationType === 'self-hosted' || integrationType === 'official') {
             return integrationType;
         }
+        // Check environment variable (backward compatibility)
         const envValue = this.configService.get(ENV_MINERU_SERVER_TYPE)?.toLowerCase();
         if (envValue === 'self-hosted') {
             return 'self-hosted';
         }
-        return 'official';
+        // Automatically determine from URL: if normalized URL matches official address, return 'official'
+        const normalizedOfficialUrl = this.normalizeBaseUrl(DEFAULT_OFFICIAL_BASE_URL);
+        const normalizedBaseUrl = this.normalizeBaseUrl(baseUrl);
+        if (normalizedBaseUrl === normalizedOfficialUrl) {
+            return 'official';
+        }
+        return 'self-hosted';
     }
     resolveCredentials(integration) {
         const options = this.readIntegrationOptions(integration);
         const baseUrlFromIntegration = options?.apiUrl;
         const tokenFromIntegration = options?.apiKey;
-        const baseUrlEnvKey = this.serverType === 'self-hosted' ? ENV_MINERU_API_BASE_URL : ENV_MINERU_API_BASE_URL;
-        const tokenEnvKey = this.serverType === 'self-hosted' ? ENV_MINERU_API_TOKEN : ENV_MINERU_API_TOKEN;
-        const baseUrlFromEnv = this.configService.get(baseUrlEnvKey);
-        const tokenFromEnv = this.configService.get(tokenEnvKey);
+        // Read from environment variables (same keys for both official and self-hosted)
+        const baseUrlFromEnv = this.configService.get(ENV_MINERU_API_BASE_URL);
+        const tokenFromEnv = this.configService.get(ENV_MINERU_API_TOKEN);
+        // Determine baseUrl: prefer integration config, then env, then default to official URL
         const baseUrl = baseUrlFromIntegration ||
             baseUrlFromEnv ||
-            (this.serverType === 'official' ? DEFAULT_OFFICIAL_BASE_URL : null);
+            DEFAULT_OFFICIAL_BASE_URL;
+        // Determine token: prefer integration config, then env
         const token = tokenFromIntegration || tokenFromEnv;
         return { baseUrl, token };
     }
@@ -238,6 +270,11 @@ export class MinerUClient {
         if (options.seed)
             body.seed = options.seed;
         try {
+            this.logger.debug('[MinerU] createOfficialTask request', {
+                url,
+                body,
+                hasAuthHeader: Boolean(this.getOfficialHeaders().Authorization),
+            });
             const resp = await axios.post(url, body, { headers: this.getOfficialHeaders() });
             const data = resp.data;
             if (data.code !== 0) {

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

@@ -7,9 +7,9 @@ import { MinerUIntegrationOptions } from './types.js';
  * Default parsing settings for MinerU tool
  */
 export interface MinerUToolDefaults {
-    isOcr?: boolean;
-    enableFormula?: boolean;
-    enableTable?: boolean;
+    isOcr?: boolean | string;
+    enableFormula?: boolean | string;
+    enableTable?: boolean | string;
     language?: 'en' | 'ch';
     modelVersion?: 'pipeline' | 'vlm';
 }
@@ -18,50 +18,15 @@ export interface MinerUToolDefaults {
  * This tool converts PDF files to markdown format using MinerU service
  */
 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>>;
-    isOcr: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
-    enableFormula: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
-    enableTable: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
-    language: z.ZodNullable<z.ZodOptional<z.ZodEnum<["en", "ch"]>>>;
-    modelVersion: z.ZodNullable<z.ZodOptional<z.ZodEnum<["pipeline", "vlm"]>>>;
+    doc_url: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    filePath?: string;
-    fileUrl?: string;
-    isOcr?: boolean;
-    enableFormula?: boolean;
-    enableTable?: boolean;
-    language?: "en" | "ch";
-    modelVersion?: "vlm" | "pipeline";
-    fileName?: string;
+    doc_url?: string;
 }, {
-    filePath?: string;
-    fileUrl?: string;
-    isOcr?: boolean;
-    enableFormula?: boolean;
-    enableTable?: boolean;
-    language?: "en" | "ch";
-    modelVersion?: "vlm" | "pipeline";
-    fileName?: string;
+    doc_url?: string;
 }>, {
-    filePath?: string;
-    fileUrl?: string;
-    isOcr?: boolean;
-    enableFormula?: boolean;
-    enableTable?: boolean;
-    language?: "en" | "ch";
-    modelVersion?: "vlm" | "pipeline";
-    fileName?: string;
+    doc_url?: string;
 }, {
-    filePath?: string;
-    fileUrl?: string;
-    isOcr?: boolean;
-    enableFormula?: boolean;
-    enableTable?: boolean;
-    language?: "en" | "ch";
-    modelVersion?: "vlm" | "pipeline";
-    fileName?: string;
+    doc_url?: 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;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"}
+{"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;IAEjC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACjC,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC/B,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;;;;;;;;;;;;;;MAmL9B"}

package/dist/lib/mineru.tool.js

@@ -11,55 +11,75 @@ import { MinerUIntegration } from './types.js';
 export function buildMinerUTool(configService, resultParser, options, fileSystem, defaults) {
     return tool(async (input) => {
         try {
-            const { fileUrl, filePath, fileName, isOcr, enableFormula, enableTable, language, modelVersion } = input;
-            // Use defaults from toolset config if not provided in input
-            const finalIsOcr = isOcr ?? defaults?.isOcr ?? true;
-            const finalEnableFormula = enableFormula ?? defaults?.enableFormula ?? true;
-            const finalEnableTable = enableTable ?? defaults?.enableTable ?? true;
-            const finalLanguage = language ?? defaults?.language ?? 'ch';
-            const finalModelVersion = modelVersion ?? defaults?.modelVersion ?? 'pipeline';
-            if (!fileUrl && !filePath) {
-                throw new Error('Either fileUrl or filePath must be provided');
+            const { doc_url } = input;
+            // Log raw input (mask nothing sensitive here because doc_url is public; avoid logging other fields)
+            console.debug('[MinerU] tool invoked with input', { doc_url, extraKeys: Object.keys(input || {}).filter((k) => k !== 'doc_url') });
+            if (!doc_url) {
+                throw new Error('doc_url is required');
             }
             // Get workspace context from current task
             const currentState = getCurrentTaskInput();
             const workspacePath = currentState?.['sys']?.['volume'] ?? '/tmp/xpert';
-            const baseUrl = currentState?.['sys']?.['workspace_url'];
-            // Create MinerU client with API options stored in toolset credentials
-            const integration = options
-                ? {
-                    provider: MinerUIntegration,
-                    options,
-                }
-                : undefined;
+            // Use configuration from authorization page (passed via options and defaults parameters)
+            // These values come from the authorization page configuration and are set when the tool is created
+            const finalApiUrl = options?.apiUrl || 'https://mineru.net/api/v4';
+            const finalApiKey = options?.apiKey; // apiKey is required and validated in authorization page
+            // Log effective config (mask key) to确认是否拿到了授权页的凭据
+            const maskedKey = finalApiKey && finalApiKey.length > 8
+                ? `${finalApiKey.slice(0, 4)}***${finalApiKey.slice(-4)}`
+                : finalApiKey
+                    ? 'provided'
+                    : 'missing';
+            console.debug('[MinerU] buildMinerUTool config', {
+                fromOptions: Boolean(options),
+                apiUrl: finalApiUrl,
+                apiKey: maskedKey,
+                defaults: {
+                    isOcr: defaults?.isOcr,
+                    enableFormula: defaults?.enableFormula,
+                    enableTable: defaults?.enableTable,
+                    language: defaults?.language,
+                    modelVersion: defaults?.modelVersion,
+                },
+            });
+            // Use configuration values from authorization page (passed via defaults parameter)
+            // Convert string enum values ('true'/'false') to boolean, or use boolean values directly
+            // If undefined, default to true
+            const finalIsOcr = defaults?.isOcr === undefined
+                ? true
+                : (typeof defaults.isOcr === 'string' ? defaults.isOcr === 'true' : defaults.isOcr === true);
+            const finalEnableFormula = defaults?.enableFormula === undefined
+                ? true
+                : (typeof defaults.enableFormula === 'string' ? defaults.enableFormula === 'true' : defaults.enableFormula === true);
+            const finalEnableTable = defaults?.enableTable === undefined
+                ? true
+                : (typeof defaults.enableTable === 'string' ? defaults.enableTable === 'true' : defaults.enableTable === true);
+            const finalLanguage = defaults?.language || 'ch';
+            const finalModelVersion = defaults?.modelVersion || 'pipeline';
+            const effectiveOptions = {
+                apiUrl: finalApiUrl,
+                apiKey: finalApiKey,
+            };
+            const integration = {
+                provider: MinerUIntegration,
+                options: effectiveOptions,
+            };
             const mineruClient = new MinerUClient(configService, {
                 fileSystem,
                 integration,
             });
-            // Determine file name if not provided
-            let finalFileName = fileName;
-            if (!finalFileName) {
-                if (fileUrl) {
-                    try {
-                        const url = new URL(fileUrl);
-                        finalFileName = url.pathname.split('/').pop() || 'document.pdf';
-                    }
-                    catch {
-                        finalFileName = 'document.pdf';
-                    }
-                }
-                else if (filePath) {
-                    const pathParts = filePath.split(/[/\\]/);
-                    finalFileName = pathParts[pathParts.length - 1] || 'document.pdf';
-                }
-                else {
-                    finalFileName = 'document.pdf';
-                }
+            // Determine file name from URL
+            let finalFileName = 'document.pdf';
+            try {
+                const parsed = new URL(doc_url);
+                finalFileName = parsed.pathname.split('/').pop() || 'document.pdf';
+            }
+            catch {
+                // ignore
             }
             // Create MinerU task
             const { taskId } = await mineruClient.createTask({
-                url: fileUrl,
-                filePath: filePath,
+                url: doc_url,
                 fileName: finalFileName,
                 isOcr: finalIsOcr,
                 enableFormula: finalEnableFormula,
@@ -75,8 +95,7 @@ export function buildMinerUTool(configService, resultParser, options, fileSystem
                     throw new Error('Failed to get MinerU task result');
                 }
                 parsedResult = await resultParser.parseLocalTask(taskResult, taskId, {
-                    fileUrl,
-                    filePath,
+                    fileUrl: doc_url,
                     name: finalFileName,
                     folder: workspacePath,
                 }, fileSystem);
@@ -85,8 +104,7 @@ export function buildMinerUTool(configService, resultParser, options, fileSystem
                 // Official API: wait for completion
                 const result = await mineruClient.waitForTask(taskId, 5 * 60 * 1000, 5000);
                 parsedResult = await resultParser.parseFromUrl(result.full_zip_url, taskId, {
-                    fileUrl,
-                    filePath,
+                    fileUrl: doc_url,
                     name: finalFileName,
                     folder: workspacePath,
                 }, fileSystem);
@@ -115,8 +133,9 @@ export function buildMinerUTool(configService, resultParser, options, fileSystem
             const markdownContent = parsedResult.chunks
                 ?.map((chunk) => chunk.pageContent)
                 .join('\n\n') || '';
+            // Return full markdown (do NOT truncate). If the platform/UI needs a preview, it can truncate client-side.
             return [
-                `PDF processed successfully by MinerU.\n\nTask ID: ${taskId}\n\nMarkdown Content:\n${markdownContent.substring(0, 1000)}${markdownContent.length > 1000 ? '...' : ''}`,
+                markdownContent,
                 {
                     files: fileArtifacts,
                     taskId,
@@ -131,14 +150,7 @@ export function buildMinerUTool(configService, resultParser, options, fileSystem
         name: 'mineru_pdf_parser',
         description: 'Convert PDF files to markdown format using MinerU. Supports OCR, formula recognition, and table extraction. Returns markdown content and extracted files (images, JSON, etc.).',
         schema: z.object({
-            fileUrl: z.string().optional().nullable().describe('URL of the PDF file to process'),
-            filePath: z.string().optional().nullable().describe('Local file path of the PDF file'),
-            fileName: z.string().optional().nullable().describe('Name of the PDF file'),
-            isOcr: z.boolean().optional().nullable().describe('Enable OCR for image-based PDFs (default: true)'),
-            enableFormula: z.boolean().optional().nullable().describe('Enable formula recognition (default: true)'),
-            enableTable: z.boolean().optional().nullable().describe('Enable table recognition (default: true)'),
-            language: z.enum(['en', 'ch']).optional().nullable().describe('Document language: "en" for English, "ch" for Chinese (default: "ch")'),
-            modelVersion: z.enum(['pipeline', 'vlm']).optional().nullable().describe('Model version: "pipeline" or "vlm" (default: "pipeline")'),
+            doc_url: z.string().min(1).describe('PDF URL (required)'),
         }),
         responseFormat: 'content_and_artifact',
     });