@openclaw-cn/feishu 0.1.8

package/dist/src/wiki.js

@@ -0,0 +1,176 @@
+import { listEnabledFeishuAccounts } from "./accounts.js";
+import { createFeishuClient } from "./client.js";
+import { resolveToolsConfig } from "./tools-config.js";
+import { FeishuWikiSchema } from "./wiki-schema.js";
+// ============ Helpers ============
+function json(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        details: data,
+    };
+}
+// ============ Actions ============
+const WIKI_ACCESS_HINT = "To grant wiki access: Open wiki space → Settings → Members → Add the bot. " +
+    "See: https://open.feishu.cn/document/server-docs/docs/wiki-v2/wiki-qa#a40ad4ca";
+async function listSpaces(client) {
+    const res = await client.wiki.space.list({});
+    if (res.code !== 0) {
+        throw new Error(res.msg);
+    }
+    const spaces = res.data?.items?.map((s) => ({
+        space_id: s.space_id,
+        name: s.name,
+        description: s.description,
+        visibility: s.visibility,
+    })) ?? [];
+    return {
+        spaces,
+        ...(spaces.length === 0 && { hint: WIKI_ACCESS_HINT }),
+    };
+}
+async function listNodes(client, spaceId, parentNodeToken) {
+    const res = await client.wiki.spaceNode.list({
+        path: { space_id: spaceId },
+        params: { parent_node_token: parentNodeToken },
+    });
+    if (res.code !== 0) {
+        throw new Error(res.msg);
+    }
+    return {
+        nodes: res.data?.items?.map((n) => ({
+            node_token: n.node_token,
+            obj_token: n.obj_token,
+            obj_type: n.obj_type,
+            title: n.title,
+            has_child: n.has_child,
+        })) ?? [],
+    };
+}
+async function getNode(client, token) {
+    const res = await client.wiki.space.getNode({
+        params: { token },
+    });
+    if (res.code !== 0) {
+        throw new Error(res.msg);
+    }
+    const node = res.data?.node;
+    return {
+        node_token: node?.node_token,
+        space_id: node?.space_id,
+        obj_token: node?.obj_token,
+        obj_type: node?.obj_type,
+        title: node?.title,
+        parent_node_token: node?.parent_node_token,
+        has_child: node?.has_child,
+        creator: node?.creator,
+        create_time: node?.node_create_time,
+    };
+}
+async function createNode(client, spaceId, title, objType, parentNodeToken) {
+    const res = await client.wiki.spaceNode.create({
+        path: { space_id: spaceId },
+        data: {
+            obj_type: objType || "docx",
+            node_type: "origin",
+            title,
+            parent_node_token: parentNodeToken,
+        },
+    });
+    if (res.code !== 0) {
+        throw new Error(res.msg);
+    }
+    const node = res.data?.node;
+    return {
+        node_token: node?.node_token,
+        obj_token: node?.obj_token,
+        obj_type: node?.obj_type,
+        title: node?.title,
+    };
+}
+async function moveNode(client, spaceId, nodeToken, targetSpaceId, targetParentToken) {
+    const res = await client.wiki.spaceNode.move({
+        path: { space_id: spaceId, node_token: nodeToken },
+        data: {
+            target_space_id: targetSpaceId || spaceId,
+            target_parent_token: targetParentToken,
+        },
+    });
+    if (res.code !== 0) {
+        throw new Error(res.msg);
+    }
+    return {
+        success: true,
+        node_token: res.data?.node?.node_token,
+    };
+}
+async function renameNode(client, spaceId, nodeToken, title) {
+    const res = await client.wiki.spaceNode.updateTitle({
+        path: { space_id: spaceId, node_token: nodeToken },
+        data: { title },
+    });
+    if (res.code !== 0) {
+        throw new Error(res.msg);
+    }
+    return {
+        success: true,
+        node_token: nodeToken,
+        title,
+    };
+}
+// ============ Tool Registration ============
+export function registerFeishuWikiTools(api) {
+    if (!api.config) {
+        api.logger.debug?.("feishu_wiki: No config available, skipping wiki tools");
+        return;
+    }
+    const accounts = listEnabledFeishuAccounts(api.config);
+    if (accounts.length === 0) {
+        api.logger.debug?.("feishu_wiki: No Feishu accounts configured, skipping wiki tools");
+        return;
+    }
+    const firstAccount = accounts[0];
+    const toolsCfg = resolveToolsConfig(firstAccount.config.tools);
+    if (!toolsCfg.wiki) {
+        api.logger.debug?.("feishu_wiki: wiki tool disabled in config");
+        return;
+    }
+    const getClient = () => createFeishuClient(firstAccount);
+    api.registerTool({
+        name: "feishu_wiki",
+        label: "Feishu Wiki",
+        description: "Feishu knowledge base operations. Actions: spaces, nodes, get, create, move, rename",
+        parameters: FeishuWikiSchema,
+        async execute(_toolCallId, params) {
+            const p = params;
+            try {
+                const client = getClient();
+                switch (p.action) {
+                    case "spaces":
+                        return json(await listSpaces(client));
+                    case "nodes":
+                        return json(await listNodes(client, p.space_id, p.parent_node_token));
+                    case "get":
+                        return json(await getNode(client, p.token));
+                    case "search":
+                        return json({
+                            error: "Search is not available. Use feishu_wiki with action: 'nodes' to browse or action: 'get' to lookup by token.",
+                        });
+                    case "create":
+                        return json(await createNode(client, p.space_id, p.title, p.obj_type, p.parent_node_token));
+                    case "move":
+                        return json(await moveNode(client, p.space_id, p.node_token, p.target_space_id, p.target_parent_token));
+                    case "rename":
+                        return json(await renameNode(client, p.space_id, p.node_token, p.title));
+                    default:
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- exhaustive check fallback
+                        return json({ error: `Unknown action: ${p.action}` });
+                }
+            }
+            catch (err) {
+                return json({ error: err instanceof Error ? err.message : String(err) });
+            }
+        },
+    }, { name: "feishu_wiki" });
+    api.logger.info?.(`feishu_wiki: Registered feishu_wiki tool`);
+}
+//# sourceMappingURL=wiki.js.map

package/dist/src/wiki.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki.js","sourceRoot":"","sources":["../../src/wiki.ts"],"names":[],"mappings":"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"}

package/openclaw.plugin.json

@@ -0,0 +1,9 @@
+{
+  "id": "feishu",
+  "channels": ["feishu"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@openclaw-cn/feishu",
+  "version": "0.1.8",
+  "description": "飞书（Larksuite）OpenClaw 中文频道插件，由OpenClaw中文社区维护，提供飞书机器人集成（WebSocket）。",
+  "keywords": [
+    "feishu",
+    "larksuite",
+    "openclaw",
+    "plugin"
+  ],
+  "homepage": "https://github.com/openclaw/openclaw-cn/tree/main/extensions/feishu",
+  "bugs": {
+    "url": "https://github.com/openclaw/openclaw-cn/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openclaw/openclaw-cn.git",
+    "directory": "extensions/feishu"
+  },
+  "files": [
+    "openclaw.plugin.json",
+    "package.json",
+    "README.md",
+    "dist/"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  },
+  "peerDependencies": {
+    "openclaw": "*",
+    "openclaw-cn": "*"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    },
+    "openclaw-cn": {
+      "optional": true
+    }
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "channel": {
+      "id": "feishu",
+      "label": "飞书",
+      "selectionLabel": "飞书 (Lark 开放平台)",
+      "docsPath": "/channels/feishu",
+      "docsLabel": "feishu",
+      "blurb": "飞书/Lark 机器人集成 (WebSocket)。",
+      "aliases": [
+        "lark"
+      ],
+      "order": 35,
+      "quickstartAllowFrom": true
+    },
+    "install": {
+      "npmSpec": "@openclaw-cn/feishu",
+      "localPath": "extensions/feishu",
+      "defaultChoice": "npm"
+    }
+  }
+}