nolo-cli 0.1.45 → 0.1.47

package/ai/tools/createDocTool.ts

@@ -1,132 +0,0 @@
-// 文件路径: 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

@@ -1,155 +0,0 @@
-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

@@ -1,154 +0,0 @@
-/**
- * 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

@@ -1,31 +0,0 @@
-// 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 };
-}