@workclaw/openclaw-workclaw 1.0.17 → 1.0.19

package/dist/src/connection/workclaw-client.js

@@ -0,0 +1,351 @@
+import { Agent, fetch as undiciFetch } from "undici";
+import { getWorkclawLogger } from "../runtime.js";
+const tokenCache = new Map();
+export function clearWorkclawTokenCache(cacheKey) {
+    tokenCache.delete(cacheKey);
+}
+export function normalizeBaseUrl(value) {
+    const raw = (value || "https://workbrain.cn/backend-api").trim();
+    return raw.endsWith("/") ? raw.slice(0, -1) : raw;
+}
+function createWsEndpoint(baseUrl) {
+    const wsBase = baseUrl.replace(/^https?:\/\//i, (match) => match.toLowerCase() === "https://" ? "wss://" : "ws://");
+    return `${wsBase}/v1/ws/connect`;
+}
+export async function doFetchJson(url, init, allowInsecureTls, requestTimeout) {
+    const dispatcher = allowInsecureTls
+        ? new Agent({ connect: { rejectUnauthorized: false } })
+        : undefined;
+    const fetcher = allowInsecureTls ? undiciFetch : globalThis.fetch;
+    const controller = new AbortController();
+    const timeoutMs = typeof requestTimeout === "number" && requestTimeout > 0 ? requestTimeout : 30000;
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    let response;
+    let text = "";
+    try {
+        response = await fetcher(url, {
+            ...init,
+            signal: controller.signal,
+            ...(dispatcher ? { dispatcher } : {}),
+        });
+        text = await response.text().catch(() => "");
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+    let data = {};
+    if (text) {
+        try {
+            data = JSON.parse(text);
+        }
+        catch {
+            data = {};
+        }
+    }
+    if (!response.ok) {
+        const message = data?.message || text || `HTTP ${response.status}`;
+        throw new Error(message);
+    }
+    return data;
+}
+async function fetchAccessTokenFromServer(requestUrl, config) {
+    getWorkclawLogger().info(`Requesting access token url=${requestUrl} appKeyPrefix=${String(config.appKey)}... appSecretLen=${String(config.appSecret)}`);
+    const data = await doFetchJson(requestUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            app_key: config.appKey,
+            app_secret: config.appSecret,
+        }),
+    }, config.allowInsecureTls, config.requestTimeout);
+    getWorkclawLogger().info(`Access token response code=${String(data?.code ?? "")} errCode=${String(data?.errCode ?? "")} errMsg=${String(data?.errMsg ?? data?.message ?? "")}`);
+    if (data?.code !== 200 || !data?.data?.accessToken) {
+        throw new Error(String(data?.message || data?.errMsg || "Failed to acquire access token"));
+    }
+    const token = String(data.data.accessToken);
+    const expiresIn = Number(data.data.expiresIn || 0);
+    const expiresAt = Date.now() + (expiresIn > 0 ? expiresIn * 1000 : 0);
+    getWorkclawLogger().info(`Access token acquired tokenLen=${token.length} expiresInSec=${expiresIn} expiresAt=${new Date(expiresAt).toISOString()}`);
+    return { token, expiresAt };
+}
+export async function getWorkclawAccessToken(cacheKey, config) {
+    const startedAt = Date.now();
+    const baseUrl = normalizeBaseUrl(config.baseUrl);
+    const requestUrl = `${baseUrl}/authen/v1/access_token/internal`;
+    const timeoutMs = typeof config.requestTimeout === "number" && config.requestTimeout > 0
+        ? config.requestTimeout
+        : 30000;
+    getWorkclawLogger().info(`getWorkclawAccessToken start cacheKey=${cacheKey} requestUrl=${requestUrl} baseUrl=${baseUrl} allowInsecureTls=${Boolean(config.allowInsecureTls)} timeoutMs=${timeoutMs}`);
+    try {
+        const cached = tokenCache.get(cacheKey);
+        if (cached && cached.token) {
+            const now = Date.now();
+            const refreshAt = cached.expiresAt - 5 * 60 * 1000;
+            const remainingMs = cached.expiresAt - now;
+            getWorkclawLogger().info(`Token cache found cacheKey=${cacheKey} expiresAt=${new Date(cached.expiresAt).toISOString()} remainingMs=${remainingMs}`);
+            if (now < refreshAt) {
+                getWorkclawLogger().info(`Using cached token cacheKey=${cacheKey} elapsedMs=${now - startedAt}`);
+                return cached.token;
+            }
+            getWorkclawLogger().info(`Cached token near expiry/expired, refreshing cacheKey=${cacheKey} elapsedMs=${now - startedAt}`);
+        }
+        if (!config.appKey || !config.appSecret) {
+            getWorkclawLogger().error(`Missing appKey/appSecret cacheKey=${cacheKey} appKey=${String(config.appKey || "") ? "present" : "missing"} appSecret=${String(config.appSecret || "") ? "present" : "missing"}`);
+            throw new Error("Missing appKey/appSecret");
+        }
+        const result = await fetchAccessTokenFromServer(requestUrl, config);
+        tokenCache.set(cacheKey, { token: result.token, expiresAt: result.expiresAt });
+        getWorkclawLogger().info(`getWorkclawAccessToken success cacheKey=${cacheKey} elapsedMs=${Date.now() - startedAt}`);
+        return result.token;
+    }
+    catch (error) {
+        getWorkclawLogger().error(`getWorkclawAccessToken failed cacheKey=${cacheKey} requestUrl=${requestUrl} baseUrl=${baseUrl} elapsedMs=${Date.now() - startedAt} error=${String(error)}`);
+        throw error;
+    }
+}
+export async function openWorkclawConnection(cacheKey, config) {
+    const startedAt = Date.now();
+    const baseUrl = normalizeBaseUrl(config.baseUrl);
+    const requestUrl = `${baseUrl}/open-apis/v1/connections/open`;
+    const timeoutMs = typeof config.requestTimeout === "number" && config.requestTimeout > 0
+        ? config.requestTimeout
+        : 30000;
+    const appKeyRaw = String(config.appKey ?? "");
+    const appSecretRaw = String(config.appSecret ?? "");
+    getWorkclawLogger().info(`openWorkclawConnection start cacheKey=${cacheKey} baseUrl=${baseUrl} requestUrl=${requestUrl} allowInsecureTls=${Boolean(config.allowInsecureTls)} timeoutMs=${timeoutMs} localIp=${String(config.localIp ?? "")} websocketUrl=${String(config.websocketUrl ?? "")} appKeyPrefix=${appKeyRaw ? `${appKeyRaw.slice(0, 8)}...` : "missing"} appSecretLen=${appSecretRaw.length}`);
+    const tokenStartedAt = Date.now();
+    const token = await getWorkclawAccessToken(cacheKey, config);
+    getWorkclawLogger().info(`openWorkclawConnection got access token cacheKey=${cacheKey} tokenLen=${token.length} elapsedMs=${Date.now() - tokenStartedAt}`);
+    const payload = {
+        appKey: config.appKey,
+        appSecret: config.appSecret,
+        subscriptions: [
+            { type: "CALLBACK", topic: "AGENT_MESSAGE" },
+            { type: "EVENT", topic: "*" },
+            { type: "SYSTEM", topic: "*" },
+        ],
+        ...(config.localIp ? { localIp: config.localIp } : {}),
+    };
+    getWorkclawLogger().info(`Opening connection url=${requestUrl} cacheKey=${cacheKey} subscriptions=${payload.subscriptions.length}`);
+    const data = await doFetchJson(requestUrl, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${token}`,
+        },
+        body: JSON.stringify(payload),
+    }, config.allowInsecureTls, config.requestTimeout);
+    getWorkclawLogger().info(`Open connection response code=${String(data?.code ?? "")} errCode=${String(data?.errCode ?? "")} errMsg=${String(data?.errMsg ?? data?.message ?? "")} hasTicket=${Boolean(data?.data?.ticket)} hasEndpoint=${Boolean(data?.data?.endpoint)}`);
+    if (data?.code !== 200 || !data?.data?.ticket) {
+        throw new Error(String(data?.message || data?.errMsg || "Failed to open connection"));
+    }
+    const ticket = String(data.data.ticket);
+    let endpointSource = "derived";
+    // 优先使用配置中的 websocketUrl，其次使用 API 返回的 endpoint，最后使用默认构建的 endpoint
+    const endpoint = config.websocketUrl
+        ? ((endpointSource = "config"), String(config.websocketUrl))
+        : data?.data?.endpoint
+            ? ((endpointSource = "api"), String(data.data.endpoint))
+            : ((endpointSource = "derived"), createWsEndpoint(baseUrl));
+    getWorkclawLogger().info(`openWorkclawConnection success cacheKey=${cacheKey} endpoint=${endpoint} endpointSource=${endpointSource} ticketLen=${ticket.length} elapsedMs=${Date.now() - startedAt}`);
+    return { endpoint, ticket };
+}
+/**
+ * 获取智能体列表
+ * POST /open-apis/instance/list
+ */
+export async function getAgentInstances(cacheKey, config) {
+    const baseUrl = normalizeBaseUrl(config.baseUrl);
+    const token = await getWorkclawAccessToken(cacheKey, config);
+    const payload = {
+        appKey: config.appKey,
+    };
+    getWorkclawLogger().info(`Getting agent instances from ${baseUrl}/open-apis/instance/list`);
+    getWorkclawLogger().info(`Payload:`, JSON.stringify(payload, null, 2));
+    const data = await doFetchJson(`${baseUrl}/open-apis/instance/list`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${token}`,
+        },
+        body: JSON.stringify(payload),
+    }, config.allowInsecureTls, config.requestTimeout);
+    getWorkclawLogger().info(`Agent instances response:`, JSON.stringify(data, null, 2));
+    if (data?.code !== 200 || !Array.isArray(data?.data)) {
+        throw new Error(data?.message || "Failed to get agent instances");
+    }
+    return data.data;
+}
+/**
+ * 发送主动消息（非回复）
+ * POST /im/v1/messages
+ */
+export async function sendWorkclawMessage(params) {
+    const baseUrl = normalizeBaseUrl(params.config.baseUrl);
+    const token = await getWorkclawAccessToken(params.cacheKey, params.config);
+    // 主动消息参数
+    const payload = {
+        agentId: params.agentId,
+        receiveId: params.receiveId,
+        msgType: params.msgType,
+        content: params.content,
+    };
+    // 添加 last 字段（仅当为 true 时）
+    if (params.last === true) {
+        payload.is_last = true;
+    }
+    // openConversationId 非必填，API 字段名为 conversationId
+    if (params.openConversationId) {
+        payload.conversationId = params.openConversationId;
+    }
+    const endpoint = params.endpoint || "/open-apis/im/v1/messages";
+    getWorkclawLogger().info(`Sending proactive message to ${baseUrl}${endpoint}`);
+    getWorkclawLogger().info(`Payload:`, JSON.stringify(payload, null, 2));
+    const data = await doFetchJson(`${baseUrl}${endpoint}`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${token}`,
+        },
+        body: JSON.stringify(payload),
+    }, params.config.allowInsecureTls, params.config.requestTimeout);
+    getWorkclawLogger().info(`Send message response:`, JSON.stringify(data, null, 2));
+    if (data?.code !== 200 || !data?.data?.msgId) {
+        throw new Error(data?.message || "Failed to send message");
+    }
+    return String(data.data.msgId);
+}
+/**
+ * 发送回复消息
+ * POST /im/v1/messages/{messageId}/reply
+ */
+export async function sendWorkclawReplyMessage(params) {
+    const baseUrl = normalizeBaseUrl(params.config.baseUrl);
+    const token = await getWorkclawAccessToken(params.cacheKey, params.config);
+    // 回复消息参数
+    // 注意：虽然 API 文档说不需要 openConversationId，但为了保险起见还是会传递
+    const payload = {
+        agentId: params.agentId,
+        receiveId: params.receiveId,
+        msgType: params.msgType,
+        content: params.content,
+    };
+    getWorkclawLogger().info(`Reply payload is last : ${params.last} `);
+    // 添加 last 字段（仅当为 true 时）
+    if (params.last === true) {
+        payload.is_last = true;
+    }
+    // 如果提供了 openConversationId，也添加到 payload 中（以防 API 需要）
+    if (params.openConversationId) {
+        payload.conversationId = params.openConversationId;
+        getWorkclawLogger().info(`Reply payload includes conversationId: ${params.openConversationId}`);
+    }
+    else {
+        getWorkclawLogger().info(`Reply payload does NOT include conversationId (openConversationId is empty)`);
+    }
+    const endpoint = params.endpoint || `/open-apis/im/v1/messages/${params.messageId}/reply`;
+    getWorkclawLogger().info(`Sending reply message to ${baseUrl}${endpoint}`);
+    getWorkclawLogger().info(`Reply Payload:`, JSON.stringify(payload, null, 2));
+    const data = await doFetchJson(`${baseUrl}${endpoint}`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${token}`,
+        },
+        body: JSON.stringify(payload),
+    }, params.config.allowInsecureTls, params.config.requestTimeout);
+    getWorkclawLogger().info(`Send reply response:`, JSON.stringify(data, null, 2));
+    if (data?.code !== 200 || !data?.data?.msgId) {
+        throw new Error(data?.message || "Failed to send reply");
+    }
+    return String(data.data.msgId);
+}
+export function resolveWorkclawMessage(text, mediaUrl) {
+    if (!mediaUrl || text.trim()) {
+        return { msgType: "text", content: text };
+    }
+    const url = mediaUrl.trim();
+    const lower = url.toLowerCase();
+    const isAudio = lower.endsWith(".mp3") ||
+        lower.endsWith(".wav") ||
+        lower.endsWith(".aac") ||
+        lower.endsWith(".m4a") ||
+        lower.endsWith(".ogg");
+    const payload = JSON.stringify({ url });
+    return { msgType: isAudio ? "audio" : "image", content: payload };
+}
+/**
+ * 同步 openclaw 创建的定时任务至后端
+ * POST /cron/job/add
+ */
+export async function syncWorkclawCronJobToBackend(cacheKey, config, payload) {
+    const baseUrl = normalizeBaseUrl(config.baseUrl);
+    const token = await getWorkclawAccessToken(cacheKey, config);
+    // 尝试添加 /open-apis 前缀，以匹配其他 API 的模式 (如 getAgentInstances)
+    const requestUrl = `${baseUrl}/open-apis/cron/job/add`;
+    getWorkclawLogger().info(`Syncing cron job to ${requestUrl}`);
+    getWorkclawLogger().info(`Payload:`, JSON.stringify(payload, null, 2));
+    const data = await doFetchJson(requestUrl, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${token}`,
+        },
+        body: JSON.stringify(payload),
+    }, config.allowInsecureTls, config.requestTimeout);
+    getWorkclawLogger().info(`Sync cron job response:`, JSON.stringify(data, null, 2));
+    if (data?.code !== 200 && data?.code !== 0) {
+        throw new Error(data?.message || data?.msg || "Failed to sync cron job");
+    }
+    return data;
+}
+/**
+ * 获取AppKey所对应的模型配置
+ * POST /open-apis/instance/apiKey/{appKey}
+ */
+export async function getWorkclawModelConfigByAppKey(cacheKey, config) {
+    const baseUrl = normalizeBaseUrl(config.baseUrl);
+    const token = await getWorkclawAccessToken(cacheKey, config);
+    const appKey = config.appKey;
+    if (!appKey) {
+        throw new Error("Missing appKey for getModelKeyByAppKey");
+    }
+    const requestUrl = `${baseUrl}/open-apis/instance/apiKey/${appKey}`;
+    getWorkclawLogger().info(`Getting model key from ${requestUrl}`);
+    const data = await doFetchJson(requestUrl, {
+        method: "GET",
+        headers: {
+            "Content-Type": "x-www-form-urlencoded",
+            "Authorization": `Bearer ${token}`,
+        }
+    }, config.allowInsecureTls, config.requestTimeout);
+    getWorkclawLogger().info(`Model key response:`, JSON.stringify(data, null, 2));
+    if (data?.code !== 200 || !data?.data) {
+        throw new Error(data?.message || data?.msg || "Failed to get model key");
+    }
+    return data.data;
+}
+/**
+ * 此时定时任务触发消息至后端
+ * POST /open-apis/cron/job/message
+ */
+export async function sendWorkclawCronJobMessageToBackend(cacheKey, config, payload) {
+    const baseUrl = normalizeBaseUrl(config.baseUrl);
+    const token = await getWorkclawAccessToken(cacheKey, config);
+    const requestUrl = `${baseUrl}/open-apis/cron/job/message`;
+    getWorkclawLogger().info(`Sending cron job message to ${requestUrl}`);
+    getWorkclawLogger().info(`Payload:`, JSON.stringify(payload, null, 2));
+    const data = await doFetchJson(requestUrl, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${token}`,
+        },
+        body: JSON.stringify(payload),
+    }, config.allowInsecureTls, config.requestTimeout);
+    getWorkclawLogger().info(`Send cron job message response:`, JSON.stringify(data, null, 2));
+    if (data?.code !== 200 && data?.code !== 0) {
+        throw new Error(data?.message || data?.msg || "Failed to send cron job message");
+    }
+    return data;
+}

package/dist/src/gateway/agent-handlers.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Agent Handlers - handle AGENT_CREATED, AGENT_UPDATED, AGENT_DELETED events
+ */
+type AgentLogger = {
+    info?: (msg: string) => void;
+    warn?: (msg: string) => void;
+    error?: (msg: string) => void;
+};
+export declare function handleAgentCreated(accountData: any, cfg: any, log?: AgentLogger): Promise<void>;
+export declare function handleAgentUpdated(accountData: any, cfg: any, log?: AgentLogger): Promise<void>;
+export declare function handleAgentDeleted(accountData: any, cfg: any, log?: AgentLogger): Promise<void>;
+export {};