@xuanyue202/wecom 2026.3.22 → 2026.3.31

package/dist/index.d.ts

@@ -4,6 +4,16 @@ type WecomDmPolicy = "open" | "pairing" | "allowlist" | "disabled";
 type WecomGroupPolicy = "open" | "allowlist" | "disabled";
 type WecomTransportMode = "webhook" | "ws";
 type WecomWsImageReplyMode = "native" | "markdown-url";
+type WecomRetryConfig = {
+    /** 最大重试次数，默认 3 */
+    attempts?: number;
+    /** 最小退避延迟(ms)，默认 400 */
+    minDelayMs?: number;
+    /** 最大退避延迟(ms)，封顶，默认 30000 */
+    maxDelayMs?: number;
+    /** 随机抖动比例（0-1），防多实例同时重试，默认 0.1 */
+    jitter?: number;
+};
 type WecomAccountConfig = {
     name?: string;
     enabled?: boolean;
@@ -26,6 +36,9 @@ type WecomAccountConfig = {
     groupPolicy?: WecomGroupPolicy;
     groupAllowFrom?: string[];
     requireMention?: boolean;
+    retry?: WecomRetryConfig;
+    /** 单条消息最大字符数，超过后自动拆分，默认 500 */
+    textChunkLimit?: number;
 };
 type WecomConfig = WecomAccountConfig & {
     accounts?: Record<string, WecomAccountConfig>;
@@ -48,6 +61,8 @@ type ResolvedWecomAccount = {
     reconnectMaxDelayMs: number;
     publicBaseUrl?: string;
     wsImageReplyMode: WecomWsImageReplyMode;
+    retry: Required<WecomRetryConfig>;
+    textChunkLimit: number;
     config: WecomAccountConfig;
 };
 type WecomInboundBase = {
@@ -103,6 +118,13 @@ interface PluginConfig {
     };
 }
 
+type WecomMessageActionName = "send" | "sendAttachment";
+interface WecomMessageToolResult {
+    ok: boolean;
+    messageId?: string;
+    error?: string;
+    [key: string]: unknown;
+}
 declare const wecomPlugin: {
     id: string;
     meta: {
@@ -217,6 +239,33 @@ declare const wecomPlugin: {
                 requireMention: {
                     type: string;
                 };
+                retry: {
+                    type: string;
+                    additionalProperties: boolean;
+                    properties: {
+                        attempts: {
+                            type: string;
+                            minimum: number;
+                        };
+                        minDelayMs: {
+                            type: string;
+                            minimum: number;
+                        };
+                        maxDelayMs: {
+                            type: string;
+                            minimum: number;
+                        };
+                        jitter: {
+                            type: string;
+                            minimum: number;
+                            maximum: number;
+                        };
+                    };
+                };
+                textChunkLimit: {
+                    type: string;
+                    minimum: number;
+                };
                 defaultAccount: {
                     type: string;
                 };
@@ -303,6 +352,33 @@ declare const wecomPlugin: {
                             requireMention: {
                                 type: string;
                             };
+                            retry: {
+                                type: string;
+                                additionalProperties: boolean;
+                                properties: {
+                                    attempts: {
+                                        type: string;
+                                        minimum: number;
+                                    };
+                                    minDelayMs: {
+                                        type: string;
+                                        minimum: number;
+                                    };
+                                    maxDelayMs: {
+                                        type: string;
+                                        minimum: number;
+                                    };
+                                    jitter: {
+                                        type: string;
+                                        minimum: number;
+                                        maximum: number;
+                                    };
+                                };
+                            };
+                            textChunkLimit: {
+                                type: string;
+                                minimum: number;
+                            };
                         };
                     };
                 };
@@ -463,6 +539,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>;
+    };
 };
 
 /**