@aalis/plugin-websearch-serper 0.1.0

package/README.md

@@ -0,0 +1,21 @@
+# @aalis/plugin-websearch-serper
+
+运行时插件
+
+## 角色
+
+运行时插件
+
+## 安装
+
+```bash
+pnpm add @aalis/plugin-websearch-serper
+```
+
+## 文档
+
+详见 [docs/plugins/plugin-websearch-serper.md](../../docs/plugins/plugin-websearch-serper.md)。
+
+## 许可
+
+见仓库根目录 LICENSE。

package/dist/i18n.d.ts

@@ -0,0 +1,4 @@
+import type { I18nResources } from '@aalis/core';
+export declare const DEFAULT_COMPRESSION_PROMPT_ZH = "\u8BF7\u6839\u636E\u7528\u6237\u7684\u641C\u7D22\u610F\u56FE\uFF0C\u5C06\u4EE5\u4E0B\u641C\u7D22\u7ED3\u679C\u538B\u7F29\u6574\u5408\u4E3A\u4E00\u6BB5\u7B80\u6D01\u3001\u51C6\u786E\u3001\u6709\u6761\u7406\u7684\u6458\u8981\u3002\u4FDD\u7559\u5173\u952E\u4E8B\u5B9E\u3001\u6570\u636E\u548C\u6765\u6E90\uFF0C\u53BB\u9664\u91CD\u590D\u548C\u65E0\u5173\u4FE1\u606F\u3002\u7528\u4E2D\u6587\u56DE\u7B54\u3002\n\n\u641C\u7D22\u5173\u952E\u8BCD: {query}\n\n\u641C\u7D22\u7ED3\u679C:\n{results}";
+export declare const i18n: I18nResources;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,eAAO,MAAM,6BAA6B,0eAA8G,CAAC;AAEzJ,eAAO,MAAM,IAAI,EAAE,aAelB,CAAC"}

package/dist/i18n.js

@@ -0,0 +1,18 @@
+export const DEFAULT_COMPRESSION_PROMPT_ZH = '请根据用户的搜索意图，将以下搜索结果压缩整合为一段简洁、准确、有条理的摘要。保留关键事实、数据和来源，去除重复和无关信息。用中文回答。\n\n搜索关键词: {query}\n\n搜索结果:\n{results}';
+export const i18n = {
+    'zh-CN': {
+        'plugin.websearchSerper.displayName': 'Serper 网络搜索',
+        'config.websearchSerper.promptLocale.label': 'Prompt 语言',
+        'config.websearchSerper.promptLocale.description': '默认搜索结果压缩提示词使用的语言。自定义压缩提示词不受此项影响。',
+        'config.websearchSerper.promptLocale.auto': '跟随全局设置',
+        'prompt.websearchSerper.compression': DEFAULT_COMPRESSION_PROMPT_ZH,
+    },
+    'en-US': {
+        'plugin.websearchSerper.displayName': 'Serper Web Search',
+        'config.websearchSerper.promptLocale.label': 'Prompt Language',
+        'config.websearchSerper.promptLocale.description': 'Language used by the default search-result compression prompt. Custom compression prompts are left unchanged.',
+        'config.websearchSerper.promptLocale.auto': 'Follow Global Setting',
+        'prompt.websearchSerper.compression': 'Based on the user\'s search intent, compress and integrate the following search results into a concise, accurate, well-structured summary. Preserve key facts, data, and sources, and remove duplicate or irrelevant information. Answer in English.\n\nSearch query: {query}\n\nSearch results:\n{results}',
+    },
+};
+//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,6BAA6B,GAAG,2GAA2G,CAAC;AAEzJ,MAAM,CAAC,MAAM,IAAI,GAAkB;IACjC,OAAO,EAAE;QACP,oCAAoC,EAAE,aAAa;QACnD,2CAA2C,EAAE,WAAW;QACxD,iDAAiD,EAAE,kCAAkC;QACrF,0CAA0C,EAAE,QAAQ;QACpD,oCAAoC,EAAE,6BAA6B;KACpE;IACD,OAAO,EAAE;QACP,oCAAoC,EAAE,mBAAmB;QACzD,2CAA2C,EAAE,iBAAiB;QAC9D,iDAAiD,EAAE,+GAA+G;QAClK,0CAA0C,EAAE,uBAAuB;QACnE,oCAAoC,EAAE,6SAA6S;KACpV;CACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import type { ConfigSchema, Context } from '@aalis/core';
+import '@aalis/plugin-tools-api';
+export type { WebSearchCapability, WebSearchCapabilityRegistry, WebSearchRequest, WebSearchResponse, WebSearchResult, WebSearchService, } from './types.js';
+export { WebSearchCapabilities } from './types.js';
+export declare const name = "@aalis/plugin-websearch-serper";
+export declare const displayName = "Serper \u7F51\u7EDC\u641C\u7D22";
+export declare const subsystem = "tools";
+export declare const provides: string[];
+export declare const inject: {
+    optional: string[];
+};
+export declare const configSchema: ConfigSchema;
+export declare const defaultConfig: {
+    maxPerMinute: number;
+    maxPerDay: number;
+    maxConcurrent: number;
+    defaultNumResults: number;
+    enableCompression: boolean;
+    compressionPrompt: string;
+};
+export declare function apply(ctx: Context, config: Record<string, unknown>): void;
+declare module '@aalis/core' {
+    interface ServiceTypeMap {
+        'web-search': import('./types.js').WebSearchService;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAOzD,OAAO,yBAAyB,CAAC;AAEjC,YAAY,EACV,mBAAmB,EACnB,2BAA2B,EAC3B,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAInD,eAAO,MAAM,IAAI,mCAAmC,CAAC;AACrD,eAAO,MAAM,WAAW,oCAAgB,CAAC;AACzC,eAAO,MAAM,SAAS,UAAU,CAAC;AACjC,eAAO,MAAM,QAAQ,UAAiB,CAAC;AACvC,eAAO,MAAM,MAAM;;CAElB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,YAuB1B,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;CAOzB,CAAC;AAoKF,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAkNzE;AAGD,OAAO,QAAQ,aAAa,CAAC;IAC3B,UAAU,cAAc;QACtB,YAAY,EAAE,OAAO,YAAY,EAAE,gBAAgB,CAAC;KACrD;CACF"}

package/dist/index.js

@@ -0,0 +1,348 @@
+import { resolveLLMModel } from '@aalis/plugin-llm-api';
+import { useToolService } from '@aalis/plugin-tools-api';
+import { WebSearchCapabilities } from './types.js';
+import '@aalis/plugin-tools-api';
+export { WebSearchCapabilities } from './types.js';
+// ===== 插件元数据 =====
+export const name = '@aalis/plugin-websearch-serper';
+export const displayName = 'Serper 网络搜索';
+export const subsystem = 'tools';
+export const provides = ['web-search'];
+export const inject = {
+    optional: ['llm'],
+};
+export const configSchema = {
+    apiKey: { type: 'string', label: 'Serper API Key', required: true, secret: true, description: 'Serper.dev API 密钥' },
+    maxPerMinute: { type: 'number', label: '每分钟最大次数', default: 10, description: '频率限制：每分钟最多搜索次数' },
+    maxPerDay: { type: 'number', label: '每天最大次数', default: 100, description: '频率限制：每天最多搜索次数' },
+    maxConcurrent: { type: 'number', label: '最大并发', default: 3, description: '同时进行的搜索请求数上限' },
+    defaultNumResults: { type: 'number', label: '默认结果数', default: 5, description: '每次搜索返回的结果条数' },
+    enableCompression: {
+        type: 'boolean',
+        label: '启用搜索结果压缩',
+        default: false,
+        description: '启用后，搜索结果将先经过 LLM 压缩整合后再返回给 Agent，减少 Token 消耗并提升信息质量。',
+    },
+    compressionLLM: {
+        type: 'llm-ref',
+        label: '压缩模型',
+        description: '选择用于压缩搜索结果的模型。留空则使用默认 LLM 提供者。',
+    },
+    compressionPrompt: {
+        type: 'textarea',
+        label: '压缩提示词',
+        default: '',
+        description: '自定义压缩搜索结果的提示词。留空使用默认提示。提示词中可使用 {query} 代表搜索关键词。',
+    },
+};
+export const defaultConfig = {
+    maxPerMinute: 10,
+    maxPerDay: 100,
+    maxConcurrent: 3,
+    defaultNumResults: 5,
+    enableCompression: false,
+    compressionPrompt: '',
+};
+// ===== 速率限制器 =====
+class RateLimiter {
+    maxPerMinute;
+    maxPerDay;
+    maxConcurrent;
+    minuteTimestamps = [];
+    dayTimestamps = [];
+    concurrent = 0;
+    constructor(config) {
+        this.maxPerMinute = config.maxPerMinute;
+        this.maxPerDay = config.maxPerDay;
+        this.maxConcurrent = config.maxConcurrent;
+    }
+    /**
+     * 检查是否可以发起请求，返回 null 表示允许，否则返回拒绝原因
+     */
+    check() {
+        const now = Date.now();
+        // 清理过期记录
+        const oneMinuteAgo = now - 60_000;
+        const oneDayAgo = now - 86_400_000;
+        this.minuteTimestamps = this.minuteTimestamps.filter(t => t > oneMinuteAgo);
+        this.dayTimestamps = this.dayTimestamps.filter(t => t > oneDayAgo);
+        if (this.concurrent >= this.maxConcurrent) {
+            return `已达最大并发数 (${this.maxConcurrent})`;
+        }
+        if (this.minuteTimestamps.length >= this.maxPerMinute) {
+            return `已达每分钟调用上限 (${this.maxPerMinute}/min)`;
+        }
+        if (this.dayTimestamps.length >= this.maxPerDay) {
+            return `已达每日调用上限 (${this.maxPerDay}/day)`;
+        }
+        return null;
+    }
+    acquire() {
+        const now = Date.now();
+        this.minuteTimestamps.push(now);
+        this.dayTimestamps.push(now);
+        this.concurrent++;
+    }
+    release() {
+        this.concurrent = Math.max(0, this.concurrent - 1);
+    }
+    getStatus() {
+        const now = Date.now();
+        const oneMinuteAgo = now - 60_000;
+        const oneDayAgo = now - 86_400_000;
+        return {
+            minuteUsed: this.minuteTimestamps.filter(t => t > oneMinuteAgo).length,
+            minuteLimit: this.maxPerMinute,
+            dayUsed: this.dayTimestamps.filter(t => t > oneDayAgo).length,
+            dayLimit: this.maxPerDay,
+            concurrent: this.concurrent,
+            concurrentLimit: this.maxConcurrent,
+        };
+    }
+}
+async function serperSearch(query, apiKey, numResults) {
+    const response = await fetch('https://google.serper.dev/search', {
+        method: 'POST',
+        headers: {
+            'X-API-KEY': apiKey,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            q: query,
+            num: numResults,
+        }),
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Serper API 错误 (${response.status}): ${text}`);
+    }
+    return (await response.json());
+}
+function formatSearchResults(data) {
+    const parts = [];
+    if (data.answerBox) {
+        const ab = data.answerBox;
+        parts.push(`【直接回答】${ab.answer ?? ab.snippet ?? ab.title ?? ''}`);
+    }
+    if (data.knowledgeGraph) {
+        const kg = data.knowledgeGraph;
+        if (kg.description) {
+            parts.push(`【知识图谱】${kg.title ?? ''}: ${kg.description}`);
+        }
+    }
+    if (data.organic && data.organic.length > 0) {
+        parts.push('【搜索结果】');
+        for (const item of data.organic) {
+            parts.push(`${item.position ?? '-'}. ${item.title}\n   ${item.link}\n   ${item.snippet}`);
+        }
+    }
+    return parts.length > 0 ? parts.join('\n\n') : '未找到搜索结果。';
+}
+/** 将 Serper 原始响应转换为标准 WebSearchResult 数组 */
+function toStandardResults(data) {
+    return (data.organic ?? []).map(item => ({
+        title: item.title,
+        url: item.link,
+        snippet: item.snippet,
+    }));
+}
+// ===== 插件入口 =====
+export function apply(ctx, config) {
+    const cfg = {
+        apiKey: config.apiKey ?? '',
+        maxPerMinute: config.maxPerMinute ?? 10,
+        maxPerDay: config.maxPerDay ?? 100,
+        maxConcurrent: config.maxConcurrent ?? 3,
+        defaultNumResults: config.defaultNumResults ?? 5,
+        enableCompression: config.enableCompression ?? false,
+        compressionLLM: config.compressionLLM &&
+            typeof config.compressionLLM === 'object' &&
+            config.compressionLLM.provider &&
+            config.compressionLLM.model
+            ? config.compressionLLM
+            : undefined,
+        compressionPrompt: config.compressionPrompt ?? '',
+    };
+    if (!cfg.apiKey) {
+        throw new Error('未配置 Serper API Key，网络搜索不可用');
+    }
+    const limiter = new RateLimiter(cfg);
+    const DEFAULT_COMPRESSION_PROMPT = '请根据用户的搜索意图，将以下搜索结果压缩整合为一段简洁、准确、有条理的摘要。' +
+        '保留关键事实、数据和来源，去除重复和无关信息。用中文回答。\n\n' +
+        '搜索关键词: {query}\n\n搜索结果:\n{results}';
+    /** 使用 LLM 压缩搜索结果 */
+    async function compressResults(query, rawResults) {
+        const entry = resolveLLMModel(ctx, cfg.compressionLLM, ['chat']);
+        if (!entry)
+            return rawResults;
+        const promptTemplate = cfg.compressionPrompt || DEFAULT_COMPRESSION_PROMPT;
+        const prompt = promptTemplate.replace('{query}', query).replace('{results}', rawResults);
+        const messages = [{ role: 'user', content: prompt }];
+        try {
+            const response = await entry.instance.chat({
+                messages,
+                maxTokens: 1024,
+            });
+            return response.content?.trim() || rawResults;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            ctx.logger.warn(`搜索结果压缩失败，返回原始结果: ${msg}`);
+            return rawResults;
+        }
+    }
+    ctx.logger.info(`网络搜索已启用 (provider: serper, ` +
+        `限制: ${cfg.maxPerMinute}/min, ${cfg.maxPerDay}/day, ` +
+        `并发: ${cfg.maxConcurrent}` +
+        `${cfg.enableCompression ? ', 压缩: 已启用' : ''})`);
+    // 注册为 web-search 服务，供其他插件消费
+    const serperService = {
+        providerName: 'serper',
+        async search(request) {
+            const num = Math.min(10, Math.max(1, request.numResults ?? cfg.defaultNumResults));
+            const data = await serperSearch(request.query, cfg.apiKey, num);
+            return {
+                query: request.query,
+                results: toStandardResults(data),
+                answer: data.answerBox?.answer ?? data.answerBox?.snippet,
+                raw: data,
+            };
+        },
+    };
+    const { Web, Compression } = WebSearchCapabilities;
+    ctx.provide('web-search', serperService, {
+        capabilities: cfg.enableCompression ? [Web, Compression] : [Web],
+        label: 'Serper',
+    });
+    // 注册工具分组
+    useToolService(ctx).registerGroup({
+        name: 'search',
+        label: '网页搜索',
+        description: '通过 Serper API 搜索互联网获取最新信息',
+    });
+    // 注册搜索工具
+    useToolService(ctx).register({
+        groups: ['search'],
+        definition: {
+            type: 'function',
+            function: {
+                name: 'web_search',
+                strict: true,
+                description: '搜索互联网获取最新信息。以下情况应主动使用，不要等被明确要求才搜索：' +
+                    '(1) 遇到不熟悉的梗、网络用语、表情包、段子、缩写；' +
+                    '(2) 时事新闻、热点事件、最新数据；' +
+                    '(3) 任何拿不准或想核实的事实、人物、作品；' +
+                    '(4) 用户明确要求查询的内容。',
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        query: {
+                            type: 'string',
+                            description: '搜索关键词，应当简洁且有针对性',
+                        },
+                        numResults: {
+                            type: 'number',
+                            description: `返回结果数量，默认 ${cfg.defaultNumResults}，范围 1-10`,
+                        },
+                    },
+                    required: ['query'],
+                    additionalProperties: false,
+                },
+            },
+        },
+        handler: async (args) => {
+            const query = args.query;
+            const numResults = Math.min(10, Math.max(1, args.numResults ?? cfg.defaultNumResults));
+            // 速率限制检查
+            const rejectReason = limiter.check();
+            if (rejectReason) {
+                ctx.logger.warn(`搜索被限流: ${rejectReason}`);
+                return JSON.stringify({
+                    error: `搜索请求被限流: ${rejectReason}`,
+                    status: limiter.getStatus(),
+                });
+            }
+            limiter.acquire();
+            try {
+                ctx.logger.debug(`执行搜索: "${query}" (${numResults} 条结果)`);
+                const data = await serperSearch(query, cfg.apiKey, numResults);
+                let result = formatSearchResults(data);
+                // 压缩整合
+                if (cfg.enableCompression) {
+                    ctx.logger.debug(`压缩搜索结果 (原始长度: ${result.length})`);
+                    result = await compressResults(query, result);
+                    ctx.logger.debug(`压缩完成 (压缩后长度: ${result.length})`);
+                }
+                return result;
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                ctx.logger.error(`搜索失败: ${message}`);
+                return JSON.stringify({ error: `搜索失败: ${message}` });
+            }
+            finally {
+                limiter.release();
+            }
+        },
+    });
+    // 图片搜索工具：返回候选图片 URL 列表，配合 send_attachment 使用
+    useToolService(ctx).register({
+        groups: ['search'],
+        definition: {
+            type: 'function',
+            function: {
+                name: 'search_images',
+                description: '搜索互联网图片，返回候选图片 URL 列表。常与 send_attachment 配合：' +
+                    '先 search_images 拿候选 → 评估缩略图 → 调 send_attachment(kind="image", url) 发出。' +
+                    '适用场景：用户要求"发个 xxx 表情包"、"找张 xxx 的图发我"。',
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        query: { type: 'string', description: '图片搜索关键词。' },
+                        numResults: {
+                            type: 'number',
+                            description: `返回数量，默认 ${cfg.defaultNumResults}，范围 1-10`,
+                        },
+                    },
+                    required: ['query'],
+                },
+            },
+        },
+        handler: async (args) => {
+            const query = args.query;
+            const numResults = Math.min(10, Math.max(1, args.numResults ?? cfg.defaultNumResults));
+            const rejectReason = limiter.check();
+            if (rejectReason)
+                return JSON.stringify({ error: `图片搜索被限流: ${rejectReason}` });
+            limiter.acquire();
+            try {
+                const res = await fetch('https://google.serper.dev/images', {
+                    method: 'POST',
+                    headers: { 'X-API-KEY': cfg.apiKey, 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ q: query, num: numResults }),
+                });
+                if (!res.ok)
+                    return JSON.stringify({ error: `Serper images API 错误 ${res.status}` });
+                const data = (await res.json());
+                const images = (data.images ?? []).slice(0, numResults).map(it => ({
+                    title: it.title,
+                    imageUrl: it.imageUrl,
+                    thumbnailUrl: it.thumbnailUrl,
+                    source: it.source,
+                    link: it.link,
+                    width: it.imageWidth,
+                    height: it.imageHeight,
+                }));
+                return JSON.stringify({ query, count: images.length, images });
+            }
+            catch (err) {
+                return JSON.stringify({ error: err instanceof Error ? err.message : String(err) });
+            }
+            finally {
+                limiter.release();
+            }
+        },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,88 @@
+/** 单条搜索结果 */
+export interface WebSearchResult {
+    /** 条目标题 */
+    title: string;
+    /** 条目 URL */
+    url: string;
+    /** 摘要/片段（可能为空） */
+    snippet?: string;
+    /** 来源站点（可选，如 "wikipedia.org"） */
+    source?: string;
+    /** 发布或更新日期（可选，ISO 字符串） */
+    publishedAt?: string;
+}
+/** 搜索请求参数 */
+export interface WebSearchRequest {
+    /** 搜索关键词 */
+    query: string;
+    /** 期望返回的结果数（后端决定最大值） */
+    numResults?: number;
+    /** 语言偏好（如 'zh' / 'en'），后端可忽略 */
+    language?: string;
+    /** 搜索类型筛选（后端按 capability 声明的支持范围处理） */
+    kind?: 'web' | 'news' | 'images';
+}
+/** 搜索响应 */
+export interface WebSearchResponse {
+    /** 搜索关键词（回显） */
+    query: string;
+    /** 结果列表 */
+    results: WebSearchResult[];
+    /** 后端给出的摘要/答案框（如 Serper 的 answerBox） */
+    answer?: string;
+    /** 相关问题（若后端支持） */
+    relatedQuestions?: string[];
+    /** 后端元信息（如耗时、总条数等） */
+    raw?: Record<string, unknown>;
+}
+/**
+ * 网络搜索服务
+ *
+ * 实现者需至少提供 `search()`。`describeProvider()` 用于日志/WebUI 展示。
+ */
+export interface WebSearchService {
+    /** 执行一次搜索 */
+    search(request: WebSearchRequest): Promise<WebSearchResponse>;
+    /** 后端标识（供日志/排错用），如 'serper' */
+    readonly providerName: string;
+}
+/**
+ * 网络搜索服务能力注册表
+ *
+ * 第三方插件可通过 declaration merging 追加：
+ * ```ts
+ * declare module '@aalis/core' {
+ *   interface WebSearchCapabilityRegistry {
+ *     Scholar: 'scholar';
+ *   }
+ * }
+ * ```
+ */
+export interface WebSearchCapabilityRegistry {
+    /** 支持常规网页搜索（基本能力） */
+    Web: 'web';
+    /** 支持新闻搜索 */
+    News: 'news';
+    /** 支持图片搜索 */
+    Images: 'images';
+    /** 支持对结果进行 LLM 压缩/摘要 */
+    Compression: 'compression';
+    /** 返回关联问题 */
+    RelatedQuestions: 'related-questions';
+}
+/** 网络搜索能力字符串 union（自动包含第三方扩展） */
+export type WebSearchCapability = WebSearchCapabilityRegistry[keyof WebSearchCapabilityRegistry];
+/** 网络搜索内置能力常量 */
+export declare const WebSearchCapabilities: {
+    readonly Web: "web";
+    readonly News: "news";
+    readonly Images: "images";
+    readonly Compression: "compression";
+    readonly RelatedQuestions: "related-questions";
+};
+declare module '@aalis/core' {
+    interface ServiceCapabilityMap {
+        'web-search': WebSearchCapability;
+    }
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAUA,aAAa;AACb,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,aAAa;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,aAAa;AACb,MAAM,WAAW,gBAAgB;IAC/B,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;CAClC;AAED,WAAW;AACX,MAAM,WAAW,iBAAiB;IAChC,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,sBAAsB;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa;IACb,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9D,+BAA+B;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAID;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,2BAA2B;IAC1C,qBAAqB;IACrB,GAAG,EAAE,KAAK,CAAC;IACX,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,MAAM,EAAE,QAAQ,CAAC;IACjB,wBAAwB;IACxB,WAAW,EAAE,aAAa,CAAC;IAC3B,aAAa;IACb,gBAAgB,EAAE,mBAAmB,CAAC;CACvC;AAED,iCAAiC;AACjC,MAAM,MAAM,mBAAmB,GAAG,2BAA2B,CAAC,MAAM,2BAA2B,CAAC,CAAC;AAEjG,iBAAiB;AACjB,eAAO,MAAM,qBAAqB;;;;;;CAMc,CAAC;AAEjD,OAAO,QAAQ,aAAa,CAAC;IAC3B,UAAU,oBAAoB;QAC5B,YAAY,EAAE,mBAAmB,CAAC;KACnC;CACF"}

package/dist/types.js

@@ -0,0 +1,23 @@
+// ----- 网络搜索服务接口 -----
+//
+// 由 plugin-websearch-serper 等插件实现。Agent 或其他插件可通过
+// `ctx.getService<WebSearchService>('web-search')` 获得该服务来执行搜索，
+// 而无需关心具体后端（Serper / DuckDuckGo / Bing 等）。
+//
+// 多个搜索后端可同时注册，框架按 priority 选择默认实现；
+// 若需指定特定后端（如只使用带新闻能力的后端），可通过 capability 过滤：
+//   `ctx.getService<WebSearchService>('web-search', ['news'])`
+/** 网络搜索内置能力常量 */
+export const WebSearchCapabilities = {
+    Web: 'web',
+    News: 'news',
+    Images: 'images',
+    Compression: 'compression',
+    RelatedQuestions: 'related-questions',
+};
+import { registerCapabilityProbe } from '@aalis/core';
+registerCapabilityProbe('web-search', WebSearchCapabilities.Web, inst => typeof inst.search === 'function'
+    ? true
+    : 'WebSearchService.search() is required for capability "web"');
+// News / Images / Compression / RelatedQuestions 均由请求参数/实现内决定，不做方法探测。
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,EAAE;AACF,iDAAiD;AACjD,+DAA+D;AAC/D,2CAA2C;AAC3C,EAAE;AACF,mCAAmC;AACnC,4CAA4C;AAC5C,+DAA+D;AAoF/D,iBAAiB;AACjB,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,aAAa;IAC1B,gBAAgB,EAAE,mBAAmB;CACS,CAAC;AAQjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD,uBAAuB,CAAC,YAAY,EAAE,qBAAqB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CACtE,OAAQ,IAA6B,CAAC,MAAM,KAAK,UAAU;IACzD,CAAC,CAAC,IAAI;IACN,CAAC,CAAC,4DAA4D,CACjE,CAAC;AAEF,sEAAsE"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@aalis/plugin-websearch-serper",
+  "version": "0.1.0",
+  "type": "module",
+  "keywords": [
+    "aalis-plugin"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@aalis/plugin-llm-api": "^0.1.0",
+    "@aalis/plugin-tools-api": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "@aalis/plugin-webui-api": "0.1.0",
+    "@aalis/core": "0.1.0",
+    "@aalis/plugin-message-api": "0.1.0"
+  },
+  "peerDependencies": {
+    "@aalis/core": "^0.1.0"
+  },
+  "aalis": {
+    "service": {
+      "optional": [
+        "llm"
+      ],
+      "provides": [
+        "web-search"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}