nolo-cli 0.1.18 → 0.1.20

package/agentRuntimeLocal.ts

@@ -1,7 +1,45 @@
+export {
+  buildOpenAiCompatibleChatCompletionRequest,
+  buildPlatformChatCompletionRequest,
+  canUsePlatformChatProvider,
+  hasDirectOpenAiCompatibleProvider,
+  createHybridRecordStore,
+  executeLocalToolWithPolicy,
+  activateWorkspaceSession,
+  createWorkspaceSession,
+  buildAgentRuntimeAgentLookupKeys,
+  buildAgentRuntimeDialogWritePlan,
+  dialogMessageRecordToAgentRuntimeMessage,
+  formatWorkspaceSessionActivation,
+  pickAgentRuntimeInferenceOptions,
+  parseOpenAiCompatibleChatCompletionResponse,
+  parsePlatformChatCompletionData,
+  parsePlatformChatCompletionResponse,
+  resolveAgentRuntimeConfigFromRecord,
+  resolvePlatformChatProviderConfig,
+  resolveLocalToolPolicy,
+  resolveOpenAiCompatibleProviderConfig,
+  shouldUsePlatformChatProvider,
+  shouldCacheHybridRemoteRecord,
+  shouldFetchAgentRuntimeRecordRemotely,
+} from "./agent-runtime";
 export { runLocalAgentTurn } from "./agent-runtime/localLoop";
+export {
+  buildLocalWorkspaceOpenAiTools,
+  buildLocalWorkspacePolicyToolNames,
+  buildLocalWorkspaceToolset,
+  createLocalWorkspaceToolExecutors,
+} from "./agent-runtime/localWorkspaceTools";
 export type {
   AgentRuntimeAgentConfig,
   AgentRuntimeHostAdapter,
   AgentRuntimeRequestedMode,
   AgentRuntimeSaveTurnInput,
+  HybridRecordKvDb,
+  HybridRecordStore,
+  LocalToolPolicyDecision,
+  PreparedTaskWorkspace,
+  PrepareTaskWorkspace,
+  WorkspaceSession,
+  WorkspaceSessionMode,
 } from "./agent-runtime";

package/ai/agent/agentSlice.ts

@@ -193,6 +193,16 @@ const processAgentUpdateChanges = (
   if ("useServerProxy" in data && data.useServerProxy !== undefined) {
     changes.useServerProxy = !!data.useServerProxy;
   }
+  if ("sharingLevel" in data) {
+    const sharingLevel = (data as any).sharingLevel;
+    if (
+      sharingLevel === "default" ||
+      sharingLevel === "split" ||
+      sharingLevel === "full"
+    ) {
+      changes.sharingLevel = sharingLevel;
+    }
+  }
 
   // greeting / tools 直接透传
   if ("greeting" in data) {

package/ai/agent/buildEditingContext.ts

@@ -2,6 +2,7 @@
 
 import type { RootState } from "app/store";
 import type { AgentRuntimeOptions } from "./types";
+import { buildCanvasNodeEditingContextSummary } from "./canvasEditingContext";
 import { selectCurrentTable, selectTableRows } from "render/table/tableSlice";
 import { selectDoc } from "render/page/docSlice";
 
@@ -368,6 +369,10 @@ export const buildEditingContextSummary = (
         ].join("\n");
     }
 
+    if (targetKind === "canvas_node") {
+        return buildCanvasNodeEditingContextSummary(runtimeOptions);
+    }
+
     // 其它 kind 以后按需扩展
     return null;
 };

package/ai/agent/buildSystemPrompt.ts

@@ -7,6 +7,7 @@ import { Agent } from "app/types";
 import { buildSkillGuidancePromptBlock } from "ai/skills/referenceRuntime";
 import { buildRuntimeGuidanceBlocks } from "ai/agent/runtimeGuidance";
 import { canonicalizeToolNames } from "ai/tools/toolNameAliases";
+import { PAGE_BUILDER_HANDOFF_INSTRUCTIONS } from "./pageBuilderHandoffRules";
 import { compileContextLayers, type CompiledContext } from "./contextCompiler";
 import { Contexts } from "../types";
 
@@ -31,20 +32,18 @@ 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 抓取失败、页面明显缺字段、或页面内容与任务不匹配时，才允许额外搜索；如果发生这种降级，最终回复里要明确说明原因。
@@ -71,6 +70,20 @@ const WEBPAGE_ACCESS_INSTRUCTIONS = `--- 网页访问能力 (Web Access) ---
 3. **精准数据抓取 (Scrapers)**
   - 如果用户明确需要 YouTube 视频信息、亚马逊商品数据、Google 搜索结果，请直接使用对应的专用 Scraper 工具 (youtubeScraper, amazonProductScraper 等)，效果比自己去爬网页更好。`;
 
+// ============================================================================
+// 本地文件整理（有 local desktop file tools 时注入）
+// ============================================================================
+
+const LOCAL_FILE_ORGANIZATION_INSTRUCTIONS = `--- 本地文件整理能力 ---
+你可以帮助用户整理 Windows 桌面客户端里已授权的本地文件夹。必须遵守：
+
+- 只能访问用户已授权的本地文件夹，所有路径都必须是授权根目录内的相对路径。
+- 开始整理前，先列目录和读取必要文件，理解现状后再提出计划。
+- 对移动、重命名、写入、删除等改动，不要直接修改文件；先调用 proposeLocalFileChanges 创建待确认计划。
+- 用户确认后，才执行已确认的本地文件整理计划。
+- 删除类操作要保守；能通过移动到整理目录解决时，不要优先删除。
+- 回复用户时说明将要改哪些文件、为什么改、以及是否可撤销。`;
+
 // ============================================================================
 // Agent 编排协作（有 callAgent / runStreamingAgent 工具时注入）
 // ============================================================================
@@ -79,9 +92,6 @@ 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 当成远端机器。
 - 当用户需要多视角分析或辩论时，你可以：
@@ -105,22 +115,17 @@ const AGENT_ORCHESTRATION_INSTRUCTIONS = `--- Agent 编排与协作 ---
 // ============================================================================
 
 const KNOWLEDGE_MANAGEMENT_INSTRUCTIONS = `--- 知识管理 ---
-你拥有 read / createDoc / updateDoc 能力，应主动管理知识，而不是每次重新推理。
 
 ## 三层知识决策
 
-**1. 直接写进 prompt**（需要 updateAgent 权限）
-- 极短、每次必用的规则（角色定义、回复风格、固定限制）
-- 标准：去掉它你就不知道自己是谁
-
-**2. references 挂载知识（每次对话自动加载）**
+**1. references 挂载知识（每次对话自动加载）**
 - Agent 配置里的 references 会在每次对话开始时自动展开注入到 system prompt
 - type=instruction：高优先级，注入到 system prompt 顶部，适合行为规则、操作指南
 - type=knowledge：作为参考资料注入，适合领域知识、背景资料
 - 支持挂载：page / dialog / table（内容完整展开）
 - **page 里的 @mention 只展开元信息（标题+dbKey），不递归展开内容本身**
 
-**3. createDoc 创建文档（按需 read 加载）**
+**2. createDoc 创建文档（按需 read 加载）**
 - 总知识页（索引）：跨会话的决策规则、路由表，用 @[page:PAGE-xxx|标题] mention 指向细分页
 - 细分知识页（内容）：具体领域内容、任务结果，通过总知识索引
 - mention 只是指针，要获取细分页内容必须显式调用 read({ dbKey })
@@ -164,7 +169,6 @@ const MEMORY_CAPTURE_INSTRUCTIONS = `--- 长期记忆 ---
 // ============================================================================
 
 const SELF_UPDATE_INSTRUCTIONS = `--- Agent 自我更新能力 ---
-你拥有 updateSelf 权限，可以修改自己的配置。请谨慎、精准地使用。
 
 ## 何时更新自己
 - 重要决策/进度变化 → updateDoc 写回状态页
@@ -210,8 +214,6 @@ const CODE_EDITING_FIDELITY_INSTRUCTIONS = `--- 代码编辑真值规则 ---
 - 编辑完成后，最终回复只做简短结果汇报：说清改了哪些条目、依据了哪些 URL、是否还有缺失字段。不要长篇复述网页正文。`;
 
 const TABLE_SHARE_INSTRUCTIONS = `--- 表格创建与分享 ---
-当用户要你整理结构化信息时，可以先用 createTable 建表，再用 addTableRow / addTableRows 填充内容。
-
 如果用户明确要求“社区分享 / 公开分享 / 分享链接”，并且你有 shareTable 工具：
 - 优先调用 shareTable；
 - 传入表的 dbKey，或 tenantId + tableId；
@@ -419,7 +421,10 @@ export const buildSystemPromptContext = (options: {
   const agentOrchestrationSection = agentTools.some((t) =>
     ["callAgent", "runStreamingAgent", "streamParallelAgents"].includes(t)
   )
-    ? AGENT_ORCHESTRATION_INSTRUCTIONS
+    ? [
+      AGENT_ORCHESTRATION_INSTRUCTIONS,
+      agentTools.includes("runStreamingAgent") ? PAGE_BUILDER_HANDOFF_INSTRUCTIONS : "",
+    ].filter(Boolean).join("\n\n")
     : "";
 
   const menuUsageSection = agentTools.includes("ui_ask_choice")
@@ -431,6 +436,17 @@ export const buildSystemPromptContext = (options: {
   )
     ? WEBPAGE_ACCESS_INSTRUCTIONS
     : "";
+  const localFileOrganizationSection = agentTools.some((t) =>
+    [
+      "listLocalFiles",
+      "readLocalFile",
+      "proposeLocalFileChanges",
+      "executeApprovedLocalFileChanges",
+      "undoLocalFileChangeBatch",
+    ].includes(t)
+  )
+    ? LOCAL_FILE_ORGANIZATION_INSTRUCTIONS
+    : "";
   const tableShareSection = agentTools.some((t) =>
     ["createTable", "shareTable", "addTableRow", "addTableRows"].includes(t)
   )
@@ -466,6 +482,7 @@ export const buildSystemPromptContext = (options: {
     startupProtocol,
     contextLayerContract,
     emailRegistrationWorkflow,
+    webResearchToolPolicy,
   } =
     buildRuntimeGuidanceBlocks(agentTools);
 
@@ -500,6 +517,7 @@ export const buildSystemPromptContext = (options: {
     { id: "core-persona", owner: "agent", content: corePersonaSection },
     { id: "agent-orchestration", owner: "platform", content: agentOrchestrationSection },
     { id: "web-access", owner: "platform", content: webAccessSection },
+    { id: "local-file-organization", owner: "platform", content: localFileOrganizationSection },
     { id: "table-share", owner: "platform", content: tableShareSection },
     { id: "menu-usage", owner: "platform", content: menuUsageSection },
     { id: "clarification-mode", owner: "platform", content: clarifyingSection },
@@ -515,6 +533,11 @@ export const buildSystemPromptContext = (options: {
       owner: "platform",
       content: emailRegistrationWorkflow,
     },
+    {
+      id: "web-research-tool-policy",
+      owner: "platform",
+      content: webResearchToolPolicy,
+    },
     { id: "user-global-prompt", owner: "user", content: userGlobalPromptSection },
     { id: "response-guidelines", owner: "platform", content: responseGuidelinesSection },
     { id: "skill-guidance", owner: "runtime", content: skillGuidanceSection },

package/ai/agent/canvasEditingContext.ts

@@ -0,0 +1,49 @@
+import type { AgentRuntimeOptions } from "./types";
+
+export function buildCanvasNodeEditingContextSummary(
+  runtimeOptions?: AgentRuntimeOptions
+): string | null {
+  if (runtimeOptions?.editingTarget?.kind !== "canvas_node") return null;
+
+  const editingTarget = runtimeOptions.editingTarget;
+  const metadata = editingTarget.metadata ?? {};
+  const selectedNodeId =
+    typeof metadata.selectedNodeId === "string"
+      ? metadata.selectedNodeId
+      : editingTarget.key ?? "(未知节点)";
+  const part =
+    typeof metadata.part === "string"
+      ? metadata.part
+      : editingTarget.title ?? selectedNodeId;
+  const nodeType =
+    typeof metadata.type === "string" ? metadata.type : "(未知类型)";
+  const path = Array.isArray(metadata.path)
+    ? metadata.path.filter((item): item is string => typeof item === "string")
+    : [];
+  const props = metadata.props && typeof metadata.props === "object"
+    ? metadata.props
+    : {};
+  const style = metadata.style && typeof metadata.style === "object"
+    ? metadata.style
+    : {};
+
+  return [
+    "当前编辑目标：Canvas Tree 中的一个选中节点。",
+    `- 节点 ID: ${selectedNodeId}`,
+    `- part: ${part}`,
+    `- 节点类型: ${nodeType}`,
+    ...(path.length ? [`- 节点路径: ${path.join(" > ")}`] : []),
+    "",
+    "当前节点 props:",
+    JSON.stringify(props, null, 2),
+    "",
+    "当前节点 style:",
+    JSON.stringify(style, null, 2),
+    "",
+    "【给 AI 的操作指南 / 非用户原话】",
+    `1. 如果用户要求修改当前模块，只输出 updateNode，目标 id 必须是 ${selectedNodeId}。`,
+    "2. 不要重建 root/shell，不要重新 append 已存在的大块内容。",
+    "3. 除非用户明确要求新增子模块，否则不要 appendNode。",
+    "4. 回复仍必须遵守 Canvas Tree MVP 协议：只输出 canvas_snapshot NDJSON，不要输出解释或源码。",
+  ].join("\n");
+}

package/ai/agent/cliExecutor.ts

@@ -29,6 +29,7 @@ export interface CliExecuteOptions {
   model?: string;
   timeout?: number;   // ms，默认 120_000
   cwd?: string;
+  env?: Record<string, string | undefined>;
   yolo?: boolean;     // 允许所有工具，默认 true（后台任务常用）
 }
 
@@ -62,6 +63,16 @@ export interface CliSessionTurnResult extends CliExecuteResult {
 
 const cliSessions = new Map<string, CliSessionState>();
 
+function buildCliProcessEnv(extraEnv?: Record<string, string | undefined>) {
+  return Object.fromEntries(
+    Object.entries({
+      ...process.env,
+      ...extraEnv,
+      NO_COLOR: "1",
+    }).filter((entry): entry is [string, string] => typeof entry[1] === "string")
+  );
+}
+
 // ── 各 provider 实现 ─────────────────────────────────────────────────────────
 
 /**
@@ -97,7 +108,7 @@ function executeCopilot(
 
     exec(
       cmd,
-      { timeout, cwd, env: { ...process.env } },
+      { timeout, cwd, env: buildCliProcessEnv(options.env) },
       (error, stdout, stderr) => {
         if (error) {
           if (error.killed && (error as any).signal === "SIGTERM") {
@@ -198,7 +209,7 @@ function executeGemini(
 
     exec(
       cmd,
-      { timeout, cwd, env: { ...process.env } },
+      { timeout, cwd, env: buildCliProcessEnv(options.env) },
       (error, stdout, stderr) => {
         if (error) {
           if (error.killed && (error as any).signal === "SIGTERM") {
@@ -255,7 +266,7 @@ function executeCodex(
     const start = Date.now();
     const proc = spawn("codex", [...args, prompt], {
       cwd,
-      env: { ...process.env, NO_COLOR: "1" },
+      env: buildCliProcessEnv(options.env),
       stdio: ["ignore", "pipe", "pipe"],
     });
     let stdout = "";
@@ -335,7 +346,7 @@ function executeClaude(
     const start = Date.now();
     const proc = spawn("claude", args, {
       cwd,
-      env: { ...process.env, NO_COLOR: "1" },
+      env: buildCliProcessEnv(options.env),
       stdio: ["ignore", "pipe", "pipe"],
     });
     let stdout = "";

package/ai/agent/createAgentSchema.ts

@@ -112,6 +112,8 @@ export const getCreateAgentSchema = (t: TFunction) =>
 
       outputPrice: z.number().min(0, t("validation.priceMin")).default(0),
 
+      sharingLevel: z.enum(["default", "split", "full"]).optional(),
+
       avatarFileId: z.string().optional().or(z.string().length(0)),
 
       tags: z.string().trim().optional().or(z.string().length(0)),

package/ai/agent/executeToolCall.ts

@@ -24,7 +24,7 @@ interface ToolCall {
 export async function executeToolCall(
   tc: ToolCall,
   thunkApi: any,
-  parentMessageId?: string
+  context?: { parentMessageId?: string; agentKey?: string }
 ): Promise<string> {
   const toolName: string = tc.function?.name ?? "";
   const toolArgs = (() => {
@@ -41,7 +41,8 @@ export async function executeToolCall(
       return `[工具 "${toolName}" 未找到]`;
     }
     const result = await executor(toolArgs, thunkApi, {
-      parentMessageId: parentMessageId ?? "",
+      parentMessageId: context?.parentMessageId ?? "",
+      agentKey: context?.agentKey,
     });
     // executor 返回 { rawData, displayData? } 或直接返回字符串
     const raw = result?.rawData ?? result;

package/ai/agent/hooks/usePublicAgents.ts

@@ -43,6 +43,8 @@ export interface UsePublicAgentsOptions {
   imageOutputOnly?: boolean;
   /** Filter agents that include this tool in their tools array */
   toolName?: string;
+  /** Return list-card metadata only from remote public-agent APIs. */
+  summary?: boolean;
   initialData?: Agent[];
   reloadMode?: "preview" | "catalog";
 }
@@ -163,6 +165,7 @@ export function usePublicAgents({
   userId,
   imageOutputOnly = false,
   toolName,
+  summary = false,
   initialData = [],
   reloadMode = "catalog",
 }: UsePublicAgentsOptions = {}) {
@@ -194,6 +197,7 @@ export function usePublicAgents({
       userId,
       imageOutputOnly,
       toolName,
+      summary,
     };
     const myReqId = ++requestIdRef.current;
 
@@ -413,6 +417,7 @@ export function usePublicAgents({
     userId,
     imageOutputOnly,
     toolName,
+    summary,
     currentServer,
     syncServers,
     currentUserId,
@@ -432,6 +437,7 @@ export function usePublicAgents({
     searchName,
     sortBy,
     toolName,
+    summary,
     userId,
   ]);
 

package/ai/agent/pageBuilderHandoffRules.ts

@@ -0,0 +1,75 @@
+export const PAGE_BUILDER_AGENT_PUBLIC_KEY =
+  "agent-pub-01PAGEBUILDR00000000FT7R9G";
+
+export type PageBuilderScenario = {
+  id: string;
+  label: string;
+  userIntent: string;
+  prompt: string;
+};
+
+export const PAGE_BUILDER_SCENARIOS: PageBuilderScenario[] = [
+  {
+    id: "information-display",
+    label: "信息展示",
+    userIntent: "主页、产品介绍、服务介绍、作品集、活动页、报价页",
+    prompt:
+      "帮我做一个独立 AI 产品顾问的个人主页。要看起来专业，包含个人定位、能提供的服务卡片、代表成果卡片、可信背书和联系合作按钮。",
+  },
+  {
+    id: "data-analysis",
+    label: "数据分析",
+    userIntent: "日报、周报、经营看板、质检报告、销售漏斗、反馈分析",
+    prompt:
+      "帮我做一个 AI 客服质检日报，包含核心指标、近 7 天风险趋势、异常会话明细表，以及明天需要跟进的建议。",
+  },
+  {
+    id: "process-guide",
+    label: "流程说明",
+    userIntent: "教程、SOP、onboarding、操作指南、课程步骤、申请流程",
+    prompt:
+      "帮我做一个新员工使用 CRM 的交互教程页面，包含学习目标、操作步骤、示例练习、检查清单和下一步按钮。",
+  },
+  {
+    id: "decision-comparison",
+    label: "决策比较",
+    userIntent: "方案对比、产品选型、候选人对比、竞品分析、采购建议",
+    prompt:
+      "帮我做一个三款 CRM 方案对比页，包含对比维度表格、每个方案的优缺点卡片、评分、适合团队类型和最终推荐。",
+  },
+  {
+    id: "plan-roadmap",
+    label: "计划排布",
+    userIntent: "项目计划、学习计划、健身计划、内容日历、发布节奏",
+    prompt:
+      "帮我做一个 30 天内容发布计划页面，包含阶段目标、每周任务、优先级、里程碑卡片和风险提醒。",
+  },
+  {
+    id: "mixed-pitch",
+    label: "混合长尾",
+    userIntent: "汇报页、融资材料、复杂项目概览，混合展示、数据、计划、对比",
+    prompt:
+      "给一个早期 AI 客服创业项目做一页融资汇报页，包含市场机会、关键数据指标卡、增长趋势图、产品路线、竞品对比表、团队介绍和下一步计划。",
+  },
+];
+
+const scenarioLines = PAGE_BUILDER_SCENARIOS.map(
+  (scenario) => `- ${scenario.label}：${scenario.userIntent}`
+).join("\n");
+
+export const PAGE_BUILDER_HANDOFF_INSTRUCTIONS = `--- 页面生成助手 handoff ---
+当用户需要把内容变成“可看的页面/报告/看板/教程/对比页/计划页”时，可以把本轮交给页面生成助手。
+
+目标 Agent:
+- agentKey: ${PAGE_BUILDER_AGENT_PUBLIC_KEY}
+- 推荐工具: runStreamingAgent
+
+适合 handoff 的视觉意图大类：
+${scenarioLines}
+
+调用边界：
+- 用户明确要求“做成页面 / 看板 / 报告 / 教程 / 主页 / 对比页 / 计划表 / 可视化”时，可以直接 runStreamingAgent。
+- 如果用户只是讨论内容，但你判断“文字回答不如可视化页面”，先询问用户：“这个更适合做成一页可视化页面，要我生成一个可交互版本吗？”
+- 不要把普通问答、闲聊、代码解释、纯文本总结强行交给页面生成助手。
+- handoff 时，把用户原始需求和你已确认的业务上下文一起放进 userInput，不要要求用户理解 React、HTML、代码块或运行时。
+- 页面生成助手只负责生成和修改可交互页面；你仍负责判断、解释、澄清和后续协调。`;

package/ai/agent/runAgentClientLoop.ts

@@ -125,7 +125,10 @@ export async function runAgentClientLoop(
     // 5. 执行工具调用
     for (const tc of assistantMsg.tool_calls) {
       toolCallCount++;
-      const toolResultContent = await executeToolCall(tc, thunkApi, parentMessageId);
+      const toolResultContent = await executeToolCall(tc, thunkApi, {
+        parentMessageId,
+        agentKey,
+      });
       messages.push({
         role: "tool",
         tool_call_id: tc.id,

package/ai/agent/runtimeGuidance.ts

@@ -45,6 +45,20 @@ const buildEmailRegistrationWorkflowBlock = (
   ].join("\n");
 };
 
+const buildWebResearchToolPolicyBlock = (
+  hasExecShellTool: boolean,
+  hasFetchWebpageTool: boolean
+): string => {
+  if (!hasExecShellTool || !hasFetchWebpageTool) return "";
+
+  return [
+    "--- 生产环境网页研究工具策略 ---",
+    "生产环境网页研究优先使用 fetchWebpage、站点 Markdown / llms.txt、或专用浏览/搜索工具。",
+    "不要用 execShell/execBash 调 curl、grep、sed 等命令抓网页或截取网页段落；生产环境通常会禁用 dev shell，反复尝试只会浪费回合。",
+    "如果网页内容过长或锚点段落没有被单独提取，先寻找该文档站提供的 Markdown 版本、独立页面、llms.txt 索引或更具体 URL，再继续回答。",
+  ].join("\n");
+};
+
 export const resolveRuntimeGuidanceToolOptions = (
   tools: string[] = []
 ): RuntimeGuidanceToolOptions => {
@@ -80,6 +94,7 @@ export const resolveRuntimeGuidanceToolOptions = (
 
 export const buildRuntimeGuidanceBlocks = (tools: string[] = []) => {
   const options = resolveRuntimeGuidanceToolOptions(tools);
+  const normalizedTools = canonicalizeToolNames(tools);
 
   return {
     startupProtocol: buildStartupProtocolBlock({
@@ -93,5 +108,9 @@ export const buildRuntimeGuidanceBlocks = (tools: string[] = []) => {
     emailRegistrationWorkflow: buildEmailRegistrationWorkflowBlock(
       options.hasEmailRegistrationWorkflow
     ),
+    webResearchToolPolicy: buildWebResearchToolPolicyBlock(
+      options.hasExecShellTool,
+      normalizedTools.includes("fetchWebpage")
+    ),
   };
 };

package/ai/agent/server/fetchPublicAgents.ts

@@ -20,6 +20,8 @@ export interface FetchPublicAgentsOptions {
   imageOutputOnly?: boolean;
   /** Filter agents that include this tool in their tools array */
   toolName?: string;
+  /** Return list-card metadata only. Full agent config is still available by key. */
+  summary?: boolean;
 }
 
 export interface FetchPublicAgentsResult {
@@ -80,6 +82,51 @@ async function getPublicAgents(): Promise<Agent[]> {
 const DEFAULT_LIMIT = 20;
 const MAX_LIMIT = 100;
 
+const SUMMARY_FIELDS = new Set([
+  "dbKey",
+  "id",
+  "type",
+  "userId",
+  "name",
+  "title",
+  "displayName",
+  "introduction",
+  "tags",
+  "tools",
+  "provider",
+  "model",
+  "cliProvider",
+  "apiSource",
+  "hasVision",
+  "cover",
+  "avatarFileId",
+  "inputPrice",
+  "outputPrice",
+  "imageModel",
+  "imageConfig",
+  "imageWorkflow",
+  "pricing",
+  "metrics",
+  "runtimeBinding",
+  "spaceId",
+  "isPublic",
+  "createdAt",
+  "updatedAt",
+  "created",
+  "updated_at",
+  "deletedAt",
+]);
+
+const toPublicAgentSummary = (agent: Agent): Agent => {
+  const summary: Record<string, unknown> = {};
+  for (const [key, value] of Object.entries(agent as Record<string, unknown>)) {
+    if (SUMMARY_FIELDS.has(key)) {
+      summary[key] = value;
+    }
+  }
+  return summary as Agent;
+};
+
 export async function fetchPublicAgents(
   options: FetchPublicAgentsOptions = {}
 ): Promise<FetchPublicAgentsResult> {
@@ -90,6 +137,7 @@ export async function fetchPublicAgents(
     userId,
     imageOutputOnly = false,
     toolName,
+    summary = false,
   } = options;
 
   const limit = Math.min(Math.max(rawLimit, 1), MAX_LIMIT);
@@ -123,6 +171,8 @@ export async function fetchPublicAgents(
   // 使用统一的排序逻辑
   const sorted = sortAgents(list, sortBy);
 
-  const data = sorted.slice(0, limit);
+  const data = sorted.slice(0, limit).map((agent) =>
+    summary ? toPublicAgentSummary(agent) : agent
+  );
   return { data, total: list.length, hasMore: list.length > limit };
 }