nolo-cli 0.1.40 → 0.1.42

package/ai/agent/createAgentSchema.ts

@@ -0,0 +1,272 @@
+// 路径: ai/agent/createAgentSchema.ts
+
+import { ReferenceItem } from "../../app/types"; // 确保 app/types 里有 ReferenceItem 定义
+import { TFunction } from "i18next";
+import { z } from "zod";
+
+// --- 常量 ---
+export const DEFAULT_TEMPERATURE = 0.7;
+export const DEFAULT_TOP_P = 1;
+export const DEFAULT_FREQUENCY_PENALTY = 0.0;
+export const DEFAULT_PRESENCE_PENALTY = 0.0;
+export const DEFAULT_MAX_TOKENS = 4096;
+export const DEFAULT_REASONING_EFFORT = "medium";
+
+export const REASONING_EFFORT_OPTIONS = ["low", "medium", "high"] as const;
+const greetingMenuItemSchema = z.object({
+  id: z.string().min(1),
+  label: z.string().min(1),
+  userMessage: z.string().optional(),
+});
+
+const greetingConfigSchema = z.object({
+  text: z.string().trim().optional(),
+  menu: z.array(greetingMenuItemSchema).optional(),
+});
+
+const isLocalCustomProviderUrl = (value: unknown): boolean => {
+  if (typeof value !== "string" || !value.trim()) return false;
+  try {
+    const url = new URL(value);
+    const host = url.hostname.toLowerCase();
+    return host === "127.0.0.1" || host === "localhost" || host === "::1";
+  } catch {
+    return false;
+  }
+};
+
+const referenceItemSchema = z
+  .object({
+    dbKey: z.string(),
+    title: z.string(),
+    type: z.enum(["knowledge", "instruction", "page"]),
+  })
+  .transform((data) => ({
+    ...data,
+    type: data.type === "page" ? "knowledge" : data.type,
+  }));
+
+// --- 核心 schema ---
+export const getCreateAgentSchema = (t: TFunction) =>
+  z
+    .object({
+      name: z
+        .string()
+        .trim()
+        .min(1, t("validation.nameRequired"))
+        .max(50, t("validation.nameTooLong")),
+
+      /**
+       * provider 不再必填：只是一个可选的标识字段
+       */
+      provider: z.string().trim().optional().or(z.string().length(0)),
+
+      /**
+       * 模型：所有模式下必须选择（通过 refine 条件校验）
+       */
+      model: z.string().trim().optional().or(z.string().length(0)),
+
+      /**
+       * 模型是否支持图像（来自模型元数据，方便持久化 / 服务端快速判断）
+       */
+      hasVision: z.boolean().optional().default(false),
+
+      /**
+       * API 来源：平台 / 自定义 / CLI
+       */
+      apiSource: z.enum(["platform", "custom", "cli"]).default("platform"),
+
+      /**
+       * 默认交互模式：文本聊天 / 实时语音通话
+       */
+      defaultInteractionMode: z.enum(["text", "live_audio"]).default("text"),
+
+      /**
+       * 语音配置：例如预设音色
+       */
+      voiceConfig: z.object({
+        voiceId: z.string().optional()
+      }).optional(),
+
+      /**
+       * CLI provider（apiSource=cli 时有效）：支持 "copilot" | "gemini" | "codex" | "claude" | "agy" | "qoder"
+       */
+      cliProvider: z
+        .enum(["copilot", "gemini", "codex", "claude", "agy", "qoder"])
+        .optional()
+        .or(z.literal("")),
+
+      /**
+       * Optional machine binding for CLI agents. Empty means use the server/local
+       * CLI runtime; a value means dispatch the CLI run to a connected machine.
+       */
+      machineId: z.string().trim().optional().or(z.string().length(0)),
+
+      customProviderUrl: z
+        .string()
+        .trim()
+        .optional()
+        .or(z.string().length(0))
+        .refine((val) => !val || z.string().url().safeParse(val).success, {
+          message: t("validation.invalidUrl"),
+        }),
+
+      /**
+       * API Key：完全可选（本地 / 无鉴权的自定义接口不需要）
+       */
+      apiKey: z.string().trim().optional().or(z.string().length(0)),
+
+      useServerProxy: z.boolean().default(true),
+
+      prompt: z.string().trim().optional().or(z.string().length(0)),
+
+      tools: z.array(z.string()).default([]),
+
+      isPublic: z.boolean().default(false),
+
+      greeting: z
+        .union([z.string(), greetingConfigSchema])
+        .optional(),
+
+
+      introduction: z.string().trim().optional().or(z.string().length(0)),
+
+      inputPrice: z.number().min(0, t("validation.priceMin")).default(0),
+
+      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)),
+
+      references: z
+        .array(referenceItemSchema)
+        .optional()
+        .default([])
+        .refine(
+          (refs) => {
+            const dbKeys = refs?.map((ref) => ref.dbKey) || [];
+            return dbKeys.length === new Set(dbKeys).size;
+          },
+          { message: t("validation.duplicateReferences") }
+        ),
+
+      temperature: z
+        .number()
+        .min(0, t("validation.temperatureRange"))
+        .max(2, t("validation.temperatureRange"))
+        .optional(),
+
+      top_p: z
+        .number()
+        .min(0, t("validation.topPRange"))
+        .max(1, t("validation.topPRange"))
+        .optional(),
+
+      frequency_penalty: z
+        .number()
+        .min(-2, t("validation.frequencyPenaltyRange"))
+        .max(2, t("validation.frequencyPenaltyRange"))
+        .optional(),
+
+      presence_penalty: z
+        .number()
+        .min(-2, t("validation.presencePenaltyRange"))
+        .max(2, t("validation.presencePenaltyRange"))
+        .optional(),
+
+      max_tokens: z
+        .number()
+        .min(1, t("validation.maxTokensMin"))
+        .max(500000, t("validation.maxTokensMax"))
+        .optional(),
+
+      reasoning_effort: z
+        .enum(REASONING_EFFORT_OPTIONS, {
+          errorMap: () => ({ message: t("validation.reasoningEffortInvalid") }),
+        })
+        .default(DEFAULT_REASONING_EFFORT)
+        .optional(),
+
+      /**
+       * enableThinking：是否开启模型思考模式
+       * - Ollama/Qwen3: delta.reasoning 字段会流式返回思考过程
+       * - Anthropic Claude: 注入 thinking: { type:"enabled", budget_tokens }
+       * - DeepSeek: delta.reasoning_content
+       */
+      enableThinking: z.boolean().optional().default(false),
+
+      /**
+       * thinkingBudget：思考 token 预算（仅对支持 budget_tokens 的 provider 生效，如 Anthropic）
+       * Ollama/DeepSeek 等不支持 budget_tokens 的 provider 忽略此字段
+       */
+      thinkingBudget: z
+        .number()
+        .min(1024, t("validation.thinkingBudgetMin"))
+        .max(32000, t("validation.thinkingBudgetMax"))
+        .optional(),
+
+      /**
+       * whitelist：白名单
+       */
+      whitelist: z.array(z.string().trim().min(1)).optional().default([]),
+
+      /**
+       * linkedSpaces：关联的其他 Space ID 列表
+       * Agent 可以访问这些 Space 的目录结构作为粗略上下文
+       */
+      linkedSpaces: z.array(z.string().trim().min(1)).optional().default([]),
+    })
+    // --- refine 逻辑 ---
+    // 1) 自定义 URL 必填：
+    //    - 只要 apiSource === "custom"，必须填写 customProviderUrl
+    .refine(
+      (data) => {
+        if (data.apiSource === "custom") {
+          return !!data.customProviderUrl;
+        }
+        return true;
+      },
+      {
+        message: t("validation.customUrlRequired"),
+        path: ["customProviderUrl"],
+      }
+    )
+    // 2) model 必填规则：
+    //    - platform / custom 模式必填；cli 模式有默认值，不强制
+    .refine(
+      (data) => {
+        if (data.apiSource === "cli") return true;
+        return !!data.model?.trim();
+      },
+      {
+        message: t("validation.modelRequired"),
+        path: ["model"],
+      }
+    )
+    .superRefine((data, ctx) => {
+      if (!data.machineId?.trim()) return;
+      const canUseMachineBinding =
+        data.apiSource === "cli" ||
+        (data.apiSource === "custom" &&
+          isLocalCustomProviderUrl(data.customProviderUrl));
+      if (canUseMachineBinding) return;
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        path: ["machineId"],
+        message: t("validation.machineBindingRequiresCliOrLocalCustom"),
+      });
+    });
+
+export type FormData = z.infer<ReturnType<typeof getCreateAgentSchema>>;
+
+export const normalizeReferences = (references: any[]): ReferenceItem[] => {
+  if (!Array.isArray(references)) return [];
+  return references.map((ref) => ({
+    dbKey: ref.dbKey || "",
+    title: ref.title || "",
+    type: ref.type === "page" ? "knowledge" : ref.type || "knowledge",
+  }));
+};

package/ai/agent/currentTimeContext.ts

@@ -0,0 +1,65 @@
+const pad2 = (value: number): string => String(value).padStart(2, "0");
+
+const resolveDefaultTimeZone = (): string => {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
+  } catch {
+    return "UTC";
+  }
+};
+
+const partsForTimeZone = (date: Date, timeZone: string): Record<string, string> => {
+  const parts = new Intl.DateTimeFormat("en-US", {
+    timeZone,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hour12: false,
+  }).formatToParts(date);
+
+  return Object.fromEntries(
+    parts
+      .filter((part) => part.type !== "literal")
+      .map((part) => [part.type, part.value]),
+  );
+};
+
+const zonedDateTime = (date: Date, timeZone: string): string => {
+  const parts = partsForTimeZone(date, timeZone);
+  return [
+    `${parts.year}-${parts.month}-${parts.day}`,
+    `${parts.hour}:${parts.minute}:${parts.second}`,
+  ].join(" ");
+};
+
+const timeZoneOffset = (date: Date, timeZone: string): string => {
+  const parts = partsForTimeZone(date, timeZone);
+  const utcMs = Date.UTC(
+    Number(parts.year),
+    Number(parts.month) - 1,
+    Number(parts.day),
+    Number(parts.hour),
+    Number(parts.minute),
+    Number(parts.second),
+  );
+  const offsetMinutes = Math.round((utcMs - date.getTime()) / 60_000);
+  const sign = offsetMinutes >= 0 ? "+" : "-";
+  const absolute = Math.abs(offsetMinutes);
+  return `UTC${sign}${pad2(Math.floor(absolute / 60))}:${pad2(absolute % 60)}`;
+};
+
+export const buildCurrentTimeBlock = (
+  now: Date = new Date(),
+  timeZone: string = resolveDefaultTimeZone(),
+): string => [
+  "--- 当前时间 ---",
+  `当前日期: ${zonedDateTime(now, timeZone).slice(0, 10)}`,
+  `当前本地时间: ${zonedDateTime(now, timeZone)}`,
+  `本地时区: ${timeZone} / ${timeZoneOffset(now, timeZone)}`,
+  `UTC 时间: ${now.toISOString()}`,
+  "当用户问“现在”“当前时间”“北京时间”等时间问题时，直接使用这里的当前时间；不要只回答日期。",
+  "当用户说“今天”“今日”或 today 时，默认指当前本地日期，除非用户明确给出其它日期。",
+].join("\n");

package/ai/agent/executeToolCall.ts

@@ -0,0 +1,58 @@
+// packages/ai/agent/executeToolCall.ts
+//
+// 提取自 runAgentClientLoop：非流式多轮循环中执行单次 tool_call 的公共逻辑。
+// streamAgentChatTurn 走 sendOpenAICompletionsRequest → toolThunks，不使用此函数。
+
+import { findToolExecutor } from "../tools";
+import { getToolResultErrorData } from "../tools/toolResultError";
+
+interface ToolCall {
+  id: string;
+  function?: {
+    name?: string;
+    arguments?: string;
+  };
+}
+
+/**
+ * 执行单次 tool_call，返回工具结果字符串（供追加到 messages）。
+ *
+ * @param tc            LLM 返回的单个 tool_call 对象
+ * @param thunkApi      Redux thunkApi（含 dispatch / getState）
+ * @param parentMessageId 父消息 ID（关联上下文）
+ */
+export async function executeToolCall(
+  tc: ToolCall,
+  thunkApi: any,
+  context?: { parentMessageId?: string; agentKey?: string }
+): Promise<string> {
+  const toolName: string = tc.function?.name ?? "";
+  const toolArgs = (() => {
+    try {
+      return JSON.parse(tc.function?.arguments ?? "{}");
+    } catch {
+      return {};
+    }
+  })();
+
+  try {
+    const toolDefinition = findToolExecutor(toolName);
+    if (!toolDefinition) {
+      return `[工具 "${toolName}" 未找到]`;
+    }
+    const result = await toolDefinition.executor(toolArgs, thunkApi, {
+      parentMessageId: context?.parentMessageId ?? "",
+    });
+    // executor 返回 { rawData, displayData? } 或直接返回字符串
+    const raw = result?.rawData ?? result;
+    return typeof raw === "string" ? raw : JSON.stringify(raw);
+  } catch (err: any) {
+    console.error(`[executeToolCall] tool "${toolName}" 执行失败:`, err);
+    const structured = getToolResultErrorData(err);
+    if (structured?.rawData !== undefined) {
+      const raw = structured.rawData;
+      return typeof raw === "string" ? raw : JSON.stringify(raw);
+    }
+    return `[工具 "${toolName}" 执行失败: ${err?.message ?? err}]`;
+  }
+}

package/ai/agent/fetchAgentContexts.ts

@@ -0,0 +1,42 @@
+import { fetchReferenceContents } from "../context/buildReferenceContext";
+import { resolveReferenceAssets } from "../agent/referenceUtils";
+import type { ReferenceItem } from "../../app/types";
+
+export interface AgentContexts {
+  botInstructionsContext: string;
+  botKnowledgeContext: string;
+}
+
+/** 根据 agentConfig.references 拉取 instruction / knowledge */
+export async function fetchAgentContexts(
+  references: ReferenceItem[] | undefined,
+  dispatch: any
+): Promise<AgentContexts> {
+  if (!Array.isArray(references)) {
+    return { botInstructionsContext: "", botKnowledgeContext: "" };
+  }
+
+  const { references: normalizedRefs, contentByKey } =
+    await resolveReferenceAssets(references, dispatch);
+
+  const instructionKeys = new Set<string>();
+  const knowledgeKeys = new Set<string>();
+  normalizedRefs.forEach((ref) => {
+    if (!ref.dbKey) return;
+    ref.type === "instruction"
+      ? instructionKeys.add(ref.dbKey)
+      : knowledgeKeys.add(ref.dbKey);
+  });
+  const [instructionsMap, knowledgeMap] = await Promise.all([
+    fetchReferenceContents(Array.from(instructionKeys), dispatch, {
+      preloaded: contentByKey,
+    }),
+    fetchReferenceContents(Array.from(knowledgeKeys), dispatch, {
+      preloaded: contentByKey,
+    }),
+  ]);
+  return {
+    botInstructionsContext: Array.from(instructionsMap.values()).join(""),
+    botKnowledgeContext: Array.from(knowledgeMap.values()).join(""),
+  };
+}

package/ai/agent/generatePrompt.ts

@@ -0,0 +1,3 @@
+// 文件路径: ai/agent/generatePrompt.ts
+// 向后兼容转发层，请使用 buildSystemPrompt
+export { buildSystemPrompt as generatePrompt, buildSystemPrompt } from "./buildSystemPrompt";

package/ai/agent/getFullChatContextKeys.ts

@@ -0,0 +1,168 @@
+
+// packages/ai/agent/getFullChatContextKeys.ts
+import { RootState } from "../../app/store";
+import { selectAllMsgs } from "../../chat/messages/messageSlice";
+import type { DialogConfig } from "../../app/types";
+import { extractCustomId } from "../../core/prefix";
+
+/** 简单的数组差集工具：返回 arrA 中不在 arrB 里的元素 */
+const difference = <T>(arrA: T[], arrB: T[]): T[] => {
+  if (!arrA.length) return [];
+  if (!arrB.length) return [...arrA];
+
+  const exclude = new Set(arrB);
+  return arrA.filter((item) => !exclude.has(item));
+};
+
+/**
+ * Collect all possible reference keys for this chat turn:
+ * - botInstructionKeys: keys from agentConfig.references of type "instruction"
+ * - botKnowledgeKeys: keys from agentConfig.references (non-instruction)
+ * - currentInputKeys: keys referenced directly by the user's current input (array parts with pageKey)
+ * - historyKeys: keys from all previous messages' content parts
+ */
+export const getFullChatContextKeys = async (
+  state: RootState,
+  dispatch: any,
+  agentConfig: any,
+  userInput: string | any[],
+  dialogConfig?: DialogConfig
+): Promise<Record<string, Set<string>>> => {
+  const msgs = selectAllMsgs(
+    state,
+    dialogConfig?.dbKey
+      ? extractCustomId(dialogConfig.dbKey)
+      : dialogConfig?.id
+  );
+
+  const botInstructionKeys = new Set<string>();
+  const botKnowledgeKeys = new Set<string>();
+
+  if (Array.isArray(agentConfig.references)) {
+    for (const ref of agentConfig.references as Array<{
+      dbKey: string;
+      type: string;
+    }>) {
+      if (!ref?.dbKey) continue;
+      if (ref.type === "instruction") {
+        botInstructionKeys.add(ref.dbKey);
+      } else {
+        botKnowledgeKeys.add(ref.dbKey);
+      }
+    }
+  }
+
+  const currentInputKeys = new Set<string>();
+  if (Array.isArray(userInput)) {
+    for (const part of userInput) {
+      if (part?.pageKey) currentInputKeys.add(part.pageKey);
+      if (part?.dialogKey) currentInputKeys.add(part.dialogKey);
+    }
+  }
+
+  const historyKeys = new Set<string>();
+
+  // 1. 从 DialogConfig.referenceKeys 读取（这是主要的、持久化的引用来源）
+  // 即使消息被压缩，这里的 keys 也会保留
+  const savedKeys = dialogConfig?.referenceKeys;
+  if (Array.isArray(savedKeys)) {
+    savedKeys.forEach((k: string) => historyKeys.add(k));
+  }
+
+  // 2. 仅扫描尚未被压缩的近期消息
+  // 已压缩的消息（summarizedBeforeId 之前的部分，包含该条本身）的 keys
+  // 已在压缩时存入 dialogConfig.referenceKeys，步骤 1 已覆盖，无需重复扫描。
+  const scanContentParts = (msg: any) => {
+    if (!msg.content) return;
+    const contentParts = Array.isArray(msg.content) ? msg.content : [msg.content];
+    for (const part of contentParts) {
+      if (part && typeof part === 'object') {
+        if (part?.pageKey) historyKeys.add(part.pageKey);
+        if (part?.dialogKey) historyKeys.add(part.dialogKey);
+      }
+    }
+  };
+
+  if (msgs && msgs.length > 0) {
+    const summarizedBeforeId = dialogConfig?.summarizedBeforeId;
+
+    if (!summarizedBeforeId) {
+      // 无压缩记录，扫描全部消息
+      for (const msg of (msgs as any[])) scanContentParts(msg);
+    } else {
+      let foundMarker = false;
+      let startScan = false;
+
+      for (const msg of (msgs as any[])) {
+        if (!startScan) {
+          if (msg.id === summarizedBeforeId) {
+            foundMarker = true;
+            startScan = true;
+            // summarizedBeforeId 那条消息本身已被压缩，keys 在 referenceKeys 里，跳过
+          }
+          continue;
+        }
+        scanContentParts(msg);
+      }
+
+      // marker 找不到说明 Redux 中的消息都是新的，应该全扫
+      if (!foundMarker) {
+        console.warn(`[getFullChatContextKeys] marker ${summarizedBeforeId} not found, scanning all`);
+        for (const msg of (msgs as any[])) scanContentParts(msg);
+      }
+    }
+  }
+
+  return {
+    botInstructionKeys,
+    currentInputKeys,
+    historyKeys,
+    botKnowledgeKeys,
+  };
+};
+
+/**
+ * Deduplicate keys across priority levels.
+ * Priority order (high -> low):
+ * 1) botInstructionKeys
+ * 2) currentInputKeys
+ * 3) historyKeys
+ * 4) botKnowledgeKeys
+ *
+ * Return field names match context block identifiers expected downstream.
+ */
+export const deduplicateContextKeys = (
+  keys: Record<string, Set<string>>
+): Record<string, string[]> => {
+  const {
+    botInstructionKeys,
+    currentInputKeys,
+    historyKeys,
+    botKnowledgeKeys,
+  } = keys;
+
+  const finalBotInstructionKeys = Array.from(botInstructionKeys);
+
+  const finalCurrentInputKeys = difference(
+    Array.from(currentInputKeys),
+    finalBotInstructionKeys
+  );
+
+  const finalHistoryKeys = difference(Array.from(historyKeys), [
+    ...finalBotInstructionKeys,
+    ...finalCurrentInputKeys,
+  ]);
+
+  const finalBotKnowledgeKeys = difference(Array.from(botKnowledgeKeys), [
+    ...finalBotInstructionKeys,
+    ...finalCurrentInputKeys,
+    ...finalHistoryKeys,
+  ]);
+
+  return {
+    botInstructionsContext: finalBotInstructionKeys,
+    currentInputContext: finalCurrentInputKeys,
+    historyContext: finalHistoryKeys,
+    botKnowledgeContext: finalBotKnowledgeKeys,
+  };
+};

package/ai/agent/guidedCreation/capabilities.ts

@@ -0,0 +1,84 @@
+import type { GuidedAgentCapabilityId } from "./types";
+
+type CapabilityDefinition = {
+  id: GuidedAgentCapabilityId;
+  label: {
+    zhCN: string;
+    en: string;
+  };
+  description: {
+    zhCN: string;
+    en: string;
+  };
+  toolIds: string[];
+};
+
+export const GUIDED_AGENT_CAPABILITIES: Record<
+  GuidedAgentCapabilityId,
+  CapabilityDefinition
+> = {
+  webSearch: {
+    id: "webSearch",
+    label: { zhCN: "联网搜索", en: "Search the web" },
+    description: {
+      zhCN: "需要获取外部网页、资料或最新信息时使用。",
+      en: "Use when the agent needs external webpages, research, or current information.",
+    },
+    toolIds: ["exa_search", "fetchWebpage"],
+  },
+  docs: {
+    id: "docs",
+    label: { zhCN: "读写文档", en: "Read and write docs" },
+    description: {
+      zhCN: "需要读取、创建或更新知识页和文档时使用。",
+      en: "Use when the agent should read, create, or update docs.",
+    },
+    toolIds: ["createDoc", "updateDoc", "read"],
+  },
+  tables: {
+    id: "tables",
+    label: { zhCN: "处理表格", en: "Work with tables" },
+    description: {
+      zhCN: "需要创建表、追加记录或整理结构化数据时使用。",
+      en: "Use when the agent should create tables or manage structured rows.",
+    },
+    toolIds: ["createTable", "addTableRow", "addTableRows", "read"],
+  },
+  agents: {
+    id: "agents",
+    label: { zhCN: "调用其他 AI", en: "Call other AI agents" },
+    description: {
+      zhCN: "需要多 Agent 协作、评审或分工时使用。",
+      en: "Use when the agent should collaborate with other agents.",
+    },
+    toolIds: ["callAgent", "startAgentDialog"],
+  },
+  apps: {
+    id: "apps",
+    label: { zhCN: "创建应用或代码", en: "Create apps or code" },
+    description: {
+      zhCN: "需要生成应用、代码或使用 App Builder 能力时使用。",
+      en: "Use when the agent should build apps, code, or App Builder outputs.",
+    },
+    toolIds: ["appDeploy", "appList", "appRead"],
+  },
+};
+
+export const mapCapabilityIdsToToolIds = (
+  capabilityIds: GuidedAgentCapabilityId[]
+): string[] => {
+  const seen = new Set<string>();
+  const result: string[] = [];
+
+  for (const id of capabilityIds) {
+    const definition = GUIDED_AGENT_CAPABILITIES[id];
+    if (!definition) continue;
+    for (const toolId of definition.toolIds) {
+      if (seen.has(toolId)) continue;
+      seen.add(toolId);
+      result.push(toolId);
+    }
+  }
+
+  return result;
+};