@workclaw/openclaw-workclaw 1.0.18 → 1.0.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (145) hide show
  1. package/README.md +30 -11
  2. package/dist/api.d.ts +3 -0
  3. package/dist/api.js +3 -0
  4. package/dist/index.d.ts +11 -0
  5. package/dist/index.js +264 -0
  6. package/dist/setup-entry.d.ts +2 -0
  7. package/dist/setup-entry.js +12 -0
  8. package/dist/src/accounts.d.ts +66 -0
  9. package/dist/src/accounts.js +279 -0
  10. package/dist/src/api/accounts-api.d.ts +2 -0
  11. package/dist/src/api/accounts-api.js +130 -0
  12. package/dist/src/api/prompts-api.d.ts +2 -0
  13. package/dist/src/api/prompts-api.js +103 -0
  14. package/dist/src/api/session-api.d.ts +2 -0
  15. package/dist/src/api/session-api.js +207 -0
  16. package/dist/src/api/skills-api.d.ts +2 -0
  17. package/dist/src/api/skills-api.js +64 -0
  18. package/dist/src/api/workspace.d.ts +3 -0
  19. package/dist/src/api/workspace.js +30 -0
  20. package/dist/src/channel.d.ts +11 -0
  21. package/{src/channel.ts → dist/src/channel.js} +199 -225
  22. package/dist/src/config-schema.d.ts +93 -0
  23. package/dist/src/config-schema.js +56 -0
  24. package/dist/src/connection/workclaw-client.d.ts +147 -0
  25. package/dist/src/connection/workclaw-client.js +351 -0
  26. package/dist/src/gateway/agent-handlers.d.ts +12 -0
  27. package/{src/gateway/agent-handlers.ts → dist/src/gateway/agent-handlers.js} +372 -462
  28. package/dist/src/gateway/config-writer.d.ts +71 -0
  29. package/dist/src/gateway/config-writer.js +302 -0
  30. package/dist/src/gateway/cron-tasks-handler.d.ts +19 -0
  31. package/dist/src/gateway/cron-tasks-handler.js +188 -0
  32. package/dist/src/gateway/message-context.d.ts +80 -0
  33. package/{src/gateway/message-context.ts → dist/src/gateway/message-context.js} +509 -594
  34. package/dist/src/gateway/message-dispatcher.d.ts +18 -0
  35. package/dist/src/gateway/message-dispatcher.js +572 -0
  36. package/dist/src/gateway/reconnect.d.ts +27 -0
  37. package/{src/gateway/reconnect.ts → dist/src/gateway/reconnect.js} +210 -253
  38. package/dist/src/gateway/skills-handler.d.ts +29 -0
  39. package/dist/src/gateway/skills-handler.js +615 -0
  40. package/dist/src/gateway/skills-list-handler.d.ts +27 -0
  41. package/dist/src/gateway/skills-list-handler.js +233 -0
  42. package/dist/src/gateway/tools-list-handler.d.ts +30 -0
  43. package/dist/src/gateway/tools-list-handler.js +101 -0
  44. package/dist/src/gateway/workclaw-gateway.d.ts +14 -0
  45. package/dist/src/gateway/workclaw-gateway.js +237 -0
  46. package/dist/src/media/upload.d.ts +13 -0
  47. package/dist/src/media/upload.js +125 -0
  48. package/dist/src/outbound/index.d.ts +36 -0
  49. package/dist/src/outbound/index.js +123 -0
  50. package/dist/src/outbound/workclaw-sender.d.ts +36 -0
  51. package/{src/outbound/workclaw-sender.ts → dist/src/outbound/workclaw-sender.js} +95 -158
  52. package/dist/src/runtime.d.ts +116 -0
  53. package/dist/src/runtime.js +374 -0
  54. package/dist/src/secret-contract-api.d.ts +4 -0
  55. package/dist/src/secret-contract-api.js +4 -0
  56. package/{src/send.ts → dist/src/send.d.ts} +1 -1
  57. package/dist/src/send.js +1 -0
  58. package/dist/src/setup-api.d.ts +3 -0
  59. package/dist/src/setup-api.js +3 -0
  60. package/dist/src/setup-core.d.ts +3 -0
  61. package/dist/src/setup-core.js +13 -0
  62. package/dist/src/setup-surface.d.ts +7 -0
  63. package/dist/src/setup-surface.js +363 -0
  64. package/dist/src/tools/openclaw-workclaw-cron/api/index.d.ts +93 -0
  65. package/dist/src/tools/openclaw-workclaw-cron/api/index.js +209 -0
  66. package/dist/src/tools/openclaw-workclaw-cron/index.d.ts +10 -0
  67. package/{src/tools/openclaw-workclaw-cron/index.ts → dist/src/tools/openclaw-workclaw-cron/index.js} +33 -39
  68. package/dist/src/tools/openclaw-workclaw-cron/src/add/params.d.ts +16 -0
  69. package/dist/src/tools/openclaw-workclaw-cron/src/add/params.js +152 -0
  70. package/dist/src/tools/openclaw-workclaw-cron/src/add/sync.d.ts +18 -0
  71. package/dist/src/tools/openclaw-workclaw-cron/src/add/sync.js +162 -0
  72. package/dist/src/tools/openclaw-workclaw-cron/src/disable/params.d.ts +14 -0
  73. package/dist/src/tools/openclaw-workclaw-cron/src/disable/params.js +80 -0
  74. package/dist/src/tools/openclaw-workclaw-cron/src/disable/sync.d.ts +14 -0
  75. package/dist/src/tools/openclaw-workclaw-cron/src/disable/sync.js +107 -0
  76. package/dist/src/tools/openclaw-workclaw-cron/src/enable/params.d.ts +14 -0
  77. package/dist/src/tools/openclaw-workclaw-cron/src/enable/params.js +80 -0
  78. package/dist/src/tools/openclaw-workclaw-cron/src/enable/sync.d.ts +14 -0
  79. package/dist/src/tools/openclaw-workclaw-cron/src/enable/sync.js +107 -0
  80. package/dist/src/tools/openclaw-workclaw-cron/src/notify/sync.d.ts +17 -0
  81. package/dist/src/tools/openclaw-workclaw-cron/src/notify/sync.js +127 -0
  82. package/dist/src/tools/openclaw-workclaw-cron/src/remove/params.d.ts +14 -0
  83. package/dist/src/tools/openclaw-workclaw-cron/src/remove/params.js +87 -0
  84. package/dist/src/tools/openclaw-workclaw-cron/src/remove/sync.d.ts +14 -0
  85. package/dist/src/tools/openclaw-workclaw-cron/src/remove/sync.js +107 -0
  86. package/dist/src/tools/openclaw-workclaw-cron/src/update/params.d.ts +17 -0
  87. package/dist/src/tools/openclaw-workclaw-cron/src/update/params.js +164 -0
  88. package/dist/src/tools/openclaw-workclaw-cron/src/update/sync.d.ts +18 -0
  89. package/dist/src/tools/openclaw-workclaw-cron/src/update/sync.js +135 -0
  90. package/dist/src/tools/openclaw-workclaw-cron/types/index.d.ts +52 -0
  91. package/dist/src/tools/openclaw-workclaw-cron/types/index.js +4 -0
  92. package/dist/src/tools/openclaw-workclaw-cron/utils/index.d.ts +40 -0
  93. package/dist/src/tools/openclaw-workclaw-cron/utils/index.js +122 -0
  94. package/dist/src/tools/openclaw-workclaw-system/index.d.ts +10 -0
  95. package/{src/tools/openclaw-workclaw-system/index.ts → dist/src/tools/openclaw-workclaw-system/index.js} +15 -17
  96. package/dist/src/tools/openclaw-workclaw-system/src/get/index.d.ts +8 -0
  97. package/dist/src/tools/openclaw-workclaw-system/src/get/index.js +64 -0
  98. package/dist/src/tools/openclaw-workclaw-system/src/token/index.d.ts +8 -0
  99. package/dist/src/tools/openclaw-workclaw-system/src/token/index.js +78 -0
  100. package/{src/types.ts → dist/src/types.d.ts} +39 -58
  101. package/dist/src/types.js +1 -0
  102. package/dist/src/utils/content.d.ts +15 -0
  103. package/{src/utils/content.ts → dist/src/utils/content.js} +38 -35
  104. package/package.json +13 -9
  105. package/index.ts +0 -302
  106. package/setup-entry.ts +0 -6
  107. package/src/accounts.ts +0 -312
  108. package/src/api/accounts-api.ts +0 -156
  109. package/src/api/prompts-api.ts +0 -116
  110. package/src/api/session-api.ts +0 -238
  111. package/src/api/skills-api.ts +0 -72
  112. package/src/api/workspace.ts +0 -41
  113. package/src/config-schema.ts +0 -110
  114. package/src/connection/workclaw-client.ts +0 -643
  115. package/src/gateway/config-writer.ts +0 -296
  116. package/src/gateway/message-dispatcher.ts +0 -641
  117. package/src/gateway/skills-handler.ts +0 -741
  118. package/src/gateway/skills-list-handler.ts +0 -332
  119. package/src/gateway/tools-list-handler.ts +0 -160
  120. package/src/gateway/workclaw-gateway.ts +0 -367
  121. package/src/media/upload.ts +0 -157
  122. package/src/outbound/index.ts +0 -185
  123. package/src/runtime.ts +0 -497
  124. package/src/tools/openclaw-workclaw-cron/api/index.ts +0 -326
  125. package/src/tools/openclaw-workclaw-cron/src/add/params.ts +0 -177
  126. package/src/tools/openclaw-workclaw-cron/src/add/sync.ts +0 -188
  127. package/src/tools/openclaw-workclaw-cron/src/disable/params.ts +0 -100
  128. package/src/tools/openclaw-workclaw-cron/src/disable/sync.ts +0 -127
  129. package/src/tools/openclaw-workclaw-cron/src/enable/params.ts +0 -100
  130. package/src/tools/openclaw-workclaw-cron/src/enable/sync.ts +0 -127
  131. package/src/tools/openclaw-workclaw-cron/src/notify/sync.ts +0 -148
  132. package/src/tools/openclaw-workclaw-cron/src/remove/params.ts +0 -109
  133. package/src/tools/openclaw-workclaw-cron/src/remove/sync.ts +0 -127
  134. package/src/tools/openclaw-workclaw-cron/src/update/params.ts +0 -195
  135. package/src/tools/openclaw-workclaw-cron/src/update/sync.ts +0 -161
  136. package/src/tools/openclaw-workclaw-cron/types/index.ts +0 -55
  137. package/src/tools/openclaw-workclaw-cron/utils/index.ts +0 -141
  138. package/src/tools/openclaw-workclaw-system/src/get/index.ts +0 -77
  139. package/src/tools/openclaw-workclaw-system/src/token/index.ts +0 -93
  140. package/tests/accounts.test.ts +0 -285
  141. package/tests/message-context.test.ts +0 -313
  142. package/tests/reconnect.test.ts +0 -257
  143. package/tests/workclaw-client.test.ts +0 -112
  144. package/tsconfig.json +0 -14
  145. package/vitest.config.ts +0 -8
@@ -0,0 +1,207 @@
1
+ import { getWorkclawRuntime } from "../runtime.js";
2
+ function sendJson(res, statusCode, payload) {
3
+ res.statusCode = statusCode;
4
+ res.setHeader("Content-Type", "application/json");
5
+ res.end(JSON.stringify(payload));
6
+ }
7
+ async function readRequestBody(req) {
8
+ const chunks = [];
9
+ await new Promise((resolve, reject) => {
10
+ req.on("data", (chunk) => {
11
+ chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
12
+ });
13
+ req.on("end", () => resolve());
14
+ req.on("error", (err) => reject(err));
15
+ });
16
+ return Buffer.concat(chunks).toString("utf-8");
17
+ }
18
+ /**
19
+ * 构建会话 key
20
+ * 格式: openclaw-workclaw:{accountId}:{userId}
21
+ */
22
+ function buildSessionKey(accountId, userId) {
23
+ return `openclaw-workclaw:${accountId}:${userId}`;
24
+ }
25
+ /**
26
+ * 解析会话 key
27
+ */
28
+ function parseSessionKey(sessionKey) {
29
+ const parts = sessionKey.split(":");
30
+ if (parts.length !== 3 || parts[0] !== "openclaw-workclaw") {
31
+ return null;
32
+ }
33
+ return {
34
+ channel: parts[0],
35
+ accountId: parts[1],
36
+ userId: parts[2],
37
+ };
38
+ }
39
+ /**
40
+ * 重置/开启新会话
41
+ * 通过发送系统事件 /new 到指定会话
42
+ */
43
+ async function resetSession(sessionKey, log) {
44
+ try {
45
+ const runtime = getWorkclawRuntime();
46
+ // 使用 system.enqueueSystemEvent 发送 /new 命令
47
+ runtime.system.enqueueSystemEvent("/new", {
48
+ sessionKey,
49
+ contextKey: null,
50
+ });
51
+ log?.info?.(`[SessionAPI] Sent /new command to session: ${sessionKey}`);
52
+ return {
53
+ success: true,
54
+ message: `Session reset command sent to ${sessionKey}`,
55
+ };
56
+ }
57
+ catch (err) {
58
+ const errorMsg = `Failed to reset session: ${String(err)}`;
59
+ log?.error?.(`[SessionAPI] ${errorMsg}`);
60
+ return { success: false, message: errorMsg };
61
+ }
62
+ }
63
+ /**
64
+ * 获取会话存储路径
65
+ */
66
+ function getSessionStorePath(agentId, log) {
67
+ try {
68
+ const runtime = getWorkclawRuntime();
69
+ const storePath = runtime.channel.session.resolveStorePath(undefined, {
70
+ agentId,
71
+ });
72
+ return storePath;
73
+ }
74
+ catch (err) {
75
+ log?.error?.(`[SessionAPI] Failed to resolve store path: ${String(err)}`);
76
+ return null;
77
+ }
78
+ }
79
+ /**
80
+ * 读取会话最后更新时间
81
+ */
82
+ async function getSessionLastUpdated(sessionKey, log) {
83
+ try {
84
+ const runtime = getWorkclawRuntime();
85
+ const storePath = runtime.channel.session.resolveStorePath();
86
+ const updatedAt = runtime.channel.session.readSessionUpdatedAt({
87
+ storePath,
88
+ sessionKey,
89
+ });
90
+ return updatedAt ?? null;
91
+ }
92
+ catch (err) {
93
+ log?.error?.(`[SessionAPI] Failed to read session updated at: ${String(err)}`);
94
+ return null;
95
+ }
96
+ }
97
+ export function createSessionApiHandler(api) {
98
+ return async (req, res) => {
99
+ const method = String(req.method ?? "GET").toUpperCase();
100
+ const url = new URL(req.url ?? "", "http://localhost");
101
+ // 移除尾部斜杠并获取路径部分
102
+ const fullPath = url.pathname.replace(/\/+$/, "");
103
+ // 提取子路径(去掉 /openclaw-workclaw/sessions 前缀)
104
+ const subPath = fullPath.replace(/^\/openclaw-workclaw\/sessions/, "").replace(/^\//, "") || "/";
105
+ const log = {
106
+ info: (msg) => api.logger?.info?.(`[SessionAPI] ${msg}`),
107
+ error: (msg) => api.logger?.error?.(`[SessionAPI] ${msg}`),
108
+ };
109
+ log?.info?.(`[SessionAPI] ${method} ${fullPath} (subPath: ${subPath})`);
110
+ // GET /sessions 或 /sessions/ - 列出会话信息
111
+ if (method === "GET" && (subPath === "/" || subPath === "")) {
112
+ const sessionKey = url.searchParams.get("sessionKey");
113
+ if (sessionKey) {
114
+ // 获取特定会话信息
115
+ const parsed = parseSessionKey(sessionKey);
116
+ const updatedAt = await getSessionLastUpdated(sessionKey, log);
117
+ sendJson(res, 200, {
118
+ ok: true,
119
+ session: {
120
+ sessionKey,
121
+ parsed,
122
+ lastUpdatedAt: updatedAt,
123
+ lastUpdatedAtFormatted: updatedAt
124
+ ? new Date(updatedAt).toISOString()
125
+ : null,
126
+ },
127
+ });
128
+ return;
129
+ }
130
+ // 返回 API 信息
131
+ sendJson(res, 200, {
132
+ ok: true,
133
+ message: "Session Management API",
134
+ endpoints: {
135
+ "GET /sessions": "获取会话信息 (可选参数: sessionKey)",
136
+ "POST /sessions/reset": "重置/开启新会话 (参数: accountId + userId 或直接提供 sessionKey)",
137
+ "GET /sessions/store-path": "获取会话存储路径 (可选参数: agentId)",
138
+ },
139
+ });
140
+ return;
141
+ }
142
+ // POST /sessions/reset - 重置会话
143
+ if (method === "POST" && subPath === "reset") {
144
+ const raw = await readRequestBody(req);
145
+ let input = {};
146
+ try {
147
+ input = raw ? JSON.parse(raw) : {};
148
+ }
149
+ catch {
150
+ sendJson(res, 400, { ok: false, error: "Invalid JSON" });
151
+ return;
152
+ }
153
+ const { accountId, userId, sessionKey: directSessionKey } = input;
154
+ let sessionKey;
155
+ if (directSessionKey) {
156
+ sessionKey = directSessionKey;
157
+ }
158
+ else if (accountId && userId) {
159
+ sessionKey = buildSessionKey(accountId, userId);
160
+ }
161
+ else {
162
+ sendJson(res, 400, {
163
+ ok: false,
164
+ error: "Missing required fields: either provide 'sessionKey' or both 'accountId' and 'userId'",
165
+ });
166
+ return;
167
+ }
168
+ const result = await resetSession(sessionKey, log);
169
+ if (result.success) {
170
+ sendJson(res, 200, {
171
+ ok: true,
172
+ message: result.message,
173
+ sessionKey,
174
+ });
175
+ }
176
+ else {
177
+ sendJson(res, 500, {
178
+ ok: false,
179
+ error: result.message,
180
+ sessionKey,
181
+ });
182
+ }
183
+ return;
184
+ }
185
+ // GET /sessions/store-path - 获取会话存储路径
186
+ if (method === "GET" && subPath === "store-path") {
187
+ const agentId = url.searchParams.get("agentId") ?? undefined;
188
+ const storePath = getSessionStorePath(agentId, log);
189
+ if (storePath) {
190
+ sendJson(res, 200, {
191
+ ok: true,
192
+ storePath,
193
+ agentId: agentId ?? "default",
194
+ });
195
+ }
196
+ else {
197
+ sendJson(res, 500, {
198
+ ok: false,
199
+ error: "Failed to resolve session store path",
200
+ });
201
+ }
202
+ return;
203
+ }
204
+ // 404
205
+ sendJson(res, 404, { ok: false, error: "Not Found" });
206
+ };
207
+ }
@@ -0,0 +1,2 @@
1
+ import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
2
+ export declare function createSkillsApiHandler(api: OpenClawPluginApi): (req: any, res: any) => Promise<void>;
@@ -0,0 +1,64 @@
1
+ import { exec } from "node:child_process";
2
+ import { promisify } from "node:util";
3
+ const execAsync = promisify(exec);
4
+ function sendJson(res, statusCode, payload) {
5
+ res.statusCode = statusCode;
6
+ res.setHeader("Content-Type", "application/json");
7
+ res.end(JSON.stringify(payload));
8
+ }
9
+ export function createSkillsApiHandler(api) {
10
+ return async (req, res) => {
11
+ const method = String(req.method ?? "GET").toUpperCase();
12
+ if (method === "GET") {
13
+ try {
14
+ // 调用 openclaw skills list 命令
15
+ const { stdout, stderr } = await execAsync("openclaw skills list --json", {
16
+ timeout: 10000, // 10秒超时
17
+ });
18
+ if (stderr && !stdout) {
19
+ api.logger.error(`Skills list error: ${stderr}`);
20
+ sendJson(res, 500, { ok: false, error: "Failed to list skills" });
21
+ return;
22
+ }
23
+ // 尝试解析JSON输出
24
+ let skillsData;
25
+ try {
26
+ skillsData = JSON.parse(stdout);
27
+ }
28
+ catch {
29
+ // 如果不支持--json输出,尝试解析文本输出
30
+ const lines = stdout.split('\n');
31
+ const skills = lines
32
+ .filter((line) => line.trim() && !line.includes('Skills'))
33
+ .map((line) => {
34
+ const parts = line.split(/\s{2,}/).map((p) => p.trim());
35
+ if (parts.length >= 3) {
36
+ return {
37
+ status: parts[0]?.includes('✓') ? 'ready' : 'missing',
38
+ name: parts[1],
39
+ description: parts[2],
40
+ source: parts[3] || 'openclaw-bundled'
41
+ };
42
+ }
43
+ return null;
44
+ })
45
+ .filter((s) => s !== null);
46
+ skillsData = {
47
+ total: skills.length,
48
+ ready: skills.filter((s) => s.status === 'ready').length,
49
+ missing: skills.filter((s) => s.status === 'missing').length,
50
+ skills
51
+ };
52
+ }
53
+ sendJson(res, 200, { ok: true, ...skillsData });
54
+ return;
55
+ }
56
+ catch (error) {
57
+ api.logger.error(`Skills API error: ${error.message}`);
58
+ sendJson(res, 500, { ok: false, error: error.message });
59
+ return;
60
+ }
61
+ }
62
+ sendJson(res, 405, { ok: false, error: "Method Not Allowed" });
63
+ };
64
+ }
@@ -0,0 +1,3 @@
1
+ import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
2
+ export declare function resolveWorkspaceDir(api: OpenClawPluginApi): string;
3
+ export declare function isDefaultWorkspace(api: OpenClawPluginApi): boolean;
@@ -0,0 +1,30 @@
1
+ import os from "node:os";
2
+ import path from "node:path";
3
+ import { getWorkclawLogger } from "../runtime.js";
4
+ export function resolveWorkspaceDir(api) {
5
+ const agents = api.config.agents?.list ?? [];
6
+ const defaultAgent = agents.find((agent) => agent?.default === true) ??
7
+ agents.find((agent) => String(agent?.id ?? "").toLowerCase() === "main");
8
+ const workspaceRaw = (typeof defaultAgent?.workspace === "string" && defaultAgent.workspace.trim()) ||
9
+ (typeof api.config.agents?.defaults?.workspace === "string" &&
10
+ api.config.agents.defaults.workspace.trim());
11
+ getWorkclawLogger().info(`workspaceRaw: ${workspaceRaw}`);
12
+ if (workspaceRaw) {
13
+ return api.resolvePath(workspaceRaw);
14
+ }
15
+ const profile = process.env.OPENCLAW_PROFILE?.trim();
16
+ const suffix = profile && profile.toLowerCase() !== "default" ? `workspace-${profile}` : "workspace";
17
+ return path.join(os.homedir(), ".openclaw", suffix);
18
+ }
19
+ export function isDefaultWorkspace(api) {
20
+ const agents = api.config.agents?.list ?? [];
21
+ const defaultAgent = agents.find((agent) => agent?.default === true) ??
22
+ agents.find((agent) => String(agent?.id ?? "").toLowerCase() === "main");
23
+ const workspaceRaw = (typeof defaultAgent?.workspace === "string" && defaultAgent.workspace.trim()) ||
24
+ (typeof api.config.agents?.defaults?.workspace === "string" &&
25
+ api.config.agents.defaults.workspace.trim());
26
+ if (workspaceRaw)
27
+ return false;
28
+ const profile = process.env.OPENCLAW_PROFILE?.trim();
29
+ return !profile || profile.toLowerCase() === "default";
30
+ }
@@ -0,0 +1,11 @@
1
+ import type { ChannelPlugin } from "openclaw/plugin-sdk";
2
+ import type { ResolvedWorkclawAccount } from "./types.js";
3
+ export declare const workclawDock: {
4
+ id: string;
5
+ capabilities: {
6
+ chatTypes: string[];
7
+ media: boolean;
8
+ blockStreaming: boolean;
9
+ };
10
+ };
11
+ export declare const workclawPlugin: ChannelPlugin<ResolvedWorkclawAccount>;