@hibanacloud/core 0.3.15

package/dist/src/tools/web-search/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, type ToolInvocation } from '../tools.js';
+import type { Config } from '../../config/config.js';
+import type { WebSearchToolParams, WebSearchToolResult } from './types.js';
+/**
+ * A tool to perform web searches using configurable providers.
+ */
+export declare class WebSearchTool extends BaseDeclarativeTool<WebSearchToolParams, WebSearchToolResult> {
+    private readonly config;
+    static readonly Name: string;
+    constructor(config: Config);
+    /**
+     * Validates the parameters for the WebSearchTool.
+     * @param params The parameters to validate
+     * @returns An error message string if validation fails, null if valid
+     */
+    protected validateToolParamValues(params: WebSearchToolParams): string | null;
+    protected createInvocation(params: WebSearchToolParams): ToolInvocation<WebSearchToolParams, WebSearchToolResult>;
+}
+export type { WebSearchToolParams, WebSearchToolResult, WebSearchConfig, WebSearchProviderConfig, } from './types.js';

package/dist/src/tools/web-search/index.js

@@ -0,0 +1,245 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, ToolConfirmationOutcome, } from '../tools.js';
+import { ToolErrorType } from '../tool-error.js';
+import { ApprovalMode } from '../../config/config.js';
+import { getErrorMessage } from '../../utils/errors.js';
+import { buildContentWithSources } from './utils.js';
+import { TavilyProvider } from './providers/tavily-provider.js';
+import { GoogleProvider } from './providers/google-provider.js';
+import { DashScopeProvider } from './providers/dashscope-provider.js';
+import { ToolNames, ToolDisplayNames } from '../tool-names.js';
+class WebSearchToolInvocation extends BaseToolInvocation {
+    config;
+    constructor(config, params) {
+        super(params);
+        this.config = config;
+    }
+    getDescription() {
+        const webSearchConfig = this.config.getWebSearchConfig();
+        if (!webSearchConfig) {
+            return ' (Web search is disabled - configure a provider in settings.json)';
+        }
+        const provider = this.params.provider || webSearchConfig.default;
+        return ` (Searching the web via ${provider})`;
+    }
+    async shouldConfirmExecute(_abortSignal) {
+        if (this.config.getApprovalMode() === ApprovalMode.AUTO_EDIT) {
+            return false;
+        }
+        const confirmationDetails = {
+            type: 'info',
+            title: 'Confirm Web Search',
+            prompt: `Search the web for: "${this.params.query}"`,
+            onConfirm: async (outcome) => {
+                if (outcome === ToolConfirmationOutcome.ProceedAlways) {
+                    this.config.setApprovalMode(ApprovalMode.AUTO_EDIT);
+                }
+            },
+        };
+        return confirmationDetails;
+    }
+    /**
+     * Create a provider instance from configuration.
+     */
+    createProvider(config) {
+        switch (config.type) {
+            case 'tavily':
+                return new TavilyProvider(config);
+            case 'google':
+                return new GoogleProvider(config);
+            case 'dashscope': {
+                // Pass auth type to DashScope provider for availability check
+                const authType = this.config.getAuthType();
+                const dashscopeConfig = {
+                    ...config,
+                    authType: authType,
+                };
+                return new DashScopeProvider(dashscopeConfig);
+            }
+            default:
+                throw new Error('Unknown provider type');
+        }
+    }
+    /**
+     * Create all configured providers.
+     */
+    createProviders(configs) {
+        const providers = new Map();
+        for (const config of configs) {
+            try {
+                const provider = this.createProvider(config);
+                if (provider.isAvailable()) {
+                    providers.set(config.type, provider);
+                }
+            }
+            catch (error) {
+                console.warn(`Failed to create ${config.type} provider:`, error);
+            }
+        }
+        return providers;
+    }
+    /**
+     * Select the appropriate provider based on configuration and parameters.
+     * Throws error if provider not found.
+     */
+    selectProvider(providers, requestedProvider, defaultProvider) {
+        // Use requested provider if specified
+        if (requestedProvider) {
+            const provider = providers.get(requestedProvider);
+            if (!provider) {
+                const available = Array.from(providers.keys()).join(', ');
+                throw new Error(`The specified provider "${requestedProvider}" is not available. Available: ${available}`);
+            }
+            return provider;
+        }
+        // Use default provider if specified and available
+        if (defaultProvider && providers.has(defaultProvider)) {
+            return providers.get(defaultProvider);
+        }
+        // Fallback to first available provider
+        const firstProvider = providers.values().next().value;
+        if (!firstProvider) {
+            throw new Error('No web search providers are available.');
+        }
+        return firstProvider;
+    }
+    /**
+     * Format search results into a content string.
+     */
+    formatSearchResults(searchResult) {
+        const sources = searchResult.results.map((r) => ({
+            title: r.title,
+            url: r.url,
+        }));
+        let content = searchResult.answer?.trim() || '';
+        if (!content) {
+            // Fallback: Build an informative summary with title + snippet + source link
+            // This provides enough context for the LLM while keeping token usage efficient
+            content = searchResult.results
+                .slice(0, 5) // Top 5 results
+                .map((r, i) => {
+                const parts = [`${i + 1}. **${r.title}**`];
+                // Include snippet/content if available
+                if (r.content?.trim()) {
+                    parts.push(`   ${r.content.trim()}`);
+                }
+                // Always include the source URL
+                parts.push(`   Source: ${r.url}`);
+                // Optionally include relevance score if available
+                if (r.score !== undefined) {
+                    parts.push(`   Relevance: ${(r.score * 100).toFixed(0)}%`);
+                }
+                // Optionally include publish date if available
+                if (r.publishedDate) {
+                    parts.push(`   Published: ${r.publishedDate}`);
+                }
+                return parts.join('\n');
+            })
+                .join('\n\n');
+            // Add a note about using web_fetch for detailed content
+            if (content) {
+                content +=
+                    '\n\n*Note: For detailed content from any source above, use the web_fetch tool with the URL.*';
+            }
+        }
+        else {
+            // When answer is available, append sources section
+            content = buildContentWithSources(content, sources);
+        }
+        return { content, sources };
+    }
+    async execute(signal) {
+        // Check if web search is configured
+        const webSearchConfig = this.config.getWebSearchConfig();
+        if (!webSearchConfig) {
+            return {
+                llmContent: 'Web search is disabled. Please configure a web search provider in your settings.',
+                returnDisplay: 'Web search is disabled.',
+                error: {
+                    message: 'Web search is disabled',
+                    type: ToolErrorType.EXECUTION_FAILED,
+                },
+            };
+        }
+        try {
+            // Create and select provider
+            const providers = this.createProviders(webSearchConfig.provider);
+            const provider = this.selectProvider(providers, this.params.provider, webSearchConfig.default);
+            // Perform search
+            const searchResult = await provider.search(this.params.query, signal);
+            const { content, sources } = this.formatSearchResults(searchResult);
+            // Guard: Check if we got results
+            if (!content.trim()) {
+                return {
+                    llmContent: `No search results found for query: "${this.params.query}" (via ${provider.name})`,
+                    returnDisplay: `No information found for "${this.params.query}".`,
+                };
+            }
+            // Success result
+            return {
+                llmContent: `Web search results for "${this.params.query}" (via ${provider.name}):\n\n${content}`,
+                returnDisplay: `Search results for "${this.params.query}".`,
+                sources,
+            };
+        }
+        catch (error) {
+            const errorMessage = `Error during web search: ${getErrorMessage(error)}`;
+            console.error(errorMessage, error);
+            return {
+                llmContent: errorMessage,
+                returnDisplay: 'Error performing web search.',
+                error: {
+                    message: errorMessage,
+                    type: ToolErrorType.EXECUTION_FAILED,
+                },
+            };
+        }
+    }
+}
+/**
+ * A tool to perform web searches using configurable providers.
+ */
+export class WebSearchTool extends BaseDeclarativeTool {
+    config;
+    static Name = ToolNames.WEB_SEARCH;
+    constructor(config) {
+        super(WebSearchTool.Name, ToolDisplayNames.WEB_SEARCH, 'Allows searching the web and using results to inform responses. Provides up-to-date information for current events and recent data beyond the training data cutoff. Returns search results formatted with concise answers and source links. Use this tool when accessing information that may be outdated or beyond the knowledge cutoff.', Kind.Search, {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'The search query to find information on the web.',
+                },
+                provider: {
+                    type: 'string',
+                    description: 'Optional provider to use for the search (e.g., "tavily", "google", "dashscope"). IMPORTANT: Only specify this parameter if you explicitly know which provider to use. Otherwise, omit this parameter entirely and let the system automatically select the appropriate provider based on availability and configuration. The system will choose the best available provider automatically.',
+                },
+            },
+            required: ['query'],
+        });
+        this.config = config;
+    }
+    /**
+     * Validates the parameters for the WebSearchTool.
+     * @param params The parameters to validate
+     * @returns An error message string if validation fails, null if valid
+     */
+    validateToolParamValues(params) {
+        if (!params.query || params.query.trim() === '') {
+            return "The 'query' parameter cannot be empty.";
+        }
+        // Validate provider parameter if provided
+        if (params.provider !== undefined && params.provider.trim() === '') {
+            return "The 'provider' parameter cannot be empty if specified.";
+        }
+        return null;
+    }
+    createInvocation(params) {
+        return new WebSearchToolInvocation(this.config, params);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/tools/web-search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/web-search/index.ts"],"names":[],"mappings":"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"}

package/dist/src/tools/web-search/index.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/tools/web-search/index.test.js

@@ -0,0 +1,237 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { WebSearchTool } from './index.js';
+import { ApprovalMode } from '../../config/config.js';
+describe('WebSearchTool', () => {
+    let mockConfig;
+    beforeEach(() => {
+        vi.resetAllMocks();
+        mockConfig = {
+            getApprovalMode: vi.fn(() => ApprovalMode.AUTO_EDIT),
+            setApprovalMode: vi.fn(),
+            getWebSearchConfig: vi.fn(),
+        };
+    });
+    describe('formatSearchResults', () => {
+        it('should use answer when available and append sources', async () => {
+            const webSearchConfig = {
+                provider: [
+                    {
+                        type: 'tavily',
+                        apiKey: 'test-key',
+                    },
+                ],
+                default: 'tavily',
+            };
+            mockConfig.getWebSearchConfig.mockReturnValue(webSearchConfig);
+            // Mock fetch to return search results with answer
+            global.fetch = vi.fn().mockResolvedValue({
+                ok: true,
+                json: async () => ({
+                    query: 'test query',
+                    answer: 'This is a concise answer from the search provider.',
+                    results: [
+                        {
+                            title: 'Result 1',
+                            url: 'https://example.com/1',
+                            content: 'Content 1',
+                        },
+                        {
+                            title: 'Result 2',
+                            url: 'https://example.com/2',
+                            content: 'Content 2',
+                        },
+                    ],
+                }),
+            });
+            const tool = new WebSearchTool(mockConfig);
+            const invocation = tool.build({ query: 'test query' });
+            const result = await invocation.execute(new AbortController().signal);
+            expect(result.llmContent).toContain('This is a concise answer from the search provider.');
+            expect(result.llmContent).toContain('Sources:');
+            expect(result.llmContent).toContain('[1] Result 1 (https://example.com/1)');
+            expect(result.llmContent).toContain('[2] Result 2 (https://example.com/2)');
+        });
+        it('should build informative summary when answer is not available', async () => {
+            const webSearchConfig = {
+                provider: [
+                    {
+                        type: 'google',
+                        apiKey: 'test-key',
+                        searchEngineId: 'test-engine',
+                    },
+                ],
+                default: 'google',
+            };
+            mockConfig.getWebSearchConfig.mockReturnValue(webSearchConfig);
+            // Mock fetch to return search results without answer
+            global.fetch = vi.fn().mockResolvedValue({
+                ok: true,
+                json: async () => ({
+                    items: [
+                        {
+                            title: 'Google Result 1',
+                            link: 'https://example.com/1',
+                            snippet: 'This is a helpful snippet from the first result.',
+                        },
+                        {
+                            title: 'Google Result 2',
+                            link: 'https://example.com/2',
+                            snippet: 'This is a helpful snippet from the second result.',
+                        },
+                    ],
+                }),
+            });
+            const tool = new WebSearchTool(mockConfig);
+            const invocation = tool.build({ query: 'test query' });
+            const result = await invocation.execute(new AbortController().signal);
+            // Should contain formatted results with title, snippet, and source
+            expect(result.llmContent).toContain('1. **Google Result 1**');
+            expect(result.llmContent).toContain('This is a helpful snippet from the first result.');
+            expect(result.llmContent).toContain('Source: https://example.com/1');
+            expect(result.llmContent).toContain('2. **Google Result 2**');
+            expect(result.llmContent).toContain('This is a helpful snippet from the second result.');
+            expect(result.llmContent).toContain('Source: https://example.com/2');
+            // Should include web_fetch hint
+            expect(result.llmContent).toContain('web_fetch tool');
+        });
+        it('should include optional fields when available', async () => {
+            const webSearchConfig = {
+                provider: [
+                    {
+                        type: 'tavily',
+                        apiKey: 'test-key',
+                    },
+                ],
+                default: 'tavily',
+            };
+            mockConfig.getWebSearchConfig.mockReturnValue(webSearchConfig);
+            // Mock fetch to return results with score and publishedDate
+            global.fetch = vi.fn().mockResolvedValue({
+                ok: true,
+                json: async () => ({
+                    query: 'test query',
+                    results: [
+                        {
+                            title: 'Result with metadata',
+                            url: 'https://example.com',
+                            content: 'Content with metadata',
+                            score: 0.95,
+                            published_date: '2024-01-15',
+                        },
+                    ],
+                }),
+            });
+            const tool = new WebSearchTool(mockConfig);
+            const invocation = tool.build({ query: 'test query' });
+            const result = await invocation.execute(new AbortController().signal);
+            // Should include relevance score
+            expect(result.llmContent).toContain('Relevance: 95%');
+            // Should include published date
+            expect(result.llmContent).toContain('Published: 2024-01-15');
+        });
+        it('should handle empty results gracefully', async () => {
+            const webSearchConfig = {
+                provider: [
+                    {
+                        type: 'google',
+                        apiKey: 'test-key',
+                        searchEngineId: 'test-engine',
+                    },
+                ],
+                default: 'google',
+            };
+            mockConfig.getWebSearchConfig.mockReturnValue(webSearchConfig);
+            // Mock fetch to return empty results
+            global.fetch = vi.fn().mockResolvedValue({
+                ok: true,
+                json: async () => ({
+                    items: [],
+                }),
+            });
+            const tool = new WebSearchTool(mockConfig);
+            const invocation = tool.build({ query: 'test query' });
+            const result = await invocation.execute(new AbortController().signal);
+            expect(result.llmContent).toContain('No search results found');
+        });
+        it('should limit to top 5 results in fallback mode', async () => {
+            const webSearchConfig = {
+                provider: [
+                    {
+                        type: 'google',
+                        apiKey: 'test-key',
+                        searchEngineId: 'test-engine',
+                    },
+                ],
+                default: 'google',
+            };
+            mockConfig.getWebSearchConfig.mockReturnValue(webSearchConfig);
+            // Mock fetch to return 10 results
+            const items = Array.from({ length: 10 }, (_, i) => ({
+                title: `Result ${i + 1}`,
+                link: `https://example.com/${i + 1}`,
+                snippet: `Snippet ${i + 1}`,
+            }));
+            global.fetch = vi.fn().mockResolvedValue({
+                ok: true,
+                json: async () => ({ items }),
+            });
+            const tool = new WebSearchTool(mockConfig);
+            const invocation = tool.build({ query: 'test query' });
+            const result = await invocation.execute(new AbortController().signal);
+            // Should only contain first 5 results
+            expect(result.llmContent).toContain('1. **Result 1**');
+            expect(result.llmContent).toContain('5. **Result 5**');
+            expect(result.llmContent).not.toContain('6. **Result 6**');
+            expect(result.llmContent).not.toContain('10. **Result 10**');
+        });
+    });
+    describe('validation', () => {
+        it('should throw validation error when query is empty', () => {
+            const tool = new WebSearchTool(mockConfig);
+            expect(() => tool.build({ query: '' })).toThrow("The 'query' parameter cannot be empty");
+        });
+        it('should throw validation error when provider is empty string', () => {
+            const tool = new WebSearchTool(mockConfig);
+            expect(() => tool.build({ query: 'test', provider: '' })).toThrow("The 'provider' parameter cannot be empty");
+        });
+    });
+    describe('configuration', () => {
+        it('should return error when web search is not configured', async () => {
+            mockConfig.getWebSearchConfig.mockReturnValue(null);
+            const tool = new WebSearchTool(mockConfig);
+            const invocation = tool.build({ query: 'test query' });
+            const result = await invocation.execute(new AbortController().signal);
+            expect(result.error?.message).toContain('Web search is disabled');
+            expect(result.llmContent).toContain('Web search is disabled');
+        });
+        it('should return descriptive message in getDescription when web search is not configured', () => {
+            mockConfig.getWebSearchConfig.mockReturnValue(null);
+            const tool = new WebSearchTool(mockConfig);
+            const invocation = tool.build({ query: 'test query' });
+            const description = invocation.getDescription();
+            expect(description).toBe(' (Web search is disabled - configure a provider in settings.json)');
+        });
+        it('should return provider name in getDescription when web search is configured', () => {
+            const webSearchConfig = {
+                provider: [
+                    {
+                        type: 'tavily',
+                        apiKey: 'test-key',
+                    },
+                ],
+                default: 'tavily',
+            };
+            mockConfig.getWebSearchConfig.mockReturnValue(webSearchConfig);
+            const tool = new WebSearchTool(mockConfig);
+            const invocation = tool.build({ query: 'test query' });
+            const description = invocation.getDescription();
+            expect(description).toBe(' (Searching the web via tavily)');
+        });
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/src/tools/web-search/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../../src/tools/web-search/index.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAI,UAAkB,CAAC;IAEvB,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,UAAU,GAAG;YACX,eAAe,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC;YACpD,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE;YACxB,kBAAkB,EAAE,EAAE,CAAC,EAAE,EAAE;SACP,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;YACnE,MAAM,eAAe,GAAoB;gBACvC,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,QAAQ;wBACd,MAAM,EAAE,UAAU;qBACnB;iBACF;gBACD,OAAO,EAAE,QAAQ;aAClB,CAAC;YAGA,UAAU,CAAC,kBACZ,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;YAEnC,kDAAkD;YAClD,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;gBACvC,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;oBACjB,KAAK,EAAE,YAAY;oBACnB,MAAM,EAAE,oDAAoD;oBAC5D,OAAO,EAAE;wBACP;4BACE,KAAK,EAAE,UAAU;4BACjB,GAAG,EAAE,uBAAuB;4BAC5B,OAAO,EAAE,WAAW;yBACrB;wBACD;4BACE,KAAK,EAAE,UAAU;4BACjB,GAAG,EAAE,uBAAuB;4BAC5B,OAAO,EAAE,WAAW;yBACrB;qBACF;iBACF,CAAC;aACH,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;YAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC;YAEtE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CACjC,oDAAoD,CACrD,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YAChD,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CACjC,sCAAsC,CACvC,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CACjC,sCAAsC,CACvC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;YAC7E,MAAM,eAAe,GAAoB;gBACvC,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,QAAQ;wBACd,MAAM,EAAE,UAAU;wBAClB,cAAc,EAAE,aAAa;qBAC9B;iBACF;gBACD,OAAO,EAAE,QAAQ;aAClB,CAAC;YAGA,UAAU,CAAC,kBACZ,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;YAEnC,qDAAqD;YACrD,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;gBACvC,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;oBACjB,KAAK,EAAE;wBACL;4BACE,KAAK,EAAE,iBAAiB;4BACxB,IAAI,EAAE,uBAAuB;4BAC7B,OAAO,EAAE,kDAAkD;yBAC5D;wBACD;4BACE,KAAK,EAAE,iBAAiB;4BACxB,IAAI,EAAE,uBAAuB;4BAC7B,OAAO,EAAE,mDAAmD;yBAC7D;qBACF;iBACF,CAAC;aACH,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;YAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC;YAEtE,mEAAmE;YACnE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;YAC9D,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CACjC,kDAAkD,CACnD,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,+BAA+B,CAAC,CAAC;YACrE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;YAC9D,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CACjC,mDAAmD,CACpD,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,+BAA+B,CAAC,CAAC;YAErE,gCAAgC;YAChC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;YAC7D,MAAM,eAAe,GAAoB;gBACvC,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,QAAQ;wBACd,MAAM,EAAE,UAAU;qBACnB;iBACF;gBACD,OAAO,EAAE,QAAQ;aAClB,CAAC;YAGA,UAAU,CAAC,kBACZ,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;YAEnC,4DAA4D;YAC5D,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;gBACvC,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;oBACjB,KAAK,EAAE,YAAY;oBACnB,OAAO,EAAE;wBACP;4BACE,KAAK,EAAE,sBAAsB;4BAC7B,GAAG,EAAE,qBAAqB;4BAC1B,OAAO,EAAE,uBAAuB;4BAChC,KAAK,EAAE,IAAI;4BACX,cAAc,EAAE,YAAY;yBAC7B;qBACF;iBACF,CAAC;aACH,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;YAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC;YAEtE,iCAAiC;YACjC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;YACtD,gCAAgC;YAChC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;YACtD,MAAM,eAAe,GAAoB;gBACvC,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,QAAQ;wBACd,MAAM,EAAE,UAAU;wBAClB,cAAc,EAAE,aAAa;qBAC9B;iBACF;gBACD,OAAO,EAAE,QAAQ;aAClB,CAAC;YAGA,UAAU,CAAC,kBACZ,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;YAEnC,qCAAqC;YACrC,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;gBACvC,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;oBACjB,KAAK,EAAE,EAAE;iBACV,CAAC;aACH,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;YAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC;YAEtE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;YAC9D,MAAM,eAAe,GAAoB;gBACvC,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,QAAQ;wBACd,MAAM,EAAE,UAAU;wBAClB,cAAc,EAAE,aAAa;qBAC9B;iBACF;gBACD,OAAO,EAAE,QAAQ;aAClB,CAAC;YAGA,UAAU,CAAC,kBACZ,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;YAEnC,kCAAkC;YAClC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBAClD,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE;gBACxB,IAAI,EAAE,uBAAuB,CAAC,GAAG,CAAC,EAAE;gBACpC,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE;aAC5B,CAAC,CAAC,CAAC;YAEJ,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;gBACvC,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;aAC9B,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;YAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC;YAEtE,sCAAsC;YACtC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;YACvD,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;YACvD,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;YAC3D,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;YAC3D,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;YAC3C,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAC7C,uCAAuC,CACxC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;YACrE,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;YAC3C,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAC/D,0CAA0C,CAC3C,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;YAEnE,UAAU,CAAC,kBACZ,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YAExB,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;YAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC;YAEtE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;YAClE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uFAAuF,EAAE,GAAG,EAAE;YAE7F,UAAU,CAAC,kBACZ,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YAExB,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;YAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YACvD,MAAM,WAAW,GAAG,UAAU,CAAC,cAAc,EAAE,CAAC;YAEhD,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CACtB,mEAAmE,CACpE,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;YACrF,MAAM,eAAe,GAAoB;gBACvC,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,QAAQ;wBACd,MAAM,EAAE,UAAU;qBACnB;iBACF;gBACD,OAAO,EAAE,QAAQ;aAClB,CAAC;YAGA,UAAU,CAAC,kBACZ,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;YAEnC,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;YAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;YACvD,MAAM,WAAW,GAAG,UAAU,CAAC,cAAc,EAAE,CAAC;YAEhD,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/tools/web-search/providers/dashscope-provider.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseWebSearchProvider } from '../base-provider.js';
+import type { WebSearchResult, DashScopeProviderConfig } from '../types.js';
+/**
+ * Web search provider using Alibaba Cloud DashScope API.
+ */
+export declare class DashScopeProvider extends BaseWebSearchProvider {
+    private readonly config;
+    readonly name = "DashScope";
+    constructor(config: DashScopeProviderConfig);
+    isAvailable(): boolean;
+    /**
+     * Get the access token and API endpoint for authentication and web search.
+     * Tries OAuth credentials first, falls back to apiKey if OAuth is not available.
+     * Returns both token and endpoint to avoid loading credentials multiple times.
+     */
+    private getAuthConfig;
+    protected performSearch(query: string, signal: AbortSignal): Promise<WebSearchResult>;
+}