@workclaw/openclaw-workclaw 1.0.17 → 1.0.19

package/dist/src/runtime.js

@@ -0,0 +1,374 @@
+let runtime = null;
+// WebSocket 连接存储: key 为 appKey
+const wsByKey = new Map();
+// 额外需要的映射
+const accountIdsByAppKey = new Map();
+const appKeyByAccountId = new Map();
+const reconnectSchedulers = new Map();
+const dispatchersByAppKey = new Map();
+// 正在连接中的 appKey → Promise<ws>（成功后 resolve(ws)，失败 resolve(null)）
+const connectingPromises = new Map();
+const lastMessageAtByKey = new Map(); // 上次消息时间，key 为 accountId 或 appKey
+export function setWorkclawRuntime(next) {
+    runtime = next;
+}
+export function getWorkclawRuntime() {
+    if (!runtime) {
+        throw new Error("Workclaw runtime not initialized");
+    }
+    return runtime;
+}
+let _logger = null;
+const _noop = () => { };
+function _fallbackLogger() {
+    return {
+        info: console.log.bind(console),
+        warn: console.warn.bind(console),
+        error: console.error.bind(console),
+        debug: _noop,
+    };
+}
+/** Store the gateway's log into runtime. Called from startAccount. */
+export function setWorkclawLoggerFromContext(log) {
+    _logger = log;
+}
+/** Get the shared logger. Returns ctx.log from gateway if set, otherwise a console fallback. */
+export function getWorkclawLogger() {
+    if (!_logger) {
+        return _fallbackLogger();
+    }
+    // If the stored logger's info is a noop, fall back to console
+    const l = _logger;
+    if (l.info === _noop) {
+        return _fallbackLogger();
+    }
+    return _logger;
+}
+/**
+ * Wrap a logger with a prefix automatically prepended to every message.
+ * All messages logged via the returned logger will have the prefix attached.
+ */
+export function createLogger(prefix, log) {
+    const fallback = _fallbackLogger();
+    return {
+        info: log?.info ? (msg, ...args) => log.info(`${prefix} ${msg}`, ...args) : fallback.info,
+        warn: log?.warn ? (msg, ...args) => log.warn(`${prefix} ${msg}`, ...args) : fallback.warn,
+        error: log?.error ? (msg, ...args) => log.error(`${prefix} ${msg}`, ...args) : fallback.error,
+        debug: log?.debug ? (msg, ...args) => log.debug(`${prefix} ${msg}`, ...args) : fallback.debug,
+    };
+}
+export function setWorkclawWsConnection(key, ws) {
+    wsByKey.set(key, ws);
+}
+export function clearWorkclawWsConnection(key) {
+    wsByKey.delete(key);
+}
+export function getWorkclawWsConnection(key) {
+    return wsByKey.get(key);
+}
+export function setLastInboundAt(key, timestamp) {
+    lastMessageAtByKey.set(key, timestamp);
+}
+export function getLastInboundAt(key) {
+    return lastMessageAtByKey.get(key);
+}
+const lastOutboundAtByKey = new Map();
+// Cached connection config: accountId -> connection config with stable appKey/appSecret
+// This prevents re-resolving from cfg which may have been mutated
+const connectionConfigCache = new Map();
+export function setWorkclawConnectionConfig(accountId, config) {
+    connectionConfigCache.set(accountId, {
+        appKey: config.appKey,
+        appSecret: config.appSecret,
+        baseUrl: config.baseUrl ?? "",
+        websocketUrl: config.websocketUrl,
+        localIp: config.localIp,
+        allowInsecureTls: config.allowInsecureTls,
+        requestTimeout: config.requestTimeout,
+    });
+}
+export function getWorkclawConnectionConfig(accountId) {
+    return connectionConfigCache.get(accountId);
+}
+export function clearWorkclawConnectionConfig(accountId) {
+    connectionConfigCache.delete(accountId);
+}
+export function setLastOutboundAt(key, timestamp) {
+    lastOutboundAtByKey.set(key, timestamp);
+}
+export function getLastOutboundAt(key) {
+    return lastOutboundAtByKey.get(key);
+}
+// 注册账号上下文
+export function registerAccountContext(appKey, accountId, ctx) {
+    if (!accountIdsByAppKey.has(appKey)) {
+        accountIdsByAppKey.set(appKey, new Set());
+    }
+    accountIdsByAppKey.get(appKey).add(accountId);
+    appKeyByAccountId.set(accountId, appKey);
+    if (!dispatchersByAppKey.has(appKey)) {
+        dispatchersByAppKey.set(appKey, new Map());
+    }
+    dispatchersByAppKey.get(appKey).set(accountId, { ctx });
+}
+export function unregisterAccountContext(appKey, accountId) {
+    accountIdsByAppKey.get(appKey)?.delete(accountId);
+    appKeyByAccountId.delete(accountId);
+    dispatchersByAppKey.get(appKey)?.delete(accountId);
+}
+export function getAccountIdsByAppKey(appKey) {
+    return Array.from(accountIdsByAppKey.get(appKey) ?? []);
+}
+export function getAppKeyByAccountId(accountId) {
+    return appKeyByAccountId.get(accountId);
+}
+export function getDispatcherByAppKeyAndAccountId(appKey, accountId) {
+    return dispatchersByAppKey.get(appKey)?.get(accountId);
+}
+export function getAllDispatchersByAppKey(appKey) {
+    return dispatchersByAppKey.get(appKey);
+}
+export function setReconnectScheduler(appKey, scheduler) {
+    reconnectSchedulers.set(appKey, scheduler);
+}
+export function getReconnectScheduler(appKey) {
+    return reconnectSchedulers.get(appKey);
+}
+export function clearReconnectScheduler(appKey) {
+    reconnectSchedulers.delete(appKey);
+}
+// 尝试开始连接
+// 关键：所有并发调用者必须共享同一个 Promise，而不是各自创建新的导致重复建连
+export function tryStartConnecting(appKey) {
+    // 优先查 connectingPromises，确保所有并发调用者共享同一个 Promise
+    const existingPromise = connectingPromises.get(appKey);
+    if (existingPromise !== undefined) {
+        // 已有并发账号在连接，等待同一个 Promise
+        return {
+            isConnector: false,
+            existingWs: wsByKey.get(appKey),
+            connectingPromise: existingPromise,
+        };
+    }
+    // Map 里没有 entry，自己是新 connector
+    let resolvePromise;
+    const promise = new Promise((resolve) => { resolvePromise = resolve; });
+    promise._resolve = resolvePromise;
+    connectingPromises.set(appKey, promise);
+    return { isConnector: true, existingWs: undefined, connectingPromise: promise };
+}
+// 标记连接完成（成功或失败都需要调用）
+// ws 不传或传 undefined 表示失败
+export function finishConnecting(appKey, ws) {
+    const promise = connectingPromises.get(appKey);
+    if (promise) {
+        promise._resolve?.(ws ?? null);
+        connectingPromises.delete(appKey);
+    }
+    // ws 已建立成功时存入 wsByKey，供后续 tryStartConnecting 返回 existingWs
+    if (ws) {
+        wsByKey.set(appKey, ws);
+    }
+}
+// runId -> ToolContext 映射表
+const runIdToToolContext = new Map();
+// toolCallId -> runId 映射表（用于 tool_result_persist 通过 toolCallId 找到 runId，再找到 ctx）
+const toolCallIdToRunId = new Map();
+// 获取工具上下文（通过 runId）
+export function getToolContext(runId) {
+    return runIdToToolContext.get(runId);
+}
+// 设置工具上下文（仅通过 runId）
+export function setToolContext(runId, ctx) {
+    runIdToToolContext.set(runId, ctx);
+}
+// 建立 toolCallId -> runId 的映射（用于 after_tool_call 中）
+export function setToolCallIdToRunIdMapping(toolCallId, runId) {
+    toolCallIdToRunId.set(toolCallId, runId);
+}
+// 通过 toolCallId 获取 runId
+export function getRunIdByToolCallId(toolCallId) {
+    return toolCallIdToRunId.get(toolCallId);
+}
+// 删除工具上下文
+export function deleteToolContext(runId) {
+    runIdToToolContext.delete(runId);
+}
+// 清空所有工具上下文（用于清理）
+export function clearAllToolContexts() {
+    runIdToToolContext.clear();
+    toolCallIdToRunId.clear();
+}
+// 调用sub-agent进行协作
+export async function spawnSubAgent(params) {
+    if (!runtime) {
+        throw new Error("Workclaw runtime not initialized");
+    }
+    try {
+        // 通过runtime调用sessions_spawn
+        const sessionsSpawn = runtime?.sessions_spawn;
+        if (!sessionsSpawn || typeof sessionsSpawn !== "function") {
+            // 如果runtime没有提供sessions_spawn，返回模拟数据
+            getWorkclawLogger().warn(`Runtime does not provide sessions_spawn, returning mock response for agent ${params.agentId}`);
+            return {
+                ok: true,
+                summary: `[模拟] Agent ${params.agentId} 完成任务: ${params.task.substring(0, 50)}...`
+            };
+        }
+        const result = await sessionsSpawn({
+            agentId: params.agentId,
+            task: params.task,
+            label: params.label,
+            model: params.model
+        });
+        return {
+            ok: true,
+            sessionKey: result.sessionKey,
+            summary: result.summary
+        };
+    }
+    catch (error) {
+        getWorkclawLogger().error(`Failed to spawn sub-agent: ${error.message}`);
+        return {
+            ok: false,
+            error: error.message
+        };
+    }
+}
+export const __openclaw_workclaw_runtime_emitted = true;
+/**
+ * 获取工具执行开始的提示（用于 onToolStart）
+ */
+export function getToolStartHint(toolName) {
+    if (!toolName)
+        return "🔄 正在执行工具...";
+    const normalizedToolName = toolName.toLowerCase().trim();
+    const toolMap = {
+        // 📁 文件操作
+        read: { emoji: "📖", title: "读取文件", hint: "正在读取文件", aliases: ["file_read", "read_file"] },
+        write: { emoji: "✍️", title: "写入文件", hint: "正在写入文件", aliases: ["file_write", "write_file"] },
+        edit: { emoji: "✏️", title: "编辑文件", hint: "正在编辑文件", aliases: ["file_edit", "modify"] },
+        // 💻 系统命令
+        exec: { emoji: "⚡", title: "执行命令", hint: "正在执行命令", aliases: ["bash", "shell", "cmd", "command"] },
+        process: { emoji: "🔄", title: "进程管理", hint: "正在处理进程", aliases: ["process_manager"] },
+        // 🌐 网络/浏览器
+        web_fetch: { emoji: "🕸️", title: "获取网页", hint: "正在获取网页内容", aliases: ["fetch", "http_get", "http_request", "curl"] },
+        web_search: { emoji: "🔍", title: "搜索网页", hint: "正在搜索网页", aliases: ["search", "google_search", "brave_search"] },
+        browser: { emoji: "🌐", title: "浏览器控制", hint: "正在控制浏览器", aliases: ["browser_control", "playwright"] },
+        // 💬 消息/通信
+        message: { emoji: "💌", title: "发送消息", hint: "正在发送消息", aliases: ["send_message", "mcp_deliver", "deliver", "notify"] },
+        tts: { emoji: "🔊", title: "文字转语音", hint: "正在转换语音", aliases: ["text_to_speech", "speak"] },
+        // 🎭 会话管理
+        sessions_spawn: { emoji: "🧬", title: "创建子代理", hint: "正在创建子代理", aliases: ["spawn", "create_agent", "new_session"] },
+        sessions_send: { emoji: "📤", title: "跨会话发消息", hint: "正在发送跨会话消息", aliases: ["send_to_session", "forward"] },
+        sessions_list: { emoji: "📋", title: "列出会话", hint: "正在列出会话", aliases: ["list_sessions"] },
+        sessions_history: { emoji: "📜", title: "获取历史", hint: "正在获取历史消息", aliases: ["get_history", "history"] },
+        sessions_yield: { emoji: "⏸️", title: "暂停让出", hint: "正在暂停等待", aliases: ["yield", "pause"] },
+        subagents: { emoji: "🐛", title: "子代理管理", hint: "正在管理子代理", aliases: ["subagent_manager"] },
+        agents_list: { emoji: "🤖", title: "列出代理", hint: "正在列出可用代理", aliases: ["list_agents"] },
+        // 🧠 记忆/知识
+        memory_search: { emoji: "🔎", title: "搜索记忆", hint: "正在搜索记忆", aliases: ["search_memory", "recall"] },
+        memory_get: { emoji: "📝", title: "读取记忆", hint: "正在读取记忆片段", aliases: ["get_memory", "read_memory"] },
+        // ⏰ 定时任务
+        "openclaw-workclaw-cron-add-params": { emoji: "⏱️", title: "创建定时任务", hint: "正在创建定时任务", aliases: ["cron_add", "add_timer"] },
+        "openclaw-workclaw-cron-update-params": { emoji: "🔧", title: "修改定时任务", hint: "正在修改定时任务", aliases: ["cron_update", "update_timer"] },
+        "openclaw-workclaw-cron-remove-params": { emoji: "🗑️", title: "删除定时任务", hint: "正在删除定时任务", aliases: ["cron_remove", "remove_timer"] },
+        "openclaw-workclaw-cron-notify-sync": { emoji: "🔔", title: "定时触发通知", hint: "定时任务已触发", aliases: ["cron_trigger", "notify"] },
+        "openclaw-workclaw-cron-add-sync": { emoji: "✅", title: "同步定时任务", hint: "正在同步到后端", aliases: [] },
+        "openclaw-workclaw-cron-update-sync": { emoji: "✅", title: "同步定时更新", hint: "正在同步更新", aliases: [] },
+        "openclaw-workclaw-cron-remove-sync": { emoji: "✅", title: "同步定时删除", hint: "正在同步删除", aliases: [] },
+        "openclaw-workclaw-cron-disable-params": { emoji: "⏸️", title: "禁用定时任务", hint: "正在禁用定时任务", aliases: ["cron_disable"] },
+        "openclaw-workclaw-cron-enable-params": { emoji: "▶️", title: "启用定时任务", hint: "正在启用定时任务", aliases: ["cron_enable"] },
+        // 📊 其他
+        session_status: { emoji: "📊", title: "会话状态", hint: "正在获取会话状态", aliases: ["status", "get_status"] },
+        canvas: { emoji: "🎨", title: "画布控制", hint: "正在控制画布", aliases: ["canvas_control", "draw"] },
+    };
+    // 精确匹配
+    if (toolMap[normalizedToolName]) {
+        const tool = toolMap[normalizedToolName];
+        return `${tool.emoji} ${tool.hint}...`;
+    }
+    // 别名匹配
+    for (const [key, tool] of Object.entries(toolMap)) {
+        if (tool.aliases.includes(normalizedToolName)) {
+            return `${tool.emoji} ${tool.hint}...`;
+        }
+    }
+    // 默认
+    return `🔄 正在执行 ${toolName}...`;
+}
+/**
+ * 获取工具执行完成的提示（用于 after_tool_call）
+ */
+export function getToolResultHint(toolName) {
+    if (!toolName)
+        return "✅ 工具执行完成";
+    const normalizedToolName = toolName.toLowerCase().trim();
+    const toolMap = {
+        // 📁 文件操作
+        read: { emoji: "📖", title: "读取文件", hint: "已读取文件", aliases: ["file_read", "read_file"] },
+        write: { emoji: "✍️", title: "写入文件", hint: "已写入文件", aliases: ["file_write", "write_file"] },
+        edit: { emoji: "✏️", title: "编辑文件", hint: "已编辑文件", aliases: ["file_edit", "modify"] },
+        // 💻 系统命令
+        exec: { emoji: "⚡", title: "执行命令", hint: "已执行命令", aliases: ["bash", "shell", "cmd", "command"] },
+        process: { emoji: "🔄", title: "进程管理", hint: "已处理进程", aliases: ["process_manager"] },
+        // 🌐 网络/浏览器
+        web_fetch: { emoji: "🕸️", title: "获取网页", hint: "已获取网页", aliases: ["fetch", "http_get", "http_request", "curl"] },
+        web_search: { emoji: "🔍", title: "搜索网页", hint: "已搜索网页", aliases: ["search", "google_search", "brave_search"] },
+        browser: { emoji: "🌐", title: "浏览器控制", hint: "已控制浏览器", aliases: ["browser_control", "playwright"] },
+        // 💬 消息/通信
+        message: { emoji: "💌", title: "发送消息", hint: "已发送消息", aliases: ["send_message", "mcp_deliver", "deliver", "notify"] },
+        tts: { emoji: "🔊", title: "文字转语音", hint: "已转换语音", aliases: ["text_to_speech", "speak"] },
+        // 🎭 会话管理
+        sessions_spawn: { emoji: "🧬", title: "创建子代理", hint: "已创建子代理", aliases: ["spawn", "create_agent", "new_session"] },
+        sessions_send: { emoji: "📤", title: "跨会话发消息", hint: "已发送跨会话消息", aliases: ["send_to_session", "forward"] },
+        sessions_list: { emoji: "📋", title: "列出会话", hint: "已列出会话", aliases: ["list_sessions"] },
+        sessions_history: { emoji: "📜", title: "获取历史", hint: "已获取历史消息", aliases: ["get_history", "history"] },
+        sessions_yield: { emoji: "⏸️", title: "暂停让出", hint: "已暂停等待", aliases: ["yield", "pause"] },
+        subagents: { emoji: "🐛", title: "子代理管理", hint: "已管理子代理", aliases: ["subagent_manager"] },
+        agents_list: { emoji: "🤖", title: "列出代理", hint: "已列出代理", aliases: ["list_agents"] },
+        // 🧠 记忆/知识
+        memory_search: { emoji: "🔎", title: "搜索记忆", hint: "已搜索记忆", aliases: ["search_memory", "recall"] },
+        memory_get: { emoji: "📝", title: "读取记忆", hint: "已读取记忆", aliases: ["get_memory", "read_memory"] },
+        // ⏰ 定时任务
+        "openclaw-workclaw-cron-add-params": { emoji: "⏱️", title: "创建定时任务", hint: "已创建定时任务", aliases: ["cron_add", "add_timer"] },
+        "openclaw-workclaw-cron-update-params": { emoji: "🔧", title: "修改定时任务", hint: "已修改定时任务", aliases: ["cron_update", "update_timer"] },
+        "openclaw-workclaw-cron-remove-params": { emoji: "🗑️", title: "删除定时任务", hint: "已删除定时任务", aliases: ["cron_remove", "remove_timer"] },
+        "openclaw-workclaw-cron-notify-sync": { emoji: "🔔", title: "定时触发通知", hint: "定时任务已触发", aliases: ["cron_trigger", "notify"] },
+        "openclaw-workclaw-cron-add-sync": { emoji: "✅", title: "同步定时任务", hint: "已同步定时任务", aliases: [] },
+        "openclaw-workclaw-cron-update-sync": { emoji: "✅", title: "同步定时更新", hint: "已同步更新", aliases: [] },
+        "openclaw-workclaw-cron-remove-sync": { emoji: "✅", title: "同步定时删除", hint: "已同步删除", aliases: [] },
+        "openclaw-workclaw-cron-disable-params": { emoji: "⏸️", title: "禁用定时任务", hint: "已禁用定时任务", aliases: ["cron_disable"] },
+        "openclaw-workclaw-cron-enable-params": { emoji: "▶️", title: "启用定时任务", hint: "已启用定时任务", aliases: ["cron_enable"] },
+        // 📊 其他
+        session_status: { emoji: "📊", title: "会话状态", hint: "已获取会话状态", aliases: ["status", "get_status"] },
+        canvas: { emoji: "🎨", title: "画布控制", hint: "已控制画布", aliases: ["canvas_control", "draw"] },
+    };
+    // 精确匹配
+    if (toolMap[normalizedToolName]) {
+        const tool = toolMap[normalizedToolName];
+        return `${tool.emoji} ${tool.hint}`;
+    }
+    // 别名匹配
+    for (const [key, tool] of Object.entries(toolMap)) {
+        if (tool.aliases.includes(normalizedToolName)) {
+            return `${tool.emoji} ${tool.hint}`;
+        }
+    }
+    // 默认
+    return `✅ 已执行 ${toolName}`;
+}
+/**
+ * 获取 Workclaw 渠道密钥
+ * 这是 setup 向导必需的接口
+ */
+export async function getWorkclawSecrets(params) {
+    const secrets = {};
+    if (params.appKey) {
+        secrets.appKey = params.appKey;
+    }
+    if (params.appSecret) {
+        secrets.appSecret = params.appSecret;
+    }
+    return secrets;
+}

package/dist/src/secret-contract-api.d.ts

@@ -0,0 +1,4 @@
+export declare const channelSecrets: {
+    specifier: string;
+    exportName: string;
+};

package/dist/src/secret-contract-api.js

@@ -0,0 +1,4 @@
+export const channelSecrets = {
+    specifier: "./runtime.js",
+    exportName: "getWorkclawSecrets",
+};

package/dist/src/send.d.ts

@@ -0,0 +1 @@
+export { sendMessageWorkclaw, getMessageWorkclaw } from "./outbound/index.js";

package/dist/src/send.js

@@ -0,0 +1 @@
+export { sendMessageWorkclaw, getMessageWorkclaw } from "./outbound/index.js";

package/dist/src/setup-api.d.ts

@@ -0,0 +1,3 @@
+export { workclawPlugin } from "./channel.js";
+export * from "./setup-core.js";
+export * from "./setup-surface.js";

package/dist/src/setup-api.js

@@ -0,0 +1,3 @@
+export { workclawPlugin } from "./channel.js";
+export * from "./setup-core.js";
+export * from "./setup-surface.js";

package/dist/src/setup-core.d.ts

@@ -0,0 +1,3 @@
+import { type ChannelSetupAdapter, type OpenClawConfig } from "openclaw/plugin-sdk/setup";
+export declare function setWorkclawNamedAccountEnabled(cfg: OpenClawConfig, accountId: string, enabled: boolean): OpenClawConfig;
+export declare const workclawSetupAdapter: ChannelSetupAdapter;

package/dist/src/setup-core.js

@@ -0,0 +1,13 @@
+import { DEFAULT_ACCOUNT_ID, } from "openclaw/plugin-sdk/setup";
+import { resolveDefaultWorkclawAccountId } from "./accounts.js";
+import { patchWorkclawConfig } from "./setup-surface.js";
+export function setWorkclawNamedAccountEnabled(cfg, accountId, enabled) {
+    return patchWorkclawConfig(cfg, accountId, { enabled });
+}
+export const workclawSetupAdapter = {
+    resolveAccountId: ({ cfg, accountId }) => accountId?.trim() || resolveDefaultWorkclawAccountId(cfg),
+    applyAccountConfig: ({ cfg, accountId }) => {
+        const isDefault = !accountId || accountId === DEFAULT_ACCOUNT_ID;
+        return patchWorkclawConfig(cfg, isDefault ? DEFAULT_ACCOUNT_ID : accountId, { enabled: true });
+    },
+};

package/dist/src/setup-surface.d.ts

@@ -0,0 +1,7 @@
+import { type ChannelSetupWizard, type OpenClawConfig } from "openclaw/plugin-sdk/setup";
+/**
+ * 修补 Workclaw 配置
+ */
+export declare function patchWorkclawConfig(cfg: OpenClawConfig, accountId: string, patch: Record<string, unknown>): OpenClawConfig;
+export { workclawSetupAdapter } from "./setup-core.js";
+export declare const workclawSetupWizard: ChannelSetupWizard;