@openclaw-cn/feishu 0.1.8

package/dist/src/drive-schema.d.ts

@@ -0,0 +1,24 @@
+import { type Static } from "@sinclair/typebox";
+export declare const FeishuDriveSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TLiteral<"list">;
+    folder_token: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>, import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TLiteral<"info">;
+    file_token: import("@sinclair/typebox").TString;
+    type: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"doc">, import("@sinclair/typebox").TLiteral<"docx">, import("@sinclair/typebox").TLiteral<"sheet">, import("@sinclair/typebox").TLiteral<"bitable">, import("@sinclair/typebox").TLiteral<"folder">, import("@sinclair/typebox").TLiteral<"file">, import("@sinclair/typebox").TLiteral<"mindnote">, import("@sinclair/typebox").TLiteral<"shortcut">]>;
+}>, import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TLiteral<"create_folder">;
+    name: import("@sinclair/typebox").TString;
+    folder_token: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>, import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TLiteral<"move">;
+    file_token: import("@sinclair/typebox").TString;
+    type: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"doc">, import("@sinclair/typebox").TLiteral<"docx">, import("@sinclair/typebox").TLiteral<"sheet">, import("@sinclair/typebox").TLiteral<"bitable">, import("@sinclair/typebox").TLiteral<"folder">, import("@sinclair/typebox").TLiteral<"file">, import("@sinclair/typebox").TLiteral<"mindnote">, import("@sinclair/typebox").TLiteral<"shortcut">]>;
+    folder_token: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TLiteral<"delete">;
+    file_token: import("@sinclair/typebox").TString;
+    type: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"doc">, import("@sinclair/typebox").TLiteral<"docx">, import("@sinclair/typebox").TLiteral<"sheet">, import("@sinclair/typebox").TLiteral<"bitable">, import("@sinclair/typebox").TLiteral<"folder">, import("@sinclair/typebox").TLiteral<"file">, import("@sinclair/typebox").TLiteral<"mindnote">, import("@sinclair/typebox").TLiteral<"shortcut">]>;
+}>]>;
+export type FeishuDriveParams = Static<typeof FeishuDriveSchema>;
+//# sourceMappingURL=drive-schema.d.ts.map

package/dist/src/drive-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drive-schema.d.ts","sourceRoot":"","sources":["../../src/drive-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAatD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;IA8B5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/src/drive-schema.js

@@ -0,0 +1,39 @@
+import { Type } from "@sinclair/typebox";
+const FileType = Type.Union([
+    Type.Literal("doc"),
+    Type.Literal("docx"),
+    Type.Literal("sheet"),
+    Type.Literal("bitable"),
+    Type.Literal("folder"),
+    Type.Literal("file"),
+    Type.Literal("mindnote"),
+    Type.Literal("shortcut"),
+]);
+export const FeishuDriveSchema = Type.Union([
+    Type.Object({
+        action: Type.Literal("list"),
+        folder_token: Type.Optional(Type.String({ description: "Folder token (optional, omit for root directory)" })),
+    }),
+    Type.Object({
+        action: Type.Literal("info"),
+        file_token: Type.String({ description: "File or folder token" }),
+        type: FileType,
+    }),
+    Type.Object({
+        action: Type.Literal("create_folder"),
+        name: Type.String({ description: "Folder name" }),
+        folder_token: Type.Optional(Type.String({ description: "Parent folder token (optional, omit for root)" })),
+    }),
+    Type.Object({
+        action: Type.Literal("move"),
+        file_token: Type.String({ description: "File token to move" }),
+        type: FileType,
+        folder_token: Type.String({ description: "Target folder token" }),
+    }),
+    Type.Object({
+        action: Type.Literal("delete"),
+        file_token: Type.String({ description: "File token to delete" }),
+        type: FileType,
+    }),
+]);
+//# sourceMappingURL=drive-schema.js.map

package/dist/src/drive-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drive-schema.js","sourceRoot":"","sources":["../../src/drive-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAEtD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;IACnB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IACpB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;IACrB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;IACvB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;IACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IACpB,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;IACxB,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC;QACV,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAC5B,YAAY,EAAE,IAAI,CAAC,QAAQ,CACzB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kDAAkD,EAAE,CAAC,CACjF;KACF,CAAC;IACF,IAAI,CAAC,MAAM,CAAC;QACV,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAC5B,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE,CAAC;QAChE,IAAI,EAAE,QAAQ;KACf,CAAC;IACF,IAAI,CAAC,MAAM,CAAC;QACV,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC;QACrC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC;QACjD,YAAY,EAAE,IAAI,CAAC,QAAQ,CACzB,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,+CAA+C,EAAE,CAAC,CAC9E;KACF,CAAC;IACF,IAAI,CAAC,MAAM,CAAC;QACV,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAC5B,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC;QAC9D,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC;KAClE,CAAC;IACF,IAAI,CAAC,MAAM,CAAC;QACV,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC9B,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE,CAAC;QAChE,IAAI,EAAE,QAAQ;KACf,CAAC;CACH,CAAC,CAAC"}

package/dist/src/drive.d.ts

@@ -0,0 +1,3 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+export declare function registerFeishuDriveTools(api: OpenClawPluginApi): void;
+//# sourceMappingURL=drive.d.ts.map

package/dist/src/drive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drive.d.ts","sourceRoot":"","sources":["../../src/drive.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAyK7D,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,iBAAiB,QAwD9D"}

package/dist/src/drive.js

@@ -0,0 +1,181 @@
+import { listEnabledFeishuAccounts } from "./accounts.js";
+import { createFeishuClient } from "./client.js";
+import { FeishuDriveSchema } from "./drive-schema.js";
+import { resolveToolsConfig } from "./tools-config.js";
+// ============ Helpers ============
+function json(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        details: data,
+    };
+}
+// ============ Actions ============
+async function getRootFolderToken(client) {
+    // Use generic HTTP client to call the root folder meta API
+    // as it's not directly exposed in the SDK
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- accessing internal SDK property
+    const domain = client.domain ?? "https://open.feishu.cn";
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- accessing internal SDK property
+    const res = (await client.httpInstance.get(`${domain}/open-apis/drive/explorer/v2/root_folder/meta`));
+    if (res.code !== 0) {
+        throw new Error(res.msg ?? "Failed to get root folder");
+    }
+    const token = res.data?.token;
+    if (!token) {
+        throw new Error("Root folder token not found");
+    }
+    return token;
+}
+async function listFolder(client, folderToken) {
+    // Filter out invalid folder_token values (empty, "0", etc.)
+    const validFolderToken = folderToken && folderToken !== "0" ? folderToken : undefined;
+    const res = await client.drive.file.list({
+        params: validFolderToken ? { folder_token: validFolderToken } : {},
+    });
+    if (res.code !== 0) {
+        throw new Error(res.msg);
+    }
+    return {
+        files: res.data?.files?.map((f) => ({
+            token: f.token,
+            name: f.name,
+            type: f.type,
+            url: f.url,
+            created_time: f.created_time,
+            modified_time: f.modified_time,
+            owner_id: f.owner_id,
+        })) ?? [],
+        next_page_token: res.data?.next_page_token,
+    };
+}
+async function getFileInfo(client, fileToken, folderToken) {
+    // Use list with folder_token to find file info
+    const res = await client.drive.file.list({
+        params: folderToken ? { folder_token: folderToken } : {},
+    });
+    if (res.code !== 0) {
+        throw new Error(res.msg);
+    }
+    const file = res.data?.files?.find((f) => f.token === fileToken);
+    if (!file) {
+        throw new Error(`File not found: ${fileToken}`);
+    }
+    return {
+        token: file.token,
+        name: file.name,
+        type: file.type,
+        url: file.url,
+        created_time: file.created_time,
+        modified_time: file.modified_time,
+        owner_id: file.owner_id,
+    };
+}
+async function createFolder(client, name, folderToken) {
+    // Feishu supports using folder_token="0" as the root folder.
+    // We *try* to resolve the real root token (explorer API), but fall back to "0"
+    // because some tenants/apps return 400 for that explorer endpoint.
+    let effectiveToken = folderToken && folderToken !== "0" ? folderToken : "0";
+    if (effectiveToken === "0") {
+        try {
+            effectiveToken = await getRootFolderToken(client);
+        }
+        catch {
+            // ignore and keep "0"
+        }
+    }
+    const res = await client.drive.file.createFolder({
+        data: {
+            name,
+            folder_token: effectiveToken,
+        },
+    });
+    if (res.code !== 0) {
+        throw new Error(res.msg);
+    }
+    return {
+        token: res.data?.token,
+        url: res.data?.url,
+    };
+}
+async function moveFile(client, fileToken, type, folderToken) {
+    const res = await client.drive.file.move({
+        path: { file_token: fileToken },
+        data: {
+            type: type,
+            folder_token: folderToken,
+        },
+    });
+    if (res.code !== 0) {
+        throw new Error(res.msg);
+    }
+    return {
+        success: true,
+        task_id: res.data?.task_id,
+    };
+}
+async function deleteFile(client, fileToken, type) {
+    const res = await client.drive.file.delete({
+        path: { file_token: fileToken },
+        params: {
+            type: type,
+        },
+    });
+    if (res.code !== 0) {
+        throw new Error(res.msg);
+    }
+    return {
+        success: true,
+        task_id: res.data?.task_id,
+    };
+}
+// ============ Tool Registration ============
+export function registerFeishuDriveTools(api) {
+    if (!api.config) {
+        api.logger.debug?.("feishu_drive: No config available, skipping drive tools");
+        return;
+    }
+    const accounts = listEnabledFeishuAccounts(api.config);
+    if (accounts.length === 0) {
+        api.logger.debug?.("feishu_drive: No Feishu accounts configured, skipping drive tools");
+        return;
+    }
+    const firstAccount = accounts[0];
+    const toolsCfg = resolveToolsConfig(firstAccount.config.tools);
+    if (!toolsCfg.drive) {
+        api.logger.debug?.("feishu_drive: drive tool disabled in config");
+        return;
+    }
+    const getClient = () => createFeishuClient(firstAccount);
+    api.registerTool({
+        name: "feishu_drive",
+        label: "Feishu Drive",
+        description: "Feishu cloud storage operations. Actions: list, info, create_folder, move, delete",
+        parameters: FeishuDriveSchema,
+        async execute(_toolCallId, params) {
+            const p = params;
+            try {
+                const client = getClient();
+                switch (p.action) {
+                    case "list":
+                        return json(await listFolder(client, p.folder_token));
+                    case "info":
+                        return json(await getFileInfo(client, p.file_token));
+                    case "create_folder":
+                        return json(await createFolder(client, p.name, p.folder_token));
+                    case "move":
+                        return json(await moveFile(client, p.file_token, p.type, p.folder_token));
+                    case "delete":
+                        return json(await deleteFile(client, p.file_token, p.type));
+                    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_drive" });
+    api.logger.info?.(`feishu_drive: Registered feishu_drive tool`);
+}
+//# sourceMappingURL=drive.js.map

package/dist/src/drive.js.map

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

package/dist/src/dynamic-agent.d.ts

@@ -0,0 +1,19 @@
+import type { OpenClawConfig, PluginRuntime } from "openclaw/plugin-sdk";
+import type { DynamicAgentCreationConfig } from "./types.js";
+export type MaybeCreateDynamicAgentResult = {
+    created: boolean;
+    updatedCfg: OpenClawConfig;
+    agentId?: string;
+};
+/**
+ * Check if a dynamic agent should be created for a DM user and create it if needed.
+ * This creates a unique agent instance with its own workspace for each DM user.
+ */
+export declare function maybeCreateDynamicAgent(params: {
+    cfg: OpenClawConfig;
+    runtime: PluginRuntime;
+    senderOpenId: string;
+    dynamicCfg: DynamicAgentCreationConfig;
+    log: (msg: string) => void;
+}): Promise<MaybeCreateDynamicAgentResult>;
+//# sourceMappingURL=dynamic-agent.d.ts.map

package/dist/src/dynamic-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-agent.d.ts","sourceRoot":"","sources":["../../src/dynamic-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,MAAM,6BAA6B,GAAG;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,cAAc,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,0BAA0B,CAAC;IACvC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAkGzC"}

package/dist/src/dynamic-agent.js

@@ -0,0 +1,91 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+/**
+ * Check if a dynamic agent should be created for a DM user and create it if needed.
+ * This creates a unique agent instance with its own workspace for each DM user.
+ */
+export async function maybeCreateDynamicAgent(params) {
+    const { cfg, runtime, senderOpenId, dynamicCfg, log } = params;
+    // Check if there's already a binding for this user
+    const existingBindings = cfg.bindings ?? [];
+    const hasBinding = existingBindings.some((b) => b.match?.channel === "feishu" &&
+        b.match?.peer?.kind === "dm" &&
+        b.match?.peer?.id === senderOpenId);
+    if (hasBinding) {
+        return { created: false, updatedCfg: cfg };
+    }
+    // Check maxAgents limit if configured
+    if (dynamicCfg.maxAgents !== undefined) {
+        const feishuAgentCount = (cfg.agents?.list ?? []).filter((a) => a.id.startsWith("feishu-")).length;
+        if (feishuAgentCount >= dynamicCfg.maxAgents) {
+            log(`feishu: maxAgents limit (${dynamicCfg.maxAgents}) reached, not creating agent for ${senderOpenId}`);
+            return { created: false, updatedCfg: cfg };
+        }
+    }
+    // Use full OpenID as agent ID suffix (OpenID format: ou_xxx is already filesystem-safe)
+    const agentId = `feishu-${senderOpenId}`;
+    // Check if agent already exists (but binding was missing)
+    const existingAgent = (cfg.agents?.list ?? []).find((a) => a.id === agentId);
+    if (existingAgent) {
+        // Agent exists but binding doesn't - just add the binding
+        log(`feishu: agent "${agentId}" exists, adding missing binding for ${senderOpenId}`);
+        const updatedCfg = {
+            ...cfg,
+            bindings: [
+                ...existingBindings,
+                {
+                    agentId,
+                    match: {
+                        channel: "feishu",
+                        peer: { kind: "dm", id: senderOpenId },
+                    },
+                },
+            ],
+        };
+        await runtime.config.writeConfigFile(updatedCfg);
+        return { created: true, updatedCfg, agentId };
+    }
+    // Resolve path templates with substitutions
+    const workspaceTemplate = dynamicCfg.workspaceTemplate ?? "~/.openclaw/workspace-{agentId}";
+    const agentDirTemplate = dynamicCfg.agentDirTemplate ?? "~/.openclaw/agents/{agentId}/agent";
+    const workspace = resolveUserPath(workspaceTemplate.replace("{userId}", senderOpenId).replace("{agentId}", agentId));
+    const agentDir = resolveUserPath(agentDirTemplate.replace("{userId}", senderOpenId).replace("{agentId}", agentId));
+    log(`feishu: creating dynamic agent "${agentId}" for user ${senderOpenId}`);
+    log(`  workspace: ${workspace}`);
+    log(`  agentDir: ${agentDir}`);
+    // Create directories
+    await fs.promises.mkdir(workspace, { recursive: true });
+    await fs.promises.mkdir(agentDir, { recursive: true });
+    // Update configuration with new agent and binding
+    const updatedCfg = {
+        ...cfg,
+        agents: {
+            ...cfg.agents,
+            list: [...(cfg.agents?.list ?? []), { id: agentId, workspace, agentDir }],
+        },
+        bindings: [
+            ...existingBindings,
+            {
+                agentId,
+                match: {
+                    channel: "feishu",
+                    peer: { kind: "dm", id: senderOpenId },
+                },
+            },
+        ],
+    };
+    // Write updated config using PluginRuntime API
+    await runtime.config.writeConfigFile(updatedCfg);
+    return { created: true, updatedCfg, agentId };
+}
+/**
+ * Resolve a path that may start with ~ to the user's home directory.
+ */
+function resolveUserPath(p) {
+    if (p.startsWith("~/")) {
+        return path.join(os.homedir(), p.slice(2));
+    }
+    return p;
+}
+//# sourceMappingURL=dynamic-agent.js.map

package/dist/src/dynamic-agent.js.map

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

package/dist/src/im-schema.d.ts

@@ -0,0 +1,38 @@
+export declare const ListChatsSchema: import("@sinclair/typebox").TObject<{
+    page_size: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    page_token: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export declare const GetChatSchema: import("@sinclair/typebox").TObject<{
+    chat_id: import("@sinclair/typebox").TString;
+}>;
+export declare const ListMembersSchema: import("@sinclair/typebox").TObject<{
+    chat_id: import("@sinclair/typebox").TString;
+    page_size: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    page_token: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export declare const SendMessageSchema: import("@sinclair/typebox").TObject<{
+    receive_id: import("@sinclair/typebox").TString;
+    receive_id_type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnsafe<"open_id" | "user_id" | "union_id" | "chat_id" | "email">>;
+    msg_type: import("@sinclair/typebox").TUnsafe<"text" | "post" | "interactive">;
+    content: import("@sinclair/typebox").TString;
+}>;
+export declare const ReplyMessageSchema: import("@sinclair/typebox").TObject<{
+    message_id: import("@sinclair/typebox").TString;
+    msg_type: import("@sinclair/typebox").TUnsafe<"text" | "post" | "interactive">;
+    content: import("@sinclair/typebox").TString;
+}>;
+export declare const GetMessagesSchema: import("@sinclair/typebox").TObject<{
+    container_id: import("@sinclair/typebox").TString;
+    start_time: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    end_time: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    page_size: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    page_token: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    sort_type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnsafe<"ByCreateTimeAsc" | "ByCreateTimeDesc">>;
+}>;
+export declare const CreateChatSchema: import("@sinclair/typebox").TObject<{
+    name: import("@sinclair/typebox").TString;
+    description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    user_ids: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    chat_mode: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnsafe<"group" | "topic">>;
+}>;
+//# sourceMappingURL=im-schema.d.ts.map

package/dist/src/im-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"im-schema.d.ts","sourceRoot":"","sources":["../../src/im-schema.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,eAAe;;;EAS1B,CAAC;AAEH,eAAO,MAAM,aAAa;;EAExB,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;EAU5B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;EAc5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;EAM7B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;EAe5B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;EAW3B,CAAC"}

package/dist/src/im-schema.js

@@ -0,0 +1,73 @@
+import { Type } from "@sinclair/typebox";
+import { optionalStringEnum, stringEnum } from "openclaw/plugin-sdk";
+// ============ IM Tool Schemas ============
+const RECEIVE_ID_TYPES = ["chat_id", "open_id", "user_id", "union_id", "email"];
+const MSG_TYPES = ["text", "post", "interactive"];
+const SORT_TYPES = ["ByCreateTimeAsc", "ByCreateTimeDesc"];
+const CHAT_MODES = ["group", "topic"];
+export const ListChatsSchema = Type.Object({
+    page_size: Type.Optional(Type.Number({
+        description: "每页数量 (1-100, 默认 20)",
+        minimum: 1,
+        maximum: 100,
+    })),
+    page_token: Type.Optional(Type.String({ description: "分页标记，首次请求不填" })),
+});
+export const GetChatSchema = Type.Object({
+    chat_id: Type.String({ description: "群聊 ID (oc_xxxx)" }),
+});
+export const ListMembersSchema = Type.Object({
+    chat_id: Type.String({ description: "群聊 ID (oc_xxxx)" }),
+    page_size: Type.Optional(Type.Number({
+        description: "每页数量 (1-100, 默认 20)",
+        minimum: 1,
+        maximum: 100,
+    })),
+    page_token: Type.Optional(Type.String({ description: "分页标记，首次请求不填" })),
+});
+export const SendMessageSchema = Type.Object({
+    receive_id: Type.String({
+        description: "接收方 ID，可以是 chat_id (oc_xxx)、open_id (ou_xxx) 或 user_id",
+    }),
+    receive_id_type: optionalStringEnum(RECEIVE_ID_TYPES, {
+        description: "接收方 ID 类型，默认自动识别 (oc_ 开头为 chat_id，ou_ 开头为 open_id)",
+    }),
+    msg_type: stringEnum(MSG_TYPES, {
+        description: "消息类型: text(纯文本), post(富文本), interactive(卡片)",
+    }),
+    content: Type.String({
+        description: '消息内容。text 类型: JSON 字符串 {"text":"hello"}; post 类型: 富文本 JSON; interactive 类型: 卡片 JSON。发送 @mention 请使用 <at user_id="ou_xxx">名字</at> 语法。',
+    }),
+});
+export const ReplyMessageSchema = Type.Object({
+    message_id: Type.String({ description: "要回复的消息 ID (om_xxx)" }),
+    msg_type: stringEnum(MSG_TYPES, {
+        description: "消息类型: text(纯文本), post(富文本), interactive(卡片)",
+    }),
+    content: Type.String({ description: "消息内容 (格式同 send_message)" }),
+});
+export const GetMessagesSchema = Type.Object({
+    container_id: Type.String({ description: "群聊 ID (oc_xxxx)" }),
+    start_time: Type.Optional(Type.String({ description: "起始时间 (Unix 秒级时间戳)" })),
+    end_time: Type.Optional(Type.String({ description: "结束时间 (Unix 秒级时间戳)" })),
+    page_size: Type.Optional(Type.Number({
+        description: "每页数量 (1-50, 默认 20)",
+        minimum: 1,
+        maximum: 50,
+    })),
+    page_token: Type.Optional(Type.String({ description: "分页标记，首次请求不填" })),
+    sort_type: optionalStringEnum(SORT_TYPES, {
+        description: "排序方式，默认 ByCreateTimeAsc",
+    }),
+});
+export const CreateChatSchema = Type.Object({
+    name: Type.String({ description: "群聊名称" }),
+    description: Type.Optional(Type.String({ description: "群聊描述" })),
+    user_ids: Type.Optional(Type.Array(Type.String(), {
+        description: "初始成员 open_id 列表",
+    })),
+    chat_mode: optionalStringEnum(CHAT_MODES, {
+        description: "群模式: group(普通群), topic(话题群)，默认 group",
+    }),
+});
+//# sourceMappingURL=im-schema.js.map

package/dist/src/im-schema.js.map

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

package/dist/src/im.d.ts

@@ -0,0 +1,70 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { createFeishuClient } from "./client.js";
+/** List all chats the bot has joined */
+export declare function listChats(client: ReturnType<typeof createFeishuClient>, pageSize?: number, pageToken?: string): Promise<{
+    chats: {
+        chat_id: string;
+        name: string;
+        description: string;
+        owner_id: string;
+        chat_mode: any;
+        chat_type: any;
+        member_count: any;
+    }[];
+    has_more: boolean;
+    page_token: string;
+}>;
+/** Get detailed info about a specific chat */
+export declare function getChatInfo(client: ReturnType<typeof createFeishuClient>, chatId: string): Promise<{
+    chat_id: any;
+    name: string;
+    description: string;
+    owner_id: string;
+    chat_mode: any;
+    chat_type: any;
+    member_count: any;
+    bot_name: any;
+}>;
+/** List members of a chat */
+export declare function listChatMembers(client: ReturnType<typeof createFeishuClient>, chatId: string, pageSize?: number, pageToken?: string): Promise<{
+    members: {
+        member_id: string;
+        member_id_type: string;
+        name: string;
+        tenant_key: string;
+    }[];
+    has_more: boolean;
+    page_token: string;
+    member_total: number;
+}>;
+/** Send a message to a chat or user */
+export declare function sendMessage(client: ReturnType<typeof createFeishuClient>, receiveId: string, msgType: string, content: string, receiveIdType?: "chat_id" | "open_id" | "user_id" | "union_id" | "email"): Promise<{
+    message_id: string;
+    chat_id: string;
+}>;
+/** Reply to a specific message */
+export declare function replyMessage(client: ReturnType<typeof createFeishuClient>, messageId: string, msgType: string, content: string): Promise<{
+    message_id: string;
+    chat_id: string;
+}>;
+/** List messages in a chat */
+export declare function listMessages(client: ReturnType<typeof createFeishuClient>, containerId: string, startTime?: string, endTime?: string, pageSize?: number, pageToken?: string, sortType?: string): Promise<{
+    messages: {
+        message_id: string;
+        msg_type: string;
+        content: string;
+        sender_id: string;
+        sender_type: string;
+        create_time: string;
+        chat_id: string;
+    }[];
+    has_more: boolean;
+    page_token: string;
+}>;
+/** Create a new chat group */
+export declare function createChat(client: ReturnType<typeof createFeishuClient>, name: string, description?: string, userIds?: string[], chatMode?: string): Promise<{
+    chat_id: string;
+    name: string;
+}>;
+export declare function registerFeishuImTools(api: OpenClawPluginApi): void;
+//# sourceMappingURL=im.d.ts.map

package/dist/src/im.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"im.d.ts","sourceRoot":"","sources":["../../src/im.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAkCjD,wCAAwC;AACxC,wBAAsB,SAAS,CAC7B,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,EAC7C,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM;;;;;;;;;;;;GAyBnB;AAED,8CAA8C;AAC9C,wBAAsB,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,EAAE,MAAM,EAAE,MAAM;;;;;;;;;GAkB9F;AAED,6BAA6B;AAC7B,wBAAsB,eAAe,CACnC,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,EAC7C,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM;;;;;;;;;;GAwBnB;AAED,uCAAuC;AACvC,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,EAC7C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO;;;GAsBzE;AAED,kCAAkC;AAClC,wBAAsB,YAAY,CAChC,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,EAC7C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM;;;GAiBhB;AAED,8BAA8B;AAC9B,wBAAsB,YAAY,CAChC,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,EAC7C,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM;;;;;;;;;;;;GA8BlB;AAED,8BAA8B;AAC9B,wBAAsB,UAAU,CAC9B,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,EAC7C,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,EAAE,EAClB,QAAQ,CAAC,EAAE,MAAM;;;GAyBlB;AAID,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,iBAAiB,QAgN3D"}