@hibanacloud/core 0.3.15

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

@@ -0,0 +1,120 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { promises as fs } from 'node:fs';
+import * as os from 'os';
+import * as path from 'path';
+import { BaseWebSearchProvider } from '../base-provider.js';
+// File System Configuration
+const QWEN_DIR = '.qwen';
+const QWEN_CREDENTIAL_FILENAME = 'oauth_creds.json';
+/**
+ * Get the path to the cached OAuth credentials file.
+ */
+function getQwenCachedCredentialPath() {
+    return path.join(os.homedir(), QWEN_DIR, QWEN_CREDENTIAL_FILENAME);
+}
+/**
+ * Load cached Qwen OAuth credentials from disk.
+ */
+async function loadQwenCredentials() {
+    try {
+        const keyFile = getQwenCachedCredentialPath();
+        const creds = await fs.readFile(keyFile, 'utf-8');
+        return JSON.parse(creds);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Web search provider using Alibaba Cloud DashScope API.
+ */
+export class DashScopeProvider extends BaseWebSearchProvider {
+    config;
+    name = 'DashScope';
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    isAvailable() {
+        // DashScope provider is only available when auth type is QWEN_OAUTH
+        // This ensures it's only used when OAuth credentials are available
+        return this.config.authType === 'qwen-oauth';
+    }
+    /**
+     * 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.
+     */
+    async getAuthConfig() {
+        // Load credentials once
+        const credentials = await loadQwenCredentials();
+        // Get access token: try OAuth credentials first, fallback to apiKey
+        let accessToken = null;
+        if (credentials?.access_token) {
+            // Check if token is not expired
+            if (credentials.expiry_date && credentials.expiry_date > Date.now()) {
+                accessToken = credentials.access_token;
+            }
+        }
+        if (!accessToken) {
+            accessToken = this.config.apiKey || null;
+        }
+        // Get API endpoint: use resource_url from credentials
+        if (!credentials?.resource_url) {
+            throw new Error('No resource_url found in credentials. Please authenticate using OAuth');
+        }
+        // Normalize the URL: add protocol if missing
+        const baseUrl = credentials.resource_url.startsWith('http')
+            ? credentials.resource_url
+            : `https://${credentials.resource_url}`;
+        // Remove trailing slash if present
+        const normalizedBaseUrl = baseUrl.replace(/\/$/, '');
+        const apiEndpoint = `${normalizedBaseUrl}/api/v1/indices/plugin/web_search`;
+        return { accessToken, apiEndpoint };
+    }
+    async performSearch(query, signal) {
+        // Get access token and API endpoint (loads credentials once)
+        const { accessToken, apiEndpoint } = await this.getAuthConfig();
+        if (!accessToken) {
+            throw new Error('No access token available. Please authenticate using OAuth');
+        }
+        const requestBody = {
+            uq: query,
+            page: 1,
+            rows: this.config.maxResults || 10,
+        };
+        const response = await fetch(apiEndpoint, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${accessToken}`,
+            },
+            body: JSON.stringify(requestBody),
+            signal,
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            throw new Error(`API error: ${response.status} ${response.statusText}${text ? ` - ${text}` : ''}`);
+        }
+        const data = (await response.json());
+        if (data.status !== 0) {
+            throw new Error(`API error: ${data.message || 'Unknown error'}`);
+        }
+        const results = (data.data?.docs || []).map((item) => ({
+            title: item.title,
+            url: item.url,
+            content: item.snippet,
+            score: item._score,
+            publishedDate: item.timestamp_format,
+        }));
+        return {
+            query,
+            results,
+        };
+    }
+}
+//# sourceMappingURL=dashscope-provider.js.map

package/dist/src/tools/web-search/providers/dashscope-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashscope-provider.js","sourceRoot":"","sources":["../../../../../src/tools/web-search/providers/dashscope-provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAmD5D,4BAA4B;AAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC;AACzB,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AAEpD;;GAEG;AACH,SAAS,2BAA2B;IAClC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,wBAAwB,CAAC,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,mBAAmB;IAChC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,2BAA2B,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAoB,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,qBAAqB;IAG7B;IAFpB,IAAI,GAAG,WAAW,CAAC;IAE5B,YAA6B,MAA+B;QAC1D,KAAK,EAAE,CAAC;QADmB,WAAM,GAAN,MAAM,CAAyB;IAE5D,CAAC;IAED,WAAW;QACT,oEAAoE;QACpE,mEAAmE;QACnE,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,YAAY,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,aAAa;QAIzB,wBAAwB;QACxB,MAAM,WAAW,GAAG,MAAM,mBAAmB,EAAE,CAAC;QAEhD,oEAAoE;QACpE,IAAI,WAAW,GAAkB,IAAI,CAAC;QACtC,IAAI,WAAW,EAAE,YAAY,EAAE,CAAC;YAC9B,gCAAgC;YAChC,IAAI,WAAW,CAAC,WAAW,IAAI,WAAW,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBACpE,WAAW,GAAG,WAAW,CAAC,YAAY,CAAC;YACzC,CAAC;QACH,CAAC;QACD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC;QAC3C,CAAC;QAED,sDAAsD;QACtD,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,uEAAuE,CACxE,CAAC;QACJ,CAAC;QAED,6CAA6C;QAC7C,MAAM,OAAO,GAAG,WAAW,CAAC,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC;YACzD,CAAC,CAAC,WAAW,CAAC,YAAY;YAC1B,CAAC,CAAC,WAAW,WAAW,CAAC,YAAY,EAAE,CAAC;QAC1C,mCAAmC;QACnC,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrD,MAAM,WAAW,GAAG,GAAG,iBAAiB,mCAAmC,CAAC;QAE5E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;IACtC,CAAC;IAES,KAAK,CAAC,aAAa,CAC3B,KAAa,EACb,MAAmB;QAEnB,6DAA6D;QAC7D,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAChE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG;YAClB,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE;SACnC,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,WAAW,EAAE;YACxC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,WAAW,EAAE;aACvC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;YACjC,MAAM;SACP,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,cAAc,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAClF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA4B,CAAC;QAEhE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,OAAO,GAA0B,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAChE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACT,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,aAAa,EAAE,IAAI,CAAC,gBAAgB;SACrC,CAAC,CACH,CAAC;QAEF,OAAO;YACL,KAAK;YACL,OAAO;SACR,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseWebSearchProvider } from '../base-provider.js';
+import type { WebSearchResult, GoogleProviderConfig } from '../types.js';
+/**
+ * Web search provider using Google Custom Search API.
+ */
+export declare class GoogleProvider extends BaseWebSearchProvider {
+    private readonly config;
+    readonly name = "Google";
+    constructor(config: GoogleProviderConfig);
+    isAvailable(): boolean;
+    protected performSearch(query: string, signal: AbortSignal): Promise<WebSearchResult>;
+}

package/dist/src/tools/web-search/providers/google-provider.js

@@ -0,0 +1,55 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseWebSearchProvider } from '../base-provider.js';
+/**
+ * Web search provider using Google Custom Search API.
+ */
+export class GoogleProvider extends BaseWebSearchProvider {
+    config;
+    name = 'Google';
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    isAvailable() {
+        return !!(this.config.apiKey && this.config.searchEngineId);
+    }
+    async performSearch(query, signal) {
+        const params = new URLSearchParams({
+            key: this.config.apiKey,
+            cx: this.config.searchEngineId,
+            q: query,
+            num: String(this.config.maxResults || 10),
+            safe: this.config.safeSearch || 'medium',
+        });
+        if (this.config.language) {
+            params.append('lr', `lang_${this.config.language}`);
+        }
+        if (this.config.country) {
+            params.append('cr', `country${this.config.country}`);
+        }
+        const url = `https://www.googleapis.com/customsearch/v1?${params.toString()}`;
+        const response = await fetch(url, {
+            method: 'GET',
+            signal,
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            throw new Error(`API error: ${response.status} ${response.statusText}${text ? ` - ${text}` : ''}`);
+        }
+        const data = (await response.json());
+        const results = (data.items || []).map((item) => ({
+            title: item.title,
+            url: item.link,
+            content: item.snippet,
+        }));
+        return {
+            query,
+            results,
+        };
+    }
+}
+//# sourceMappingURL=google-provider.js.map

package/dist/src/tools/web-search/providers/google-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-provider.js","sourceRoot":"","sources":["../../../../../src/tools/web-search/providers/google-provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAuB5D;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,qBAAqB;IAG1B;IAFpB,IAAI,GAAG,QAAQ,CAAC;IAEzB,YAA6B,MAA4B;QACvD,KAAK,EAAE,CAAC;QADmB,WAAM,GAAN,MAAM,CAAsB;IAEzD,CAAC;IAED,WAAW;QACT,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAC9D,CAAC;IAES,KAAK,CAAC,aAAa,CAC3B,KAAa,EACb,MAAmB;QAEnB,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;YACjC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,MAAO;YACxB,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,cAAe;YAC/B,CAAC,EAAE,KAAK;YACR,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;YACzC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,QAAQ;SACzC,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACzB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtD,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,GAAG,GAAG,8CAA8C,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;QAE9E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,KAAK;YACb,MAAM;SACP,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,cAAc,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAClF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAyB,CAAC;QAE7D,MAAM,OAAO,GAA0B,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACvE,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,IAAI,CAAC,IAAI;YACd,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,KAAK;YACL,OAAO;SACR,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseWebSearchProvider } from '../base-provider.js';
+import type { WebSearchResult, TavilyProviderConfig } from '../types.js';
+/**
+ * Web search provider using Tavily API.
+ */
+export declare class TavilyProvider extends BaseWebSearchProvider {
+    private readonly config;
+    readonly name = "Tavily";
+    constructor(config: TavilyProviderConfig);
+    isAvailable(): boolean;
+    protected performSearch(query: string, signal: AbortSignal): Promise<WebSearchResult>;
+}

package/dist/src/tools/web-search/providers/tavily-provider.js

@@ -0,0 +1,54 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseWebSearchProvider } from '../base-provider.js';
+/**
+ * Web search provider using Tavily API.
+ */
+export class TavilyProvider extends BaseWebSearchProvider {
+    config;
+    name = 'Tavily';
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    isAvailable() {
+        return !!this.config.apiKey;
+    }
+    async performSearch(query, signal) {
+        const response = await fetch('https://api.tavily.com/search', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                api_key: this.config.apiKey,
+                query,
+                search_depth: this.config.searchDepth || 'advanced',
+                max_results: this.config.maxResults || 5,
+                include_answer: this.config.includeAnswer !== false,
+            }),
+            signal,
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            throw new Error(`API error: ${response.status} ${response.statusText}${text ? ` - ${text}` : ''}`);
+        }
+        const data = (await response.json());
+        const results = (data.results || []).map((r) => ({
+            title: r.title,
+            url: r.url,
+            content: r.content,
+            score: r.score,
+            publishedDate: r.published_date,
+        }));
+        return {
+            query,
+            answer: data.answer?.trim(),
+            results,
+        };
+    }
+}
+//# sourceMappingURL=tavily-provider.js.map

package/dist/src/tools/web-search/providers/tavily-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tavily-provider.js","sourceRoot":"","sources":["../../../../../src/tools/web-search/providers/tavily-provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAqB5D;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,qBAAqB;IAG1B;IAFpB,IAAI,GAAG,QAAQ,CAAC;IAEzB,YAA6B,MAA4B;QACvD,KAAK,EAAE,CAAC;QADmB,WAAM,GAAN,MAAM,CAAsB;IAEzD,CAAC;IAED,WAAW;QACT,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC9B,CAAC;IAES,KAAK,CAAC,aAAa,CAC3B,KAAa,EACb,MAAmB;QAEnB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,+BAA+B,EAAE;YAC5D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;gBAC3B,KAAK;gBACL,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,UAAU;gBACnD,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC;gBACxC,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa,KAAK,KAAK;aACpD,CAAC;YACF,MAAM;SACP,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,cAAc,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAClF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAyB,CAAC;QAE7D,MAAM,OAAO,GAA0B,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtE,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,aAAa,EAAE,CAAC,CAAC,cAAc;SAChC,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,KAAK;YACL,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE;YAC3B,OAAO;SACR,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,138 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ToolResult } from '../tools.js';
+/**
+ * Common interface for all web search providers.
+ */
+export interface WebSearchProvider {
+    /**
+     * The name of the provider.
+     */
+    readonly name: string;
+    /**
+     * Whether the provider is available (has required configuration).
+     */
+    isAvailable(): boolean;
+    /**
+     * Perform a web search with the given query.
+     * @param query The search query
+     * @param signal Abort signal for cancellation
+     * @returns Promise resolving to search results
+     */
+    search(query: string, signal: AbortSignal): Promise<WebSearchResult>;
+}
+/**
+ * Result item from a web search.
+ */
+export interface WebSearchResultItem {
+    title: string;
+    url: string;
+    content?: string;
+    score?: number;
+    publishedDate?: string;
+}
+/**
+ * Result from a web search operation.
+ */
+export interface WebSearchResult {
+    /**
+     * The search query that was executed.
+     */
+    query: string;
+    /**
+     * A concise answer if available from the provider.
+     */
+    answer?: string;
+    /**
+     * List of search result items.
+     */
+    results: WebSearchResultItem[];
+    /**
+     * Provider-specific metadata.
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Extended tool result that includes sources for web search.
+ */
+export interface WebSearchToolResult extends ToolResult {
+    sources?: Array<{
+        title: string;
+        url: string;
+    }>;
+}
+/**
+ * Parameters for the WebSearchTool.
+ */
+export interface WebSearchToolParams {
+    /**
+     * The search query.
+     */
+    query: string;
+    /**
+     * Optional provider to use for the search.
+     * If not specified, the default provider will be used.
+     */
+    provider?: string;
+}
+/**
+ * Configuration for web search providers.
+ */
+export interface WebSearchConfig {
+    /**
+     * List of available providers with their configurations.
+     */
+    provider: WebSearchProviderConfig[];
+    /**
+     * The default provider to use.
+     */
+    default: string;
+}
+/**
+ * Base configuration for Tavily provider.
+ */
+export interface TavilyProviderConfig {
+    type: 'tavily';
+    apiKey?: string;
+    searchDepth?: 'basic' | 'advanced';
+    maxResults?: number;
+    includeAnswer?: boolean;
+}
+/**
+ * Base configuration for Google provider.
+ */
+export interface GoogleProviderConfig {
+    type: 'google';
+    apiKey?: string;
+    searchEngineId?: string;
+    maxResults?: number;
+    safeSearch?: 'off' | 'medium' | 'high';
+    language?: string;
+    country?: string;
+}
+/**
+ * Base configuration for DashScope provider.
+ */
+export interface DashScopeProviderConfig {
+    type: 'dashscope';
+    apiKey?: string;
+    uid?: string;
+    appId?: string;
+    maxResults?: number;
+    scene?: string;
+    timeout?: number;
+    /**
+     * Optional auth type to determine provider availability.
+     * If set to 'qwen-oauth', the provider will be available.
+     * If set to other values or undefined, the provider will check auth type dynamically.
+     */
+    authType?: string;
+}
+/**
+ * Discriminated union type for web search provider configurations.
+ * This ensures type safety when working with different provider configs.
+ */
+export type WebSearchProviderConfig = TavilyProviderConfig | GoogleProviderConfig | DashScopeProviderConfig;

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

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/tools/web-search/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

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

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Utility functions for web search formatting and processing.
+ */
+/**
+ * Build content string with appended sources section.
+ * @param content Main content text
+ * @param sources Array of source objects
+ * @returns Combined content with sources
+ */
+export declare function buildContentWithSources(content: string, sources: Array<{
+    title: string;
+    url: string;
+}>): string;
+/**
+ * Build a concise summary from top search results.
+ * @param sources Array of source objects
+ * @param maxResults Maximum number of results to include
+ * @returns Concise summary string
+ */
+export declare function buildSummary(sources: Array<{
+    title: string;
+    url: string;
+}>, maxResults?: number): string;

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

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Utility functions for web search formatting and processing.
+ */
+/**
+ * Build content string with appended sources section.
+ * @param content Main content text
+ * @param sources Array of source objects
+ * @returns Combined content with sources
+ */
+export function buildContentWithSources(content, sources) {
+    if (!sources.length)
+        return content;
+    const sourceList = sources
+        .map((s, i) => `[${i + 1}] ${s.title || 'Untitled'} (${s.url})`)
+        .join('\n');
+    return `${content}\n\nSources:\n${sourceList}`;
+}
+/**
+ * Build a concise summary from top search results.
+ * @param sources Array of source objects
+ * @param maxResults Maximum number of results to include
+ * @returns Concise summary string
+ */
+export function buildSummary(sources, maxResults = 3) {
+    return sources
+        .slice(0, maxResults)
+        .map((s, i) => `${i + 1}. ${s.title} - ${s.url}`)
+        .join('\n');
+}
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/tools/web-search/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,OAA8C;IAE9C,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC;IACpC,MAAM,UAAU,GAAG,OAAO;SACvB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,UAAU,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC;SAC/D,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,GAAG,OAAO,iBAAiB,UAAU,EAAE,CAAC;AACjD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,OAA8C,EAC9C,aAAqB,CAAC;IAEtB,OAAO,OAAO;SACX,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;SACpB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;SAChD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/src/tools/write-file.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+import type { ToolInvocation, ToolResult } from './tools.js';
+import { BaseDeclarativeTool } from './tools.js';
+import type { ModifiableDeclarativeTool, ModifyContext } from './modifiable-tool.js';
+/**
+ * Parameters for the WriteFile tool
+ */
+export interface WriteFileToolParams {
+    /**
+     * The absolute path to the file to write to
+     */
+    file_path: string;
+    /**
+     * The content to write to the file
+     */
+    content: string;
+    /**
+     * Whether the proposed content was modified by the user.
+     */
+    modified_by_user?: boolean;
+    /**
+     * Initially proposed content.
+     */
+    ai_proposed_content?: string;
+}
+interface GetCorrectedFileContentResult {
+    originalContent: string;
+    correctedContent: string;
+    fileExists: boolean;
+    error?: {
+        message: string;
+        code?: string;
+    };
+}
+export declare function getCorrectedFileContent(config: Config, filePath: string, proposedContent: string): Promise<GetCorrectedFileContentResult>;
+/**
+ * Implementation of the WriteFile tool logic
+ */
+export declare class WriteFileTool extends BaseDeclarativeTool<WriteFileToolParams, ToolResult> implements ModifiableDeclarativeTool<WriteFileToolParams> {
+    private readonly config;
+    static readonly Name: string;
+    constructor(config: Config);
+    protected validateToolParamValues(params: WriteFileToolParams): string | null;
+    protected createInvocation(params: WriteFileToolParams): ToolInvocation<WriteFileToolParams, ToolResult>;
+    getModifyContext(_abortSignal: AbortSignal): ModifyContext<WriteFileToolParams>;
+}
+export {};