ylib-wecom-openclaw-plugin 2026.4.29

package/dist/src/dynamic-agent.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * **动态 Agent 路由模块**
+ *
+ * 为每个用户/群组自动生成独立的 Agent ID，实现会话隔离。
+ * 参考: openclaw-plugin-wecom/dynamic-agent.js
+ */
+exports.__esModule = true;
+exports.shouldUseDynamicAgent = exports.generateAgentId = exports.getDynamicAgentConfig = void 0;
+/**
+ * **getDynamicAgentConfig (读取动态 Agent 配置)**
+ *
+ * 从全局配置中读取动态 Agent 配置，提供默认值。
+ */
+function getDynamicAgentConfig(config) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    var dynamicAgents = (_c = (_b = (_a = config) === null || _a === void 0 ? void 0 : _a.channels) === null || _b === void 0 ? void 0 : _b.wecom) === null || _c === void 0 ? void 0 : _c.dynamicAgents;
+    return {
+        enabled: (_d = dynamicAgents === null || dynamicAgents === void 0 ? void 0 : dynamicAgents.enabled) !== null && _d !== void 0 ? _d : false,
+        dmCreateAgent: (_e = dynamicAgents === null || dynamicAgents === void 0 ? void 0 : dynamicAgents.dmCreateAgent) !== null && _e !== void 0 ? _e : true,
+        groupEnabled: (_f = dynamicAgents === null || dynamicAgents === void 0 ? void 0 : dynamicAgents.groupEnabled) !== null && _f !== void 0 ? _f : true,
+        adminUsers: (_g = dynamicAgents === null || dynamicAgents === void 0 ? void 0 : dynamicAgents.adminUsers) !== null && _g !== void 0 ? _g : []
+    };
+}
+exports.getDynamicAgentConfig = getDynamicAgentConfig;
+function sanitizeDynamicIdPart(value) {
+    return String(value)
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]/g, "_");
+}
+/**
+ * **generateAgentId (生成动态 Agent ID)**
+ *
+ * 根据账号 + 聊天类型 + 对端 ID 生成确定性的 Agent ID，避免多账号串会话。
+ * 格式: wecom-{accountId}-{type}-{sanitizedPeerId}
+ */
+function generateAgentId(chatType, peerId, accountId) {
+    var sanitizedPeer = sanitizeDynamicIdPart(peerId) || "unknown";
+    var sanitizedAccountId = sanitizeDynamicIdPart(accountId !== null && accountId !== void 0 ? accountId : "default") || "default";
+    return "wecom-" + sanitizedAccountId + "-" + chatType + "-" + sanitizedPeer;
+}
+exports.generateAgentId = generateAgentId;
+/**
+ * **shouldUseDynamicAgent (检查是否使用动态 Agent)**
+ *
+ * 根据配置和发送者信息判断是否应使用动态 Agent。
+ * 管理员（adminUsers）始终绕过动态路由，使用主 Agent。
+ */
+function shouldUseDynamicAgent(params) {
+    var chatType = params.chatType, senderId = params.senderId, config = params.config;
+    var dynamicConfig = getDynamicAgentConfig(config);
+    if (!dynamicConfig.enabled) {
+        return false;
+    }
+    // 管理员绕过动态路由
+    var sender = String(senderId).trim().toLowerCase();
+    var isAdmin = dynamicConfig.adminUsers.some(function (admin) { return admin.trim().toLowerCase() === sender; });
+    if (isAdmin) {
+        return false;
+    }
+    if (chatType === "group") {
+        return dynamicConfig.groupEnabled;
+    }
+    return dynamicConfig.dmCreateAgent;
+}
+exports.shouldUseDynamicAgent = shouldUseDynamicAgent;

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

@@ -0,0 +1,65 @@
+/**
+ * 动态路由统一处理模块
+ * 提供统一的路由注入接口。
+ */
+import type { OpenClawConfig } from "ylib-openclaw/plugin-sdk";
+import type { PluginRuntime } from "ylib-openclaw/plugin-sdk";
+/**
+ * 路由对象（从 core.channel.routing.resolveAgentRoute 返回）
+ */
+export interface AgentRoute {
+    agentId: string;
+    sessionKey: string;
+    matchedBy: string;
+    accountId: string;
+    mainSessionKey?: string;
+}
+/**
+ * 动态路由处理参数
+ */
+export interface DynamicRoutingParams {
+    /** 原始路由对象 */
+    route: AgentRoute;
+    /** 全局配置 */
+    config: OpenClawConfig;
+    /** 插件运行时 */
+    core: PluginRuntime;
+    /** 账号 ID */
+    accountId: string;
+    /** 会话类型 */
+    chatType: "group" | "dm";
+    /** 对话 ID（群聊为 chatId，私聊为 userId） */
+    chatId: string;
+    /** 发送者用户 ID */
+    senderId: string;
+    /** 日志输出函数（可选） */
+    log?: (msg: string) => void;
+    /** 错误日志输出函数（可选） */
+    error?: (msg: string) => void;
+}
+/**
+ * 动态路由处理结果
+ */
+export interface DynamicRoutingResult {
+    /** 是否使用动态 Agent */
+    useDynamicAgent: boolean;
+    /** 最终的 agentId（可能被动态注入修改） */
+    finalAgentId: string;
+    /** 最终的 sessionKey（可能被动态注入修改） */
+    finalSessionKey: string;
+    /** 是否修改了路由（注入了动态 Agent） */
+    routeModified: boolean;
+}
+/**
+ * 统一处理动态路由注入逻辑
+ *
+ * 功能：
+ * 1. 判断是否需要使用动态 Agent
+ * 2. 根据 matchedBy 判断配置类型
+ * 3. 返回最终的路由信息（不修改传入的 route 对象）
+ * 4. 输出详细的调试日志
+ *
+ * @param params 动态路由处理参数
+ * @returns 处理结果
+ */
+export declare function processDynamicRouting(params: DynamicRoutingParams): DynamicRoutingResult;

package/dist/src/dynamic-routing.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * 动态路由统一处理模块
+ * 提供统一的路由注入接口。
+ */
+exports.__esModule = true;
+exports.processDynamicRouting = void 0;
+var dynamic_agent_js_1 = require("./dynamic-agent.js");
+/**
+ * 统一处理动态路由注入逻辑
+ *
+ * 功能：
+ * 1. 判断是否需要使用动态 Agent
+ * 2. 根据 matchedBy 判断配置类型
+ * 3. 返回最终的路由信息（不修改传入的 route 对象）
+ * 4. 输出详细的调试日志
+ *
+ * @param params 动态路由处理参数
+ * @returns 处理结果
+ */
+function processDynamicRouting(params) {
+    var route = params.route, config = params.config, accountId = params.accountId, chatType = params.chatType, chatId = params.chatId, senderId = params.senderId, log = params.log;
+    log === null || log === void 0 ? void 0 : log("[dynamic-routing] \uD83D\uDD0D \u8C03\u8BD5 - matchedBy=" + route.matchedBy + ", agentId=" + route.agentId);
+    if (route.matchedBy !== "default") {
+        log === null || log === void 0 ? void 0 : log("[dynamic-routing] \u2139\uFE0F  \u68C0\u6D4B\u5230\u5339\u914D\u7684 bindings (matchedBy=" + route.matchedBy + ")\uFF0C\u8DF3\u8FC7\u52A8\u6001\u8DEF\u7531");
+        return {
+            useDynamicAgent: false,
+            finalAgentId: route.agentId,
+            finalSessionKey: route.sessionKey,
+            routeModified: false
+        };
+    }
+    // 判断是否使用动态 Agent
+    var useDynamicAgent = dynamic_agent_js_1.shouldUseDynamicAgent({
+        chatType: chatType,
+        senderId: senderId,
+        config: config
+    });
+    log === null || log === void 0 ? void 0 : log("[dynamic-routing] \u662F\u5426\u4F7F\u7528\u52A8\u6001\u8DEF\u7531: useDynamicAgent=" + useDynamicAgent);
+    // 使用动态 Agent
+    if (useDynamicAgent) {
+        log === null || log === void 0 ? void 0 : log("[dynamic-routing] \u539F\u59CB\u8DEF\u7531\u4FE1\u606F: agentId=" + route.agentId + ", matchedBy=" + route.matchedBy + ", sessionKey=" + route.sessionKey);
+        var targetAgentId = dynamic_agent_js_1.generateAgentId(chatType, chatId, accountId);
+        var targetSessionKey = "agent:" + targetAgentId + ":wecom:" + accountId + ":" + chatType + ":" + chatId;
+        log === null || log === void 0 ? void 0 : log("[dynamic-routing] \uD83D\uDD04 \u8DEF\u7531\u6CE8\u5165: agentId=" + targetAgentId + ", sessionKey=" + targetSessionKey);
+        return {
+            useDynamicAgent: true,
+            finalAgentId: targetAgentId,
+            finalSessionKey: targetSessionKey,
+            routeModified: true
+        };
+    }
+    log === null || log === void 0 ? void 0 : log('[dynamic-routing] 🔄不使用动态路由');
+    // 不使用动态 Agent，返回原始路由
+    return {
+        useDynamicAgent: false,
+        finalAgentId: route.agentId,
+        finalSessionKey: route.sessionKey,
+        routeModified: false
+    };
+}
+exports.processDynamicRouting = processDynamicRouting;

package/dist/src/endpoint-dispatch.d.ts

@@ -0,0 +1,54 @@
+import type { WeComConfig } from "./utils.js";
+export declare type WecomEndpointConfig = {
+    gatewayBaseUrl: string;
+    gatewayToken?: string;
+    uploadHost?: string;
+    modelName?: string;
+    agentId?: string;
+    showFinalAnswerOnly?: boolean;
+    separateSessionByConversation: boolean;
+    groupSessionScope: "group" | "group_sender";
+    scopeType: "workspace" | "my_workspace" | "project";
+    workspaceId: string;
+    projectId: string;
+};
+declare type DispatchResult = {
+    outboundText: string;
+    mediaUrls: string[];
+    resourceCount: number;
+    textLength: number;
+};
+declare type DispatchParams = {
+    endpointConfig: WecomEndpointConfig;
+    routeAgentId?: string;
+    accountId: string;
+    platformId: string;
+    chatId: string;
+    chatType: "direct" | "group";
+    senderId: string;
+    senderName?: string;
+    chatName?: string;
+    userContent: string;
+    mediaPath?: string;
+    mediaType?: string;
+    mediaFileName?: string;
+    onConfirmationAction?: (text: string) => Promise<void>;
+    onChunk?: (chunk: string, accumulated: string) => Promise<void>;
+    runtimeLog?: (...args: any[]) => void;
+    runtimeError?: (...args: any[]) => void;
+};
+export declare function resolveWecomEndpointConfig(config: WeComConfig, fallbackScope?: {
+    scopeType: "workspace" | "my_workspace" | "project";
+    workspaceId: string;
+    projectId: string;
+} | null): WecomEndpointConfig | null;
+export declare function resolveWecomScopeByBindings(params: {
+    cfg: unknown;
+    accountId: string;
+}): {
+    scopeType: "workspace" | "my_workspace" | "project";
+    workspaceId: string;
+    projectId: string;
+} | null;
+export declare function dispatchWecomViaEndpoint(params: DispatchParams): Promise<DispatchResult>;
+export {};