nolo-cli 0.1.13 → 0.1.14

package/ai/tools/searchRepoTool.ts

@@ -0,0 +1,115 @@
+// 文件路径: packages/ai/tools/searchRepoTool.ts
+
+import { getToolBaseUrl } from "./toolApiClient";
+
+// ---- Types ----
+
+export type SearchRepoArgs = {
+    query: string;
+    pathScope?: string;
+    maxResults?: number;
+    contextLines?: number;
+};
+
+// ---- 工具 Schema ----
+
+export const searchRepoFunctionSchema = {
+    name: "search_repo",
+    description: [
+        "在项目的源代码中进行全量文本搜索。",
+        "当你不知道某个特定的字符串、类名、变量或逻辑在哪个文件中时，请使用此工具。",
+        "它会返回匹配的文件路径、行号以及代码预览。",
+        "",
+        "参数建议：",
+        "- query: 要搜索的文本（不区分大小写）。",
+        "- pathScope: 可选，缩小搜索范围（如 'packages/server'）。",
+        "- maxResults: 默认 20。",
+    ].join("\n"),
+    parameters: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "要搜索的文本字符串。",
+            },
+            pathScope: {
+                type: "string",
+                description: "可选：限制搜索在特定目录下，例如 'packages/ai'。",
+            },
+            maxResults: {
+                type: "number",
+                description: "返回的最大匹配项数量 (默认 20)。",
+            },
+            contextLines: {
+                type: "number",
+                description: "可选：匹配行前后显示的上下文行数。",
+            },
+        },
+        required: ["query"],
+    },
+};
+
+function buildSearchRepoDisplayData(
+    query: string,
+    hits: Array<{ path?: string; line?: number; preview?: string }>,
+    totalHits: number | string | undefined,
+): string {
+    if (!Array.isArray(hits) || hits.length === 0) {
+        return `🔍 搜索 "${query}": 未找到匹配项`;
+    }
+
+    const lines = hits.slice(0, 8).map((hit, index) => {
+        const path = hit.path || "unknown";
+        const line = typeof hit.line === "number" ? `:${hit.line}` : "";
+        const preview = typeof hit.preview === "string" && hit.preview.trim()
+            ? ` — ${hit.preview.trim()}`
+            : "";
+        return `${index + 1}. ${path}${line}${preview}`;
+    });
+
+    const omitted = hits.length > 8 ? `\n… 其余 ${hits.length - 8} 条已省略` : "";
+    return `🔍 搜索 "${query}": 找到 ${totalHits ?? hits.length} 个匹配项\n${lines.join("\n")}${omitted}`;
+}
+
+// ---- 执行函数 ----
+
+export async function searchRepoFunc(
+    args: SearchRepoArgs,
+    thunkApi: any,
+    context?: { signal?: AbortSignal }
+): Promise<{ rawData: any; displayData?: string }> {
+    const { query, pathScope, maxResults, contextLines } = args;
+
+    try {
+        const baseUrl = getToolBaseUrl(thunkApi);
+        const apiUrl = `${baseUrl}/api/search-repo`;
+
+        const response = await fetch(apiUrl, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            signal: context?.signal,
+            body: JSON.stringify({ query, pathScope, maxResults, contextLines }),
+        });
+
+        const data = (await response.json()) as { ok?: boolean; error?: string; hits?: any[]; totalHits?: number | string };
+
+        if (!response.ok || data?.error) {
+            throw new Error(data?.error || `搜索请求失败: ${response.status}`);
+        }
+
+        const hits = data.hits || [];
+        const displayData = buildSearchRepoDisplayData(query, hits, data.totalHits);
+
+        return {
+            rawData: {
+                ok: true,
+                query,
+                hits,
+                totalHits: data.totalHits,
+            },
+            displayData,
+        };
+    } catch (error: any) {
+        throw new Error(`全局搜索 (${query}) 失败：${error?.message || String(error)}`);
+    }
+}

package/ai/tools/searchWorkspaceTool.ts

@@ -0,0 +1,259 @@
+// ai/tools/searchWorkspaceTool.ts
+
+import {
+  buildMyContentItemsFromUserData,
+  MY_CONTENT_USER_DATA_TYPES,
+  type MyContentListItem,
+} from "app/utils/myContentItems";
+import type { SpaceContent, SpaceData, SpaceMemberWithSpaceInfo } from "app/types";
+import { fetchUserData } from "database/client/fetchUserData";
+import { getUserDataItemTimestamp, mergeAndDedupUserData } from "database/userDataMerge";
+
+type SearchWorkspaceArgs = { query: string };
+
+type SearchWorkspaceResultItem = {
+  title: string;
+  type: string;
+  contentKey: string;
+  spaceId: string | null;
+  spaceName?: string;
+  createdAt?: string | number;
+  updatedAt?: string | number;
+  serverOrigin?: string;
+};
+
+type SearchWorkspaceResult = {
+  rawData: { success: true; contents: SearchWorkspaceResultItem[] };
+  displayData: string;
+};
+
+type SearchWorkspaceState = {
+  auth?: {
+    currentUser?: {
+      userId?: string | null;
+    } | null;
+  };
+  settings?: {
+    currentServer?: string;
+  };
+  space: {
+    currentSpaceId: string | null;
+    currentSpace: SpaceData | null;
+    memberSpaces: SpaceMemberWithSpaceInfo[] | null;
+  };
+};
+
+type SearchWorkspaceThunkApi = {
+  getState: () => SearchWorkspaceState;
+  dispatch: (action: unknown) => unknown;
+  extra: {
+    db: any | null;
+    tokenManager: any | null;
+  };
+};
+
+const selectCurrentSpaceIdFromState = (state: SearchWorkspaceState) =>
+  state.space.currentSpaceId;
+
+const selectCurrentSpaceFromState = (state: SearchWorkspaceState) =>
+  state.space.currentSpace;
+
+const selectAllMemberSpacesFromState = (state: SearchWorkspaceState) => {
+  const memberSpaces = state.space.memberSpaces ?? [];
+  return [...memberSpaces].sort((a, b) => {
+    const aUpdatedAt =
+      a.spaceUpdatedAt ??
+      (a as any).memberUpdatedAt ??
+      (a as any).updatedAt ??
+      (a as any).createdAt ??
+      a.joinedAt ??
+      0;
+    const bUpdatedAt =
+      b.spaceUpdatedAt ??
+      (b as any).memberUpdatedAt ??
+      (b as any).updatedAt ??
+      (b as any).createdAt ??
+      b.joinedAt ??
+      0;
+    return bUpdatedAt - aUpdatedAt;
+  });
+};
+
+export const searchWorkspaceFunctionSchema = {
+  name: "search_workspace",
+  description: "在当前空间（Workspace）中搜索页面、表格等内容。",
+  parameters: {
+    type: "object",
+    properties: {
+      query: {
+        type: "string",
+        description: "搜索关键词。将匹配标题和文件名。",
+      },
+    },
+    required: ["query"],
+  },
+};
+
+export const searchAllSpacesFunctionSchema = {
+  name: "search_all_spaces",
+  description:
+    "在当前设备已同步的全部内容中搜索当前用户的数据（等同于全部视图 Recent 的内容语义），并返回所属空间（如有）。",
+  parameters: searchWorkspaceFunctionSchema.parameters,
+};
+
+const normalizeQuery = (value: unknown) => String(value || "").trim().toLowerCase();
+
+const toSearchResultItem = (
+  item:
+    | Pick<
+        MyContentListItem,
+        "title" | "type" | "contentKey" | "spaceId" | "spaceName" | "createdAt" | "updatedAt" | "serverOrigin"
+      >
+    | (SpaceContent & { spaceId: string; spaceName?: string })
+): SearchWorkspaceResultItem => ({
+  title: String(item.title || item.contentKey || "").trim(),
+  type: String(item.type || "").trim(),
+  contentKey: String(item.contentKey || "").trim(),
+  spaceId: item.spaceId ?? null,
+  ...(item.spaceName ? { spaceName: item.spaceName } : {}),
+  ...(item.createdAt !== undefined ? { createdAt: item.createdAt } : {}),
+  ...(item.updatedAt !== undefined ? { updatedAt: item.updatedAt } : {}),
+  ...(typeof item.serverOrigin === "string" && item.serverOrigin.trim().length > 0
+    ? { serverOrigin: item.serverOrigin }
+    : {}),
+});
+
+const searchSpaceContents = (
+  space: SpaceData,
+  query: string,
+  options?: { spaceName?: string }
+): SearchWorkspaceResultItem[] => {
+  const kw = normalizeQuery(query);
+  const allContents = Object.values(space.contents || {});
+
+  return allContents
+    .filter((content): content is SpaceContent => {
+      if (!content) return false;
+      const titleMatch = (content.title ?? "").toLowerCase().includes(kw);
+      const keyMatch = (content.contentKey ?? "").toLowerCase().includes(kw);
+      return titleMatch || keyMatch;
+    })
+    .map((content) =>
+      toSearchResultItem({
+        ...content,
+        spaceId: space.id,
+        ...(options?.spaceName ? { spaceName: options.spaceName } : {}),
+      })
+    );
+};
+
+const matchesMyContentSearch = (
+  query: string,
+  item: Pick<MyContentListItem, "title" | "type" | "spaceName" | "contentKey">
+) => {
+  const kw = normalizeQuery(query);
+  if (!kw) return false;
+  return [item.title, item.type, item.spaceName, item.contentKey].some((value) =>
+    normalizeQuery(value).includes(kw)
+  );
+};
+
+const buildScopedDisplayData = (
+  query: string,
+  results: SearchWorkspaceResultItem[],
+  scopeLabel: string
+) => {
+  if (results.length === 0) {
+    return `未能在${scopeLabel}中找到匹配 "${query}" 的内容。`;
+  }
+
+  const summary = results
+    .map((item) => {
+      const spaceSuffix = item.spaceName ? ` [${item.spaceName}]` : "";
+      return `- ${item.title} (${item.contentKey})${spaceSuffix}`;
+    })
+    .join("\n");
+
+  return `在${scopeLabel}中找到 ${results.length} 个匹配项：\n${summary}`;
+};
+
+const loadLocalMyContentResults = async (
+  thunkApi: SearchWorkspaceThunkApi,
+  state: SearchWorkspaceState
+): Promise<MyContentListItem[]> => {
+  const userId = state.auth?.currentUser?.userId?.trim();
+  if (!userId) {
+    throw new Error("无法搜索全部内容，因为当前用户未登录。");
+  }
+
+  const db = thunkApi.extra?.db;
+  if (!db) {
+    throw new Error("无法搜索全部内容，因为本地数据库不可用。");
+  }
+
+  const localResults = await fetchUserData(db, MY_CONTENT_USER_DATA_TYPES, userId, {
+    includeDeleted: true,
+  });
+  const dedupedRecords = mergeAndDedupUserData(Object.values(localResults).flat(), []);
+  const sortedRecords = [...dedupedRecords].sort(
+    (a, b) => getUserDataItemTimestamp(b) - getUserDataItemTimestamp(a)
+  );
+  const memberSpaces = selectAllMemberSpacesFromState(state);
+  const spaceNameById = new Map(
+    memberSpaces.map((space) => [space.spaceId, space.spaceName || space.spaceId] as const)
+  );
+
+  return buildMyContentItemsFromUserData(
+    sortedRecords,
+    state.settings?.currentServer || "",
+    spaceNameById,
+    "我的应用",
+    "我的内容"
+  );
+};
+
+/**
+ * [Executor] 'search_workspace' 工具的执行函数。
+ */
+export async function searchWorkspaceFunc(
+  args: SearchWorkspaceArgs,
+  thunkApi: SearchWorkspaceThunkApi
+): Promise<SearchWorkspaceResult> {
+  const { getState } = thunkApi;
+  const state = getState();
+  const spaceId = selectCurrentSpaceIdFromState(state);
+
+  if (!spaceId) {
+    throw new Error("无法查询内容，因为当前空间未设定。");
+  }
+
+  const currentSpace = selectCurrentSpaceFromState(state);
+  if (!currentSpace) {
+    throw new Error("当前空间数据未找到。");
+  }
+
+  const results = searchSpaceContents(currentSpace, args.query, {
+    spaceName: currentSpace.name,
+  });
+
+  const rawData = { success: true, contents: results };
+  const displayData = buildScopedDisplayData(args.query, results, "当前空间");
+
+  return { rawData, displayData };
+}
+
+export async function searchAllSpacesFunc(
+  args: SearchWorkspaceArgs,
+  thunkApi: SearchWorkspaceThunkApi
+): Promise<SearchWorkspaceResult> {
+  const state = thunkApi.getState();
+  const items = await loadLocalMyContentResults(thunkApi, state);
+  const results = items
+    .filter((item) => matchesMyContentSearch(args.query, item))
+    .map((item) => toSearchResultItem(item));
+
+  return {
+    rawData: { success: true, contents: results },
+    displayData: buildScopedDisplayData(args.query, results, "已同步的全部内容"),
+  };
+}

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,
+  };
+}