@bolloon/bolloon-agent 0.1.36 → 0.1.38

package/src/llm/system-prompt/registry.ts

@@ -1,325 +0,0 @@
-/**
- * registry.ts — system prompt 层注册 + 装配器
- *
- * 设计原则:
- * - 每个 layer 独立文件, 可单独更新/审查/回滚
- * - 装配器按 channel + role + tool 过滤, 输出最终 system prompt
- * - 字符预算按"层级"硬限, 避免腐烂
- * - 远程 P2P layer (function source) 可被远程智能体覆盖本地 layer
- *
- * 装配顺序 (低 priority 先, 高 priority 后):
- *   core/identity < core/knowledge < core/tools < channel/* < role/* < tool/* < dynamic/*
- */
-
-import * as fs from 'fs/promises';
-import * as path from 'path';
-import { fileURLToPath } from 'url';
-import { stripHibsml } from './strip-hibsml.js';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const LAYERS_DIR = path.join(__dirname, 'layers');
-
-export type AppliesTo = (
-  | 'local' | 'p2p-visitor' | 'p2p-agent'
-  | 'role:expert' | 'role:architect' | 'role:implementer' | 'role:security'
-  | 'tool:bash' | 'tool:str_replace' | 'tool:view' | 'tool:web_search' | 'tool:web_fetch'
-  | 'tool:mcp_apps' | 'tool:hibs_api' | 'tool:image_search' | 'tool:artifacts' | 'tool:manifest'
-  | 'all'
-  | 'never'  // P-Action 4: 停用标记, .md 保留可回滚, runtime 永远不装配
-);
-
-export type LayerSource = 'static-md' | 'function';
-
-export interface PromptLayer {
-  /** 唯一 ID, 路径式: core.refusal / channel.local / tool.bash */
-  id: string;
-  /** semver */
-  version: string;
-  /** 数字小 = 排前, 同 priority 按字母序 */
-  priority: number;
-  /** 该 layer 适用场景. 'all' 永远嵌入. 其他按 channel/role/tool 过滤 */
-  appliesTo: AppliesTo[];
-  /** 来源: 静态 .md 或函数(可异步,可被 P2P 覆盖) */
-  source: LayerSource;
-  /** 单层字符上限 (腐烂防护) */
-  maxChars: number;
-  /** 静态内容 (source='static-md' 时) */
-  content?: string;
-  /** 动态内容 (source='function' 时) */
-  resolver?: () => string | Promise<string>;
-  /**
-   * Provenance + Lifecycle metadata (P-Action 2)
-   * 安全/identity 类: ttl_days=90 (季度审)
-   * channel/role persona: ttl_days=180
-   * tool/manual: ttl_days=270
-   * knowledge/context: ttl_days=365
-   * author ∈ {yuanjie | community | maintainer-name}; 拒绝 llm-judge
-   */
-  meta?: SectionMeta;
-}
-
-export interface SectionMeta {
-  /** 初始填入时间 (ISO 8601) */
-  addedAt: string;
-  /** 上次审视时间 (ISO 8601) */
-  lastReviewedAt: string;
-  /** 过期天数 (从 lastReviewedAt 算起) */
-  ttlDays: number;
-  /** 维护者 */
-  author: string;
-  /** 自由 notes (例如 '需要 domain expert 复审', '依赖 external lib X') */
-  notes?: string;
-}
-
-/** 解析 .md frontmatter (手写 3 行 regex, 不引 yaml 依赖) */
-function parseFrontmatter(raw: string): { meta: SectionMeta | null; body: string } {
-  const m = raw.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
-  if (!m) return { meta: null, body: raw };
-  const block = m[1];
-  const body = m[2];
-  const get = (key: string): string | undefined => {
-    const re = new RegExp(`^${key}:\\s*(.+)$`, 'm');
-    const found = block.match(re);
-    return found ? found[1].trim() : undefined;
-  };
-  const addedAt = get('added_at');
-  const lastReviewedAt = get('last_reviewed_at');
-  const ttlDaysStr = get('ttl_days');
-  const author = get('author');
-  const notes = get('notes');
-  if (!addedAt || !lastReviewedAt || !ttlDaysStr || !author) {
-    // frontmatter 不完整 → 视为无 metadata (health 会标 missing-frontmatter)
-    return { meta: null, body: raw };
-  }
-  const ttlDays = parseInt(ttlDaysStr, 10);
-  if (isNaN(ttlDays) || ttlDays <= 0) {
-    return { meta: null, body: raw };
-  }
-  return {
-    meta: { addedAt, lastReviewedAt, ttlDays, author, notes },
-    body,
-  };
-}
-
-/**
- * 静态 layer 注册表 — 一个 layer 一个文件
- * 这里只声明 metadata, 内容从 .md 读
- *
- * P-Action 2: meta 默认值, 跟分层 TTL 决策一致
- *   safety  (refusal / hibs_reminders / tools.thin)        = 90
- *   channel (local / p2p-* persona)                         = 180
- *   role    (expert / architect / implementer / security)  = 180
- *   tool    (bash / search / artifacts / etc)               = 270
- *   knowledge (knowledge / tone / wellbeing / etc)         = 365
- * author = yuanjie (可被 .md frontmatter 覆盖)
- */
-const DEFAULT_META_AUTHOR = 'yuanjie';
-const DEFAULT_ADDED_AT = '2026-06-15';
-const DEFAULT_REVIEWED_AT = '2026-06-15';
-const TTL_SAFETY = 90;
-const TTL_CHANNEL = 180;
-const TTL_ROLE = 180;
-const TTL_TOOL = 270;
-const TTL_KNOWLEDGE = 365;
-const DEFAULT_META = (ttlDays: number): SectionMeta => ({
-  addedAt: DEFAULT_ADDED_AT,
-  lastReviewedAt: DEFAULT_REVIEWED_AT,
-  ttlDays,
-  author: DEFAULT_META_AUTHOR,
-});
-
-/**
- * P-Action 4 (2026-06-15): 单 layer maxChars 全面收紧, 6 个 layer 停用.
- * 阶段 0 不再对齐 Claude.ai 完整版 (hibs_api / artifacts / mcp_apps / image_search /
- *   hibs_reminders / network_filesystem 全是 Claude.ai 平台 runtime, 本地 bolloon 用不到).
- * 停用方法: appliesTo 加 'never' (matchesContext 永远 false), 文件保留可回滚.
- */
-const STATIC_LAYERS: Omit<PromptLayer, 'content'>[] = [
-  // ── core/ ──
-  { id: 'core.identity',         version: '1.0.0', priority: 50,  appliesTo: ['all'], source: 'static-md', maxChars: 800  , meta: DEFAULT_META(TTL_KNOWLEDGE) },
-  { id: 'core.knowledge',        version: '1.0.0', priority: 60,  appliesTo: ['all'], source: 'static-md', maxChars: 600  , meta: DEFAULT_META(TTL_KNOWLEDGE) },
-  { id: 'core.tools.thin',       version: '1.0.0', priority: 70,  appliesTo: ['all'], source: 'static-md', maxChars: 400  , meta: DEFAULT_META(TTL_SAFETY) },
-  { id: 'core.hibs_reminders',   version: '1.0.0', priority: 80,  appliesTo: ['never'], source: 'static-md', maxChars: 0    , meta: DEFAULT_META(TTL_SAFETY) },
-  { id: 'core.refusal',          version: '1.0.0', priority: 100, appliesTo: ['all'], source: 'static-md', maxChars: 800  , meta: DEFAULT_META(TTL_SAFETY) },
-  { id: 'core.tone',             version: '1.0.0', priority: 110, appliesTo: ['all'], source: 'static-md', maxChars: 500  , meta: DEFAULT_META(TTL_KNOWLEDGE) },
-  { id: 'core.wellbeing',        version: '1.0.0', priority: 120, appliesTo: ['all'], source: 'static-md', maxChars: 600  , meta: DEFAULT_META(TTL_KNOWLEDGE) },
-  { id: 'core.evenhandedness',   version: '1.0.0', priority: 130, appliesTo: ['all'], source: 'static-md', maxChars: 300  , meta: DEFAULT_META(TTL_KNOWLEDGE) },
-  { id: 'core.memory_system',    version: '1.0.0', priority: 140, appliesTo: ['all'], source: 'static-md', maxChars: 200  , meta: DEFAULT_META(TTL_KNOWLEDGE) },
-  { id: 'core.artifacts_storage',version: '1.0.0', priority: 145, appliesTo: ['never'], source: 'static-md', maxChars: 0    , meta: DEFAULT_META(TTL_KNOWLEDGE) },
-  { id: 'core.network_filesystem',version: '1.0.0', priority: 148, appliesTo: ['never'], source: 'static-md', maxChars: 0    , meta: DEFAULT_META(TTL_KNOWLEDGE) },
-
-  // ── role/ ── 阶段 0 只用 expert, 其他 3 个停用 (节省 + 阶段 0 不分 role)
-  { id: 'role.expert',           version: '1.0.0', priority: 200, appliesTo: ['all', 'role:expert'],         source: 'static-md', maxChars: 500 , meta: DEFAULT_META(TTL_ROLE) },
-  { id: 'role.architect',        version: '1.0.0', priority: 200, appliesTo: ['never'],                     source: 'static-md', maxChars: 0   , meta: DEFAULT_META(TTL_ROLE) },
-  { id: 'role.implementer',      version: '1.0.0', priority: 200, appliesTo: ['never'],                     source: 'static-md', maxChars: 0   , meta: DEFAULT_META(TTL_ROLE) },
-  { id: 'role.security',         version: '1.0.0', priority: 200, appliesTo: ['never'],                     source: 'static-md', maxChars: 0   , meta: DEFAULT_META(TTL_ROLE) },
-
-  // ── channel/ ──
-  { id: 'channel.local',         version: '1.0.0', priority: 150, appliesTo: ['local'],                     source: 'static-md', maxChars: 500 , meta: DEFAULT_META(TTL_CHANNEL) },
-  { id: 'channel.p2p-visitor',   version: '1.0.0', priority: 150, appliesTo: ['p2p-visitor'],               source: 'static-md', maxChars: 700 },
-  { id: 'channel.p2p-agent',     version: '1.0.0', priority: 150, appliesTo: ['p2p-agent'],                 source: 'static-md', maxChars: 700 },
-
-  // ── tool/ (按工具调用嵌对应 layer) ──
-  { id: 'tool.bash',             version: '1.0.0', priority: 250, appliesTo: ['tool:bash'],                source: 'static-md', maxChars: 600 , meta: DEFAULT_META(TTL_TOOL) },
-  { id: 'tool.web_search',       version: '1.0.0', priority: 250, appliesTo: ['tool:web_search'],          source: 'static-md', maxChars: 600 , meta: DEFAULT_META(TTL_TOOL) },
-  { id: 'tool.mcp_apps',         version: '1.0.0', priority: 250, appliesTo: ['never'],                   source: 'static-md', maxChars: 0    , meta: DEFAULT_META(TTL_TOOL) },
-  { id: 'tool.hibs_api',         version: '1.0.0', priority: 250, appliesTo: ['never'],                   source: 'static-md', maxChars: 0    , meta: DEFAULT_META(TTL_TOOL) },
-  { id: 'tool.image_search',     version: '1.0.0', priority: 250, appliesTo: ['never'],                   source: 'static-md', maxChars: 0    , meta: DEFAULT_META(TTL_TOOL) },
-  { id: 'tool.artifacts',        version: '1.0.0', priority: 250, appliesTo: ['never'],                   source: 'static-md', maxChars: 0    , meta: DEFAULT_META(TTL_TOOL) },
-  { id: 'tool.manifest',         version: '1.0.0', priority: 250, appliesTo: ['tool:manifest'],           source: 'static-md', maxChars: 500 , meta: DEFAULT_META(TTL_TOOL) },
-];
-
-/**
- * 动态 layer (运行时计算, 例如 project context, judgment 注入)
- * 接入现有 project-context.ts + value-injection.ts, 不重复实现
- */
-const DYNAMIC_LAYERS: PromptLayer[] = [
-  {
-    id: 'dynamic.project-context',
-    version: '1.0.0',
-    priority: 300,
-    appliesTo: ['all'],
-    source: 'function',
-    maxChars: 2000,  // 4000 → 2000 (P-Action 4), 跟 4 级层次合并上限对齐
-    resolver: async () => {
-      try {
-        const { getCachedBolloonContext } = await import('../../pi-ecosystem-judgment/human-value-pipeline.js');
-        const { formatContextForSystemPrompt } = await import('../../bootstrap/project-context.js');
-        const ctx = await getCachedBolloonContext({ cwd: process.cwd() });
-        return formatContextForSystemPrompt(ctx, { maxChars: 4000 });
-      } catch {
-        return '';
-      }
-    },
-  },
-];
-
-/**
- * 装配 system prompt — 按 context 过滤 + 排序 + 截断
- */
-export interface AssembleContext {
-  channel: 'local' | 'p2p-visitor' | 'p2p-agent';
-  role?: 'expert' | 'architect' | 'implementer' | 'security';
-  tool?: 'bash' | 'str_replace' | 'view' | 'web_search' | 'web_fetch';
-}
-
-/**
- * P-Action 4 (2026-06-15): 总字符上限 15000 → 4500.
- * 阶段 0 单次 system prompt 控制在 ≤ 4.5KB (≈ 1125 tokens).
- * 配合单 layer maxChars 收紧 + 6 layer 停用, 每轮 chat 节省 ≈ 2625 tokens.
- */
-const TOTAL_BUDGET = 4500;
-
-export async function assembleSystemPrompt(ctx: AssembleContext): Promise<{
-  text: string;
-  layerIds: string[];
-  totalChars: number;
-  truncated: string[];
-  /** P-Action 2: 每层 provenance + lifecycle metadata, 供 health 端点用 */
-  layers: PromptLayer[];
-}> {
-  // 1. 收集所有 layer
-  const allLayers: PromptLayer[] = [];
-  for (const meta of STATIC_LAYERS) {
-    const { content, meta: sectionMeta } = await loadStaticLayer(meta.id);
-    allLayers.push({ ...meta, content, meta: sectionMeta ?? meta.meta });
-  }
-  for (const dyn of DYNAMIC_LAYERS) {
-    allLayers.push({ ...dyn, meta: dyn.meta });
-  }
-
-  // 2. 过滤
-  const matched = allLayers.filter((l) => matchesContext(l, ctx));
-
-  // 3. 排序 (priority 低 → 高, 同 priority 按 id 字母)
-  matched.sort((a, b) => a.priority - b.priority || a.id.localeCompare(b.id));
-
-  // 4. 装配 + 截断
-  const parts: string[] = [];
-  const used: string[] = [];
-  const truncated: string[] = [];
-  let usedChars = 0;
-
-  for (const layer of matched) {
-    if (usedChars >= TOTAL_BUDGET) {
-      truncated.push(layer.id);
-      continue;
-    }
-    let content = '';
-    if (layer.source === 'function' && layer.resolver) {
-      try {
-        content = await layer.resolver();
-      } catch {
-        content = '';
-      }
-    } else {
-      content = layer.content || '';
-    }
-    if (content.length > layer.maxChars) {
-      content = content.slice(0, layer.maxChars) + '\n[… 已截断]';
-      truncated.push(layer.id);
-    }
-    if (usedChars + content.length > TOTAL_BUDGET) {
-      const remain = TOTAL_BUDGET - usedChars;
-      if (remain > 100) {
-        content = content.slice(0, remain) + '\n[… 预算截断]';
-      } else {
-        truncated.push(layer.id);
-        continue;
-      }
-    }
-    parts.push(`<!-- ${layer.id}@${layer.version} -->\n${content}`);
-    used.push(layer.id);
-    usedChars += content.length;
-  }
-
-  return {
-    text: stripHibsml(parts.join('\n\n')),
-    layerIds: used,
-    totalChars: usedChars,
-    truncated,
-    layers: matched,  // P-Action 2: 把 meta 也带回, 供 health 端点
-  };
-}
-
-function matchesContext(layer: PromptLayer, ctx: AssembleContext): boolean {
-  if (layer.appliesTo.includes('all')) return true;
-  for (const a of layer.appliesTo) {
-    if (a === ctx.channel) return true;
-    if (a.startsWith('role:') && a.slice(5) === ctx.role) return true;
-    if (a.startsWith('tool:') && a.slice(5) === ctx.tool) return true;
-  }
-  return false;
-}
-
-async function loadStaticLayer(id: string): Promise<{ content: string; meta: SectionMeta | null }> {
-  const path2md = idToPath(id);
-  try {
-    const raw = await fs.readFile(path2md, 'utf-8');
-    const { meta, body } = parseFrontmatter(raw);
-    return { content: body, meta };
-  } catch (err: any) {
-    console.warn(`[system-prompt] layer ${id} 读失败: ${err.message?.slice(0, 100)}`);
-    return { content: `<!-- ${id}: 文件丢失 -->`, meta: null };
-  }
-}
-
-function idToPath(id: string): string {
-  // core.refusal → layers/core/refusal.md
-  // tool.bash → layers/tool/bash.md
-  // channel.p2p-visitor → layers/channel/p2p-visitor.md
-  // core.tools.thin → layers/core/tools.thin.md (注意: 第一段是 group, 后面整段是文件名)
-  const [group, ...rest] = id.split('.');
-  return path.join(LAYERS_DIR, group, `${rest.join('.')}.md`);
-}
-
-/** 列所有 layer, 供调试 / reviewer 看 */
-export function listLayers(): Array<Omit<PromptLayer, 'content' | 'resolver'>> {
-  return [...STATIC_LAYERS, ...DYNAMIC_LAYERS.map((l) => {
-    const { resolver, ...rest } = l;
-    return rest;
-  })];
-}
-
-/** 整体版本号 — 跟 hibs 1 对齐 */
-export const SYSTEM_PROMPT_VERSION = 'hibs-1.v1.0.0';

package/src/llm/system-prompt/strip-hibsml.ts

@@ -1,52 +0,0 @@
-/**
- * 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: [RegExp, string | ((m: string, ...g: string[]) => string)][] = [
-  // {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: string): string {
-  let out = text;
-  for (const [re, rep] of HIBML_REPLACEMENTS) {
-    out = out.replace(re, rep as any);
-  }
-  // 收尾: 多个空行合并
-  out = out.replace(/\n{3,}/g, '\n\n');
-  return out.trim();
-}

package/src/llm/tool-manifest/ask_user_input.ts

@@ -1,37 +0,0 @@
-import type { ToolManifest } from './types.js';
-
-export const ask_user_input_v0: ToolManifest = {
-  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/src/llm/tool-manifest/bash.ts

@@ -1,25 +0,0 @@
-import type { ToolManifest } from './types.js';
-
-export const bash_tool: ToolManifest = {
-  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/src/llm/tool-manifest/create_file.ts

@@ -1,26 +0,0 @@
-import type { ToolManifest } from './types.js';
-
-export const create_file: ToolManifest = {
-  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/src/llm/tool-manifest/fetch_sports_data.ts

@@ -1,28 +0,0 @@
-import type { ToolManifest } from './types.js';
-
-export const fetch_sports_data: ToolManifest = {
-  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/src/llm/tool-manifest/image_search.ts

@@ -1,26 +0,0 @@
-import type { ToolManifest } from './types.js';
-
-export const image_search: ToolManifest = {
-  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/src/llm/tool-manifest/index.ts

@@ -1,88 +0,0 @@
-/**
- * tool-manifest/index.ts — 工具清单总入口
- *
- * 16 个工具的定义在 ./<tool>.ts 各文件 (1 个文件 1 个工具, 易于维护).
- * 这个文件提供:
- *   - listTools(): 返回所有 16 个
- *   - getToolManifest(id): 按 id 拿
- *   - formatForPrompt(): 把清单缩到 1-2KB 进 system prompt (远小于 24KB)
- *
- * 设计: prompt 只看到 oneLine + whenToUse + whenNotToUse + callExample (1-3 行).
- * 详细 schema (parameters 嵌套) 在代码侧 — bolloon 真实调用工具时由 PiAI 客户端读.
- */
-import type { ToolManifest } from './types.js';
-
-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: ToolManifest[] = [
-  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(): ToolManifest[] {
-  return ALL;
-}
-
-export function getToolManifest(id: string): ToolManifest | undefined {
-  return ALL.find((t) => t.id === id);
-}
-
-export function getToolsByLayer(layerId: string): ToolManifest[] {
-  return ALL.filter((t) => t.layerId === layerId);
-}
-
-/**
- * 缩到 1-3KB 装进 system prompt
- * 包含: 名字 + 一句话 + whenToUse(2) + whenNotToUse(1) + 1 行示例
- *
- * 不包含: 完整 parameters schema (那是 PiAI 客户端在调用时读)
- */
-export function formatForPrompt(tools?: ToolManifest[]): string {
-  const list = tools ?? ALL;
-  const lines: string[] = [
-    `## 工具清单 (${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/src/llm/tool-manifest/mcp.ts

@@ -1,46 +0,0 @@
-import type { ToolManifest } from './types.js';
-
-export const search_mcp_registry: ToolManifest = {
-  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: ToolManifest = {
-  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',
-};