@myclaw163/clawclaw-cli 0.6.56 → 0.6.57

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 (189) hide show
  1. package/README.md +440 -440
  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/postinstall.mjs +20 -20
  10. package/scripts/sync-bundled-skill.mjs +245 -245
  11. package/scripts/sync-bundled-skill.test.mjs +152 -152
  12. package/skills/clawclaw/SKILL.md +244 -240
  13. package/skills/clawclaw/references/CHATTERBOX.md +142 -142
  14. package/skills/clawclaw/references/COMMANDS.md +132 -132
  15. package/skills/clawclaw/references/GAME-MECHANICS.md +186 -186
  16. package/skills/clawclaw/references/HUB.md +48 -48
  17. package/skills/clawclaw/references/KNOWLEDGE.md +43 -43
  18. package/skills/clawclaw/references/STRATEGIES.md +57 -57
  19. package/skills/clawclaw/references/STREAM.md +59 -58
  20. package/skills/clawclaw/references/TACTICS.md +65 -65
  21. package/src/assets/clawclaw-ascii-map.txt +40 -40
  22. package/src/cli.ts +110 -153
  23. package/src/commands/_schema.ts +109 -109
  24. package/src/commands/account.ts +209 -209
  25. package/src/commands/do.test.ts +37 -37
  26. package/src/commands/do.ts +95 -95
  27. package/src/commands/events.ts +22 -22
  28. package/src/commands/game-map.test.ts +28 -28
  29. package/src/commands/game-start-plan.test.ts +84 -142
  30. package/src/commands/game.ts +1027 -882
  31. package/src/commands/history-player.test.ts +102 -102
  32. package/src/commands/history.ts +573 -573
  33. package/src/commands/hub.test.ts +96 -96
  34. package/src/commands/hub.ts +234 -234
  35. package/src/commands/knowledge.test.ts +19 -19
  36. package/src/commands/knowledge.ts +168 -168
  37. package/src/commands/load.test.ts +51 -51
  38. package/src/commands/load.ts +13 -13
  39. package/src/commands/meeting-history.test.ts +106 -106
  40. package/src/commands/memory.ts +40 -40
  41. package/src/commands/peek.ts +45 -38
  42. package/src/commands/persona.ts +57 -57
  43. package/src/commands/skill.ts +128 -128
  44. package/src/commands/state.ts +46 -46
  45. package/src/commands/strategy.test.ts +135 -135
  46. package/src/commands/strategy.ts +180 -189
  47. package/src/commands/tts.ts +128 -128
  48. package/src/commands/upgrade.test.ts +82 -82
  49. package/src/commands/upgrade.ts +148 -148
  50. package/src/commands/watch.test.ts +969 -973
  51. package/src/commands/watch.ts +720 -709
  52. package/src/lib/auth.test.ts +59 -59
  53. package/src/lib/auth.ts +186 -186
  54. package/src/lib/command-meta.ts +37 -37
  55. package/src/lib/game-client.ts +391 -391
  56. package/src/lib/http-keepalive.ts +15 -15
  57. package/src/lib/http-transport.test.ts +42 -42
  58. package/src/lib/http-transport.ts +113 -113
  59. package/src/lib/hub-client.test.ts +56 -56
  60. package/src/lib/hub-client.ts +88 -88
  61. package/src/lib/hub-install.test.ts +98 -98
  62. package/src/lib/hub-install.ts +121 -121
  63. package/src/lib/hub-reminder.ts +75 -75
  64. package/src/lib/hub-unzip.test.ts +69 -69
  65. package/src/lib/hub-unzip.ts +62 -62
  66. package/src/lib/init-command.test.ts +75 -75
  67. package/src/lib/init-command.ts +120 -120
  68. package/src/lib/knowledge-store.test.ts +180 -180
  69. package/src/lib/knowledge-store.ts +374 -374
  70. package/src/lib/load-context.test.ts +52 -52
  71. package/src/lib/load-context.ts +52 -52
  72. package/src/lib/match-state.test.ts +134 -134
  73. package/src/lib/match-state.ts +94 -94
  74. package/src/lib/netease-tts.ts +83 -83
  75. package/src/lib/normalize.ts +42 -42
  76. package/src/lib/persona.test.ts +41 -41
  77. package/src/lib/persona.ts +72 -72
  78. package/src/lib/server-registry.ts +152 -152
  79. package/src/lib/skill-version.test.ts +48 -48
  80. package/src/lib/skill-version.ts +19 -19
  81. package/src/lib/strategy-export.test.ts +232 -232
  82. package/src/lib/strategy-export.ts +242 -242
  83. package/src/lib/tts-keys.ts +7 -7
  84. package/src/lib/tts-speech.test.ts +63 -63
  85. package/src/lib/tts-speech.ts +76 -76
  86. package/src/lib/workspace-argv.test.ts +49 -49
  87. package/src/lib/workspace-argv.ts +44 -44
  88. package/src/perception/player-history-store.test.ts +87 -87
  89. package/src/perception/player-history-store.ts +194 -194
  90. package/src/pipeline/event-store.ts +124 -124
  91. package/src/pipeline/pipeline.ts +35 -35
  92. package/src/runtime/auto-upgrade.test.ts +66 -66
  93. package/src/runtime/auto-upgrade.ts +31 -31
  94. package/src/runtime/event-daemon.test.ts +107 -28
  95. package/src/runtime/event-daemon.ts +409 -371
  96. package/src/runtime/owner-control.ts +150 -0
  97. package/src/runtime/raw-ws-log.test.ts +33 -33
  98. package/src/runtime/raw-ws-log.ts +32 -32
  99. package/src/runtime/runtime-logger.ts +107 -99
  100. package/src/runtime/ws-client.test.ts +104 -47
  101. package/src/runtime/ws-client.ts +272 -272
  102. package/src/sdk/action.ts +166 -166
  103. package/src/sdk/index.ts +110 -110
  104. package/src/sdk/types.ts +146 -146
  105. package/src/strategies/avoid-lone.ts +11 -11
  106. package/src/strategies/avoid-players.knowledge.md +20 -20
  107. package/src/strategies/avoid-players.ts +15 -15
  108. package/src/strategies/corpse-patrol.ts +22 -22
  109. package/src/strategies/crab-sabotage.ts +21 -21
  110. package/src/strategies/custom-module.test.ts +269 -269
  111. package/src/strategies/find-player.ts +16 -16
  112. package/src/strategies/game-utils.test.ts +164 -164
  113. package/src/strategies/game-utils.ts +737 -721
  114. package/src/strategies/goals/avoid-lone-top.ts +168 -168
  115. package/src/strategies/goals/avoid-players-top.test.ts +83 -83
  116. package/src/strategies/goals/avoid-players-top.ts +121 -121
  117. package/src/strategies/goals/conversation-goal.ts +51 -51
  118. package/src/strategies/goals/corpse-patrol-top.ts +91 -91
  119. package/src/strategies/goals/crab-octopus-reflexes.ts +93 -93
  120. package/src/strategies/goals/crab-sabotage-top.ts +197 -197
  121. package/src/strategies/goals/emergency-hunt-goal.ts +28 -28
  122. package/src/strategies/goals/find-player-top.ts +93 -93
  123. package/src/strategies/goals/flee-players-goal.ts +53 -53
  124. package/src/strategies/goals/goal-manager.ts +41 -41
  125. package/src/strategies/goals/goal-root-strategy.ts +49 -49
  126. package/src/strategies/goals/goal.ts +28 -28
  127. package/src/strategies/goals/keep-away-goal.ts +206 -206
  128. package/src/strategies/goals/kill-frenzy-top.ts +80 -80
  129. package/src/strategies/goals/kill-lone-top.ts +160 -160
  130. package/src/strategies/goals/kill-target-goal.ts +59 -59
  131. package/src/strategies/goals/kill-target-top.ts +109 -109
  132. package/src/strategies/goals/leaf-goal.ts +25 -25
  133. package/src/strategies/goals/linger-corpse-goal.ts +79 -79
  134. package/src/strategies/goals/lone-kill-core.ts +82 -82
  135. package/src/strategies/goals/lone-kill-goal.ts +24 -24
  136. package/src/strategies/goals/lone-kill-task-top.test.ts +85 -85
  137. package/src/strategies/goals/lone-kill-task-top.ts +86 -86
  138. package/src/strategies/goals/move-room-goal.ts +60 -60
  139. package/src/strategies/goals/normal-shrimp-top.test.ts +80 -80
  140. package/src/strategies/goals/normal-shrimp-top.ts +242 -242
  141. package/src/strategies/goals/paradise-fish-top.test.ts +126 -126
  142. package/src/strategies/goals/paradise-fish-top.ts +219 -219
  143. package/src/strategies/goals/patrol-top.ts +57 -57
  144. package/src/strategies/goals/report-patrol-top.ts +80 -80
  145. package/src/strategies/goals/safe-task-goal.ts +102 -102
  146. package/src/strategies/goals/social-task-top.ts +161 -161
  147. package/src/strategies/goals/task-kill-report-top.ts +163 -163
  148. package/src/strategies/goals/task-only-top.ts +57 -57
  149. package/src/strategies/goals/task-or-patrol-goal.ts +41 -41
  150. package/src/strategies/goals/task-report-top.ts +57 -57
  151. package/src/strategies/goals/wander-task-goal.ts +33 -33
  152. package/src/strategies/goals/warrior-shrimp-top.test.ts +86 -86
  153. package/src/strategies/goals/warrior-shrimp-top.ts +248 -248
  154. package/src/strategies/greeting.ts +53 -53
  155. package/src/strategies/kill-frenzy.ts +12 -12
  156. package/src/strategies/kill-lone.knowledge.md +20 -20
  157. package/src/strategies/kill-lone.ts +13 -13
  158. package/src/strategies/kill-target.ts +18 -18
  159. package/src/strategies/loader.test.ts +678 -678
  160. package/src/strategies/loader.ts +172 -172
  161. package/src/strategies/lone-kill-task.ts +21 -21
  162. package/src/strategies/meeting-gate.test.ts +59 -59
  163. package/src/strategies/meeting-gate.ts +23 -23
  164. package/src/strategies/move-room.ts +15 -15
  165. package/src/strategies/new-events-backfill.ts +98 -98
  166. package/src/strategies/paradise-fish.knowledge.md +20 -20
  167. package/src/strategies/paradise-fish.ts +25 -25
  168. package/src/strategies/pathfind/distance-field.ts +150 -150
  169. package/src/strategies/pathfind/escape-planner.test.ts +197 -197
  170. package/src/strategies/pathfind/escape-planner.ts +348 -348
  171. package/src/strategies/pathfind/walkable-grid.ts +117 -117
  172. package/src/strategies/patrol.ts +11 -11
  173. package/src/strategies/player-targets.ts +13 -13
  174. package/src/strategies/report-patrol.ts +11 -11
  175. package/src/strategies/shrimp-memory.knowledge.md +20 -20
  176. package/src/strategies/shrimp-memory.ts +25 -25
  177. package/src/strategies/social-task.test.ts +28 -28
  178. package/src/strategies/social-task.ts +49 -49
  179. package/src/strategies/spawn.ts +82 -71
  180. package/src/strategies/speech-module.ts +123 -123
  181. package/src/strategies/strategy-loop.ts +763 -757
  182. package/src/strategies/task-kill-report.ts +17 -17
  183. package/src/strategies/task-only.ts +11 -11
  184. package/src/strategies/task-report.ts +22 -22
  185. package/src/strategies/types.ts +96 -96
  186. package/src/strategies/warrior-memory.knowledge.md +20 -20
  187. package/src/strategies/warrior-memory.ts +16 -16
  188. package/src/runtime/daemon.ts +0 -100
  189. package/src/runtime/opening-mover.ts +0 -303
@@ -1,209 +1,209 @@
1
- import { Command } 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
- .option('-d, --desc <text>', 'Agent description (max 500 chars)')
42
- .option('--invite-code <code>', 'Invite code (required during beta)')
43
- .option('--avatar-url <url>', 'Avatar image URL')
44
- .option('--avatar-file <path>', 'Avatar image file (jpeg/png/gif/webp, max 1MB)')
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>')
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')
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')
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')
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 } 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
+ .option('-d, --desc <text>', 'Agent description (max 500 chars)')
42
+ .option('--invite-code <code>', 'Invite code (required during beta)')
43
+ .option('--avatar-url <url>', 'Avatar image URL')
44
+ .option('--avatar-file <path>', 'Avatar image file (jpeg/png/gif/webp, max 1MB)')
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>')
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')
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')
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')
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,37 +1,37 @@
1
- import { describe, expect, it } from 'vitest';
2
- import { normalizeDoOptions, parseIntents } from './do.js';
3
-
4
- describe('normalizeDoOptions', () => {
5
- it('joins unquoted speech words passed as extra arguments', () => {
6
- expect(normalizeDoOptions({ speech: 'I' }, ['saw', 'player3']).speech).toBe('I saw player3');
7
- });
8
-
9
- it('leaves extra args alone when there is no speech option', () => {
10
- expect(normalizeDoOptions({}, ['unused'])).toEqual({});
11
- });
12
- });
13
-
14
- describe('parseIntents', () => {
15
- it('builds speech intents', () => {
16
- const action = parseIntents({ speech: 'hi' })[0].build().toJSON();
17
- expect(action).toMatchObject({ action: 'speech', text: 'hi' });
18
- });
19
-
20
- it('includes audio_url when url is provided', () => {
21
- const action = parseIntents({ speech: 'hi', url: 'https://cdn.example.com/a.mp3' })[0].build().toJSON();
22
- expect(action).toMatchObject({
23
- action: 'speech',
24
- text: 'hi',
25
- audio_url: 'https://cdn.example.com/a.mp3',
26
- });
27
- });
28
-
29
- it('builds vote intents', () => {
30
- const action = parseIntents({ vote: 'player1' })[0].build().toJSON();
31
- expect(action).toMatchObject({ action: 'vote', target: 'player1' });
32
- });
33
-
34
- it('ignores removed direct-control options', () => {
35
- expect(parseIntents({ move: '2424,237', task: true, kill: 'p1', report: true, alarm: true })).toEqual([]);
36
- });
37
- });
1
+ import { describe, expect, it } from 'vitest';
2
+ import { normalizeDoOptions, parseIntents } from './do.js';
3
+
4
+ describe('normalizeDoOptions', () => {
5
+ it('joins unquoted speech words passed as extra arguments', () => {
6
+ expect(normalizeDoOptions({ speech: 'I' }, ['saw', 'player3']).speech).toBe('I saw player3');
7
+ });
8
+
9
+ it('leaves extra args alone when there is no speech option', () => {
10
+ expect(normalizeDoOptions({}, ['unused'])).toEqual({});
11
+ });
12
+ });
13
+
14
+ describe('parseIntents', () => {
15
+ it('builds speech intents', () => {
16
+ const action = parseIntents({ speech: 'hi' })[0].build().toJSON();
17
+ expect(action).toMatchObject({ action: 'speech', text: 'hi' });
18
+ });
19
+
20
+ it('includes audio_url when url is provided', () => {
21
+ const action = parseIntents({ speech: 'hi', url: 'https://cdn.example.com/a.mp3' })[0].build().toJSON();
22
+ expect(action).toMatchObject({
23
+ action: 'speech',
24
+ text: 'hi',
25
+ audio_url: 'https://cdn.example.com/a.mp3',
26
+ });
27
+ });
28
+
29
+ it('builds vote intents', () => {
30
+ const action = parseIntents({ vote: 'player1' })[0].build().toJSON();
31
+ expect(action).toMatchObject({ action: 'vote', target: 'player1' });
32
+ });
33
+
34
+ it('ignores removed direct-control options', () => {
35
+ expect(parseIntents({ move: '2424,237', task: true, kill: 'p1', report: true, alarm: true })).toEqual([]);
36
+ });
37
+ });