nolo-cli 0.1.39 → 0.1.41

package/ai/tools/createDocTool.ts

@@ -0,0 +1,132 @@
+// 文件路径: ai/tools/createDocTool.ts
+
+import { createDoc } from "../../render/page/docSlice";
+import { selectCurrentSpaceId } from "../../create/space/spaceSlice";
+import type { RootState } from "../../app/store";
+
+export interface CreateDocToolArgs {
+  title?: string;
+  spaceId?: string;
+  categoryId?: string;
+  content?: string;
+}
+
+
+export const createDocFunctionSchema = {
+  name: "createDoc",
+  description: [
+    "在当前空间中创建一个新文档（page），可以指定标题、分类和初始内容。",
+    "如果需要绑定到指定分类，请先通过其它工具（如 createCategory / queryContentsByCategory）获取真实的 categoryId 再调用本工具。",
+  ].join("\n"),
+  parameters: {
+    type: "object",
+    properties: {
+      title: {
+        type: "string",
+        description:
+          "页面标题。如果未提供，将在执行器中使用默认标题（例如“新页面”或日期格式）。",
+      },
+      spaceId: {
+        type: "string",
+        description: [
+          "可选：要创建到哪个 space。",
+          "优先级：如果传了真实 spaceId，就用它；如果不传，则优先使用当前已选中的 space；如果当前也没有 space，则仍允许创建为不归属任何 space 的文档。",
+          '不需要指定时传空字符串 ""。',
+        ].join("\n"),
+      },
+      categoryId: {
+        type: "string",
+        description: [
+          "页面所属的分类ID（数据库中的真实 ID）：",
+          "- 只有在你已经从其它工具的结果或用户输入中拿到 categoryId 时，才填写真实 ID；",
+          '- 如果目前没有可用的分类ID（模型自己想的名称不算），请传空字符串 ""。',
+        ].join("\n"),
+      },
+      content: {
+        type: "string",
+        description: [
+          "页面的初始内容，使用 Markdown 格式。",
+          "支持 mention 语法引用其他资源，格式：@[type:dbKey|显示标签]",
+          "支持的类型：",
+          "- @[page:PAGE-xxx|标题]     引用另一个页面，读取时会展开页面内容",
+          "- @[agent:agent-xxx|名称]   引用一个 Agent，可作为 reference 挂载",
+          "- @[space:space-xxx|名称]   引用一个 Space 目录",
+          "例：@[page:PAGE-abc|产品规范] @[agent:agent-xyz|写作助手]",
+          "不需要初始内容时传空字符串 \"\"。",
+        ].join("\n"),
+      },
+    },
+    required: ["title", "categoryId", "content"],
+  } as const,
+};
+
+/**
+ * [Executor] 'createDoc' 工具的执行函数。
+ * @param args - LLM 提供的参数: { title?: string, categoryId?: string, content?: string }
+ * @param thunkApi - Redux Thunk API
+ * @returns {Promise<{rawData: unknown, displayData: string}>}
+ */
+export async function createDocFunc(
+  args: CreateDocToolArgs,
+  thunkApi: any
+): Promise<{ rawData: unknown; displayData: string }> {
+  const { dispatch, getState } = thunkApi;
+  const state = getState() as RootState;
+
+  console.log("[createDocTool] Received args:", args);
+
+  // 为参数提供默认值和安全处理
+  const rawTitle = (args.title ?? "").trim();
+  const title = rawTitle || "新页面";
+
+  const rawCategoryId = (args.categoryId ?? "").trim();
+  // 空字符串视为“未指定分类”，交给后续 createPageAction 进一步校验过滤
+  const categoryId = rawCategoryId || undefined;
+
+  const explicitSpaceId = (args.spaceId ?? "").trim() || undefined;
+  const currentSpaceId = selectCurrentSpaceId(state) || undefined;
+  const spaceId = explicitSpaceId ?? currentSpaceId;
+
+  const rawContent = (args.content ?? "").trim();
+  const content = rawContent || undefined;
+
+  try {
+    console.log("[createDocTool] dispatching createDoc with:", {
+      title,
+      spaceId,
+      categoryId,
+      content,
+    });
+    const id = await (dispatch as any)(
+      createDoc({ title, spaceId, categoryId, content })
+    ).unwrap();
+
+    console.log("[createDocTool] createDoc success, id:", id);
+
+    const rawData = {
+      success: true,
+      id,
+      dbKey: id,
+      title,
+      spaceId: spaceId ?? null,
+      categoryId: categoryId ?? null,
+    };
+
+    const displayData = categoryId
+      ? `页面《${title}》已成功创建并关联到分类。`
+      : `页面《${title}》已成功创建。`;
+
+    return { rawData, displayData };
+  } catch (error: any) {
+    console.error("[createDocTool] Error creating doc:", error);
+    const msg =
+      typeof error?.message === "string" ? error.message : JSON.stringify(error);
+    throw new Error(`创建文档时出错: ${msg}`);
+  }
+}
+
+// backward-compat aliases
+/** @deprecated use createDocFunctionSchema */
+export const createPageFunctionSchema = createDocFunctionSchema;
+/** @deprecated use createDocFunc */
+export { createDocFunc as createPageFunc };

package/ai/tools/createSkillDocTool.ts

@@ -0,0 +1,155 @@
+import { createDoc } from "../../render/page/docSlice";
+import { selectCurrentSpaceId } from "../../create/space/spaceSlice";
+import type { RootState } from "../../app/store";
+import {
+  buildSkillDocFromArgs,
+  type CreateSkillDocArgs,
+} from "../skills/skillDocBuilder";
+import { buildSkillFollowupResult } from "./skillFollowup";
+
+export interface CreateSkillDocToolArgs extends CreateSkillDocArgs {
+  spaceId?: string;
+  categoryId?: string;
+}
+
+export const createSkillDocFunctionSchema = {
+  name: "createSkillDoc",
+  description: [
+    "创建一个本地 skill 文档，并自动写入隐藏的 skill-config / eval-config 协议块。",
+    "适合把某个能力流程沉淀成可被 agent 引用的 skill，而不是手写协议注释。",
+    "创建成功后，如果用户还没说明下一步，优先调用 ui_ask_choice 继续询问：仅保存、挂到现有 Agent，还是新建一个 Agent 来使用它。",
+  ].join("\n"),
+  parameters: {
+    type: "object",
+    properties: {
+      title: {
+        type: "string",
+        description: "可选：文档标题。未提供时回退到 name。",
+      },
+      name: {
+        type: "string",
+        description: "可选：skill 名称。未提供时回退到 title。",
+      },
+      description: {
+        type: "string",
+        description: "必填：skill 的用途说明。",
+      },
+      body: {
+        type: "string",
+        description: "可选：skill 的正文说明、步骤、注意事项等 Markdown 内容。",
+      },
+      spaceId: {
+        type: "string",
+        description: '可选：目标 spaceId；不传则优先使用当前 space。可传空字符串 ""。',
+      },
+      categoryId: {
+        type: "string",
+        description: '可选：目标分类 categoryId；不传时传空字符串 ""。',
+      },
+      toolNames: {
+        type: "array",
+        items: { type: "string" },
+        description: "可选：该 skill 绑定的工具名列表。",
+      },
+      requiredSkills: {
+        type: "array",
+        items: { type: "string" },
+        description: "可选：硬依赖的 skill key/page key 列表。",
+      },
+      recommendedSkills: {
+        type: "array",
+        items: { type: "string" },
+        description: "可选：推荐但不强制的 skill key/page key 列表。",
+      },
+      promptPatch: {
+        type: "string",
+        description: "可选：附加到 system prompt 的技能提示。",
+      },
+      budgetTier: {
+        type: "string",
+        enum: ["low", "medium", "high"],
+        description: "可选：该 skill 的预算等级。",
+      },
+      dispatchPreferred: {
+        type: "boolean",
+        description: "可选：是否建议优先走 agent dispatch 而不是直接本 agent 执行。",
+      },
+      modalities: {
+        type: "array",
+        items: { type: "string", enum: ["text", "image", "video", "audio", "3d"] },
+        description: "可选：该 skill 涉及的模态。",
+      },
+      preferredAgents: {
+        type: "array",
+        items: { type: "string" },
+        description: "可选：更适合执行该 skill 的 agent 名称或 key。",
+      },
+      discoverKeywords: {
+        type: "array",
+        items: { type: "string" },
+        description: "可选：触发/发现关键字。",
+      },
+      discoverExamples: {
+        type: "array",
+        items: { type: "string" },
+        description: "可选：示例任务或问法。",
+      },
+      evalCases: {
+        type: "array",
+        items: {
+          type: "object",
+          properties: {
+            input: { type: "string" },
+            expectedTools: {
+              type: "array",
+              items: { type: "string" },
+            },
+            expectedSignals: {
+              type: "array",
+              items: { type: "string" },
+            },
+            forbiddenSignals: {
+              type: "array",
+              items: { type: "string" },
+            },
+          },
+          required: ["input"],
+        },
+        description: "可选：skill 的评估用例，写入 eval-config。",
+      },
+    },
+    required: ["description"],
+  } as const,
+};
+
+export async function createSkillDocFunc(
+  args: CreateSkillDocToolArgs,
+  thunkApi: any
+): Promise<{ rawData: unknown; displayData: string }> {
+  const { dispatch, getState } = thunkApi;
+  const state = getState() as RootState;
+  const { title, content, skillConfig, evalConfig } = buildSkillDocFromArgs(args);
+
+  const explicitSpaceId = (args.spaceId ?? "").trim() || undefined;
+  const currentSpaceId = selectCurrentSpaceId(state) || undefined;
+  const spaceId = explicitSpaceId ?? currentSpaceId;
+  const categoryId = (args.categoryId ?? "").trim() || undefined;
+
+  const id = await (dispatch as any)(
+    (createDoc as any)({
+      title,
+      spaceId,
+      categoryId,
+      content,
+    })
+  ).unwrap();
+
+  return buildSkillFollowupResult({
+    dbKey: id,
+    title,
+    skillId: skillConfig.id,
+    spaceId: spaceId ?? null,
+    toolNames: skillConfig.toolNames ?? [],
+    hasEvalConfig: !!evalConfig,
+  });
+}

package/ai/tools/createWorkflowTool.ts

@@ -0,0 +1,154 @@
+/**
+ * createWorkflow tool
+ *
+ * LLM calls this ONCE to define and immediately execute a workflow.
+ * The execution engine runs all steps deterministically — no further
+ * LLM involvement needed for orchestration, so token cost is O(1)
+ * regardless of step count.
+ *
+ * Use when the task path is known upfront.
+ * Use agent loop when the path needs dynamic discovery.
+ */
+
+import { runWorkflow } from "../workflow/workflowExecutor";
+import type {
+  WorkflowDefinition,
+  WorkflowStep,
+} from "../workflow/workflowTypes";
+
+export const createWorkflowFunctionSchema = {
+  name: "createWorkflow",
+  description:
+    "当你已知完整执行路径时使用本工具。定义一个多步骤 workflow，引擎自动执行全部步骤，" +
+    "不需要每步都调用 LLM 决策，大幅节省 token。" +
+    "步骤类型：" +
+    "'tool'——直接执行注册工具；" +
+    "'llm'——单次 LLM 调用（无 tool loop）；" +
+    "'parallel'——子步骤并发执行；" +
+    "'condition'——纯逻辑判断分支，无需 LLM。" +
+    "步骤间通过 {{steps.STEP_ID.result}} 传递数据。",
+  parameters: {
+    type: "object",
+    properties: {
+      title: {
+        type: "string",
+        description: "Workflow 标题，简明描述整体目标。",
+      },
+      steps: {
+        type: "array",
+        description: "有序步骤列表。每步声明类型和所需参数，引擎顺序执行（parallel 步骤内部并发）。",
+        items: {
+          type: "object",
+          properties: {
+            id: {
+              type: "string",
+              description: "步骤唯一 ID，后续步骤通过 {{steps.ID.result}} 引用。",
+            },
+            type: {
+              type: "string",
+              enum: ["tool", "llm", "parallel", "condition"],
+              description: "步骤类型。",
+            },
+            title: {
+              type: "string",
+              description: "步骤人类可读描述（可选）。",
+            },
+            // tool step
+            tool: {
+              type: "string",
+              description: "type='tool' 时必填，工具名称。",
+            },
+            args: {
+              type: "object",
+              description:
+                "type='tool' 时必填，工具参数。支持 {{steps.ID.result}} 和 {{steps.ID.result[N]}} 占位符。" +
+                "parallel 子步骤结果也可直接通过其自身 ID 引用，例如 {{steps.subStepId.result}}。",
+            },
+            // llm step
+            prompt: {
+              type: "string",
+              description: "type='llm' 时必填，发送给模型的 prompt。支持占位符。",
+            },
+            model: {
+              type: "string",
+              description: "type='llm' 时可选，指定模型名。",
+            },
+            // parallel step
+            steps: {
+              type: "array",
+              description:
+                "type='parallel' 时必填，子步骤列表（tool 或 llm 类型），并发执行。" +
+                "子步骤执行完成后，其结果同时以子步骤自身 ID 注册到全局 steps map，" +
+                "后续步骤可通过 {{steps.subStepId.result}} 直接引用，无需通过父 parallel 步骤中转。",
+              items: { type: "object" },
+            },
+            // condition step
+            check: {
+              type: "string",
+              description:
+                "type='condition' 时必填，纯 JS 布尔表达式。" +
+                "steps.<stepId>.<prop> 表示某步骤结果的属性（点路径，不支持 bracket notation，无 .result 包装）。" +
+                "支持：点路径 / 字符串和数字字面量 / 布尔 null / 比较运算符 === !== > < >= <= / 逻辑运算符 && || ! / 括号。" +
+                "例: \"steps.validate.isValid === true\" 或 \"steps.score.value >= 80 && steps.flag.ok !== false\"",
+            },
+            ifTrue: {
+              type: "array",
+              items: { type: "string" },
+              description: "条件为真时执行的步骤 ID 列表，其余步骤跳过。",
+            },
+            ifFalse: {
+              type: "array",
+              items: { type: "string" },
+              description: "条件为假时执行的步骤 ID 列表，其余步骤跳过。",
+            },
+            // error handling
+            onError: {
+              type: "string",
+              enum: ["stop", "skip", "retry"],
+              description:
+                "步骤失败时策略：stop（默认，终止 workflow）/ skip（跳过，结果记为 null 继续）" +
+                "/ retry（按 retryCount 次数重试，耗尽后若仍失败则触发 stop）。",
+            },
+            retryCount: {
+              type: "integer",
+              description: "onError='retry' 时重试次数，默认 1（即最多执行 2 次）。",
+            },
+          },
+          required: ["id", "type"],
+        },
+      },
+    },
+    required: ["title", "steps"],
+  },
+};
+
+interface CreateWorkflowArgs {
+  title: string;
+  steps: WorkflowStep[];
+}
+
+export async function createWorkflowFunc(
+  args: CreateWorkflowArgs,
+  thunkApi: any
+): Promise<{ rawData: any; displayData?: string }> {
+  const { title, steps } = args;
+
+  if (!steps?.length) {
+    throw new Error("createWorkflow: steps 不能为空。");
+  }
+
+  const definition: WorkflowDefinition = { title, steps };
+
+  const { dispatch } = thunkApi;
+  const result = await dispatch(runWorkflow({ definition })).unwrap();
+
+  const completedCount = Object.values(result.results).filter(
+    (v) => v !== null && v !== undefined
+  ).length;
+
+  const displayData = result.success
+    ? `✅ **${title}** 完成，共执行 ${completedCount} 步`
+    : `❌ **${title}** 在步骤 \`${result.failedStep}\` 失败：${result.error}`;
+
+  return { rawData: result, displayData };
+}

package/ai/tools/delayTool.ts

@@ -0,0 +1,31 @@
+// ai/tools/delayTool.ts
+
+export const delayFunctionSchema = {
+  name: "delay",
+  description:
+    "让计划暂停一小段时间（毫秒），用于节流批量操作（例如连续下载多个文件）。",
+  parameters: {
+    type: "object",
+    properties: {
+      ms: {
+        type: "integer",
+        description: "需要等待的时间（毫秒），建议 200~1000 之间。",
+      },
+    },
+    required: ["ms"],
+  },
+};
+
+export async function delayFunc(
+  args: { ms: number },
+  _thunkApi: any
+): Promise<{ rawData: object; displayData: string }> {
+  const ms = typeof args.ms === "number" && args.ms > 0 ? args.ms : 200;
+
+  await new Promise<void>((resolve) => setTimeout(resolve, ms));
+
+  const rawData = { success: true, ms };
+  const displayData = `已等待 ${ms} 毫秒，继续执行后续步骤。`;
+
+  return { rawData, displayData };
+}