@bolloon/bolloon-agent 0.1.34 → 0.1.36

package/dist/llm/system-prompt/strip-hibsml.js

@@ -0,0 +1,51 @@
+/**
+ * strip-hibsml.ts — 把 hibsml 协议标签转成 bolloon 标记
+ *
+ * hibsml 是 hibs 的协议: {hibsml:cite} {hibsml:invoke} {hibsml:thinking_mode}
+ * bolloon 不解析这些, 但传给 LLM 之前要"金脱除":
+ *   - cite → [CITE:index]
+ *   - invoke → 简化
+ *   - thinking_mode → 注释形式保留
+ *   - 其他标签 → 整段脱除
+ *
+ * 不脱除 hibsml 标签会让 LLM 看到原文标记 (raw XML) 误以为是工具调用.
+ */
+const HIBML_REPLACEMENTS = [
+    // {hibsml:cite index="0-1,3-5"}...{/hibsml:cite} → [CITE:0-1,3-5] ... [ENDCITE]
+    [
+        /\{hibsml:cite\s+index="([^"]+)"\}/g,
+        (_m, idx) => `[CITE:${idx}]`,
+    ],
+    [/\{\/hibsml:cite\}/g, '[ENDCITE]'],
+    // {hibsml:invoke name="X"} ... {/hibsml:invoke} → [TOOL:X] ... [ENDTOOL]
+    [
+        /\{hibsml:invoke\s+name="([^"]+)"\}/g,
+        (_m, name) => `[TOOL:${name}]`,
+    ],
+    [/\{\/hibsml:invoke\}/g, '[ENDTOOL]'],
+    // {hibsml:parameter name="X"}val{/hibsml:parameter} → [P:X]val[/P]
+    [
+        /\{hibsml:parameter\s+name="([^"]+)"\}/g,
+        (_m, name) => `[P:${name}]`,
+    ],
+    [/\{\/hibsml:parameter\}/g, '[/P]'],
+    // {hibsml:thinking_mode}auto{/hibsml:thinking_mode} → [THINKING:auto] (保留)
+    [
+        /\{hibsml:thinking_mode\}(\w+)\{\/hibsml:thinking_mode\}/g,
+        (_m, mode) => `[THINKING:${mode}]`,
+    ],
+    // 脱除 voice_note (hibs 1 明确说永远不用)
+    [/<details><summary>.*?<\/summary>.*?<\/details>/gs, ''],
+    // 任何其他 hibsml:* 标签
+    [/\{hibsml:[a-z_]+\}/g, ''],
+    [/\{\/hibsml:[a-z_]+\}/g, ''],
+];
+export function stripHibsml(text) {
+    let out = text;
+    for (const [re, rep] of HIBML_REPLACEMENTS) {
+        out = out.replace(re, rep);
+    }
+    // 收尾: 多个空行合并
+    out = out.replace(/\n{3,}/g, '\n\n');
+    return out.trim();
+}

package/dist/llm/tool-manifest/ask_user_input.js

@@ -0,0 +1,35 @@
+export const ask_user_input_v0 = {
+    id: 'ask_user_input_v0',
+    name: 'ask_user_input_v0',
+    oneLine: '在提供建议前展示可点击的选项以收集用户偏好 (移动端友好).',
+    description: '此工具显示交互式按钮, 用户可以点击按钮来回答, 在移动端比键入要容易得多. 用于引出信息 (ELICITATION) — 当你需要了解用户的偏好、约束或目标以提供有用建议时.',
+    whenToUse: [
+        '需要了解用户的偏好/约束/目标以提供有用建议',
+        '示例: 帮我制定锻炼计划 → 询问目标(力量/有氧/减重)、可用时间、设备访问',
+        '示例: 帮我为朋友挑礼物 → 询问场合、预算、朋友的兴趣',
+    ],
+    whenNotToUse: [
+        '用户问 A 还是 B (想要分析, 不是按钮)',
+        '用户在发泄或处理情绪',
+        '用户询问观点',
+        '事实问题 (直接回答)',
+        '用户需要散文形式反馈',
+    ],
+    parameters: [
+        { name: 'questions', type: 'array', required: true, description: '1-3 个问题', items: {
+                name: 'question', type: 'object', required: true, description: '单个问题', properties: [
+                    { name: 'question', type: 'string', required: true, description: '向用户显示的问题' },
+                    { name: 'type', type: 'enum', required: false, description: 'single_select | multi-select | rank_priorities', enumValues: ['single_select', 'multi_select', 'rank_priorities'], default: 'single_select' },
+                    { name: 'options', type: 'array', required: true, description: '2-4 个带短标签的选项', minItems: 2, maxItems: 4, items: {
+                            name: 'option', type: 'object', required: true, description: '选项', properties: [
+                                { name: 'label', type: 'string', required: true, description: '短标签' },
+                                { name: 'description', type: 'string', required: false, description: '选项描述' },
+                            ],
+                        } },
+                ],
+            } },
+    ],
+    callExample: `[TOOL:ask_user_input_v0]
+[P:questions]${'${'}JSON.stringify([{"question":"你的预算?","options":[{"label":"<500"},{"label":"500-2000"}]}])[ENDTOOL]`,
+    layerId: 'tool.manifest',
+};

package/dist/llm/tool-manifest/bash.js

@@ -0,0 +1,23 @@
+export const bash_tool = {
+    id: 'bash_tool',
+    name: 'bash_tool',
+    oneLine: '在容器中运行 bash 命令.',
+    description: '在容器中运行 bash 命令. 必须用 description 参数说明为什么跑.',
+    whenToUse: [
+        '需要执行 shell 命令 (ls, mkdir, npm, git 等)',
+        '需要跑构建/测试/脚本',
+    ],
+    whenNotToUse: [
+        '读取文件 (用 view)',
+        '编辑文件 (用 str_replace 或 create_file)',
+    ],
+    parameters: [
+        { name: 'command', type: 'string', required: true, description: '要运行的 bash 命令' },
+        { name: 'description', type: 'string', required: true, description: '为什么我要运行此命令' },
+    ],
+    callExample: `[TOOL:bash_tool]
+[P:command]ls -la /tmp
+[P:description]列出 /tmp 目录内容
+[ENDTOOL]`,
+    layerId: 'tool.bash',
+};

package/dist/llm/tool-manifest/create_file.js

@@ -0,0 +1,24 @@
+export const create_file = {
+    id: 'create_file',
+    name: 'create_file',
+    oneLine: '在容器中创建带有内容的新文件.',
+    description: '如果路径已存在则失败 — 使用 str_replace 编辑现有文件, 或使用 bash_tool (cat > path << EOF) 覆盖.',
+    whenToUse: [
+        '创建新文件',
+        '需要写完整的文件内容',
+    ],
+    whenNotToUse: [
+        '编辑已有文件 (用 str_replace)',
+    ],
+    parameters: [
+        { name: 'description', type: 'string', required: true, description: '为什么我要创建此文件' },
+        { name: 'file_text', type: 'string', required: true, description: '要写入的文件内容' },
+        { name: 'path', type: 'string', required: true, description: '要创建的文件路径' },
+    ],
+    callExample: `[TOOL:create_file]
+[P:description]新建 README
+[P:file_text]# Project\n\nHello world
+[P:path]/home/bolloon/README.md
+[ENDTOOL]`,
+    layerId: 'tool.manifest',
+};

package/dist/llm/tool-manifest/fetch_sports_data.js

@@ -0,0 +1,26 @@
+export const fetch_sports_data = {
+    id: 'fetch_sports_data',
+    name: 'fetch_sports_data',
+    oneLine: '获取当前/即将进行/最近的体育数据 (比分/积分榜/比赛统计).',
+    description: '对于最近和即将进行的比赛的数据、比分、统计, 优先使用此工具而非 Web 搜索. 工作流: 1) 获取比分 2) 根据比赛 ID 获取统计 3) 然后才回复用户.',
+    whenToUse: [
+        '用户对某场比赛的比分感兴趣',
+        '广泛查询 (最近的 NBA 结果等)',
+        '需要详细比赛统计',
+    ],
+    whenNotToUse: [
+        '历史比赛 (很久以前)',
+        '非体育数据',
+    ],
+    parameters: [
+        { name: 'data_type', type: 'enum', required: true, description: 'scores | standings | game_stats', enumValues: ['scores', 'standings', 'game_stats'] },
+        { name: 'game_id', type: 'string', required: false, description: 'SportRadar 比赛 ID (data_type=game_stats 时必需)' },
+        { name: 'league', type: 'enum', required: true, description: 'nfl/nba/nhl/mlb/wnba/ncaafb/ncaamb/ncaawb/epl/la_liga/serie_a/bundesliga/ligue_1/mls/champions_league/tennis/golf/nascar/cricket/mma', enumValues: ['nfl', 'nba', 'nhl', 'mlb', 'wnba', 'ncaafb', 'ncaamb', 'ncaawb', 'epl', 'la_liga', 'serie_a', 'bundesliga', 'ligue_1', 'mls', 'champions_league', 'tennis', 'golf', 'nascar', 'cricket', 'mma'] },
+        { name: 'team', type: 'string', required: false, description: '可选的球队名称' },
+    ],
+    callExample: `[TOOL:fetch_sports_data]
+[P:data_type]scores
+[P:league]nba
+[ENDTOOL]`,
+    layerId: 'tool.manifest',
+};

package/dist/llm/tool-manifest/image_search.js

@@ -0,0 +1,24 @@
+export const image_search = {
+    id: 'image_search',
+    name: 'image_search',
+    oneLine: '在 Web 上查找图像并连同尺寸返回 (3-4 张/次).',
+    description: '对于视觉内容可增强用户理解的任何查询, 默认使用图像搜索. 当交付物主要是文本时跳过.',
+    whenToUse: [
+        '地点、动物、食物、人物、产品、风格、图表、历史照片、练习',
+        '关于视觉事物的简单事实 ("埃菲尔铁塔是哪一年造的?" → 展示它)',
+        '多项目内容 (指南、列表、比较、时间线、步骤) — 交错图像',
+    ],
+    whenNotToUse: [
+        '文本输出 (撰写邮件、代码、文章)',
+        '数字/数据、编码查询、技术支持、分步说明',
+        '关于非视觉主题的分析',
+    ],
+    parameters: [
+        { name: 'max_results', type: 'integer', required: false, description: '返回图片数 (默认 3, 最少 3, 最多 5)', minimum: 3, maximum: 5, default: 3 },
+        { name: 'query', type: 'string', required: true, description: '搜索查询 (3-6 词具体)' },
+    ],
+    callExample: `[TOOL:image_search]
+[P:query]Eiffel Tower Paris
+[ENDTOOL]`,
+    layerId: 'tool.image_search',
+};

package/dist/llm/tool-manifest/index.js

@@ -0,0 +1,69 @@
+import { ask_user_input_v0 } from './ask_user_input.js';
+import { bash_tool } from './bash.js';
+import { create_file } from './create_file.js';
+import { fetch_sports_data } from './fetch_sports_data.js';
+import { image_search } from './image_search.js';
+import { message_compose_v1 } from './message_compose.js';
+import { places_search, places_map_display_v0 } from './places.js';
+import { present_files } from './present_files.js';
+import { recipe_display_v0 } from './recipe.js';
+import { recommend_bolloon_apps } from './recommend_apps.js';
+import { search_mcp_registry, suggest_connectors } from './mcp.js';
+import { str_replace } from './str_replace.js';
+import { view } from './view.js';
+import { web_search, web_fetch } from './web.js';
+import { weather_fetch } from './weather.js';
+const ALL = [
+    ask_user_input_v0,
+    bash_tool,
+    create_file,
+    fetch_sports_data,
+    image_search,
+    message_compose_v1,
+    places_search,
+    places_map_display_v0,
+    present_files,
+    recipe_display_v0,
+    recommend_bolloon_apps,
+    search_mcp_registry,
+    suggest_connectors,
+    str_replace,
+    view,
+    web_search,
+    web_fetch,
+    weather_fetch,
+];
+export function listTools() {
+    return ALL;
+}
+export function getToolManifest(id) {
+    return ALL.find((t) => t.id === id);
+}
+export function getToolsByLayer(layerId) {
+    return ALL.filter((t) => t.layerId === layerId);
+}
+/**
+ * 缩到 1-3KB 装进 system prompt
+ * 包含: 名字 + 一句话 + whenToUse(2) + whenNotToUse(1) + 1 行示例
+ *
+ * 不包含: 完整 parameters schema (那是 PiAI 客户端在调用时读)
+ */
+export function formatForPrompt(tools) {
+    const list = tools ?? ALL;
+    const lines = [
+        `## 工具清单 (${list.length} 个, 详细 schema 在 src/llm/tool-manifest/, 调用时由 PiAI 客户端解析)`,
+        '',
+    ];
+    for (const t of list) {
+        lines.push(`### ${t.id}`);
+        lines.push(`- **用途**: ${t.oneLine}`);
+        lines.push(`- **何时用**: ${t.whenToUse[0] ?? ''}`);
+        if (t.whenToUse.length > 1) {
+            lines.push(`  - 也: ${t.whenToUse.slice(1, 3).join(' / ')}`);
+        }
+        lines.push(`- **何时不用**: ${t.whenNotToUse[0] ?? ''}`);
+        lines.push(`- **示例**: ${t.callExample.replace(/\n/g, ' ')}`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}

package/dist/llm/tool-manifest/mcp.js

@@ -0,0 +1,43 @@
+export const search_mcp_registry = {
+    id: 'search_mcp_registry',
+    name: 'search_mcp_registry',
+    oneLine: '在 MCP 注册表中搜索可用连接器.',
+    description: '当连接新的 MCP 可能有助于解决用户查询时, 无论他们是否指名了特定产品, 请调用此工具. 如果结果相关, 调用 suggest_connectors 呈现选项. 如果没有任何匹配任务的内容, 不要调用 suggest_connectors.',
+    whenToUse: [
+        '用户隐含读取个人数据 (邮件、日历、任务、文件、工单)',
+        '需要连接外部服务 (Asana/Jira/Slack/Calendar)',
+        '用户指名了特定连接器 (即使未连接)',
+    ],
+    whenNotToUse: [
+        '知识问答/购物建议/一般性建议',
+        '用户已指名了已连接的特定服务 (直接用)',
+    ],
+    parameters: [
+        { name: 'keywords', type: 'array', required: true, description: '搜索关键词', minItems: 1, items: { name: 'kw', type: 'string', required: true, description: '关键词' } }
+    ],
+    callExample: `[TOOL:search_mcp_registry]
+[P:keywords]${'${'}JSON.stringify(["calendar","schedule"])[ENDTOOL]`,
+    layerId: 'tool.mcp_apps',
+};
+export const suggest_connectors = {
+    id: 'suggest_connectors',
+    name: 'suggest_connectors',
+    oneLine: '向用户展示连接器选项, 让用户选择.',
+    description: '每个选项都会渲染一个连接或使用按钮, 以及一个"以上都不是"选项. 调用后用一句简短的引导语结束你的回合.',
+    whenToUse: [
+        'search_mcp_registry 找到了相关选项',
+        '用户未明确指名连接器',
+        '工具调用因身份验证/凭据错误失败 (重认证)',
+    ],
+    whenNotToUse: [
+        'search_mcp_registry 未返回相关内容',
+        '用户已指名了特定的已连接服务 (直接用)',
+        '没有 search_mcp_registry 上下文',
+    ],
+    parameters: [
+        { name: 'uuids', type: 'array', required: true, description: '从 search_mcp_registry 结果的 directoryUuid 复制', minItems: 1, items: { name: 'u', type: 'string', required: true, description: 'uuid' } }
+    ],
+    callExample: `[TOOL:suggest_connectors]
+[P:uuids]${'${'}JSON.stringify(["uuid-from-search-result"])[ENDTOOL]`,
+    layerId: 'tool.mcp_apps',
+};

package/dist/llm/tool-manifest/message_compose.js

@@ -0,0 +1,31 @@
+export const message_compose_v1 = {
+    id: 'message_compose_v1',
+    name: 'message_compose_v1',
+    oneLine: '起草目标导向的消息 (email/textMessage/other).',
+    description: '分析情境类型 (工作分歧、谈判、跟进、传达坏消息、请求某事、设定边界、道歉、拒绝、提供反馈、冷启动接触、回应反馈、澄清误解、委派、庆祝) 并识别竞争目标. 多种方法 (高风险/模糊) 生成 2-3 种策略.',
+    whenToUse: [
+        '用户要你起草一封邮件/消息',
+        '高风险沟通 (谈判、道歉、设定边界)',
+        '需要适配渠道 (邮件 vs Slack vs 短信)',
+    ],
+    whenNotToUse: [
+        '用户只是要写笔记/便签',
+        '对话中直接回复',
+    ],
+    parameters: [
+        { name: 'kind', type: 'enum', required: true, description: 'email | textMessage | other', enumValues: ['email', 'textMessage', 'other'] },
+        { name: 'summary_title', type: 'string', required: true, description: '消息的摘要标题' },
+        { name: 'variants', type: 'array', required: true, description: '至少 1 个变体', minItems: 1, items: {
+                name: 'variant', type: 'object', required: true, description: '变体', properties: [
+                    { name: 'label', type: 'string', required: true, description: '变体标签' },
+                    { name: 'body', type: 'string', required: true, description: '消息内容' },
+                    { name: 'subject', type: 'string', required: false, description: '邮件主题 (仅 email)' },
+                ],
+            } },
+    ],
+    callExample: `[TOOL:message_compose_v1]
+[P:kind]email
+[P:summary_title]Follow-up on Q3 review
+[P:variants]${'${'}JSON.stringify([{"label":"direct","subject":"Quick follow-up","body":"..."}])[ENDTOOL]`,
+    layerId: 'tool.manifest',
+};

package/dist/llm/tool-manifest/places.js

@@ -0,0 +1,83 @@
+export const places_search = {
+    id: 'places_search',
+    name: 'places_search',
+    oneLine: '使用 Google Places 搜索地点/商户/餐厅/景点 (多查询).',
+    description: '单次调用支持多个查询. 多个查询可用于: 高效的行程规划, 拆解广泛或抽象的请求. 包含更广泛的区域以避免同名地点冲突.',
+    whenToUse: [
+        '用户问某地有什么 (餐厅/景点/酒店)',
+        '行程规划 (多地点)',
+        '需要 place_id 以便后续在地图展示',
+    ],
+    whenNotToUse: [
+        '需要地点坐标 (问 GPS)',
+        '只问天气 (用 weather_fetch)',
+    ],
+    parameters: [
+        { name: 'queries', type: 'array', required: true, description: '1-10 个查询', minItems: 1, maxItems: 10, items: {
+                name: 'q', type: 'object', required: true, description: '单查询', properties: [
+                    { name: 'query', type: 'string', required: true, description: '自然语言搜索' },
+                    { name: 'max_results', type: 'integer', required: false, description: '1-10, 默认 5', minimum: 1, maximum: 10, default: 5 }
+                ],
+            } },
+        { name: 'location_bias_lat', type: 'number', required: false, description: '可选纬度' },
+        { name: 'location_bias_lng', type: 'number', required: false, description: '可选经度' },
+        { name: 'location_bias_radius', type: 'number', required: false, description: '米 (默认 5000)', default: 5000 }
+    ],
+    callExample: `[TOOL:places_search]
+[P:queries]${'${'}JSON.stringify([{"query":"ramen restaurants Tokyo"}])[ENDTOOL]`,
+    layerId: 'tool.manifest',
+};
+export const places_map_display_v0 = {
+    id: 'places_map_display_v0',
+    name: 'places_map_display_v0',
+    oneLine: '在地图上展示地点, 附上你的推荐和内行小贴士.',
+    description: '工作流: 先用 places_search 获取 place_id, 然后用 place_id 引用调用本工具. 两种模式: 简单标记 (locations) 或行程 (days).',
+    whenToUse: [
+        '用户需要看地点在地图上',
+        '行程规划, 需要可视化',
+    ],
+    whenNotToUse: [
+        '只问地点信息 (用 places_search 文字回答)',
+    ],
+    parameters: [
+        { name: 'locations', type: 'array', required: false, description: '简单标记模式', minItems: 1, maxItems: 50, items: {
+                name: 'loc', type: 'object', required: true, description: '地点', properties: [
+                    { name: 'name', type: 'string', required: true, description: '地点名' },
+                    { name: 'latitude', type: 'number', required: true, description: '纬度' },
+                    { name: 'longitude', type: 'number', required: true, description: '经度' },
+                    { name: 'place_id', type: 'string', required: false, description: '从 places_search 复制' },
+                    { name: 'notes', type: 'string', required: false, description: '你的小贴士' },
+                    { name: 'address', type: 'string', required: false, description: '自定义地点的地址 (没有 place_id 时用)' },
+                    { name: 'arrival_time', type: 'string', required: false, description: '到达时间 (用于行程, e.g. "8:00 AM")' },
+                    { name: 'duration_minutes', type: 'integer', required: false, description: '停留时长 (分钟)' },
+                ],
+            } },
+        { name: 'days', type: 'array', required: false, description: '行程模式', minItems: 1, maxItems: 30, items: {
+                name: 'day', type: 'object', required: true, description: '单日', properties: [
+                    { name: 'day_number', type: 'integer', required: true, description: '天数 (从 1 开始)', minimum: 1 },
+                    { name: 'title', type: 'string', required: false, description: '日期标题' },
+                    { name: 'narrative', type: 'string', required: false, description: '该日叙述' },
+                    { name: 'locations', type: 'array', required: true, description: '该日地点', minItems: 1, maxItems: 50, items: {
+                            name: 'loc', type: 'object', required: true, description: '地点', properties: [
+                                { name: 'name', type: 'string', required: true, description: '地点名' },
+                                { name: 'latitude', type: 'number', required: true, description: '纬度' },
+                                { name: 'longitude', type: 'number', required: true, description: '经度' },
+                                { name: 'place_id', type: 'string', required: false, description: '从 places_search 复制' },
+                                { name: 'notes', type: 'string', required: false, description: '你的小贴士' },
+                                { name: 'address', type: 'string', required: false, description: '自定义地点地址' },
+                                { name: 'arrival_time', type: 'string', required: false, description: '到达时间' },
+                                { name: 'duration_minutes', type: 'integer', required: false, description: '停留时长 (分钟)' },
+                            ],
+                        } },
+                ],
+            } },
+        { name: 'mode', type: 'enum', required: false, description: 'markers | itinerary', enumValues: ['markers', 'itinerary'] },
+        { name: 'travel_mode', type: 'enum', required: false, description: 'driving | walking | transit | bicycling', enumValues: ['driving', 'walking', 'transit', 'bicycling'] },
+        { name: 'show_route', type: 'boolean', required: false, description: '是否显示路线' },
+        { name: 'title', type: 'string', required: false, description: '行程标题' },
+        { name: 'narrative', type: 'string', required: false, description: '行程叙述' },
+    ],
+    callExample: `[TOOL:places_map_display_v0]
+[P:locations]${'${'}JSON.stringify([{"name":"Senso-ji","latitude":35.7148,"longitude":139.7967,"place_id":"ChIJ..."}])[ENDTOOL]`,
+    layerId: 'tool.manifest',
+};

package/dist/llm/tool-manifest/present_files.js

@@ -0,0 +1,21 @@
+export const present_files = {
+    id: 'present_files',
+    name: 'present_files',
+    oneLine: '让文件对用户可见, 客户端界面中查看和渲染.',
+    description: '接收来自容器文件系统的文件路径数组, 返回客户端可访问文件的输出路径. 输出路径按与输入路径相同的顺序返回. 多个文件可在单次调用中高效呈现. 如果文件不在输出目录中, 会自动复制到该目录.',
+    whenToUse: [
+        '让用户可以查看、下载或与文件交互',
+        '一次展示多个相关文件',
+        '创建了应向用户展示的文件之后',
+    ],
+    whenNotToUse: [
+        '只是为了自己的处理而需要读取文件内容',
+        '临时或中间文件',
+    ],
+    parameters: [
+        { name: 'filepaths', type: 'array', required: true, description: '至少 1 个文件路径', minItems: 1, items: { name: 'path', type: 'string', required: true, description: '容器内路径' } },
+    ],
+    callExample: `[TOOL:present_files]
+[P:filepaths]${'${'}JSON.stringify(["/home/bolloon/report.md"])[ENDTOOL]`,
+    layerId: 'tool.manifest',
+};

package/dist/llm/tool-manifest/recipe.js

@@ -0,0 +1,40 @@
+export const recipe_display_v0 = {
+    id: 'recipe_display_v0',
+    name: 'recipe_display_v0',
+    oneLine: '显示带可调整份量的交互式食谱.',
+    description: '用户要求食谱、烹饪说明或食物准备指南时使用. 该组件允许用户通过调整份量控件按比例缩放所有食材的用量.',
+    whenToUse: [
+        '用户问食谱',
+        '需要比例缩放 (份量调整)',
+    ],
+    whenNotToUse: [
+        '用户只要食材列表 (用文字)',
+        '用户问餐厅推荐 (用 places_search)',
+    ],
+    parameters: [
+        { name: 'title', type: 'string', required: true, description: '食谱名称' },
+        { name: 'base_servings', type: 'integer', required: false, description: '基础份数 (默认 4)' },
+        { name: 'description', type: 'string', required: false, description: '简短描述' },
+        { name: 'ingredients', type: 'array', required: true, description: '食材', items: {
+                name: 'ing', type: 'object', required: true, description: '食材', properties: [
+                    { name: 'id', type: 'string', required: true, description: '唯一 ID' },
+                    { name: 'amount', type: 'number', required: true, description: '数量', minimum: 0 },
+                    { name: 'unit', type: 'enum', required: false, description: 'g/kg/ml/l/tsp/tbsp/cup/fl_oz/oz/lb/pinch', enumValues: ['g', 'kg', 'ml', 'l', 'tsp', 'tbsp', 'cup', 'fl_oz', 'oz', 'lb', 'pinch'] },
+                    { name: 'name', type: 'string', required: true, description: '显示名 (整体可数项, 把 counting noun 放在这里)' },
+                ],
+            } },
+        { name: 'steps', type: 'array', required: true, description: '步骤', items: {
+                name: 's', type: 'object', required: true, description: '步骤', properties: [
+                    { name: 'id', type: 'string', required: true, description: '唯一 ID' },
+                    { name: 'title', type: 'string', required: true, description: '步骤摘要' },
+                    { name: 'content', type: 'string', required: true, description: '完整指令 (用 {id} 引用食材)' },
+                    { name: 'timer_seconds', type: 'integer', required: false, description: '等待/烹饪计时秒数', minimum: 0 }
+                ],
+            } },
+        { name: 'notes', type: 'string', required: false, description: '附加说明' },
+    ],
+    callExample: `[TOOL:recipe_display_v0]
+[P:title]Pasta
+[P:ingredients]${'${'}JSON.stringify([{"id":"a1","amount":500,"name":"pasta"}])[ENDTOOL]`,
+    layerId: 'tool.manifest',
+};

package/dist/llm/tool-manifest/recommend_apps.js

@@ -0,0 +1,23 @@
+export const recommend_bolloon_apps = {
+    id: 'recommend_bolloon_apps',
+    name: 'recommend_bolloon_apps',
+    oneLine: '推荐 1-3 个 Bolloon 应用或扩展.',
+    description: '当用户正在处理的事情可能更适合用 Bolloon 聊天以外的应用来完成时, 展示此建议. 仅推荐与用户当前用例相关的应用, 并按相关性排序.',
+    whenToUse: [
+        '编码任务 (Bolloon Code)',
+        '知识工作 (Cowork)',
+        '处理电子表格 (Excel) 或幻灯片 (PowerPoint)',
+        '浏览器自动化 (Chrome)',
+    ],
+    whenNotToUse: [
+        '用户已明确不想离开对话',
+        '没有相关应用',
+    ],
+    parameters: [
+        { name: 'app_ids', type: 'array', required: true, description: '应用 ID 数组', items: {
+                name: 'id', type: 'string', required: true, description: '应用 ID (如 desktop/ios/android/code_terminal/code_vscode/code_jetbrains/code_slack/excel/powerpoint/chrome)',
+            } },
+    ],
+    callExample: '[TOOL:recommend_bolloon_apps] [P:app_ids] ["code_vscode","excel"] [ENDTOOL]',
+    layerId: 'tool.manifest',
+};

package/dist/llm/tool-manifest/str_replace.js

@@ -0,0 +1,27 @@
+export const str_replace = {
+    id: 'str_replace',
+    name: 'str_replace',
+    oneLine: '将文件中的唯一字符串替换为另一个.',
+    description: 'old_str 必须与原始文件内容完全匹配且只出现一次. 从 view 输出复制时, 不要包含行号前缀(空格 + 行号 + 制表符). 在编辑前立即查看文件; 任何成功的 str_replace 之后, 该文件之前的 view 输出已失效 — 在对同一文件进行进一步编辑之前请重新查看. /mnt/* 路径只读, 需先复制到可写位置.',
+    whenToUse: [
+        '编辑已有文件的小改动',
+        '精确替换单段文本',
+    ],
+    whenNotToUse: [
+        '创建新文件 (用 create_file)',
+        '完全重写文件 (用 create_file + 删除)',
+    ],
+    parameters: [
+        { name: 'description', type: 'string', required: true, description: '为什么我要做这个编辑' },
+        { name: 'old_str', type: 'string', required: true, description: '要被替换的字符串 (必须唯一)' },
+        { name: 'new_str', type: 'string', required: true, description: '新字符串 (空字符串 = 删除)', default: '' },
+        { name: 'path', type: 'string', required: true, description: '文件路径' },
+    ],
+    callExample: `[TOOL:str_replace]
+[P:description]修复 typo
+[P:old_str]recieve
+[P:new_str]receive
+[P:path]/home/bolloon/main.py
+[ENDTOOL]`,
+    layerId: 'tool.manifest',
+};

package/dist/llm/tool-manifest/types.js

@@ -0,0 +1,7 @@
+/**
+ * tool-manifest/types.ts — 工具清单的类型
+ *
+ * 设计原则: schema 在代码侧(结构化数据), description/when-to-use 在代码侧,
+ * prompt 里只嵌"调用格式 + 名字 + 一句话描述" — 节省 LLM 注意力.
+ */
+export {};

package/dist/llm/tool-manifest/view.js

@@ -0,0 +1,24 @@
+export const view = {
+    id: 'view',
+    name: 'view',
+    oneLine: '查看文本、图像和目录列表.',
+    description: '支持的路径类型: 目录 (列出文件和目录, 最多 2 层深度, 忽略隐藏项和 node_modules); 图像文件 (.jpg, .jpeg, .png, .gif, .webp) 以可视方式显示; 文本文件显示带行号的内容 (前缀仅用于显示 — 不要在 str_replace 的 old_str 中包含它). 可以指定 view_range 来查看特定行.',
+    whenToUse: [
+        '读取已有文件的内容',
+        '看图像文件',
+        '列目录',
+    ],
+    whenNotToUse: [
+        '创建新文件 (用 create_file)',
+    ],
+    parameters: [
+        { name: 'description', type: 'string', required: true, description: '为什么我要查看' },
+        { name: 'path', type: 'string', required: true, description: '绝对路径' },
+        { name: 'view_range', type: 'array', required: false, description: '[start, end] 1-indexed, end=-1 表示到末尾', minItems: 2, maxItems: 2, items: { name: 'r', type: 'integer', required: true, description: '行号' } }
+    ],
+    callExample: `[TOOL:view]
+[P:description]读 README
+[P:path]/home/bolloon/README.md
+[ENDTOOL]`,
+    layerId: 'tool.manifest',
+};

package/dist/llm/tool-manifest/weather.js

@@ -0,0 +1,27 @@
+export const weather_fetch = {
+    id: 'weather_fetch',
+    name: 'weather_fetch',
+    oneLine: '显示天气信息 (用用户家庭位置确定温度单位).',
+    description: '使用用户的家庭位置来确定温度单位: 美国用户使用华氏度, 其他用户使用摄氏度.',
+    whenToUse: [
+        '用户询问特定地点的天气',
+        '用户询问"我该带雨伞/外套吗"',
+        '用户在规划户外活动',
+        '用户询问"[城市]怎么样"(天气语境)',
+    ],
+    whenNotToUse: [
+        '气候或历史天气问题',
+        '闲聊天气但未指定地点',
+    ],
+    parameters: [
+        { name: 'location_name', type: 'string', required: true, description: '人类可读地点名' },
+        { name: 'latitude', type: 'number', required: true, description: '纬度' },
+        { name: 'longitude', type: 'number', required: true, description: '经度' },
+    ],
+    callExample: `[TOOL:weather_fetch]
+[P:location_name]San Francisco, CA
+[P:latitude]37.78
+[P:longitude]-122.41
+[ENDTOOL]`,
+    layerId: 'tool.manifest',
+};