nolo-cli 0.1.13 → 0.1.14

package/ai/tools/browserTools/openSession.ts

@@ -0,0 +1,48 @@
+import { executeBrowserTool } from "./common";
+import { assertFetchableDocsUrl, discoverCanonicalDocsUrl } from "../fetchWebpageSupport";
+
+// Schema: 给LLM看的说明书
+export const browser_openSession_Schema = {
+  name: "browser_openSession",
+  description:
+    "打开一个新的浏览器会话并导航到指定的URL。这是所有浏览器交互的第一步。它会返回一个唯一的 'sessionId'，后续所有浏览器操作都必须使用此ID。",
+  parameters: {
+    type: "object",
+    properties: {
+      url: {
+        type: "string",
+        description:
+          "要访问的完整、有效的URL，必须以 http:// 或 https:// 开头。",
+      },
+    },
+    required: ["url"],
+  },
+};
+
+// Executor: 实际执行函数
+export async function browser_openSession_Func(
+  args: { url: string },
+  thunkApi: any
+) {
+  const resolution = await discoverCanonicalDocsUrl(args.url);
+  const targetUrl = resolution.resolvedUrl;
+  if (targetUrl !== args.url) {
+    await assertFetchableDocsUrl(targetUrl, fetch, args.url);
+  }
+
+  const result = await executeBrowserTool(
+    "browser_openSession",
+    { ...args, url: targetUrl },
+    thunkApi
+  );
+
+  // 返回给 plan 执行器的数据
+  return {
+    // rawData 是给下一步骤使用的关键数据
+    rawData: result.sessionId,
+    // displayData 是在UI中展示给用户看的信息
+    displayData:
+      `✅ 已成功打开会话并访问 ${targetUrl}。` +
+      (targetUrl !== args.url ? `\n🧭 文档地址已规范化: ${args.url} → ${targetUrl}` : ""),
+  };
+}

package/ai/tools/browserTools/readContent.ts

@@ -0,0 +1,38 @@
+
+import { executeBrowserTool } from "./common";
+
+export const browser_readContent_Schema = {
+    name: "browser_readContent",
+    description:
+        "获取当前浏览器页面的文本内容 (innerText) 或特定元素的内容。",
+    parameters: {
+        type: "object",
+        properties: {
+            sessionId: {
+                type: "string",
+                description: "由 browser_openSession 返回的活跃会话 ID。",
+            },
+            selector: {
+                type: "string",
+                description:
+                    "可选。若指定，则仅提取该元素内的文本 (例如 '.article-body')。若留空，则提取全页文本。",
+            },
+        },
+        required: ["sessionId"],
+    },
+};
+
+export async function browser_readContent_Func(
+    args: { sessionId: string; selector?: string },
+    thunkApi: any
+) {
+    const result: any = await executeBrowserTool("browser_readContent", args, thunkApi);
+
+    const content = typeof result === "string" ? result : result.content || "";
+    const preview = content.substring(0, 300) + (content.length > 300 ? "..." : "");
+
+    return {
+        rawData: content,
+        displayData: `✅ 已成功读取页面内容 (${content.length} 字符)。\n**预览:**\n${preview}`,
+    };
+}

package/ai/tools/browserTools/selectOption.ts

@@ -0,0 +1,46 @@
+import { executeBrowserTool } from "./common";
+
+// Schema
+export const browser_selectOption_Schema = {
+  name: "browser_selectOption",
+  description:
+    "在当前浏览器会话中，为一个 <select> 下拉框元素选择一个指定的选项。",
+  parameters: {
+    type: "object",
+    properties: {
+      sessionId: {
+        type: "string",
+        description: "必需。由 'browser_openSession' 工具返回的会话ID。",
+      },
+      selector: {
+        type: "string",
+        description:
+          "必需。目标 <select> 元素的CSS选择器，例如 'select#country' 或 'select[name=\"country\"]'。",
+      },
+      value: {
+        type: "string",
+        description:
+          "必需。要选择的 <option> 元素的 value 属性值。例如 'CN' 或 'USA'。",
+      },
+    },
+    required: ["sessionId", "selector", "value"],
+  },
+};
+
+// Executor
+export async function browser_selectOption_Func(
+  args: { sessionId: string; selector: string; value: string },
+  thunkApi: any
+) {
+  const result = await executeBrowserTool(
+    "browser_selectOption",
+    args,
+    thunkApi
+  );
+
+  return {
+    // 此步骤通常不产生给下一步的数据，返回一个状态即可
+    rawData: result.status,
+    displayData: `✅ 成功选择选项: \`${args.value}\` 应用于元素 \`${args.selector}\``,
+  };
+}

package/ai/tools/browserTools/typeText.ts

@@ -0,0 +1,42 @@
+
+import { executeBrowserTool } from "./common";
+
+export const browser_typeText_Schema = {
+    name: "browser_typeText",
+    description:
+        "在当前浏览器会话中，向指定元素输入文本内容 (通常用于填写表单)。",
+    parameters: {
+        type: "object",
+        properties: {
+            sessionId: {
+                type: "string",
+                description: "由 browser_openSession 返回的活跃会话 ID。",
+            },
+            selector: {
+                type: "string",
+                description: "目标输入框的 CSS 选择器 (例如 'input[name=\"search\"]' ).",
+            },
+            text: {
+                type: "string",
+                description: "要输入的文本内容。",
+            },
+            pressEnter: {
+                type: "boolean",
+                description: "输入完成后是否模拟按下回车键 (默认 false)。",
+            },
+        },
+        required: ["sessionId", "selector", "text"],
+    },
+};
+
+export async function browser_typeText_Func(
+    args: { sessionId: string; selector: string; text: string; pressEnter?: boolean },
+    thunkApi: any
+) {
+    const result = await executeBrowserTool("browser_typeText", args, thunkApi);
+    return {
+        rawData: result,
+        displayData: `✅ 已向 \`${args.selector}\` 输入文本: "${args.text}"${args.pressEnter ? " (并回车)" : ""
+            }`,
+    };
+}

package/ai/tools/category/createCategoryTool.ts

@@ -0,0 +1,66 @@
+// ai/tools/createCategoryTool.ts
+
+import { addCategory, selectCurrentSpaceId } from "create/space/spaceSlice";
+import type { RootState } from "app/store";
+
+/**
+ * [Schema] 定义了 'createCategory' 工具的结构，供 LLM 调用。
+ */
+export const createCategoryFunctionSchema = {
+  // 已从 'create_category' 更新为 'createCategory'
+  name: "createCategory",
+  description: "在当前空间中创建新分类。",
+  parameters: {
+    type: "object",
+    properties: {
+      name: {
+        type: "string",
+        description: "分类名称",
+      },
+    },
+    required: ["name"],
+  },
+};
+
+/**
+ * [Executor] 'createCategory' 工具的执行函数。
+ * @param args    LLM 提供的参数: { name: string }
+ * @param thunkApi Redux Thunk API
+ * @returns       Promise<{ rawData: object, displayData: string }>
+ */
+export async function createCategoryFunc(
+  args: { name: string },
+  thunkApi: any
+): Promise<{
+  rawData: { success: true; id: string; name: string };
+  displayData: string;
+}> {
+  const { dispatch, getState } = thunkApi;
+  const state = getState() as RootState;
+  const spaceId = selectCurrentSpaceId(state);
+
+  if (!spaceId) {
+    throw new Error("无法创建分类，因为当前空间未设定。");
+  }
+
+  const name = args.name.trim() || "新分类";
+
+  try {
+    const { updatedSpaceData } = await dispatch(
+      addCategory({ spaceId, name })
+    ).unwrap();
+
+    // 从 updatedSpaceData 中找到新分类的 ID
+    const newCategoryId =
+      Object.keys(updatedSpaceData.categories).find(
+        (id) => updatedSpaceData.categories[id]?.name === name
+      ) || "";
+
+    const rawData = { success: true, id: newCategoryId, name };
+    const displayData = `分类「${name}」已成功创建。`;
+    return { rawData, displayData };
+  } catch (error: any) {
+    const msg = error?.message || JSON.stringify(error) || "未知错误";
+    throw new Error(`创建分类时出错: ${msg}`);
+  }
+}

package/ai/tools/category/queryContentsByCategoryTool.ts

@@ -0,0 +1,69 @@
+// ai/tools/queryContentsByCategoryTool.ts
+
+import { selectCurrentSpaceId } from "create/space/spaceSlice";
+import type { RootState } from "app/store";
+
+/**
+ * [Schema] 定义了 'queryContentsByCategory' 工具的结构，供 LLM 调用。
+ */
+export const queryContentsByCategoryFunctionSchema = {
+  name: "queryContentsByCategory",
+  description: "查询当前空间中某个分类下的所有内容。",
+  parameters: {
+    type: "object",
+    properties: {
+      categoryId: {
+        type: "string",
+        description: "分类ID，可选，不提供则查询未分类内容",
+      },
+      filter: {
+        type: "string",
+        description: "标题关键字过滤，可选",
+      },
+    },
+    required: [],
+  },
+};
+
+/**
+ * [Executor] 'queryContentsByCategory' 工具的执行函数。
+ * @param args    LLM 提供的参数: { categoryId?: string; filter?: string }
+ * @param thunkApi Redux Thunk API
+ * @returns       Promise<{ rawData: { success: true; contents: any[] }; displayData: string }>
+ */
+export async function queryContentsByCategoryFunc(
+  args: { categoryId?: string; filter?: string },
+  thunkApi: any
+): Promise<{
+  rawData: { success: true; contents: any[] };
+  displayData: string;
+}> {
+  const { getState } = thunkApi;
+  const state = getState() as RootState;
+  const spaceId = selectCurrentSpaceId(state);
+
+  if (!spaceId) {
+    throw new Error("无法查询内容，因为当前空间未设定。");
+  }
+
+  // 假设当前空间数据存在于 state.space.currentSpace
+  const currentSpace: any = (state as any).space.currentSpace;
+  if (!currentSpace) {
+    throw new Error("当前空间数据未找到。");
+  }
+
+  let list = Object.values(currentSpace.contents || {});
+  if (args.categoryId != null) {
+    list = list.filter((c: any) => c.categoryId === args.categoryId);
+  } else {
+    list = list.filter((c: any) => !c.categoryId);
+  }
+  if (args.filter) {
+    const kw = args.filter.toLowerCase();
+    list = list.filter((c: any) => (c.title ?? "").toLowerCase().includes(kw));
+  }
+
+  const rawData = { success: true, contents: list };
+  const displayData = `共查询到 ${list.length} 条内容。`;
+  return { rawData, displayData };
+}

package/ai/tools/category/updateContentCategoryTool.ts

@@ -0,0 +1,75 @@
+// ai/tools/updateContentCategoryTool.ts
+
+import {
+  updateContentCategory,
+  selectCurrentSpaceId,
+} from "create/space/spaceSlice";
+import type { RootState } from "app/store";
+
+/**
+ * [Schema] 定义了 'updateContentCategory' 工具的结构，供 LLM 调用。
+ */
+export const updateContentCategoryFunctionSchema = {
+  name: "updateContentCategory",
+  description: "更新当前空间中某个内容的分类。",
+  parameters: {
+    type: "object",
+    properties: {
+      contentId: {
+        type: "string",
+        description: "要更新的内容ID",
+      },
+      categoryId: {
+        type: "string",
+        description: "新的分类ID，可选，不提供则设为未分类",
+      },
+    },
+    required: ["contentId"],
+  },
+};
+
+/**
+ * [Executor] 'updateContentCategory' 工具的执行函数。
+ * @param args    LLM 提供的参数: { contentId: string; categoryId?: string }
+ * @param thunkApi Redux Thunk API
+ * @returns       Promise<{ rawData: { success: true; id: string; categoryId?: string }; displayData: string }>
+ */
+export async function updateContentCategoryFunc(
+  args: { contentId: string; categoryId?: string },
+  thunkApi: any
+): Promise<{
+  rawData: { success: true; id: string; categoryId?: string };
+  displayData: string;
+}> {
+  const { dispatch, getState } = thunkApi;
+  const state = getState() as RootState;
+  const spaceId = selectCurrentSpaceId(state);
+
+  if (!spaceId) {
+    throw new Error("无法更新分类，因为当前空间未设定。");
+  }
+  if (!args.contentId.trim()) {
+    throw new Error("无法更新分类，因为内容ID未提供。");
+  }
+
+  try {
+    const updatedId = await dispatch(
+      updateContentCategory({
+        spaceId,
+        contentId: args.contentId,
+        categoryId: args.categoryId || undefined,
+      })
+    ).unwrap();
+
+    const rawData = {
+      success: true,
+      id: updatedId,
+      categoryId: args.categoryId || undefined,
+    };
+    const displayData = `内容 ${updatedId} 的分类已更新为「${args.categoryId ?? "未分类"}」。`;
+    return { rawData, displayData };
+  } catch (err: any) {
+    const msg = err?.message ?? JSON.stringify(err) ?? "未知错误";
+    throw new Error(`更新分类时出错: ${msg}`);
+  }
+}