nolo-cli 0.1.39 → 0.1.41

package/ai/tools/skillFollowup.ts

@@ -0,0 +1,86 @@
+export type SkillReferenceChoice = {
+  dbKey: string;
+  title: string;
+  type: "instruction";
+};
+
+export type SkillFollowupChoice = {
+  id: "save_only" | "use_existing_agent" | "create_agent";
+  label: string;
+  userMessage: string;
+};
+
+type SkillFollowupInput = {
+  dbKey: string;
+  title: string;
+  skillId?: string;
+  spaceId?: string | null;
+  toolNames?: string[];
+  hasEvalConfig?: boolean;
+  importedFrom?: string | null;
+};
+
+export const buildSkillReferenceChoice = (
+  dbKey: string,
+  title: string
+): SkillReferenceChoice => ({
+  dbKey,
+  title,
+  type: "instruction",
+});
+
+export const buildSkillFollowupChoices = (
+  reference: SkillReferenceChoice
+): SkillFollowupChoice[] => [
+  {
+    id: "save_only",
+    label: "仅保存",
+    userMessage: `先只保存这个 skill 文档，不挂到任何 agent。skill dbKey 是 ${reference.dbKey}。`,
+  },
+  {
+    id: "use_existing_agent",
+    label: "挂到现有 Agent",
+    userMessage: `请把这个 skill 挂到我现有的 agent 上。skill dbKey 是 ${reference.dbKey}。`,
+  },
+  {
+    id: "create_agent",
+    label: "新建一个 Agent 来使用它",
+    userMessage: `请基于这个 skill 新建一个 agent 来使用它。skill dbKey 是 ${reference.dbKey}。`,
+  },
+];
+
+export const buildSkillFollowupResult = (input: SkillFollowupInput) => {
+  const reference = buildSkillReferenceChoice(input.dbKey, input.title);
+  const nextActions = buildSkillFollowupChoices(reference);
+  const lines = [
+    `Skill《${input.title}》已保存为本地文档。`,
+    `- dbKey: ${input.dbKey}`,
+    input.spaceId ? `- spaceId: ${input.spaceId}` : null,
+    input.skillId ? `- skillId: ${input.skillId}` : null,
+    input.importedFrom ? `- importedFrom: ${input.importedFrom}` : null,
+    Array.isArray(input.toolNames) && input.toolNames.length > 0
+      ? `- tools: ${input.toolNames.join(", ")}`
+      : null,
+    typeof input.hasEvalConfig === "boolean"
+      ? `- hasEvalConfig: ${input.hasEvalConfig ? "yes" : "no"}`
+      : null,
+    "下一步请优先询问用户：仅保存、挂到现有 Agent，还是新建一个 Agent 来使用它。",
+  ].filter(Boolean);
+
+  return {
+    rawData: {
+      success: true,
+      id: input.dbKey,
+      dbKey: input.dbKey,
+      title: input.title,
+      skillId: input.skillId ?? null,
+      spaceId: input.spaceId ?? null,
+      toolNames: input.toolNames ?? [],
+      hasEvalConfig: input.hasEvalConfig ?? false,
+      importedFrom: input.importedFrom ?? null,
+      reference,
+      nextActions,
+    },
+    displayData: lines.join("\n"),
+  };
+};

package/ai/tools/surfWeatherTool.ts

@@ -0,0 +1,169 @@
+export interface SurfWeatherToolArgs {
+  latitude: number;
+  longitude: number;
+  location_name?: string;
+  forecast_days?: number;
+}
+
+export const surfWeatherFunctionSchema = {
+  name: "surfWeather",
+  description: [
+    "获取指定海岸位置的冲浪天气预报，包括浪高、涌浪高度、浪周期、涌浪周期、浪向等关键指标。",
+    "数据来源：Open-Meteo Marine API（免费，无需 API Key）。",
+    "适用场景：查询某个冲浪点未来几天的海浪状况，判断是否适合冲浪。",
+  ].join("\n"),
+  parameters: {
+    type: "object",
+    properties: {
+      latitude: {
+        type: "number",
+        description: "纬度，例如海南万宁为 18.8",
+      },
+      longitude: {
+        type: "number",
+        description: "经度，例如海南万宁为 110.4",
+      },
+      location_name: {
+        type: "string",
+        description: "地点名称（可选），仅用于展示，例如「海南万宁日月湾」",
+      },
+      forecast_days: {
+        type: "number",
+        description: "预报天数，1~7，默认 3",
+      },
+    },
+    required: ["latitude", "longitude"],
+  },
+} as const;
+
+interface HourlyData {
+  time: string[];
+  wave_height: number[];
+  wave_period: number[];
+  wave_direction: number[];
+  wind_wave_height: number[];
+  swell_wave_height: number[];
+  swell_wave_period: number[];
+  swell_wave_direction: number[];
+}
+
+function getSurfRating(waveHeight: number, wavePeriod: number): string {
+  if (waveHeight < 0.3) return "⚫ 无浪";
+  if (waveHeight < 0.6 && wavePeriod < 6) return "🟤 极差";
+  if (waveHeight < 0.8) return "🔴 差";
+  if (waveHeight < 1.2 && wavePeriod >= 6) return "🟡 一般";
+  if (waveHeight < 2.0 && wavePeriod >= 8) return "🟢 较好";
+  if (waveHeight >= 2.0 && wavePeriod >= 10) return "🔵 优秀";
+  return "🟡 一般";
+}
+
+function getWindDirection(deg: number): string {
+  const dirs = ["北", "东北", "东", "东南", "南", "西南", "西", "西北"];
+  return dirs[Math.round(deg / 45) % 8];
+}
+
+export async function surfWeatherFunc(
+  args: SurfWeatherToolArgs
+): Promise<{ rawData: unknown; displayData: string }> {
+  const { latitude, longitude, location_name, forecast_days = 3 } = args;
+
+  const days = Math.min(Math.max(Math.round(forecast_days), 1), 7);
+  const params = [
+    "wave_height",
+    "wave_period",
+    "wave_direction",
+    "wind_wave_height",
+    "swell_wave_height",
+    "swell_wave_period",
+    "swell_wave_direction",
+  ].join(",");
+
+  const url =
+    `https://marine-api.open-meteo.com/v1/marine` +
+    `?latitude=${latitude}&longitude=${longitude}` +
+    `&hourly=${params}` +
+    `&timezone=Asia/Shanghai` +
+    `&forecast_days=${days}`;
+
+  const res = await fetch(url);
+  if (!res.ok) {
+    throw new Error(`Open-Meteo API 请求失败: ${res.status} ${res.statusText}`);
+  }
+
+  const data = (await res.json()) as {
+    latitude: number;
+    longitude: number;
+    hourly: HourlyData;
+  };
+
+  const h = data.hourly;
+  const locationLabel = location_name || `${data.latitude}°N, ${data.longitude}°E`;
+
+  // 每天取最大浪高时段作为日摘要（取 08:00 - 20:00 峰值）
+  const dailySummaries: {
+    date: string;
+    maxWaveHeight: number;
+    wavePeriod: number;
+    swellHeight: number;
+    swellPeriod: number;
+    waveDirection: number;
+    rating: string;
+  }[] = [];
+
+  const totalHours = h.time.length;
+  for (let d = 0; d < days; d++) {
+    const start = d * 24;
+    const end = Math.min(start + 24, totalHours);
+    // 找当天最大浪高的小时
+    let bestIdx = start;
+    for (let i = start; i < end; i++) {
+      const hour = parseInt(h.time[i].slice(11, 13), 10);
+      if (hour < 8 || hour > 20) continue;
+      if (h.wave_height[i] > h.wave_height[bestIdx]) bestIdx = i;
+    }
+    const date = h.time[bestIdx].slice(0, 10);
+    const wh = h.wave_height[bestIdx];
+    const wp = h.wave_period[bestIdx];
+    const sh = h.swell_wave_height[bestIdx];
+    const sp = h.swell_wave_period[bestIdx];
+    const wd = h.wave_direction[bestIdx];
+    dailySummaries.push({
+      date,
+      maxWaveHeight: wh,
+      wavePeriod: wp,
+      swellHeight: sh,
+      swellPeriod: sp,
+      waveDirection: wd,
+      rating: getSurfRating(wh, wp),
+    });
+  }
+
+  // 构建展示文本
+  const lines: string[] = [];
+  lines.push(`🏄 冲浪天气预报 — ${locationLabel}`);
+  lines.push(`数据来源：Open-Meteo Marine API\n`);
+  lines.push(`日期          评级      浪高    涌浪    周期  涌浪周期  浪向`);
+  lines.push("─".repeat(58));
+
+  for (const s of dailySummaries) {
+    lines.push(
+      `${s.date}  ${s.rating}  ${s.maxWaveHeight.toFixed(2)}m  ${s.swellHeight.toFixed(2)}m  ${s.wavePeriod.toFixed(1)}s  ${s.swellPeriod.toFixed(1)}s  ${getWindDirection(s.waveDirection)}`
+    );
+  }
+
+  lines.push("\n评级说明：🔵优秀 🟢较好 🟡一般 🔴差 🟤极差 ⚫无浪");
+
+  const displayData = lines.join("\n");
+
+  return {
+    rawData: {
+      location: locationLabel,
+      latitude: data.latitude,
+      longitude: data.longitude,
+      forecast_days: days,
+      daily: dailySummaries,
+      hourly: h,
+    },
+    displayData,
+  };
+}

package/ai/tools/table/addTableRowTool.ts

@@ -0,0 +1,217 @@
+// 文件: ai/tools/table/addTableRowTool.ts
+
+import type { RootState } from "../../../app/store";
+import { addRow } from "../../../render/table/tableSlice";
+
+/**
+ * [Schema] addTableRow：在当前已打开的表中新增一行数据
+ *
+ * 设计要点：
+ * - 默认情况下，从当前 Redux 状态里的 tableSlice.currentTable 推断 tenantId / tableId
+ * - LLM 主要只需要关心 values（列名 -> 值）
+ * - 如果没有当前表，又没显式传 tenantId / tableId，则报错
+ */
+export const addTableRowFunctionSchema = {
+    name: "addTableRow",
+    description:
+        [
+            "在指定表中新增一行数据。",
+            "【重要】如果你是在对话（chat）中调用此函数（而非在表格页面的「页面助手」中），",
+            "则必须显式传入 tenantId 和 tableId。这两个值可从 createTable 的返回结果中获取。",
+            "如果你刚刚调用了 createTable，请务必将其返回的 tenantId 和 tableId 传入此函数。",
+            "只有在表格页面打开「页面助手」时，tenantId 和 tableId 才可以省略（会自动推断）。",
+            "【重要】表格字段必须放在 values 对象里，不要把 content、status 这类列名直接放在顶层。",
+            '完整示例：{"tenantId":"u1","tableId":"t1","values":{"content":"希望支持支付宝支付","status":"待处理"}}。',
+        ].join("\n"),
+    parameters: {
+        type: "object",
+        properties: {
+            values: {
+                type: "object",
+                description:
+                    [
+                        "要写入新行的数据。key 必须是目标表已有的列名，多余字段会被忽略。",
+                        '请根据用户的自然语言描述，为每个相关字段填上合理的值，而不是传入空对象 {}。',
+                        '字段必须包在 values 中。示例：{"values": {"name": "张三", "desc": "测试任务", "date": "2025-01-01"}}。',
+                    ].join("\n"),
+                additionalProperties: {
+                    description:
+                        "单个字段的值；可以是字符串、数字、布尔值、null、对象或数组。",
+                },
+            },
+            tenantId: {
+                type: "string",
+                description:
+                    "租户 ID。在对话（chat）中调用时必须显式传入，从 createTable 的返回结果获取。",
+            },
+            tableId: {
+                type: "string",
+                description:
+                    "表 ID。在对话（chat）中调用时必须显式传入，从 createTable 的返回结果获取。",
+            },
+        },
+        required: ["values"],
+    },
+};
+
+type AddTableRowArgs = {
+    values?: Record<string, any>;
+    tenantId?: string;
+    tableId?: string;
+} & Record<string, any>;
+
+type AddTableRowResult = {
+    rawData: any;
+    displayData: string;
+};
+
+const toPreviewJson = (value: unknown, maxLength = 400): string => {
+    try {
+        const json = JSON.stringify(value, null, 2);
+        if (json.length <= maxLength) return json;
+        return `${json.slice(0, maxLength)}\n…(已截断)…`;
+    } catch {
+        return "[无法序列化为 JSON]";
+    }
+};
+
+const RESERVED_ARG_KEYS = new Set(["tenantId", "tableId", "values"]);
+
+const extractLegacyValues = (args: AddTableRowArgs | undefined): Record<string, any> => {
+    if (!args || typeof args !== "object" || Array.isArray(args)) {
+        return {};
+    }
+
+    return Object.fromEntries(
+        Object.entries(args).filter(
+            ([key, value]) => !RESERVED_ARG_KEYS.has(key) && value !== undefined
+        )
+    );
+};
+
+/**
+ * [Executor] 在当前表中新增一行
+ *
+ * - 优先从 args.tenantId / args.tableId 取值
+ * - 否则使用 state.table.currentTable 的 tenantId / tableId
+ * - 如果当前表元数据可用，会自动过滤掉不存在的列名，并在 displayData 提示
+ */
+export async function addTableRowFunc(
+    args: AddTableRowArgs,
+    thunkApi: any
+): Promise<AddTableRowResult> {
+    const state = thunkApi.getState() as RootState;
+    const tableState = state.table as RootState["table"];
+
+    const currentTable = tableState.currentTable;
+
+    const tenantId = args?.tenantId ?? currentTable?.tenantId;
+    const tableId = args?.tableId ?? currentTable?.tableId;
+    const normalizedValues =
+        args?.values !== undefined ? args.values : extractLegacyValues(args);
+    const values = (normalizedValues ?? {}) as Record<string, any>;
+
+    if (!tenantId || !tableId) {
+        throw new Error(
+            "addTableRow 只能在已打开某张表的页面中调用，或显式提供 tenantId 和 tableId。"
+        );
+    }
+
+    if (!values || typeof values !== "object" || Array.isArray(values)) {
+        throw new Error(
+            'addTableRow.values 必须是一个对象（列名到值的映射，例如 { "name": "张三", "desc": "测试任务" }）。'
+        );
+    }
+
+    // 兜底：禁止传空对象 {}，要求至少提供一个字段
+    if (Object.keys(values).length === 0) {
+        const knownCols = currentTable
+            ? currentTable.columns.map((c) => c.name).join(", ") || "(无列定义)"
+            : "(当前表字段未知)";
+
+        throw new Error(
+            `addTableRow.values 不能为空：你需要至少为一个字段提供值。\n` +
+            `请根据用户的输入，从以下字段中选择并填充值：${knownCols}`
+        );
+    }
+
+    let sanitizedValues: Record<string, any> = values;
+    let ignoredColumns: string[] = [];
+
+    if (
+        currentTable &&
+        currentTable.tenantId === tenantId &&
+        currentTable.tableId === tableId
+    ) {
+        const allowedColumns = new Set(currentTable.columns.map((c) => c.name));
+
+        sanitizedValues = {};
+        ignoredColumns = [];
+
+        for (const [key, val] of Object.entries(values)) {
+            if (allowedColumns.has(key)) {
+                sanitizedValues[key] = val;
+            } else {
+                ignoredColumns.push(key);
+            }
+        }
+
+        if (
+            Object.keys(sanitizedValues).length === 0 &&
+            Object.keys(values).length > 0
+        ) {
+            const knownCols =
+                currentTable.columns.map((c) => c.name).join(", ") || "(无列定义)";
+
+            throw new Error(
+                `addTableRow 失败：提供的字段名都不在当前表中。\n` +
+                `已知字段: ${knownCols}\n` +
+                `请仅使用这些字段名作为 key。`
+            );
+        }
+    }
+
+    try {
+        const actionResult = await thunkApi.dispatch(
+            addRow({ tenantId, tableId, values: sanitizedValues })
+        );
+
+        if (!addRow.fulfilled.match(actionResult)) {
+            const msg =
+                (actionResult.payload as string) ||
+                actionResult.error?.message ||
+                "新增表行失败";
+            throw new Error(msg);
+        }
+
+        const createdRow = actionResult.payload as any;
+
+        const tableLabel =
+            currentTable?.displayName ||
+            currentTable?.tableId ||
+            tableId ||
+            "当前表";
+
+        const ignoredInfo =
+            ignoredColumns.length > 0
+                ? `\n\n注意：以下字段在当前表中不存在，已被忽略：${ignoredColumns.join(
+                    ", "
+                )}`
+                : "";
+
+        return {
+            rawData: {
+                ...createdRow,
+                values: sanitizedValues,
+            },
+            displayData:
+                `已在表「${tableLabel}」中新增一行数据。\n` +
+                `rowId: ${createdRow.rowId ?? "（无 rowId 字段）"}\n\n` +
+                `数据预览：\n${toPreviewJson(createdRow)}${ignoredInfo}`,
+        };
+    } catch (error: any) {
+        throw new Error(
+            `addTableRow 调用失败：${error?.message ?? "未知错误"}`
+        );
+    }
+}