@myclaw163/clawclaw-cli 0.6.76 → 0.6.77

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 (209) hide show
  1. package/README.md +387 -387
  2. package/bin/clawclaw-cli.mjs +3 -3
  3. package/package.json +48 -48
  4. package/personas//347/220/206/346/231/272/346/270/251/345/222/214.md +23 -23
  5. package/personas//350/200/201/350/260/213/346/267/261/347/256/227.md +22 -22
  6. package/personas//350/257/232/346/201/263/347/233/264/347/216/207.md +22 -22
  7. package/personas//350/275/273/346/235/276/346/264/273/346/263/274.md +22 -22
  8. package/personas//351/207/216/346/200/247/345/217/233/351/200/206.md +23 -23
  9. package/scripts/check-skill-command-surface.mjs +116 -116
  10. package/scripts/find-hide-spots.py +157 -157
  11. package/scripts/postinstall.mjs +20 -20
  12. package/scripts/sync-bundled-skill.mjs +254 -245
  13. package/scripts/sync-bundled-skill.test.mjs +152 -152
  14. package/skills/clawclaw/SKILL.md +248 -248
  15. package/skills/clawclaw/references/CHATTERBOX.md +141 -141
  16. package/skills/clawclaw/references/COMMANDS.md +160 -160
  17. package/skills/clawclaw/references/GAME-MECHANICS.md +188 -188
  18. package/skills/clawclaw/references/HUB.md +48 -48
  19. package/skills/clawclaw/references/KNOWLEDGE.md +42 -42
  20. package/skills/clawclaw/references/STRATEGIES.md +59 -59
  21. package/skills/clawclaw/references/STREAM.md +93 -93
  22. package/skills/clawclaw/references/TACTICS.md +65 -65
  23. package/src/assets/clawclaw-ascii-map.txt +40 -40
  24. package/src/cli.ts +112 -112
  25. package/src/commands/_schema.ts +124 -124
  26. package/src/commands/account.ts +209 -209
  27. package/src/commands/data.test.ts +33 -33
  28. package/src/commands/data.ts +22 -22
  29. package/src/commands/do.test.ts +84 -84
  30. package/src/commands/do.ts +130 -130
  31. package/src/commands/events.test.ts +100 -100
  32. package/src/commands/events.ts +250 -250
  33. package/src/commands/game-map.test.ts +28 -28
  34. package/src/commands/game-start-plan.test.ts +84 -84
  35. package/src/commands/game.ts +1113 -1113
  36. package/src/commands/history-player.test.ts +102 -102
  37. package/src/commands/history.ts +573 -573
  38. package/src/commands/hub.test.ts +96 -96
  39. package/src/commands/hub.ts +234 -234
  40. package/src/commands/knowledge.test.ts +13 -13
  41. package/src/commands/knowledge.ts +139 -139
  42. package/src/commands/load.test.ts +51 -51
  43. package/src/commands/load.ts +13 -13
  44. package/src/commands/meeting-history.test.ts +106 -106
  45. package/src/commands/memory.ts +40 -40
  46. package/src/commands/peek.ts +45 -45
  47. package/src/commands/persona.ts +57 -57
  48. package/src/commands/setup/codex.ts +266 -266
  49. package/src/commands/skill.ts +128 -128
  50. package/src/commands/state.ts +46 -46
  51. package/src/commands/strategy.test.ts +153 -153
  52. package/src/commands/strategy.ts +183 -183
  53. package/src/commands/tts.ts +128 -128
  54. package/src/commands/upgrade.test.ts +82 -82
  55. package/src/commands/upgrade.ts +148 -148
  56. package/src/commands/watch.test.ts +999 -999
  57. package/src/commands/watch.ts +660 -660
  58. package/src/lib/auth.test.ts +86 -86
  59. package/src/lib/auth.ts +223 -223
  60. package/src/lib/command-meta.ts +37 -37
  61. package/src/lib/game-client.ts +403 -403
  62. package/src/lib/game-context.ts +92 -92
  63. package/src/lib/http-keepalive.ts +15 -15
  64. package/src/lib/http-transport.test.ts +42 -42
  65. package/src/lib/http-transport.ts +113 -113
  66. package/src/lib/hub-client.test.ts +56 -56
  67. package/src/lib/hub-client.ts +88 -88
  68. package/src/lib/hub-install.test.ts +98 -98
  69. package/src/lib/hub-install.ts +160 -160
  70. package/src/lib/hub-reminder.ts +78 -78
  71. package/src/lib/hub-unzip.test.ts +69 -69
  72. package/src/lib/hub-unzip.ts +62 -62
  73. package/src/lib/init-command.test.ts +75 -75
  74. package/src/lib/init-command.ts +130 -130
  75. package/src/lib/knowledge-store.test.ts +170 -170
  76. package/src/lib/knowledge-store.ts +369 -369
  77. package/src/lib/load-context.test.ts +52 -52
  78. package/src/lib/load-context.ts +52 -52
  79. package/src/lib/match-state.test.ts +134 -134
  80. package/src/lib/match-state.ts +94 -94
  81. package/src/lib/netease-tts.ts +83 -83
  82. package/src/lib/normalize.ts +42 -42
  83. package/src/lib/persona.test.ts +41 -41
  84. package/src/lib/persona.ts +72 -72
  85. package/src/lib/server-registry.ts +152 -152
  86. package/src/lib/skill-version.test.ts +48 -48
  87. package/src/lib/skill-version.ts +19 -19
  88. package/src/lib/strategy-export.test.ts +240 -240
  89. package/src/lib/strategy-export.ts +247 -247
  90. package/src/lib/tts-keys.ts +7 -7
  91. package/src/lib/tts-speech.test.ts +63 -63
  92. package/src/lib/tts-speech.ts +76 -76
  93. package/src/lib/user-data.test.ts +96 -96
  94. package/src/lib/user-data.ts +400 -400
  95. package/src/lib/workspace-argv.test.ts +49 -49
  96. package/src/lib/workspace-argv.ts +44 -44
  97. package/src/perception/player-history-store.test.ts +87 -87
  98. package/src/perception/player-history-store.ts +194 -194
  99. package/src/pipeline/event-format.test.ts +243 -243
  100. package/src/pipeline/event-format.ts +501 -501
  101. package/src/pipeline/event-hints.ts +195 -195
  102. package/src/pipeline/event-store.test.ts +28 -28
  103. package/src/pipeline/event-store.ts +193 -193
  104. package/src/pipeline/pipeline.ts +35 -35
  105. package/src/pipeline/player-projection.test.ts +168 -168
  106. package/src/pipeline/player-projection.ts +370 -370
  107. package/src/runtime/auto-upgrade.test.ts +66 -66
  108. package/src/runtime/auto-upgrade.ts +31 -31
  109. package/src/runtime/event-daemon.test.ts +209 -209
  110. package/src/runtime/event-daemon.ts +519 -519
  111. package/src/runtime/owner-control.ts +150 -150
  112. package/src/runtime/raw-ws-log.test.ts +33 -33
  113. package/src/runtime/raw-ws-log.ts +32 -32
  114. package/src/runtime/runtime-logger.ts +107 -107
  115. package/src/runtime/ws-client.test.ts +125 -125
  116. package/src/runtime/ws-client.ts +287 -287
  117. package/src/sdk/action.ts +166 -166
  118. package/src/sdk/index.ts +110 -110
  119. package/src/sdk/types.ts +161 -161
  120. package/src/strategies/avoid-lone.ts +12 -12
  121. package/src/strategies/avoid-players.knowledge.md +19 -19
  122. package/src/strategies/avoid-players.ts +16 -16
  123. package/src/strategies/corpse-patrol.ts +23 -23
  124. package/src/strategies/crab-sabotage.ts +22 -22
  125. package/src/strategies/custom-module.test.ts +270 -270
  126. package/src/strategies/find-player.ts +17 -17
  127. package/src/strategies/game-utils.test.ts +242 -242
  128. package/src/strategies/game-utils.ts +846 -846
  129. package/src/strategies/goals/anchor-linger.ts +77 -77
  130. package/src/strategies/goals/avoid-lone-top.ts +168 -168
  131. package/src/strategies/goals/avoid-players-top.test.ts +83 -83
  132. package/src/strategies/goals/avoid-players-top.ts +121 -121
  133. package/src/strategies/goals/conversation-goal.ts +51 -51
  134. package/src/strategies/goals/corpse-patrol-top.ts +113 -113
  135. package/src/strategies/goals/crab-octopus-reflexes.ts +101 -101
  136. package/src/strategies/goals/crab-sabotage-top.ts +197 -197
  137. package/src/strategies/goals/emergency-hunt-goal.ts +28 -28
  138. package/src/strategies/goals/find-player-top.ts +93 -93
  139. package/src/strategies/goals/flee-players-goal.ts +53 -53
  140. package/src/strategies/goals/follow-companion-goal.ts +106 -106
  141. package/src/strategies/goals/goal-manager.ts +41 -41
  142. package/src/strategies/goals/goal-root-strategy.ts +49 -49
  143. package/src/strategies/goals/goal.ts +28 -28
  144. package/src/strategies/goals/hide-top.ts +197 -197
  145. package/src/strategies/goals/keep-away-goal.ts +221 -221
  146. package/src/strategies/goals/kill-frenzy-top.ts +80 -80
  147. package/src/strategies/goals/kill-lone-top.ts +160 -160
  148. package/src/strategies/goals/kill-target-goal.ts +59 -59
  149. package/src/strategies/goals/kill-target-top.ts +109 -109
  150. package/src/strategies/goals/leaf-goal.ts +27 -27
  151. package/src/strategies/goals/linger-corpse-goal.ts +35 -35
  152. package/src/strategies/goals/lone-kill-core.ts +82 -82
  153. package/src/strategies/goals/lone-kill-goal.ts +24 -24
  154. package/src/strategies/goals/lone-kill-task-top.test.ts +85 -85
  155. package/src/strategies/goals/lone-kill-task-top.ts +133 -133
  156. package/src/strategies/goals/move-room-goal.ts +60 -60
  157. package/src/strategies/goals/normal-shrimp-top.test.ts +80 -80
  158. package/src/strategies/goals/normal-shrimp-top.ts +242 -242
  159. package/src/strategies/goals/paradise-fish-top.test.ts +126 -126
  160. package/src/strategies/goals/paradise-fish-top.ts +224 -224
  161. package/src/strategies/goals/patrol-top.ts +57 -57
  162. package/src/strategies/goals/report-patrol-top.ts +80 -80
  163. package/src/strategies/goals/safe-task-goal.ts +102 -102
  164. package/src/strategies/goals/social-task-top.ts +161 -161
  165. package/src/strategies/goals/task-kill-report-top.ts +163 -163
  166. package/src/strategies/goals/task-only-top.ts +57 -57
  167. package/src/strategies/goals/task-or-patrol-goal.ts +41 -41
  168. package/src/strategies/goals/task-report-top.ts +57 -57
  169. package/src/strategies/goals/wander-task-goal.ts +33 -33
  170. package/src/strategies/goals/warrior-shrimp-top.test.ts +87 -87
  171. package/src/strategies/goals/warrior-shrimp-top.ts +267 -267
  172. package/src/strategies/greeting.ts +53 -53
  173. package/src/strategies/hide-spots.ts +59 -59
  174. package/src/strategies/hide.ts +24 -24
  175. package/src/strategies/kill-frenzy.ts +13 -13
  176. package/src/strategies/kill-lone.knowledge.md +17 -17
  177. package/src/strategies/kill-lone.ts +14 -14
  178. package/src/strategies/kill-target.ts +19 -19
  179. package/src/strategies/loader.test.ts +678 -678
  180. package/src/strategies/loader.ts +181 -181
  181. package/src/strategies/lone-kill-task.ts +22 -22
  182. package/src/strategies/meeting-gate.test.ts +59 -59
  183. package/src/strategies/meeting-gate.ts +23 -23
  184. package/src/strategies/move-room.ts +16 -16
  185. package/src/strategies/new-events-backfill.ts +98 -98
  186. package/src/strategies/off-route-points.ts +105 -105
  187. package/src/strategies/paradise-fish.knowledge.md +19 -19
  188. package/src/strategies/paradise-fish.ts +26 -26
  189. package/src/strategies/pathfind/distance-field.ts +150 -150
  190. package/src/strategies/pathfind/escape-planner.test.ts +197 -197
  191. package/src/strategies/pathfind/escape-planner.ts +355 -355
  192. package/src/strategies/pathfind/walkable-grid.ts +117 -117
  193. package/src/strategies/patrol.ts +12 -12
  194. package/src/strategies/player-targets.ts +13 -13
  195. package/src/strategies/report-patrol.ts +12 -12
  196. package/src/strategies/shrimp-memory.knowledge.md +19 -19
  197. package/src/strategies/shrimp-memory.ts +26 -26
  198. package/src/strategies/social-task.test.ts +28 -28
  199. package/src/strategies/social-task.ts +50 -50
  200. package/src/strategies/spawn.ts +82 -82
  201. package/src/strategies/speech-module.ts +123 -123
  202. package/src/strategies/strategy-loop.test.ts +15 -15
  203. package/src/strategies/strategy-loop.ts +776 -776
  204. package/src/strategies/task-kill-report.ts +18 -18
  205. package/src/strategies/task-only.ts +12 -12
  206. package/src/strategies/task-report.ts +23 -23
  207. package/src/strategies/types.ts +109 -109
  208. package/src/strategies/warrior-memory.knowledge.md +21 -21
  209. package/src/strategies/warrior-memory.ts +17 -17
@@ -1,209 +1,209 @@
1
- import { Command, Option } from 'commander';
2
- import { AuthStore } from '../lib/auth.js';
3
- import type { AuthProfile } from '../lib/auth.js';
4
- import { GameClient, ApiError } from '../lib/game-client.js';
5
- import { createProfileDirs, cmdInit } from '../lib/init-command.js';
6
- import { setMeta } from '../lib/command-meta.js';
7
- import { hubReminder, readCachedGamesPlayed, writeGamesPlayedCache } from '../lib/hub-reminder.js';
8
-
9
- const DEFAULT_SERVER_URL = 'https://myclaw.163.com/claw';
10
- const SERVER_URL_ENV = 'CLAWCLAW_SERVER_URL';
11
-
12
- function createClientForProfile(profile: AuthProfile): GameClient {
13
- return new GameClient({
14
- lobbyUrl: profile.serverUrl,
15
- gameServerUrl: profile.gameServerUrl,
16
- apiKey: profile.apiKey,
17
- agentName: profile.agentName,
18
- });
19
- }
20
-
21
- function extractServerAccountName(payload: any): string | undefined {
22
- const data = payload?.data ?? payload;
23
- return data?.agent_name ?? data?.agentName ?? data?.name;
24
- }
25
-
26
- function getRegisterServerUrl(env: NodeJS.ProcessEnv = process.env): string {
27
- const configured = env[SERVER_URL_ENV]?.trim();
28
- return configured || DEFAULT_SERVER_URL;
29
- }
30
-
31
- export function createAccountCommand(): Command {
32
- const account = new Command('account');
33
- account.description('Account management & game data');
34
-
35
- // ─── Auth ───
36
-
37
- account
38
- .command('register')
39
- .description('Register new agent')
40
- .option('-n, --name <name>', 'Agent name (max 16 chars); omit to let the server choose randomly')
41
- .addOption(new Option('-d, --desc <text>', 'Agent description (max 500 chars)').hideHelp())
42
- .option('--invite-code <code>', 'Invite code (required during beta)')
43
- .addOption(new Option('--avatar-url <url>', 'Avatar image URL').hideHelp())
44
- .addOption(new Option('--avatar-file <path>', 'Avatar image file (jpeg/png/gif/webp, max 1MB)').hideHelp())
45
- .action(async (opts: { name?: string; desc?: string; inviteCode?: string; avatarUrl?: string; avatarFile?: string }) => {
46
- const authStore = new AuthStore();
47
- const { created, path: wsPath } = cmdInit();
48
- if (created) console.log(`[ClawClaw] Workspace initialized at ${wsPath}`);
49
- const serverUrl = getRegisterServerUrl();
50
-
51
- const tmpClient = new GameClient({ lobbyUrl: serverUrl, apiKey: '' });
52
- const result = await tmpClient.registerAgent({
53
- name: opts.name,
54
- description: opts.desc,
55
- inviteCode: opts.inviteCode,
56
- avatarUrl: opts.avatarUrl,
57
- avatarFile: opts.avatarFile,
58
- });
59
- const d = result.data ?? result;
60
- const apiKey = d.api_key ?? d.apiKey ?? '';
61
- if (!apiKey) throw new Error('Registration failed: server did not return an API key.');
62
- const agentName = d.agent_name ?? '';
63
- if (!agentName) throw new Error('Registration failed: server did not return an agent name.');
64
-
65
- const profile: AuthProfile = {
66
- agentName,
67
- apiKey,
68
- serverUrl,
69
- };
70
- authStore.addProfile(profile);
71
- try { createProfileDirs(profile); } catch {}
72
- console.log(JSON.stringify({ ...result, message: `Registered and saved as profile "${agentName}"` }, null, 2));
73
- });
74
-
75
- account
76
- .command('rename <name>')
77
- .description('Rename agent (max once/month, max 2/year, not during a game)')
78
- .action(async (newName: string) => {
79
- const authStore = new AuthStore();
80
- const profile = authStore.getActive();
81
- if (!profile) throw new Error('Not logged in.');
82
- const client = GameClient.fromAuth();
83
- const result = await client.renameAgent(newName);
84
- const oldName = profile.agentName;
85
- profile.agentName = newName;
86
- authStore.removeProfile(oldName);
87
- authStore.addProfile(profile);
88
- authStore.switchProfile(newName);
89
- console.log(JSON.stringify({ ...result, message: `Renamed "${oldName}" → "${newName}"` }, null, 2));
90
- });
91
-
92
- account
93
- .command('switch <apiKey>', { hidden: true })
94
- .description('Switch active profile by API key')
95
- .action(async (apiKey: string) => {
96
- const authStore = new AuthStore();
97
- const data = authStore.load();
98
- const profileKey = Object.keys(data.profiles).find(key => data.profiles[key]?.apiKey === apiKey);
99
- if (!profileKey) {
100
- throw new Error(`Profile with apiKey "${apiKey}" not found. Use \`clawclaw-cli account list\` to inspect saved accounts.`);
101
- }
102
- authStore.switchProfile(profileKey);
103
- console.log(JSON.stringify({ message: 'Switched active profile', apiKey }, null, 2));
104
- });
105
-
106
- account
107
- .command('list', { hidden: true })
108
- .description('List all saved profiles with current server names')
109
- .action(async () => {
110
- const authStore = new AuthStore();
111
- const active = authStore.getActive();
112
- const data = authStore.load();
113
- const result = await Promise.all(Object.values(data.profiles).map(async (profile) => {
114
- try {
115
- const me = await createClientForProfile(profile).getMe();
116
- return {
117
- name: extractServerAccountName(me) ?? profile.agentName,
118
- apiKey: profile.apiKey,
119
- active: profile.apiKey === active?.apiKey,
120
- };
121
- } catch {
122
- return {
123
- name: profile.agentName,
124
- apiKey: profile.apiKey,
125
- active: profile.apiKey === active?.apiKey,
126
- };
127
- }
128
- }));
129
- console.log(JSON.stringify(result, null, 2));
130
- });
131
-
132
- // ─── Game Data ───
133
-
134
- account
135
- .command('leaderboard', { hidden: true })
136
- .description('Show leaderboard')
137
- .option('-p, --page <number>', 'Page number')
138
- .option('-l, --limit <number>', 'Items per page (max 100)', '20')
139
- .action(async (opts: { page?: string; limit: string }) => {
140
- const client = GameClient.fromAuth();
141
- const page = opts.page ? Number(opts.page) : undefined;
142
- const result = await client.getLeaderboard(page, Number(opts.limit));
143
- console.log(JSON.stringify(result, null, 2));
144
- });
145
-
146
- account
147
- .command('settlement')
148
- .description('Show settlement data from last game')
149
- .action(async () => {
150
- const client = GameClient.fromAuth();
151
- try {
152
- const result = await client.getSettlement();
153
- // `ccl account settlement` is the last command the agent runs before
154
- // writing the debrief close, and its `data` block is long enough to bury
155
- // the reminder that rode in on the `game_over` push. Re-attach it here as
156
- // the final fields (after `data`) so the nudge is the freshest thing in
157
- // context the moment the agent writes the close.
158
- const reminder = hubReminder(readCachedGamesPlayed());
159
- const out: Record<string, any> = (result && typeof result === 'object' && !Array.isArray(result))
160
- ? { ...result }
161
- : { result };
162
- if (reminder) {
163
- out.hub_reminder = reminder;
164
- out.next_step = `Write the post-game debrief with your user from this settlement, then close out. ${reminder}`;
165
- }
166
- console.log(JSON.stringify(out, null, 2));
167
- } catch (err: any) {
168
- if (err instanceof ApiError && err.body?.includes('NO_SETTLEMENT')) {
169
- console.info('No settlement data yet. The game may still be in progress, or you quit early after dying; you can still give a brief recap from known events so far.');
170
- return;
171
- }
172
- throw err;
173
- }
174
- });
175
-
176
- account
177
- .command('history', { hidden: true })
178
- .description('Show game history')
179
- .option('-p, --page <number>', 'Page number', '1')
180
- .option('-l, --limit <number>', 'Items per page (max 100)', '20')
181
- .action(async (opts: { page: string; limit: string }) => {
182
- const client = GameClient.fromAuth();
183
- const result = await client.getGameHistory(Number(opts.page), Number(opts.limit));
184
- console.log(JSON.stringify(result, null, 2));
185
- });
186
-
187
- account
188
- .command('info')
189
- .description('Print account name, Claw Key, and spectate URL')
190
- .action(async () => {
191
- const authStore = new AuthStore();
192
- const profile = authStore.getActive();
193
- if (!profile) throw new Error('Not logged in.');
194
- const client = GameClient.fromAuth();
195
- const result = await client.getMe();
196
- if (result?.data) delete result.data.tutorial;
197
- const gp = result?.data?.games_played;
198
- if (typeof gp === 'number') writeGamesPlayedCache(gp);
199
- const origin = new URL(profile.serverUrl).origin.replace(/^http:\/\//, 'https://');
200
- const url = `${origin}/lobby?token=${encodeURIComponent(profile.apiKey)}`;
201
- console.log(JSON.stringify({ ...result, clawKey: profile.apiKey, spectateUrl: url }, null, 2));
202
- });
203
-
204
- // ── Adapter metadata (consumed by ccl _schema, applied by openclaw-clawclaw L2 generator) ──
205
- setMeta(account.commands.find((c) => c.name() === 'register')!, { requiresConfirm: true });
206
- setMeta(account.commands.find((c) => c.name() === 'rename')!, { requiresConfirm: true });
207
-
208
- return account;
209
- }
1
+ import { Command, Option } from 'commander';
2
+ import { AuthStore } from '../lib/auth.js';
3
+ import type { AuthProfile } from '../lib/auth.js';
4
+ import { GameClient, ApiError } from '../lib/game-client.js';
5
+ import { createProfileDirs, cmdInit } from '../lib/init-command.js';
6
+ import { setMeta } from '../lib/command-meta.js';
7
+ import { hubReminder, readCachedGamesPlayed, writeGamesPlayedCache } from '../lib/hub-reminder.js';
8
+
9
+ const DEFAULT_SERVER_URL = 'https://myclaw.163.com/claw';
10
+ const SERVER_URL_ENV = 'CLAWCLAW_SERVER_URL';
11
+
12
+ function createClientForProfile(profile: AuthProfile): GameClient {
13
+ return new GameClient({
14
+ lobbyUrl: profile.serverUrl,
15
+ gameServerUrl: profile.gameServerUrl,
16
+ apiKey: profile.apiKey,
17
+ agentName: profile.agentName,
18
+ });
19
+ }
20
+
21
+ function extractServerAccountName(payload: any): string | undefined {
22
+ const data = payload?.data ?? payload;
23
+ return data?.agent_name ?? data?.agentName ?? data?.name;
24
+ }
25
+
26
+ function getRegisterServerUrl(env: NodeJS.ProcessEnv = process.env): string {
27
+ const configured = env[SERVER_URL_ENV]?.trim();
28
+ return configured || DEFAULT_SERVER_URL;
29
+ }
30
+
31
+ export function createAccountCommand(): Command {
32
+ const account = new Command('account');
33
+ account.description('Account management & game data');
34
+
35
+ // ─── Auth ───
36
+
37
+ account
38
+ .command('register')
39
+ .description('Register new agent')
40
+ .option('-n, --name <name>', 'Agent name (max 16 chars); omit to let the server choose randomly')
41
+ .addOption(new Option('-d, --desc <text>', 'Agent description (max 500 chars)').hideHelp())
42
+ .option('--invite-code <code>', 'Invite code (required during beta)')
43
+ .addOption(new Option('--avatar-url <url>', 'Avatar image URL').hideHelp())
44
+ .addOption(new Option('--avatar-file <path>', 'Avatar image file (jpeg/png/gif/webp, max 1MB)').hideHelp())
45
+ .action(async (opts: { name?: string; desc?: string; inviteCode?: string; avatarUrl?: string; avatarFile?: string }) => {
46
+ const authStore = new AuthStore();
47
+ const { created, path: wsPath } = cmdInit();
48
+ if (created) console.log(`[ClawClaw] Workspace initialized at ${wsPath}`);
49
+ const serverUrl = getRegisterServerUrl();
50
+
51
+ const tmpClient = new GameClient({ lobbyUrl: serverUrl, apiKey: '' });
52
+ const result = await tmpClient.registerAgent({
53
+ name: opts.name,
54
+ description: opts.desc,
55
+ inviteCode: opts.inviteCode,
56
+ avatarUrl: opts.avatarUrl,
57
+ avatarFile: opts.avatarFile,
58
+ });
59
+ const d = result.data ?? result;
60
+ const apiKey = d.api_key ?? d.apiKey ?? '';
61
+ if (!apiKey) throw new Error('Registration failed: server did not return an API key.');
62
+ const agentName = d.agent_name ?? '';
63
+ if (!agentName) throw new Error('Registration failed: server did not return an agent name.');
64
+
65
+ const profile: AuthProfile = {
66
+ agentName,
67
+ apiKey,
68
+ serverUrl,
69
+ };
70
+ authStore.addProfile(profile);
71
+ try { createProfileDirs(profile); } catch {}
72
+ console.log(JSON.stringify({ ...result, message: `Registered and saved as profile "${agentName}"` }, null, 2));
73
+ });
74
+
75
+ account
76
+ .command('rename <name>')
77
+ .description('Rename agent (max once/month, max 2/year, not during a game)')
78
+ .action(async (newName: string) => {
79
+ const authStore = new AuthStore();
80
+ const profile = authStore.getActive();
81
+ if (!profile) throw new Error('Not logged in.');
82
+ const client = GameClient.fromAuth();
83
+ const result = await client.renameAgent(newName);
84
+ const oldName = profile.agentName;
85
+ profile.agentName = newName;
86
+ authStore.removeProfile(oldName);
87
+ authStore.addProfile(profile);
88
+ authStore.switchProfile(newName);
89
+ console.log(JSON.stringify({ ...result, message: `Renamed "${oldName}" → "${newName}"` }, null, 2));
90
+ });
91
+
92
+ account
93
+ .command('switch <apiKey>', { hidden: true })
94
+ .description('Switch active profile by API key')
95
+ .action(async (apiKey: string) => {
96
+ const authStore = new AuthStore();
97
+ const data = authStore.load();
98
+ const profileKey = Object.keys(data.profiles).find(key => data.profiles[key]?.apiKey === apiKey);
99
+ if (!profileKey) {
100
+ throw new Error(`Profile with apiKey "${apiKey}" not found. Use \`clawclaw-cli account list\` to inspect saved accounts.`);
101
+ }
102
+ authStore.switchProfile(profileKey);
103
+ console.log(JSON.stringify({ message: 'Switched active profile', apiKey }, null, 2));
104
+ });
105
+
106
+ account
107
+ .command('list', { hidden: true })
108
+ .description('List all saved profiles with current server names')
109
+ .action(async () => {
110
+ const authStore = new AuthStore();
111
+ const active = authStore.getActive();
112
+ const data = authStore.load();
113
+ const result = await Promise.all(Object.values(data.profiles).map(async (profile) => {
114
+ try {
115
+ const me = await createClientForProfile(profile).getMe();
116
+ return {
117
+ name: extractServerAccountName(me) ?? profile.agentName,
118
+ apiKey: profile.apiKey,
119
+ active: profile.apiKey === active?.apiKey,
120
+ };
121
+ } catch {
122
+ return {
123
+ name: profile.agentName,
124
+ apiKey: profile.apiKey,
125
+ active: profile.apiKey === active?.apiKey,
126
+ };
127
+ }
128
+ }));
129
+ console.log(JSON.stringify(result, null, 2));
130
+ });
131
+
132
+ // ─── Game Data ───
133
+
134
+ account
135
+ .command('leaderboard', { hidden: true })
136
+ .description('Show leaderboard')
137
+ .option('-p, --page <number>', 'Page number')
138
+ .option('-l, --limit <number>', 'Items per page (max 100)', '20')
139
+ .action(async (opts: { page?: string; limit: string }) => {
140
+ const client = GameClient.fromAuth();
141
+ const page = opts.page ? Number(opts.page) : undefined;
142
+ const result = await client.getLeaderboard(page, Number(opts.limit));
143
+ console.log(JSON.stringify(result, null, 2));
144
+ });
145
+
146
+ account
147
+ .command('settlement')
148
+ .description('Show settlement data from last game')
149
+ .action(async () => {
150
+ const client = GameClient.fromAuth();
151
+ try {
152
+ const result = await client.getSettlement();
153
+ // `ccl account settlement` is the last command the agent runs before
154
+ // writing the debrief close, and its `data` block is long enough to bury
155
+ // the reminder that rode in on the `game_over` push. Re-attach it here as
156
+ // the final fields (after `data`) so the nudge is the freshest thing in
157
+ // context the moment the agent writes the close.
158
+ const reminder = hubReminder(readCachedGamesPlayed());
159
+ const out: Record<string, any> = (result && typeof result === 'object' && !Array.isArray(result))
160
+ ? { ...result }
161
+ : { result };
162
+ if (reminder) {
163
+ out.hub_reminder = reminder;
164
+ out.next_step = `Write the post-game debrief with your user from this settlement, then close out. ${reminder}`;
165
+ }
166
+ console.log(JSON.stringify(out, null, 2));
167
+ } catch (err: any) {
168
+ if (err instanceof ApiError && err.body?.includes('NO_SETTLEMENT')) {
169
+ console.info('No settlement data yet. The game may still be in progress, or you quit early after dying; you can still give a brief recap from known events so far.');
170
+ return;
171
+ }
172
+ throw err;
173
+ }
174
+ });
175
+
176
+ account
177
+ .command('history', { hidden: true })
178
+ .description('Show game history')
179
+ .option('-p, --page <number>', 'Page number', '1')
180
+ .option('-l, --limit <number>', 'Items per page (max 100)', '20')
181
+ .action(async (opts: { page: string; limit: string }) => {
182
+ const client = GameClient.fromAuth();
183
+ const result = await client.getGameHistory(Number(opts.page), Number(opts.limit));
184
+ console.log(JSON.stringify(result, null, 2));
185
+ });
186
+
187
+ account
188
+ .command('info')
189
+ .description('Print account name, Claw Key, and spectate URL')
190
+ .action(async () => {
191
+ const authStore = new AuthStore();
192
+ const profile = authStore.getActive();
193
+ if (!profile) throw new Error('Not logged in.');
194
+ const client = GameClient.fromAuth();
195
+ const result = await client.getMe();
196
+ if (result?.data) delete result.data.tutorial;
197
+ const gp = result?.data?.games_played;
198
+ if (typeof gp === 'number') writeGamesPlayedCache(gp);
199
+ const origin = new URL(profile.serverUrl).origin.replace(/^http:\/\//, 'https://');
200
+ const url = `${origin}/lobby?token=${encodeURIComponent(profile.apiKey)}`;
201
+ console.log(JSON.stringify({ ...result, clawKey: profile.apiKey, spectateUrl: url }, null, 2));
202
+ });
203
+
204
+ // ── Adapter metadata (consumed by ccl _schema, applied by openclaw-clawclaw L2 generator) ──
205
+ setMeta(account.commands.find((c) => c.name() === 'register')!, { requiresConfirm: true });
206
+ setMeta(account.commands.find((c) => c.name() === 'rename')!, { requiresConfirm: true });
207
+
208
+ return account;
209
+ }
@@ -1,33 +1,33 @@
1
- import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
2
- import { mkdtempSync, rmSync } from 'fs';
3
- import { tmpdir } from 'os';
4
- import { join } from 'path';
5
- import { createDataCommand } from './data.js';
6
-
7
- describe('data command', () => {
8
- let ws: string;
9
- let logs: string[];
10
-
11
- beforeEach(() => {
12
- ws = mkdtempSync(join(tmpdir(), 'ccl-data-cmd-'));
13
- process.env.CLAWCLAW_WORKSPACE_DIR = ws;
14
- logs = [];
15
- vi.spyOn(console, 'log').mockImplementation((...args) => { logs.push(args.join(' ')); });
16
- });
17
-
18
- afterEach(() => {
19
- delete process.env.CLAWCLAW_WORKSPACE_DIR;
20
- vi.restoreAllMocks();
21
- rmSync(ws, { recursive: true, force: true });
22
- });
23
-
24
- it('prints the manual migration user-data path', async () => {
25
- const cmd = createDataCommand();
26
- await cmd.parseAsync(['node', 'ccl', 'path']);
27
-
28
- const out = JSON.parse(logs[0]);
29
- expect(out.path.split('\\').join('/')).toBe(join(ws, 'user-data').split('\\').join('/'));
30
- expect(out.contains_secrets).toBe(true);
31
- expect(out.message).toContain('Zip this folder');
32
- });
33
- });
1
+ import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
2
+ import { mkdtempSync, rmSync } from 'fs';
3
+ import { tmpdir } from 'os';
4
+ import { join } from 'path';
5
+ import { createDataCommand } from './data.js';
6
+
7
+ describe('data command', () => {
8
+ let ws: string;
9
+ let logs: string[];
10
+
11
+ beforeEach(() => {
12
+ ws = mkdtempSync(join(tmpdir(), 'ccl-data-cmd-'));
13
+ process.env.CLAWCLAW_WORKSPACE_DIR = ws;
14
+ logs = [];
15
+ vi.spyOn(console, 'log').mockImplementation((...args) => { logs.push(args.join(' ')); });
16
+ });
17
+
18
+ afterEach(() => {
19
+ delete process.env.CLAWCLAW_WORKSPACE_DIR;
20
+ vi.restoreAllMocks();
21
+ rmSync(ws, { recursive: true, force: true });
22
+ });
23
+
24
+ it('prints the manual migration user-data path', async () => {
25
+ const cmd = createDataCommand();
26
+ await cmd.parseAsync(['node', 'ccl', 'path']);
27
+
28
+ const out = JSON.parse(logs[0]);
29
+ expect(out.path.split('\\').join('/')).toBe(join(ws, 'user-data').split('\\').join('/'));
30
+ expect(out.contains_secrets).toBe(true);
31
+ expect(out.message).toContain('Zip this folder');
32
+ });
33
+ });
@@ -1,22 +1,22 @@
1
- import { Command } from 'commander';
2
- import { getWorkspaceDir } from '../lib/init-command.js';
3
- import { ensureUserDataLayout, getUserDataDir } from '../lib/user-data.js';
4
-
5
- export function createDataCommand(): Command {
6
- const cmd = new Command('data')
7
- .description('Show local ClawClaw user-data paths');
8
-
9
- cmd.command('path')
10
- .description('Print the user-data directory for manual migration')
11
- .action(() => {
12
- const workspaceDir = getWorkspaceDir();
13
- ensureUserDataLayout(workspaceDir);
14
- console.log(JSON.stringify({
15
- path: getUserDataDir(workspaceDir),
16
- contains_secrets: true,
17
- message: 'Zip this folder to move ClawClaw user data to another terminal. It contains account keys, TTS keys, persona, memory, and user strategies.',
18
- }, null, 2));
19
- });
20
-
21
- return cmd;
22
- }
1
+ import { Command } from 'commander';
2
+ import { getWorkspaceDir } from '../lib/init-command.js';
3
+ import { ensureUserDataLayout, getUserDataDir } from '../lib/user-data.js';
4
+
5
+ export function createDataCommand(): Command {
6
+ const cmd = new Command('data')
7
+ .description('Show local ClawClaw user-data paths');
8
+
9
+ cmd.command('path')
10
+ .description('Print the user-data directory for manual migration')
11
+ .action(() => {
12
+ const workspaceDir = getWorkspaceDir();
13
+ ensureUserDataLayout(workspaceDir);
14
+ console.log(JSON.stringify({
15
+ path: getUserDataDir(workspaceDir),
16
+ contains_secrets: true,
17
+ message: 'Zip this folder to move ClawClaw user data to another terminal. It contains account keys, TTS keys, persona, memory, and user strategies.',
18
+ }, null, 2));
19
+ });
20
+
21
+ return cmd;
22
+ }