nolo-cli 0.1.13 → 0.1.15

package/ai/tools/agent/skillAgentArgs.ts

@@ -0,0 +1,106 @@
+import type { CreateAgentToolArgs } from "./createAgentTool";
+
+export type SkillAgentMode = "creator" | "evaluator" | "creator_evaluator";
+
+export interface CreateSkillAgentToolArgs {
+  mode?: SkillAgentMode;
+  name?: string;
+  model?: string;
+  provider?: string;
+  isPublic?: boolean;
+  references?: CreateAgentToolArgs["references"];
+  linkedSpaces?: string[];
+}
+
+const DEFAULT_PROVIDER = "openrouter";
+const DEFAULT_MODEL = "xiaomi/mimo-v2.5-pro";
+
+const buildPreset = (mode: SkillAgentMode) => {
+  const commonTools = [
+    "createSkillDoc",
+    "importSkill",
+    "doctorSkill",
+    "evalSkill",
+    "readDoc",
+    "updateDoc",
+  ];
+
+  if (mode === "creator") {
+    return {
+      defaultName: "Skill Creator",
+      tools: commonTools,
+      introduction: "帮你设计、创建和完善 skill 文档协议的助手。",
+      greeting:
+        "你好，我是 Skill Creator。\n\n告诉我你想做什么能力，我会帮你把它整理成可导入、可诊断、可评估的 skill 文档。",
+      prompt: `你是一个 skill creator。你的任务是把用户的能力需求沉淀成 skill 文档，而不是泛泛给建议。
+
+核心原则：
+- Agent 是第一公民；只有切换 Agent 成本更高时，才优先补 skill
+- skill 以普通 doc 为存储底座，使用隐藏的 skill-config / eval-config 协议块
+- 优先用 createSkillDoc 创建；已有文档则用 updateDoc 定点补齐协议
+- 创建后立刻运行 doctorSkill；必要时再运行 evalSkill
+- 默认做最小可用协议，不要过早发明复杂 DSL
+- 对外部技能导入，优先保留文本流程，再谨慎映射工具`,
+    };
+  }
+
+  if (mode === "evaluator") {
+    return {
+      defaultName: "Skill Evaluator",
+      tools: [...commonTools, "runLlm"],
+      introduction: "帮你诊断 skill 文档质量、协议完整性与评估结果的助手。",
+      greeting:
+        "你好，我是 Skill Evaluator。\n\n把一个 skill 文档给我，我会检查协议、工具绑定、评估用例和潜在风险。",
+      prompt: `你是一个 skill evaluator。你的任务是审查 skill 是否真的可用，而不是替用户写新功能。
+
+工作顺序：
+1. 先 doctorSkill 看协议和明显问题
+2. 再 evalSkill 看 eval-config 是否通过
+3. 如发现问题，指出最小修复点
+4. 除非用户要求，不主动大改 skill
+
+审查重点：
+- 工具名是否有效、是否需要 canonicalize
+- requiredSkills / recommendedSkills 是否表达准确
+- eval-config 是否覆盖关键成功路径
+- 是否存在过期命令、环境前提、登录态依赖等隐患`,
+    };
+  }
+
+  return {
+    defaultName: "Skill Builder",
+    tools: [...commonTools, "runLlm", "createAgent", "updateAgent"],
+    introduction: "既能创建也能评估 skill 文档协议，还能帮助你沉淀 skill 工作流助手。",
+    greeting:
+      "你好，我是 Skill Builder。\n\n我可以帮你把能力做成 skill、导入外部 skill、诊断质量、补评估，并继续迭代相关 agent。",
+    prompt: `你是一个 skill creator + evaluator。
+
+原则：
+- 先判断该问题是否更适合换 Agent；只有没必要切 Agent 或切 Agent 成本更高时，才补 skill
+- skill 负责动态能力编排；knowledge 负责内容；dispatch 负责任务分派
+- 创建或更新 skill 后，必须至少做一次 doctorSkill；如果有 eval-config，再跑 evalSkill
+- 不把 recommendedSkills 当硬加载；requiredSkills 才是硬依赖
+- 尽量帮助用户形成“创建 -> 诊断 -> 评估 -> 迭代”的闭环`,
+  };
+};
+
+export const buildCreateSkillAgentArgs = (
+  args: CreateSkillAgentToolArgs
+): CreateAgentToolArgs => {
+  const mode = args.mode ?? "creator_evaluator";
+  const preset = buildPreset(mode);
+  return {
+    name: (args.name ?? "").trim() || preset.defaultName,
+    model: (args.model ?? "").trim() || DEFAULT_MODEL,
+    provider: (args.provider ?? "").trim() || DEFAULT_PROVIDER,
+    introduction: preset.introduction,
+    greeting: preset.greeting,
+    prompt: preset.prompt,
+    isPublic: args.isPublic ?? false,
+    tools: preset.tools,
+    references: args.references ?? [],
+    linkedSpaces: args.linkedSpaces ?? [],
+    temperature: 0.3,
+    reasoning_effort: "medium",
+  };
+};

package/ai/tools/agent/skillAgentPreset.ts

@@ -0,0 +1,89 @@
+import type { Agent } from "app/types";
+import { DataType } from "create/types";
+import { createAgentKey } from "database/keys";
+import { ulid } from "ulid";
+import {
+  normalizeReferences,
+  type FormData as AgentFormData,
+} from "ai/agent/createAgentSchema";
+import { ALL_MODELS, type ModelWithProvider } from "ai/llm/models";
+import { getModelPricing } from "ai/llm/getPricing";
+import {
+  buildCreateSkillAgentArgs,
+  type CreateSkillAgentToolArgs,
+} from "./skillAgentArgs";
+
+export {
+  buildCreateSkillAgentArgs,
+  type CreateSkillAgentToolArgs,
+  type SkillAgentMode,
+} from "./skillAgentArgs";
+
+const findModelConfig = (
+  modelName: string,
+  provider?: string
+): ModelWithProvider | null => {
+  const name = (modelName ?? "").trim();
+  const prov = (provider ?? "").trim();
+  if (!name) return null;
+  if (prov) {
+    const exact = ALL_MODELS.find((m) => m.name === name && m.provider === prov);
+    if (exact) return exact;
+  }
+  const matches = ALL_MODELS.filter((m) => m.name === name);
+  return matches.length === 1 ? matches[0] : null;
+};
+
+export const buildSkillAgentRecord = (options: {
+  userId: string;
+  currentSpaceId?: string;
+  args: CreateSkillAgentToolArgs;
+}): Agent & { dbKey: string; publicDbKey: string } => {
+  const createArgs = buildCreateSkillAgentArgs(options.args);
+  const now = Date.now();
+  const id = ulid();
+  const dbKey = createAgentKey.private(options.userId, id);
+  const publicDbKey = createAgentKey.public(id);
+  const modelConfig = findModelConfig(createArgs.model, createArgs.provider);
+  const pricing = getModelPricing(
+    modelConfig?.provider || createArgs.provider,
+    createArgs.model
+  );
+  const references = normalizeReferences((createArgs.references as any) ?? []);
+  const tags = ["skill", "builder", options.args.mode ?? "creator_evaluator"];
+
+  return {
+    id,
+    dbKey,
+    type: DataType.AGENT,
+    userId: options.userId,
+    name: createArgs.name,
+    model: createArgs.model,
+    provider: modelConfig?.provider || createArgs.provider,
+    apiSource: "platform",
+    useServerProxy: true,
+    hasVision: Boolean(modelConfig?.hasVision),
+    prompt: createArgs.prompt ?? "",
+    introduction: createArgs.introduction ?? "",
+    greeting: createArgs.greeting,
+    isPublic: !!createArgs.isPublic,
+    tags,
+    tools: createArgs.tools ?? [],
+    references,
+    linkedSpaces: createArgs.linkedSpaces ?? [],
+    customProviderUrl: "",
+    apiKey: "",
+    whitelist: [],
+    inputPrice: pricing?.inputPrice ?? 0,
+    outputPrice: pricing?.outputPrice ?? 0,
+    temperature: createArgs.temperature,
+    reasoning_effort: createArgs.reasoning_effort,
+    createdAt: now,
+    updatedAt: now,
+    dialogCount: 0,
+    messageCount: 0,
+    tokenCount: 0,
+    spaceId: options.currentSpaceId,
+    publicDbKey,
+  } as unknown as Agent & { dbKey: string; publicDbKey: string };
+};

package/ai/tools/agent/streamParallelAgentsTool.ts

@@ -0,0 +1,122 @@
+export const streamParallelAgentsFunctionSchema = {
+  name: "streamParallelAgents",
+  description:
+    "并行调用多个 Agent，让它们分别以流式方式输出观点。适合多模型发散、评审团式讨论和多视角分析。",
+  parameters: {
+    type: "object",
+    properties: {
+      task: {
+        type: "string",
+        description: "要并行交给多个 Agent 的任务描述。",
+      },
+      agents: {
+        type: "array",
+        description: "需要并行调用的 Agent 列表。",
+        items: {
+          type: "object",
+          properties: {
+            agentKey: {
+              type: "string",
+              description: "目标 Agent 的 dbKey。",
+            },
+            label: {
+              type: "string",
+              description: "可选：分支展示名称。",
+            },
+            branchId: {
+              type: "string",
+              description: "可选：分支稳定标识。",
+            },
+            serverBase: {
+              type: "string",
+              description:
+                "可选：该 Agent 所在的 nolo server origin，例如 Windows 机器通过 Cloudflare 暴露的 https://win.example.com。" +
+                "跨域目标必须由服务端 AGENT_TOOL_ALLOWED_SERVER_BASES 明确放行。" +
+                "如果目标 Agent 记录声明了 delegation.serverBase / runtimeServerBase，服务端会在未显式传入时自动路由。",
+            },
+          },
+          required: ["agentKey"],
+        },
+      },
+      serverBase: {
+        type: "string",
+        description:
+          "可选：默认目标 nolo server origin。agents[*].serverBase 会覆盖此值；目标 Agent 记录的 runtime 元数据可在未传值时自动补齐。",
+      },
+      timeoutMs: {
+        type: "number",
+        description: "可选：单个分支的超时时间（毫秒）。",
+      },
+      budgetCredits: {
+        type: "number",
+        description:
+          "可选：本轮并行调用可消耗的剩余预算（单位：积分 / credits）。结果会返回 spentCredits / remainingCredits / exhausted，供父 Agent 决定是否继续下一轮。",
+      },
+      returnMode: {
+        type: "string",
+        enum: ["handoff", "continue"],
+        description:
+          '可选：handoff 表示并行结果直接结束本轮并交给用户；continue 表示把分支结果留在上下文里，父 Agent 继续思考。',
+      },
+      displayMode: {
+        type: "string",
+        enum: ["folded", "inline"],
+        description:
+          '可选：inline 表示把完整分支回答直接作为当前对话里的普通消息展开。folded 已废弃，运行时会自动按 inline 处理。',
+      },
+    },
+    required: ["task", "agents", "returnMode"],
+  },
+};
+
+export async function streamParallelAgentsFunc(args: {
+  task: string;
+  agents: Array<{ agentKey: string; label?: string; branchId?: string; serverBase?: string }>;
+  serverBase?: string;
+  timeoutMs?: number;
+  budgetCredits?: number;
+  returnMode?: "handoff" | "continue";
+  displayMode?: "folded" | "inline";
+}) {
+  const task = typeof args.task === "string" ? args.task.trim() : "";
+  const agents = Array.isArray(args.agents) ? args.agents : [];
+  const timeoutMs =
+    typeof args.timeoutMs === "number" && Number.isFinite(args.timeoutMs) && args.timeoutMs > 0
+      ? args.timeoutMs
+      : undefined;
+  const budgetCredits =
+    typeof args.budgetCredits === "number" &&
+    Number.isFinite(args.budgetCredits) &&
+    args.budgetCredits > 0
+      ? Number(args.budgetCredits.toFixed(6))
+      : undefined;
+  const returnMode = args.returnMode === "continue" ? "continue" : "handoff";
+  const displayMode = "inline";
+  const serverBase =
+    typeof args.serverBase === "string" && args.serverBase.trim()
+      ? args.serverBase.trim()
+      : undefined;
+
+  if (!task) {
+    throw new Error("streamParallelAgents: 缺少 task。");
+  }
+  if (agents.length === 0) {
+    throw new Error("streamParallelAgents: 缺少 agents。");
+  }
+
+  return {
+    rawData: {
+      task,
+      agents,
+      ...(serverBase ? { serverBase } : {}),
+      ...(timeoutMs ? { timeoutMs } : {}),
+      ...(budgetCredits ? { budgetCredits } : {}),
+      returnMode,
+      displayMode,
+    },
+    displayData:
+      returnMode === "continue"
+        ? `将并行调用 ${agents.length} 个 Agent，并把结果返回给父 Agent 继续会商${budgetCredits ? `（预算 ${budgetCredits} 积分）` : ""}`
+        : `将并行调用 ${agents.length} 个 Agent${budgetCredits ? `（预算 ${budgetCredits} 积分）` : ""}`,
+  };
+}

package/ai/tools/agent/updateAgentTool.ts

@@ -0,0 +1,96 @@
+// ai/tools/agent/updateAgentTool.ts
+
+import type { RootState } from "app/store";
+import type { Agent } from "app/types";
+import { updateAgent } from "ai/agent/agentSlice";
+import { selectUserId } from "auth/authSlice";
+import {
+    type UpdateAgentToolArgs,
+    agentUpdateFieldSchemaProperties,
+    assertAgentUpdateConfirmation,
+    buildPatch,
+    buildRawDataWithUpdateInfo,
+    buildUpdateThunkPreviousAgent,
+    extractAgentId,
+    fetchAgentByDbKey,
+    formatUpdatedAgentOutput,
+    listRequestedFields,
+    validateUpdateArgs,
+} from "./agentUpdateShared";
+
+export const updateAgentToolFunctionSchema = {
+    name: "updateAgent",
+    description:
+        "根据给定配置更新一个指定的 Agent。该工具用于通用高权限维护，默认需要用户确认后才会执行。",
+    parameters: {
+        type: "object",
+        properties: {
+            agentId: {
+                type: "string",
+                description: "要更新的 Agent 的 dbKey，格式为 agent-{userId}-{id}。",
+            },
+            ...agentUpdateFieldSchemaProperties,
+        },
+        required: ["agentId"],
+    },
+};
+
+// --- Executor ---
+
+export async function updateAgentToolFunc(
+    args: UpdateAgentToolArgs,
+    thunkApi: any
+): Promise<{ rawData: Agent; displayData: string }> {
+    const state = thunkApi.getState() as RootState;
+    const userId = selectUserId(state);
+    const db = (thunkApi.extra as any)?.db;
+
+    validateUpdateArgs(userId, { requireAgentId: true, agentId: args.agentId });
+
+    const dbKey = args.agentId.trim();
+    const previousAgent = await fetchAgentByDbKey(dbKey, db);
+
+    if (!previousAgent) {
+        throw new Error(
+            `未找到 dbKey 为 "${dbKey}" 的 Agent。\n` +
+            `如果您尝试更新旧版助手 (Cybot)，请新建一个 Agent 或在 UI 界面上手动迁移。`
+        );
+    }
+
+    const agentId = extractAgentId(dbKey);
+    const formData = buildPatch(args);
+    const requestedFields = listRequestedFields(args);
+
+    assertAgentUpdateConfirmation({
+        scope: "generic",
+        requestedFields,
+        confirmed: args.__confirmedSelfEvolution === true,
+    });
+
+    const previousAgentForUpdate = buildUpdateThunkPreviousAgent(previousAgent, userId!);
+
+    const agent = await thunkApi
+        .dispatch(updateAgent({
+            userId: userId!,
+            agentId,
+            formData,
+            previousAgent: previousAgentForUpdate,
+        }))
+        .unwrap()
+        .catch((e: any) => {
+            throw new Error(`更新 Agent 失败：${e?.message ?? "未知错误"}`);
+        });
+
+    const rawDataWithUpdateInfo = buildRawDataWithUpdateInfo(
+        agent,
+        previousAgentForUpdate,
+        requestedFields,
+    );
+
+    // TODO: Add a richer generic-agent-update preview/audit view before enabling any
+    // field-level auto-approval for updateAgent. For now this tool stays confirmation-first.
+    return {
+        rawData: rawDataWithUpdateInfo as any,
+        displayData: formatUpdatedAgentOutput(agent),
+    };
+}

package/ai/tools/agent/updateSelfTool.ts

@@ -0,0 +1,113 @@
+import type { RootState } from "app/store";
+import type { Agent } from "app/types";
+import { updateAgent } from "ai/agent/agentSlice";
+import {
+  selectAutoApproveSelfUpdateFields,
+} from "app/settings/settingSlice";
+import { selectUserId } from "auth/authSlice";
+import { selectCurrentDialogConfig } from "chat/dialog/dialogSlice";
+import { resolveMessageAgentKey } from "chat/messages/messageAgent";
+import { selectMsgById } from "chat/messages/messageSlice";
+import {
+  type UpdateSelfToolArgs,
+  agentUpdateFieldSchemaProperties,
+  assertAgentUpdateConfirmation,
+  buildPatch,
+  buildRawDataWithUpdateInfo,
+  buildUpdateThunkPreviousAgent,
+  extractAgentId,
+  fetchAgentByDbKey,
+  formatUpdatedAgentOutput,
+  listRequestedFields,
+  validateUpdateArgs,
+} from "./agentUpdateShared";
+
+export const updateSelfToolFunctionSchema = {
+  name: "updateSelf",
+  description:
+    "更新当前正在运行的 Agent 自己。低风险字段可直接更新，其他字段会先向用户确认。",
+  parameters: {
+    type: "object",
+    properties: agentUpdateFieldSchemaProperties,
+  },
+};
+
+const resolveCurrentAgentKey = (
+  state: RootState,
+  parentMessageId?: string,
+): string | undefined => {
+  const parentMessage = parentMessageId
+    ? selectMsgById(state, parentMessageId)
+    : undefined;
+  const parentAgentKey = resolveMessageAgentKey(parentMessage);
+  if (parentAgentKey) {
+    return parentAgentKey;
+  }
+
+  const currentDialog = selectCurrentDialogConfig(state);
+  const firstAgentKey = Array.isArray(currentDialog?.cybots)
+    ? currentDialog.cybots.find(
+        (item): item is string =>
+          typeof item === "string" && item.trim().length > 0,
+      )
+    : undefined;
+  return firstAgentKey?.trim();
+};
+
+export async function updateSelfToolFunc(
+  args: UpdateSelfToolArgs,
+  thunkApi: any,
+  runtime?: { parentMessageId?: string },
+): Promise<{ rawData: Agent; displayData: string }> {
+  const state = thunkApi.getState() as RootState;
+  const userId = selectUserId(state);
+  const db = (thunkApi.extra as any)?.db;
+
+  validateUpdateArgs(userId);
+
+  const currentAgentKey = resolveCurrentAgentKey(state, runtime?.parentMessageId);
+  if (!currentAgentKey) {
+    throw new Error("updateSelf 失败：无法识别当前正在运行的 Agent。");
+  }
+
+  const previousAgent = await fetchAgentByDbKey(currentAgentKey, db);
+  if (!previousAgent) {
+    throw new Error(`updateSelf 失败：未找到当前 Agent（${currentAgentKey}）。`);
+  }
+
+  const requestedFields = listRequestedFields(args);
+  const autoApprovedFields = selectAutoApproveSelfUpdateFields(state);
+
+  assertAgentUpdateConfirmation({
+    scope: "self",
+    requestedFields,
+    confirmed: args.__confirmedSelfEvolution === true,
+    autoApprovedFields,
+  });
+
+  const previousAgentForUpdate = buildUpdateThunkPreviousAgent(previousAgent, userId!);
+  const agent = await thunkApi
+    .dispatch(
+      updateAgent({
+        userId: userId!,
+        agentId: extractAgentId(currentAgentKey),
+        formData: buildPatch(args),
+        previousAgent: previousAgentForUpdate,
+      }),
+    )
+    .unwrap()
+    .catch((e: any) => {
+      throw new Error(`updateSelf 失败：${e?.message ?? "未知错误"}`);
+    });
+
+  // TODO: Future automation should prefer memory/doc capture before high-impact self
+  // mutations, and add audit history for rollback. Keep this tool focused on execution.
+  return {
+    rawData: buildRawDataWithUpdateInfo(
+      agent,
+      previousAgentForUpdate,
+      requestedFields,
+    ) as any,
+    displayData: formatUpdatedAgentOutput(agent),
+  };
+}

package/ai/tools/amazonProductScraperTool.ts

@@ -0,0 +1,86 @@
+// /ai/tools/amazonProductScraperTool.ts
+
+import { callApifyActor } from "./apifyActorClient";
+
+export const amazonProductScraperFunctionSchema = {
+  name: "amazonProductScraper",
+  description:
+    "使用 Apify Amazon Product Scraper 抓取亚马逊产品数据（类目页或商品详情页 URL）。",
+  parameters: {
+    type: "object",
+    properties: {
+      urls: {
+        type: "array",
+        description:
+          "一个或多个 Amazon 类目或商品 URL，对应 categoryOrProductUrls。",
+        items: { type: "string" },
+      },
+      maxItemsPerStartUrl: {
+        type: "integer",
+        minimum: 0,
+        description: "每个起始 URL 最大产品数。",
+      },
+      language: {
+        type: "string",
+        description: "页面语言，如 en, de, fr 等。",
+      },
+      proxyCountry: {
+        type: "string",
+        description: "代理国家，默认 AUTO_SELECT_PROXY_COUNTRY。",
+      },
+      maxSearchPagesPerStartUrl: {
+        type: "integer",
+        minimum: 1,
+      },
+      extraInput: {
+        type: "object",
+        description: "可选。透传给 Apify 的其他 input 字段。",
+      },
+    },
+    required: ["urls"],
+  },
+};
+
+export async function amazonProductScraperFunc(
+  args: {
+    urls: string[];
+    maxItemsPerStartUrl?: number;
+    language?: string;
+    proxyCountry?: string;
+    maxSearchPagesPerStartUrl?: number;
+    extraInput?: Record<string, any>;
+  },
+  thunkApi: any
+) {
+  const {
+    urls,
+    maxItemsPerStartUrl,
+    language,
+    proxyCountry,
+    maxSearchPagesPerStartUrl,
+    extraInput = {},
+  } = args;
+
+  if (!urls || !urls.length) {
+    throw new Error("Amazon Product Scraper：urls 不能为空。");
+  }
+
+  const input: any = {
+    categoryOrProductUrls: urls.map((url) => ({ url })),
+    ...extraInput,
+  };
+
+  if (typeof maxItemsPerStartUrl === "number")
+    input.maxItemsPerStartUrl = maxItemsPerStartUrl;
+  if (typeof language === "string") input.language = language;
+  if (typeof proxyCountry === "string") input.proxyCountry = proxyCountry;
+  if (typeof maxSearchPagesPerStartUrl === "number")
+    input.maxSearchPagesPerStartUrl = maxSearchPagesPerStartUrl;
+
+  return callApifyActor(thunkApi, {
+    actorId: "junglee~Amazon-crawler",
+    input,
+    resultType: "datasetItems",
+    displayName: "Amazon Product Scraper",
+  });
+}

package/ai/tools/apifyActorClient.ts

@@ -0,0 +1,45 @@
+// 文件路径: ai/tools/apifyActorClient.ts
+
+import { callToolApi } from "./toolApiClient";
+
+export type ApifyResultType = "datasetItems" | "run" | "kvOutput";
+
+export interface CallApifyActorParams {
+  actorId: string; // 如 "apify~website-content-crawler"
+  input: any;      // 直接给 Apify 的 inputSchema
+  resultType?: ApifyResultType; // 默认 "datasetItems"
+  displayName?: string; // 用于 UI 提示用的名字，如 "YouTube Scraper"
+}
+
+/**
+ * 通用的 Apify Actor 调用封装。
+ * 所有具体 scraping 工具都通过它调用后端 /api/apify-actor。
+ */
+export async function callApifyActor(
+  thunkApi: any,
+  params: CallApifyActorParams
+): Promise<{ rawData: any; displayData: string }> {
+  const { actorId, input, resultType = "datasetItems", displayName } = params;
+
+  const data = await callToolApi(
+    thunkApi,
+    "/api/apify-actor",
+    { actorId, input, resultType },
+    { withAuth: true }
+  );
+
+  const isArray = Array.isArray(data);
+  const count = isArray ? data.length : undefined;
+
+  const title = displayName || actorId;
+  const preview =
+    typeof data === "string"
+      ? data.slice(0, 400)
+      : JSON.stringify(isArray ? data[0] : data, null, 2).slice(0, 800);
+
+  return {
+    rawData: data,
+    displayData: `✅ ${title} 调用成功${typeof count === "number" ? `，返回 ${count} 条记录` : ""
+      }\n\n**结果预览：**\n${preview}`,
+  };
+}