@openclaw-china/wecom 2026.3.22 → 2026.3.29

package/dist/index.d.ts

@@ -103,6 +103,13 @@ interface PluginConfig {
     };
 }
 
+type WecomMessageActionName = "send" | "sendAttachment";
+interface WecomMessageToolResult {
+    ok: boolean;
+    messageId?: string;
+    error?: string;
+    [key: string]: unknown;
+}
 declare const wecomPlugin: {
     id: string;
     meta: {
@@ -463,6 +470,25 @@ declare const wecomPlugin: {
             setStatus?: (status: Record<string, unknown>) => void;
         }) => Promise<void>;
     };
+    actions: {
+        describeMessageTool: () => {
+            actions: WecomMessageActionName[];
+            capabilities: string[];
+            schema?: {
+                properties: Record<string, unknown>;
+                visibility?: "current-channel" | "all-configured";
+            };
+        };
+        handleAction: (ctx: {
+            channel: string;
+            action: string;
+            params: Record<string, unknown>;
+            cfg: PluginConfig;
+            accountId?: string | null;
+            sessionKey?: string | null;
+            sessionId?: string | null;
+        }) => Promise<WecomMessageToolResult>;
+    };
 };
 
 /**

package/dist/index.js

@@ -10178,6 +10178,91 @@ function stopWecomWsGatewayForAccount(accountId) {
 }
 
 // src/channel.ts
+function readStringParam(params, name, opts) {
+  const value = params[name];
+  if (value === void 0 || value === null) {
+    if (opts?.required) {
+      throw new Error(`wecom ${name} param is required`);
+    }
+    return void 0;
+  }
+  const str = String(value);
+  return opts?.trim ? str.trim() : str;
+}
+async function handleWecomMessageAction(ctx, outbound) {
+  const { action, params, cfg, accountId, sessionKey, sessionId } = ctx;
+  const commonParams = {
+    cfg,
+    accountId: accountId ?? void 0,
+    sessionKey: sessionKey ?? void 0,
+    runId: sessionId ?? void 0
+  };
+  if (action === "send") {
+    const to = readStringParam(params, "to", { required: true });
+    const message = readStringParam(params, "message", { required: false, trim: true }) ?? "";
+    const media = readStringParam(params, "media", { trim: false });
+    if (!to) {
+      return { ok: false, error: "wecom send requires 'to' param" };
+    }
+    if (media) {
+      const result = await outbound.sendMedia({
+        ...commonParams,
+        to,
+        mediaUrl: media,
+        text: message || void 0
+      });
+      if (!result.ok) {
+        return { ok: false, error: result.error?.message ?? "sendMedia failed" };
+      }
+      return { ok: true, messageId: result.messageId };
+    } else {
+      const result = await outbound.sendText({
+        ...commonParams,
+        to,
+        text: message
+      });
+      if (!result.ok) {
+        return { ok: false, error: result.error?.message ?? "sendText failed" };
+      }
+      return { ok: true, messageId: result.messageId };
+    }
+  }
+  if (action === "sendAttachment") {
+    const to = readStringParam(params, "to", { required: true });
+    const media = readStringParam(params, "media", { trim: false });
+    const caption = readStringParam(params, "caption", { required: false, trim: true });
+    if (!to) {
+      return { ok: false, error: "wecom sendAttachment requires 'to' param" };
+    }
+    if (!media) {
+      return { ok: false, error: "wecom sendAttachment requires 'media' param" };
+    }
+    const result = await outbound.sendMedia({
+      ...commonParams,
+      to,
+      mediaUrl: media,
+      text: caption
+    });
+    if (!result.ok) {
+      return { ok: false, error: result.error?.message ?? "sendMedia failed" };
+    }
+    return { ok: true, messageId: result.messageId };
+  }
+  return { ok: false, error: `Unsupported wecom action: ${action}` };
+}
+function describeWecomMessageTool() {
+  return {
+    actions: ["send", "sendAttachment"],
+    capabilities: ["media"],
+    schema: {
+      properties: {
+        media: { type: "string", description: "Media file URL or local file path (for file/image/audio/video attachments)" },
+        caption: { type: "string", description: "Optional caption text for the media" }
+      },
+      visibility: "current-channel"
+    }
+  };
+}
 var BARE_USER_ID_RE = /^[a-z0-9][a-z0-9._@-]{0,63}$/;
 var EXPLICIT_USER_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._@-]{0,63}$/;
 var GROUP_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._:@-]{0,127}$/;
@@ -10932,6 +11017,10 @@ var wecomPlugin = {
       stopWecomWsGatewayForAccount(ctx.accountId);
       ctx.setStatus?.({ accountId: ctx.accountId, running: false, lastStopAt: Date.now() });
     }
+  },
+  actions: {
+    describeMessageTool: () => describeWecomMessageTool(),
+    handleAction: async (ctx) => handleWecomMessageAction(ctx, wecomPlugin.outbound)
   }
 };