minimal-agent 0.10.0 → 0.12.0

package/src/utils/stripThink.ts

@@ -0,0 +1,49 @@
+/**
+ * ============================================================
+ *  src/utils/stripThink.ts —— 剥离模型直出的 <think> 思维链块
+ * ------------------------------------------------------------
+ *  自 plugins/workflow-runner/src/agentCommon.ts 迁入内核：Agent 子任务工具
+ *  （src/tools/agent/）提取子 agent 报告时同样需要净化,而内核不能 import
+ *  插件（三层解耦红线）,故共享件上移、插件侧改经 plugin-sdk re-export。
+ * ============================================================
+ */
+
+/**
+ * 展示层切分：把 content 里模型直出的 <think> 段与正文分离。
+ * MessageList 用它把内联思维链并入 💭 块（gray dim 折叠展示），正文只显示
+ * 净化后的部分——**纯函数不 mutate 入参，history 字节零改动**（KV 缓存约束：
+ * 内核有意在 client.ts 保留内联 think 进 content，展示层各取所需）。
+ *   - 闭合块（可多个、跨行、大小写不敏感）→ 依序拼进 thought
+ *   - 剥完仍以未闭合 <think> 开头 → 余下全部视为 thought，answer=''
+ *   - 无 <think> → { thought: '', answer: text }（answer 与原文逐字节相同，
+ *     快路径：调用方可据此走旧渲染逻辑）
+ */
+export function splitThinkBlocks(text: string): { thought: string; answer: string } {
+  if (!/<think>/i.test(text)) return { thought: '', answer: text };
+  const thoughts: string[] = [];
+  const answer = text.replace(/<think>([\s\S]*?)<\/think>/gi, (_m, inner: string) => {
+    const t = inner.trim();
+    if (t) thoughts.push(t);
+    return '';
+  });
+  // 剥完闭合块后仍以未闭合 <think> 开头 → 余下整段都是思考
+  const unclosed = /^\s*<think>/i.exec(answer);
+  if (unclosed) {
+    const rest = answer.replace(/^\s*<think>/i, '').trim();
+    if (rest) thoughts.push(rest);
+    return { thought: thoughts.join('\n'), answer: '' };
+  }
+  return { thought: thoughts.join('\n'), answer };
+}
+
+/**
+ * 剥离模型直出的思维链标签块（MiniMax 等把 <think>…</think> 写进 content，
+ * 不走 reasoning_content 通道）。不剥离的话 capture 变量 / goal_supplement
+ * 补充要求 / preview / 子 agent 报告全带思考噪音——曾真实发生：
+ * supplements.json 首条是 240 字符英文 think 片段，随目标锚注入了后续每一步。
+ * 现为 splitThinkBlocks 的薄封装（单一事实来源），语义与旧实现逐 case 等价：
+ * 删除闭合块、未闭合开头整段判思考返回空串、结果 trim。
+ */
+export function stripThinkBlocks(text: string): string {
+  return splitThinkBlocks(text).answer.trim();
+}

package/src/utils/zodToJson.ts

@@ -0,0 +1,73 @@
+/**
+ * ============================================================
+ *  src/utils/zodToJson.ts —— Zod schema → JSON Schema 自动派生
+ * ------------------------------------------------------------
+ *  封装 zod-to-json-schema，统一清理输出格式。
+ *
+ *  设计原则：
+ *    - 单一数据源：每个工具只写一份 Zod schema
+ *    - 自动派生：parameters（给 LLM 看的 JSON Schema）由 Zod 自动生成
+ *    - 消除冗余：不再需要手写两份重复的参数定义
+ * ============================================================
+ */
+
+import { zodToJsonSchema } from 'zod-to-json-schema';
+// 必须用 zod/v3 入口！zod-to-json-schema 3.25+ 内部依赖 zod v4 的兼容性导入，
+// 如果用 'zod'（v3.x）会跟 zod/v3 混用导致 schema 生成失败（返回 {}）。
+import { z } from 'zod/v3';
+
+/**
+ * 把 zodToJsonSchema 输出的 draft-04 boolean 形式 exclusiveMin/Max 升级为
+ * draft-2020-12 number 形式，让生成的 schema 在严校验 LLM provider 也能通过。
+ *
+ * 背景：`target: 'openApi3'` 走 OpenAPI 3.0 / JSON Schema draft-04 规范，
+ *   `.positive()` 之类的 Zod 约束生成 `{minimum: 0, exclusiveMinimum: true}`。
+ * 严校验 provider（如火山 ARK Coding 后挂的 GLM-5.1）按 draft-2020-12 要求
+ *   `exclusiveMinimum` 必须是 number，遇 boolean 直接 400 InvalidParameter。
+ *
+ * 转换规则：
+ *   {minimum: N, exclusiveMinimum: true}  →  {exclusiveMinimum: N}
+ *   {maximum: N, exclusiveMaximum: true}  →  {exclusiveMaximum: N}
+ *
+ * Fallback：boolean 形式但同级没有 minimum/maximum 时（理论 edge case），
+ *   静默删除 boolean 字段——避免污染 schema，运行时 Zod 兜底校验。
+ */
+function modernizeExclusiveBounds(node: unknown): unknown {
+  if (Array.isArray(node)) return node.map(modernizeExclusiveBounds);
+  if (node === null || typeof node !== 'object') return node;
+  const obj = node as Record<string, unknown>;
+  const out: Record<string, unknown> = {};
+  for (const [k, v] of Object.entries(obj)) {
+    if (k === 'exclusiveMinimum' && typeof v === 'boolean') {
+      if (v && typeof obj.minimum === 'number') out.exclusiveMinimum = obj.minimum;
+      continue;
+    }
+    if (k === 'minimum' && obj.exclusiveMinimum === true) continue;
+    if (k === 'exclusiveMaximum' && typeof v === 'boolean') {
+      if (v && typeof obj.maximum === 'number') out.exclusiveMaximum = obj.maximum;
+      continue;
+    }
+    if (k === 'maximum' && obj.exclusiveMaximum === true) continue;
+    out[k] = modernizeExclusiveBounds(v);
+  }
+  return out;
+}
+
+/**
+ * 从 Zod schema 派生出 OpenAI tools[] 兼容的 JSON Schema 对象。
+ *
+ * 做了以下清理：
+ *   - 移除 `$schema` 元数据字段（LLM 不需要）
+ *   - `additionalProperties` 默认 false（防止模型传多余字段）
+ *   - `modernizeExclusiveBounds` 把 boolean exclusiveMin/Max 升级 draft-2020-12 number 形式
+ */
+export function toToolParameters(schema: z.ZodType<any>): object {
+  const json = zodToJsonSchema(schema, {
+    target: 'openApi3',
+    $refStrategy: 'none',
+  }) as Record<string, unknown>;
+
+  // 移除 LLM 不需要的元数据
+  const { $schema, ...rest } = json;
+  return modernizeExclusiveBounds(rest) as object;
+}