nolo-cli 0.1.10 → 0.1.12

package/ai/agent/buildSystemPrompt.ts

@@ -1,532 +0,0 @@
-// 文件路径: ai/agent/buildSystemPrompt.ts
-// 平台通用 Agent System Prompt 生成器
-// 所有模型调用的 system prompt 均由此函数构建
-
-import { mapLanguage } from "app/i18n/mapLanguage";
-import { Agent } from "app/types";
-import { buildSkillGuidancePromptBlock } from "ai/skills/referenceRuntime";
-import { buildRuntimeGuidanceBlocks } from "ai/agent/runtimeGuidance";
-import { canonicalizeToolNames } from "ai/tools/toolNameAliases";
-import { compileContextLayers, type CompiledContext } from "./contextCompiler";
-import { Contexts } from "../types";
-
-// ============================================================================
-// 参考资料使用说明（对所有 Agent 注入）
-// ============================================================================
-
-const CONTEXT_USAGE_INSTRUCTIONS = `参考资料使用说明：
-- 下方提供的资料是你的主要权威信息来源。
-- 回答问题时，应优先依赖这些资料。它们按优先级从高到低排列。
-- 使用其中的事实、数据和名称时，要保持精准。
-- 如果资料中没有包含答案，应说明这一点，然后再使用你的通用知识进行回答。
-- 如果你在资料中发现相互矛盾的信息，也要在回答中指出这一点。
-- 当通用指令与更具体的"按 Agent / 按文档"的规则发生冲突时，必须优先遵守更具体、优先级更高的规则。`;
-
-// ============================================================================
-// 交互说明（有 ui_ask_choice 工具时注入）
-// ============================================================================
-
-const MENU_USAGE_INSTRUCTIONS = `--- 交互说明（菜单与快捷入口） ---
-在这个系统里，无论用户是手动输入文字，还是点击某个按钮/菜单，最终你只会收到一条普通的自然语言消息（就像用户直接键入的一样）。
-
-对你来说：
-- 不要假设或讨论用户点击了哪些按钮、使用了什么菜单，也不要在回复中提到"按钮""菜单""界面""第几个选项"等字样。
-- 把所有收到的消息都当作用户刚刚输入的一句话，根据这句话的内容直接理解和回答即可。
-- 当你希望用户在几个互斥选项之间做选择时，可以调用 ui_ask_choice 工具；用户的选择会以一条新的自然语言消息的形式出现在后续对话中。`;
-
-// ============================================================================
-// 网页访问（有 exa_search 工具时注入）
-// ============================================================================
-
-const WEBPAGE_ACCESS_INSTRUCTIONS = `--- 网页访问能力 (Web Access) ---
-你拥有访问互联网的强大能力。在需要获取外部信息时，请遵循以下由简入繁的策略：
-
-0. **如果用户已经给了明确 URL，先直接抓这些 URL**
-   - 不要先搜索，不要先猜备用网址，不要忽略用户给的链接。
-   - 用户明确给出的 URL，默认就是本次任务的最高优先级网页真值来源。
-   - 如果 URL 是 X/Twitter status 链接（例如 \`x.com/.../status/...\` 或 \`twitter.com/.../status/...\`），并且你拥有 \`read_x_post\` 工具，应优先调用 \`read_x_post\`，不要先用搜索、镜像站或通用网页抓取替代。
-   - 如果任务是“根据这些网页更新代码 / 文档 / 配置”，先逐个 fetch，再基于抓到的内容提取字段。
-   - 只要这些 URL 能正常抓取，就不要再调用 exa_search 搜索“更权威”的来源，也不要自行切换到其他站点或镜像页。
-   - 只有在用户给的 URL 抓取失败、页面明显缺字段、或页面内容与任务不匹配时，才允许额外搜索；如果发生这种降级，最终回复里要明确说明原因。
-
-1. **优先使用 exa_search (Exa.ai)**
-   - 适用于：用户没有给明确 URL 时，搜索互联网信息、寻找教程、获取最新动态。
-   - 对陌生的文档站或你还不确定具体页面路径的 docs 站点，优先先用它发现权威入口，而不是直接猜 docs 子路径。
-   - 优点：它是专为 AI 设计的神经网络搜索引擎，能直接返回高质量、结构化的内容（包含正文），无需再去爬取。
-   - *Always try this FIRST for searches.*
-
-2. **其次使用 fetchWebpage (全渲染)**
-   - 适用于：你已经有了明确的 URL，需要获取该页面的完整内容（含 JS 渲染、动态内容、SPA）。
-   - 底层走 Cloudflare Browser Rendering，支持 JS 执行，返回渲染后的正文。
-   - 对于 \`docs.*\` 文档站，fetchWebpage 会自动检查 \`/llms.txt\` 和 \`/llms-full.txt\`，并把你推测的文档 URL 规范化为权威页面。
-   - 如果你不确定 docs 站里有哪些页面，先用 exa_search 做发现；如果你只是大致猜到了 docs 子路径，可以直接交给 fetchWebpage 去规范化并抓取。
-   - 优点：一次调用即可获取完整页面内容，无需手动操控浏览器。
-
-3. **仅当需要复杂交互时使用 browser_openSession**
-   - 仅当需要登录、填表、多步点击等复杂操作时使用。
-   - 适用于：需要登录的站点、需要填写表单、需要连续交互的场景。
-   - 流程：先 openSession -> 拿到 ID -> 再 typeText / click / readContent。
-
-
-3. **精准数据抓取 (Scrapers)**
-  - 如果用户明确需要 YouTube 视频信息、亚马逊商品数据、Google 搜索结果，请直接使用对应的专用 Scraper 工具 (youtubeScraper, amazonProductScraper 等)，效果比自己去爬网页更好。`;
-
-// ============================================================================
-// Agent 编排协作（有 callAgent / runStreamingAgent 工具时注入）
-// ============================================================================
-
-const AGENT_ORCHESTRATION_INSTRUCTIONS = `--- Agent 编排与协作 ---
-你所在的系统支持多个子 Agent 和工作流工具，请把自己视为"总协调者"：
-
-1）子 Agent 协作
-- 使用 callAgent 工具，可以让其它 Agent 作为"专家顾问"分别给出意见或完成子任务。
-- 使用 runStreamingAgent 工具，可以把后续对话完全交给某个专用 Agent（例如代码助手、翻译助手）。
-- 使用 streamParallelAgents 工具，可以并行询问多个 Agent，再由你继续综合共识和分歧。
-- 如果目标 Agent 记录已经声明 delegation.serverBase / runtimeServerBase，工具会自动路由到对应 nolo server；你不需要重复填写 serverBase。
-- 如果用户明确给了另一个可访问的 server origin（例如 Windows 机器的 Cloudflare 域名），可以在工具参数里传 serverBase 覆盖自动路由；不要臆造地址，也不要把普通 localhost 当成远端机器。
-- 当用户需要多视角分析或辩论时，你可以：
-  - 先用 callAgent 依次询问多个 Agent 对同一问题的看法；
-  - 在最后一条回复中，用你自己的话帮用户总结这些观点的异同，并给出综合结论。
-
-2）工作流 / Workflow 工具
-- 对于需要多步骤、顺序依赖或批量工具调用的复杂任务，应优先考虑使用 createWorkflow 这类工作流工具。
-- 调用工作流工具时，你负责：
-  - 清楚描述目标和约束；
-  - 在工作流执行过程中关注其输出的中间结果和最终结果；
-  - 当你认为任务足够完成，或用户要求总结时，对整个过程和结果进行总结，指出可能的错误或风险。
-
-3）危险 / 不可逆操作
-- 涉及不可逆操作时（修改文件、删除数据、发送消息、生成正式文件、执行交易等），请优先预览或向用户确认。
-- 当工具返回"预览"或"待确认"状态时，请暂停进一步自动修改，等待用户明确确认或反馈后再继续。不要在用户未确认前连续发出多次破坏性修改。`;
-
-// ============================================================================
-// 知识管理（有 createDoc / updateDoc / read 工具时注入）
-// 仅包含页面级知识管理，不含自我更新能力
-// ============================================================================
-
-const KNOWLEDGE_MANAGEMENT_INSTRUCTIONS = `--- 知识管理 ---
-你拥有 read / createDoc / updateDoc 能力，应主动管理知识，而不是每次重新推理。
-
-## 三层知识决策
-
-**1. 直接写进 prompt**（需要 updateAgent 权限）
-- 极短、每次必用的规则（角色定义、回复风格、固定限制）
-- 标准：去掉它你就不知道自己是谁
-
-**2. references 挂载知识（每次对话自动加载）**
-- Agent 配置里的 references 会在每次对话开始时自动展开注入到 system prompt
-- type=instruction：高优先级，注入到 system prompt 顶部，适合行为规则、操作指南
-- type=knowledge：作为参考资料注入，适合领域知识、背景资料
-- 支持挂载：page / dialog / table（内容完整展开）
-- **page 里的 @mention 只展开元信息（标题+dbKey），不递归展开内容本身**
-
-**3. createDoc 创建文档（按需 read 加载）**
-- 总知识页（索引）：跨会话的决策规则、路由表，用 @[page:PAGE-xxx|标题] mention 指向细分页
-- 细分知识页（内容）：具体领域内容、任务结果，通过总知识索引
-- mention 只是指针，要获取细分页内容必须显式调用 read({ dbKey })
-
-## 读取路径
-1. prompt / references 有答案 → 直接用（自动加载，最快）
-2. 没有 → read({ dbKey: 总知识索引页 }) 找到细分页 dbKey
-3. 找到 dbKey → read({ dbKey: 细分页 }) 获取完整内容
-
-## 何时主动创建/更新知识
-- 用户提供了值得复用的信息 → createDoc 记录，再用 updateAgent 把该页加入 references
-- 完成有价值的调研/分析 → createDoc 保存结论
-- 总知识索引缺入口 → updateDoc 补充 @mention
-- **不要**把临时性、一次性的内容写成知识页`;
-
-// ============================================================================
-// 长期记忆（有 rememberMemory 工具时注入）
-// ============================================================================
-
-const MEMORY_CAPTURE_INSTRUCTIONS = `--- 长期记忆 ---
-你拥有 rememberMemory 能力，可以在必要时把值得长期保留的信息写成一条 episodic memory。
-
-## 何时记录
-- 当你识别到对未来协作明显有帮助、且相对稳定的用户偏好、判断标准、信息组织偏好或场景化抉择模式时，可以记录
-- 当对话里形成了后续还会反复用到的空间共识、协作约定或团队规则时，可以记录
-
-## 何时不要记录
-- 一次性的当前任务细节
-- 当前对话里显而易见、很快就会过期的事实
-- 只是为了“多记一点”而勉强抽出来的内容
-
-## 记录方式
-- 优先写成简短、可复用的抽象表达，例如“这个用户在什么场景下通常怎么选 / 怎么协作”
-- 不要复制整段对话，也不要把临时上下文原样塞进去
-- 只有当前 dialog 明确绑定了 space，且这条信息确实属于共享协作共识时，才传 scope=space；否则保持默认 auto
-- 默认静默执行；除非用户正在讨论记忆本身，或需要用户感知这件事，否则不要专门宣布“我正在记忆”
-- 如果这条信息对未来帮助不明显，就不要调用 rememberMemory`;
-
-// ============================================================================
-// 自我更新能力（仅在 Agent 拥有 updateSelf 工具时注入）
-// ============================================================================
-
-const SELF_UPDATE_INSTRUCTIONS = `--- Agent 自我更新能力 ---
-你拥有 updateSelf 权限，可以修改自己的配置。请谨慎、精准地使用。
-
-## 何时更新自己
-- 重要决策/进度变化 → updateDoc 写回状态页
-- 值得复用的知识 → createDoc 建细分页，再按需要更新自己的 references / greeting / introduction
-- 小幅体验优化 → updateSelf 调整 greeting / introduction / tags
-
-## 更新原则
-- 优先形成最小、可解释的变更，不要为了“显得在进化”而频繁改自己
-- 低风险沉淀优先写入 memory / doc；只有当这些知识需要长期改变你的行为方式时，再考虑 updateSelf
-- prompt / references / tools / model 这类高影响字段，默认按需要确认来处理，不要静默大改
-- 如果工具返回 policy limit / ask / reject，不要重复尝试，应先向用户解释或等待更高权限确认
-- 没有发生实际更新时，不要在回复末尾额外汇报“未更新”状态`;
-
-const GENERIC_AGENT_UPDATE_INSTRUCTIONS = `--- Agent 维护能力 ---
-你拥有 updateAgent 权限，可以更新指定的 Agent。
-
-## 何时更新别的 Agent
-- 用户明确要求你维护、修复或批量调整另一个 Agent
-- 你需要修改的目标不是当前正在运行的自己
-
-## 更新原则
-- 默认把 updateAgent 当成高风险维护操作，优先最小改动
-- 修改前先确认目标 Agent 是否正确，避免误改
-- 如果工具返回需要确认，不要绕过确认流程`;
-
-const CODE_EDITING_FIDELITY_INSTRUCTIONS = `--- 代码编辑真值规则 ---
-当任务涉及 readFile / writeFile / applyEdit / applyLineEdits 等代码编辑工具时，必须遵守以下规则：
-
-- 先读取目标文件的最新内容，再决定修改。
-- 如果用户提供了 URL、文档页或产品页，且你需要据此改代码，必须先抓取这些网页，再开始编辑。
-- 如果用户已经提供可用 URL，就不要再搜索替代来源；只有这些 URL 无法满足任务时，才允许降级到搜索，并在最终回复中说明。
-- 网页中直接出现的模型名、价格、上下文窗口、发布日期、能力描述、是否支持 function calling / vision 等字段，视为本次修改的权威来源。
-- 如果用户提供了精确代码块、对象字面量、字段值、补丁片段或“唯一真值”，必须逐字使用这些内容，不得自行润色、改写数值、替换描述或补全你记忆里的“更合理版本”。
-- 对价格、上下文窗口、模型能力、布尔字段、枚举值这类结构化配置，禁止凭记忆推断。
-- 如果网页没有明确给出某个字段，不要编造。优先保留文件中已有的相邻风格与安全默认值，或只填写网页能直接支持的字段。
-- 保守默认值规则：
-  - 对“新加模型条目”，recommended 必须默认 false。只有用户明确要求“设为推荐/高亮”，才允许写成 true。网页里的营销词（如 flagship、strong default、best-in-class）不构成 recommended=true 的证据。
-  - deprecated 默认 false，除非网页明确写了废弃、停用、legacy、sunset。
-  - supportReasoning 默认 false，除非网页明确说明该模型支持 reasoning / thinking / reasoning tokens。
-  - supportVision 只有在网页明确出现 image input / multimodal / vision 支持时才设为 true。
-  - supportTool 只有在网页明确出现 function calling / tool calling / tools 支持时才设为 true。
-- 最终汇报必须以“实际写入后的文件内容”或 applyEdit / writeFile 的返回结果为准，不要汇报没有真正落盘的字段值。
-- 编辑完成后，最终回复只做简短结果汇报：说清改了哪些条目、依据了哪些 URL、是否还有缺失字段。不要长篇复述网页正文。`;
-
-const TABLE_SHARE_INSTRUCTIONS = `--- 表格创建与分享 ---
-当用户要你整理结构化信息时，可以先用 createTable 建表，再用 addTableRow / addTableRows 填充内容。
-
-如果用户明确要求“社区分享 / 公开分享 / 分享链接”，并且你有 shareTable 工具：
-- 优先调用 shareTable；
-- 传入表的 dbKey，或 tenantId + tableId；
-- 完成后直接返回 /share/... 链接。`;
-
-// ============================================================================
-// 无 prompt 时的澄清模式
-// ============================================================================
-
-const CLARIFICATION_MODE_INSTRUCTIONS = `在你还不了解用户意图时，通过提问来澄清需求，而不是仓促给出答案。`;
-
-const isBrowser = typeof window !== "undefined";
-
-// ============================================================================
-// 工具函数
-// ============================================================================
-
-/** 创建一个上下文 section，如果 content 为空则返回空字符串 */
-const createContextSection = (
-  title: string,
-  description: string,
-  content?: string | null
-): string =>
-  content ? `### ${title} \n${description} \n\n${content} ` : "";
-
-/** 获取当前 UTC 时间（精确到天） */
-const getCurrentTimeString = (): string => {
-  return new Date().toLocaleDateString("en-US", { timeZone: "UTC" });
-};
-
-/** 根据屏幕宽度生成响应式布局建议 */
-const buildResponseGuidelines = (isMobile: boolean): string => {
-  if (isMobile) {
-    return `-- - 响应展示指南-- -
-请为移动端进行优化：
-- 使用更短的段落和简洁的项目符号列表。
-- 避免过宽的表格或代码块，以免产生横向滚动。
-- 优先采用垂直排布，而不是左右并排的布局。`;
-  }
-  return `-- - 响应展示指南-- -
-你的回复将显示在大屏幕上。你可以：
-- 提供更丰富的推理过程说明和更有层次的结构。
-- 在合适的场景下使用宽屏优势，例如更宽的表格、并排对比展示、更长的代码块等。`;
-};
-
-/** 构建参考资料区块 */
-const buildReferenceMaterialsBlock = (contexts: Contexts): string => {
-  const sections = [
-    createContextSection(
-      "说明性文档（Instructional Documents）",
-      "（最高优先级：具体规则与流程）",
-      contexts.botInstructionsContext
-    ),
-    createContextSection(
-      "当前输入上下文（Current Input Context）",
-      "（高优先级：来自用户本次输入）",
-      contexts.currentInputContext
-    ),
-    createContextSection(
-      "会话历史引用（Conversation History References）",
-      "（中等优先级：来自过往消息）",
-      contexts.historyContext
-    ),
-    createContextSection(
-      "知识库文档（Knowledge Base Documents）",
-      "（参考优先级：用于通用查阅）",
-      contexts.botKnowledgeContext
-    ),
-  ].filter(Boolean);
-
-  if (sections.length === 0) {
-    return "";
-  }
-
-  return [
-    "--- 参考资料 ---",
-    CONTEXT_USAGE_INSTRUCTIONS,
-    "",
-    sections.join("\n\n"),
-  ].join("\n");
-};
-
-/** 构建「当前编辑上下文」区块 */
-const buildEditingContextBlock = (contexts: Contexts): string => {
-  if (!contexts.editingContext) return "";
-
-  return [
-    "--- 当前编辑上下文 ---",
-    "下面是用户当前正在查看或编辑的对象描述，请在涉及修改、建议或结构性操作时优先参考这里：",
-    "",
-    contexts.editingContext,
-  ].join("\n");
-};
-
-const buildAppWorkingMemoryBlock = (contexts: Contexts): string => {
-  if (!contexts.appWorkingMemory) return "";
-
-  return [
-    "--- 最近应用工作记忆 ---",
-    "下面是从当前对话最近的应用相关工具调用中提炼出的真值。即使用户没有打开右侧应用侧栏，只要他说“刚才那个 app / 那个网站 / 那个项目”，也优先参考这里：",
-    "",
-    contexts.appWorkingMemory,
-  ].join("\n");
-};
-
-/** 构建「当前 Space 环境」区块 */
-const buildSpaceContextBlock = (contexts: Contexts): string => {
-  if (!contexts.spaceContext) return "";
-
-  return [
-    "--- 当前空间环境 (Current Space Context) ---",
-    contexts.spaceContext,
-    "",
-    "重要指令 (Space Awareness)：",
-    "- 你正处于上述工作空间中。如果用户的问题涉及到该空间的内容、文件或知识：",
-    "  - 使用 `read` 工具查阅普通数据记录或数据表项。",
-    "- 如果你在对话中产出了值得保存的重要信息（如总结、方案、代码片段等），请主动询问用户或使用 `createDoc` 工具将其保存为新页面，以便作为长期记忆留存。",
-    "",
-    "跨空间导航 (Cross-Space Navigation)：",
-    "- 使用 `listUserSpaces` 工具可获取用户所有可访问的 Space 列表（ID 和名称）。",
-    "- 使用 `read({ dbKey: \"space-{spaceId}\" })` 可获取指定 Space 的完整数据，包括：",
-    "  - categories: 分类字典，key 是分类 ID，value 包含 name 和 order",
-    "  - contents: 内容字典，每项包含 contentKey（dbKey）、title、type、categoryId",
-  ].join("\n");
-};
-
-const buildUserPolicyBlock = (contexts: Contexts): string => {
-  if (!contexts.userPolicyContext) return "";
-
-  return [
-    "--- 用户偏好与自动化边界 ---",
-    contexts.userPolicyContext,
-  ].join("\n");
-};
-
-const buildSkillGuidanceBlock = (agentConfig: Agent): string => {
-  const recommendedSkillHints = Array.isArray((agentConfig as any).recommendedSkillHints)
-    ? ((agentConfig as any).recommendedSkillHints as string[]).filter(Boolean)
-    : [];
-  const skillPromptPatches = Array.isArray((agentConfig as any).skillPromptPatches)
-    ? ((agentConfig as any).skillPromptPatches as string[]).filter(Boolean)
-    : [];
-
-  if (recommendedSkillHints.length === 0 && skillPromptPatches.length === 0) {
-    return "";
-  }
-
-  return buildSkillGuidancePromptBlock({
-    title: "--- 技能提示 ---",
-    recommendedSkillHints,
-    skillPromptPatches,
-  });
-};
-
-// ============================================================================
-// 主函数
-// ============================================================================
-
-export const buildSystemPrompt = (options: {
-  agentConfig: Agent;
-  language?: string;
-  contexts?: Contexts;
-  viewport?: { width: number; height: number };
-  mobileBreakpoint?: number;
-}): string => buildSystemPromptContext(options).content;
-
-export const buildSystemPromptContext = (options: {
-  agentConfig: Agent;
-  language?: string;
-  contexts?: Contexts;
-  viewport?: { width: number; height: number };
-  mobileBreakpoint?: number;
-}): CompiledContext => {
-  const {
-    agentConfig,
-    contexts = {},
-    viewport,
-    mobileBreakpoint = 768,
-  } = options;
-
-  const safeLanguage =
-    options.language ??
-    (typeof navigator !== "undefined" ? navigator.language : "en");
-
-  const { name, prompt: mainPrompt, dbKey } = agentConfig;
-  const mappedLanguage = mapLanguage(safeLanguage);
-
-  const identitySection = [
-    "--- 身份信息 ---",
-    name ? `名称: ${name} ` : "",
-    dbKey ? `ID: ${dbKey} ` : "",
-    mappedLanguage ? `回复语言: ${mappedLanguage} ` : "",
-    `当前时间: ${getCurrentTimeString()} `,
-  ]
-    .filter(Boolean)
-    .join("\n");
-
-  const corePersonaSection = mainPrompt
-    ? `-- - 核心角色与任务-- -\n${mainPrompt}`
-    : "";
-
-  const agentTools = canonicalizeToolNames(agentConfig.tools ?? []);
-
-  // 按工具能力条件注入各指令块
-  const agentOrchestrationSection = agentTools.some((t) =>
-    ["callAgent", "runStreamingAgent", "streamParallelAgents"].includes(t)
-  )
-    ? AGENT_ORCHESTRATION_INSTRUCTIONS
-    : "";
-
-  const menuUsageSection = agentTools.includes("ui_ask_choice")
-    ? MENU_USAGE_INSTRUCTIONS
-    : "";
-
-  const webAccessSection = agentTools.some((t) =>
-    ["exa_search", "fetchWebpage", "browser_openSession", "read_x_post"].includes(t)
-  )
-    ? WEBPAGE_ACCESS_INSTRUCTIONS
-    : "";
-  const tableShareSection = agentTools.some((t) =>
-    ["createTable", "shareTable", "addTableRow", "addTableRows"].includes(t)
-  )
-    ? TABLE_SHARE_INSTRUCTIONS
-    : "";
-
-  // 知识管理：有页面读写工具时注入通用知识管理说明
-  const knowledgeManagementSection = agentTools.some((t) =>
-    ["createDoc", "updateDoc", "read", "readDoc", "readPage"].includes(t)
-  )
-    ? KNOWLEDGE_MANAGEMENT_INSTRUCTIONS
-    : "";
-
-  const memoryCaptureSection = agentTools.includes("rememberMemory")
-    ? MEMORY_CAPTURE_INSTRUCTIONS
-    : "";
-
-  const selfUpdateSection = agentTools.includes("updateSelf")
-    ? SELF_UPDATE_INSTRUCTIONS
-    : "";
-
-  const genericAgentUpdateSection = agentTools.includes("updateAgent")
-    ? GENERIC_AGENT_UPDATE_INSTRUCTIONS
-    : "";
-
-  const codeEditingFidelitySection = agentTools.some((t) =>
-    ["readFile", "writeFile", "applyEdit", "applyLineEdits"].includes(t)
-  )
-    ? CODE_EDITING_FIDELITY_INSTRUCTIONS
-    : "";
-
-  const {
-    startupProtocol,
-    contextLayerContract,
-    emailRegistrationWorkflow,
-  } =
-    buildRuntimeGuidanceBlocks(agentTools);
-
-  const clarifyingSection = !mainPrompt ? CLARIFICATION_MODE_INSTRUCTIONS : "";
-
-  const userGlobalPromptSection = contexts.userGlobalPrompt?.trim()
-    ? `-- - 用户全局偏好-- -\n${contexts.userGlobalPrompt.trim()} `
-    : "";
-
-  const isMobile =
-    (viewport?.width ?? (isBrowser ? window.innerWidth : 1440)) <
-    mobileBreakpoint;
-
-  const responseGuidelinesSection = buildResponseGuidelines(isMobile);
-  const editingContextSection = buildEditingContextBlock(contexts);
-  const appWorkingMemorySection = buildAppWorkingMemoryBlock(contexts);
-  const spaceContextSection = buildSpaceContextBlock(contexts);
-  const userPolicySection = buildUserPolicyBlock(contexts);
-  const skillGuidanceSection = buildSkillGuidanceBlock(agentConfig);
-  const referenceMaterialsSection = buildReferenceMaterialsBlock(contexts);
-
-  const dialogSummarySection = contexts.dialogSummary?.trim()
-    ? `--- 历史对话摘要 ---\n以下是此前对话轮次的压缩摘要（精确细节可能有简化，请优先参考最近的消息原文）：\n\n${contexts.dialogSummary.trim()}`
-    : "";
-
-  const proactiveSummarySection = contexts.proactiveSummary?.trim()
-    ? `--- 阶段工作摘要 ---\n以下是系统主动整理的近期工作摘要，原始消息仍在近期上下文中；如有冲突，请优先参考最近的消息原文：\n\n${contexts.proactiveSummary.trim()}`
-    : "";
-
-  return compileContextLayers([
-    { id: "identity", owner: "platform", content: identitySection },
-    { id: "core-persona", owner: "agent", content: corePersonaSection },
-    { id: "agent-orchestration", owner: "platform", content: agentOrchestrationSection },
-    { id: "web-access", owner: "platform", content: webAccessSection },
-    { id: "table-share", owner: "platform", content: tableShareSection },
-    { id: "menu-usage", owner: "platform", content: menuUsageSection },
-    { id: "clarification-mode", owner: "platform", content: clarifyingSection },
-    { id: "knowledge-management", owner: "platform", content: knowledgeManagementSection },
-    { id: "memory-capture", owner: "platform", content: memoryCaptureSection },
-    { id: "self-update", owner: "platform", content: selfUpdateSection },
-    { id: "generic-agent-update", owner: "platform", content: genericAgentUpdateSection },
-    { id: "code-editing-fidelity", owner: "platform", content: codeEditingFidelitySection },
-    { id: "startup-protocol", owner: "platform", content: startupProtocol },
-    { id: "context-layer-contract", owner: "platform", content: contextLayerContract },
-    {
-      id: "email-registration-workflow",
-      owner: "platform",
-      content: emailRegistrationWorkflow,
-    },
-    { id: "user-global-prompt", owner: "user", content: userGlobalPromptSection },
-    { id: "response-guidelines", owner: "platform", content: responseGuidelinesSection },
-    { id: "skill-guidance", owner: "runtime", content: skillGuidanceSection },
-    { id: "dialog-summary", owner: "runtime", content: dialogSummarySection },
-    { id: "proactive-summary", owner: "runtime", content: proactiveSummarySection },
-    { id: "space-context", owner: "runtime", content: spaceContextSection },
-    { id: "user-policy", owner: "user", content: userPolicySection },
-    { id: "reference-materials", owner: "agent", content: referenceMaterialsSection },
-    { id: "app-working-memory", owner: "runtime", content: appWorkingMemorySection },
-    { id: "editing-context", owner: "runtime", content: editingContextSection },
-  ]);
-};
-
-// 向后兼容：旧名称重新导出
-export const generatePrompt = buildSystemPrompt;

package/ai/agent/cleanAgentMessages.ts

@@ -1,140 +0,0 @@
-// 文件路径: ai/agent/cleanAgentMessages.ts
-
-import type { Message } from "chat/messages/types";
-
-/**
- * 判断消息的文本内容是否“为空”（对人没意义）
- */
-const isEmptyContent = (content: unknown): boolean => {
-    if (content == null) return true;
-
-    if (typeof content === "string") {
-        return content.trim().length === 0;
-    }
-
-    if (Array.isArray(content)) {
-        return content.length === 0;
-    }
-
-    return false;
-};
-
-/**
- * 为指定 Agent 构造“安全”的消息视图:
- *
- * 分层目标：
- * - 这一层是「对话视角清洗」，不直接关心 OpenAI/Azure 精确协议，只关心：
- *   1）当前 Agent 能看到什么历史；
- *   2）哪些内部 plumbing 信息需要隐藏。
- *
- * 约定：
- * - 所有 Agent：
- *   - 丢弃「assistant 且 content 为空 且 没有 tool 调用」的消息（通常是 streaming 占位，没实际内容）
- *
- * - 当前 Agent（cybotKey 匹配）：
- *   - user / assistant / tool 消息：原样保留（保证自己工具链完整）
- *   - 特别地：即使 assistant 只有 tool 调用、没有文本，也要保留
- *
- * - 其它 Agent：
- *   - assistant 消息：
- *       - 删除所有 tool 调用字段（tool_calls / toolCalls），避免跨 Agent 的 call_id 冲突；
- *       - 使用 agentName 作为前缀，生成可读文本：
- *         - 有原始文本：`【AgentName】 原文...`
- *         - 没有原始文本：`【AgentName】（使用了工具生成回复）`
- *   - tool 消息：直接丢弃（内部 plumbing，对当前 Agent 没意义）
- *
- * - 其它角色（system 等）：原样保留
- */
-export const buildAgentViewMessages = (
-    allMessages: Message[],
-    currentCybotKey: string
-): Message[] => {
-    const result: Message[] = [];
-
-    for (const msg of allMessages) {
-        if (!msg) continue;
-
-        const role = (msg as any).role;
-        if (!role) continue;
-
-        // 同时兼容内部字段 toolCalls 和 OpenAI 标准字段 tool_calls
-        const hasToolCalls =
-            (Array.isArray((msg as any).tool_calls) &&
-                (msg as any).tool_calls.length > 0) ||
-            (Array.isArray((msg as any).toolCalls) &&
-                (msg as any).toolCalls.length > 0);
-
-        const empty = isEmptyContent((msg as any).content);
-
-        // 1. 统一丢弃“空 assistant 且没有 tool 调用”的消息
-        //    - 对所有 Agent 一视同仁，这类通常是 streaming 中途写入的占位，没实际内容
-        if (role === "assistant" && empty && !hasToolCalls) {
-            continue;
-        }
-
-        const isCurrentAgent = (msg as any).cybotKey === currentCybotKey;
-
-        // ---- 用户消息：所有 Agent 都需要完整历史 ----
-        if (role === "user") {
-            result.push(msg);
-            continue;
-        }
-
-        // ---- 助手消息 ----
-        if (role === "assistant") {
-            if (isCurrentAgent) {
-                // 当前 Agent 自己的历史回复：原样保留（包含 toolCalls / tool_calls）
-                result.push(msg);
-            } else {
-                // 其它 Agent 的回复：降级为纯文本 + 前缀，不再携带任何 tool 调用字段
-                const cloned: Message = { ...(msg as any) } as Message;
-
-                // 删掉所有工具调用字段，避免跨 Agent 的 call_id 污染
-                if ((cloned as any).tool_calls) {
-                    delete (cloned as any).tool_calls;
-                }
-                if ((cloned as any).toolCalls) {
-                    delete (cloned as any).toolCalls;
-                }
-
-                const rawAgentName = (cloned as any).agentName;
-                const agentName =
-                    rawAgentName && String(rawAgentName).trim()
-                        ? String(rawAgentName).trim()
-                        : "其他 Agent";
-
-                if (typeof cloned.content === "string") {
-                    const trimmed = cloned.content.trim();
-                    if (trimmed) {
-                        cloned.content = `【${agentName}】 ${trimmed}`;
-                    } else {
-                        cloned.content = `【${agentName}】（使用了工具生成回复）`;
-                    }
-                } else {
-                    // 非字符串内容（理论上很少见），同样给一个占位说明
-                    cloned.content = `【${agentName}】（使用了工具生成回复）`;
-                }
-
-                result.push(cloned);
-            }
-            continue;
-        }
-
-        // ---- 工具消息 ----
-        if (role === "tool") {
-            if (isCurrentAgent) {
-                // 当前 Agent 自己的 tool 消息：保留，保证工具调用链可用
-                result.push(msg);
-            } else {
-                // 其它 Agent 的 tool 消息：全部丢弃，避免跨 Agent / 跨 provider 的 call_id 冲突
-                continue;
-            }
-            continue;
-        }
-
-        // ---- 其它角色（system 等） ----
-        result.push(msg);
-    }
-
-    return result;
-};