@myclaw163/clawclaw-cli 0.6.66 → 0.6.67

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 (199) hide show
  1. package/README.md +427 -427
  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/find-hide-spots.py +157 -157
  10. package/scripts/postinstall.mjs +20 -20
  11. package/scripts/sync-bundled-skill.mjs +245 -245
  12. package/scripts/sync-bundled-skill.test.mjs +152 -152
  13. package/skills/clawclaw/SKILL.md +244 -245
  14. package/skills/clawclaw/references/CHATTERBOX.md +142 -142
  15. package/skills/clawclaw/references/COMMANDS.md +148 -148
  16. package/skills/clawclaw/references/GAME-MECHANICS.md +188 -188
  17. package/skills/clawclaw/references/HUB.md +48 -48
  18. package/skills/clawclaw/references/KNOWLEDGE.md +43 -43
  19. package/skills/clawclaw/references/STRATEGIES.md +57 -57
  20. package/skills/clawclaw/references/STREAM.md +91 -92
  21. package/skills/clawclaw/references/TACTICS.md +65 -65
  22. package/src/assets/clawclaw-ascii-map.txt +40 -40
  23. package/src/cli.ts +110 -110
  24. package/src/commands/_schema.ts +109 -109
  25. package/src/commands/account.ts +209 -209
  26. package/src/commands/do.test.ts +73 -73
  27. package/src/commands/do.ts +126 -126
  28. package/src/commands/events.test.ts +71 -71
  29. package/src/commands/events.ts +155 -155
  30. package/src/commands/game-map.test.ts +28 -28
  31. package/src/commands/game-start-plan.test.ts +84 -84
  32. package/src/commands/game.ts +1027 -1027
  33. package/src/commands/history-player.test.ts +102 -102
  34. package/src/commands/history.ts +573 -573
  35. package/src/commands/hub.test.ts +96 -96
  36. package/src/commands/hub.ts +234 -234
  37. package/src/commands/knowledge.test.ts +19 -19
  38. package/src/commands/knowledge.ts +168 -168
  39. package/src/commands/load.test.ts +51 -51
  40. package/src/commands/load.ts +13 -13
  41. package/src/commands/meeting-history.test.ts +106 -106
  42. package/src/commands/memory.ts +40 -40
  43. package/src/commands/peek.ts +45 -45
  44. package/src/commands/persona.ts +57 -57
  45. package/src/commands/setup/codex.ts +266 -248
  46. package/src/commands/skill.ts +128 -128
  47. package/src/commands/state.ts +46 -46
  48. package/src/commands/strategy.test.ts +135 -135
  49. package/src/commands/strategy.ts +180 -180
  50. package/src/commands/tts.ts +128 -128
  51. package/src/commands/upgrade.test.ts +82 -82
  52. package/src/commands/upgrade.ts +148 -148
  53. package/src/commands/watch.test.ts +966 -966
  54. package/src/commands/watch.ts +659 -659
  55. package/src/lib/auth.test.ts +59 -59
  56. package/src/lib/auth.ts +186 -186
  57. package/src/lib/command-meta.ts +37 -37
  58. package/src/lib/game-client.ts +391 -391
  59. package/src/lib/http-keepalive.ts +15 -15
  60. package/src/lib/http-transport.test.ts +42 -42
  61. package/src/lib/http-transport.ts +113 -113
  62. package/src/lib/hub-client.test.ts +56 -56
  63. package/src/lib/hub-client.ts +88 -88
  64. package/src/lib/hub-install.test.ts +98 -98
  65. package/src/lib/hub-install.ts +121 -121
  66. package/src/lib/hub-reminder.ts +75 -75
  67. package/src/lib/hub-unzip.test.ts +69 -69
  68. package/src/lib/hub-unzip.ts +62 -62
  69. package/src/lib/init-command.test.ts +75 -75
  70. package/src/lib/init-command.ts +120 -120
  71. package/src/lib/knowledge-store.test.ts +180 -180
  72. package/src/lib/knowledge-store.ts +374 -374
  73. package/src/lib/load-context.test.ts +52 -52
  74. package/src/lib/load-context.ts +52 -52
  75. package/src/lib/match-state.test.ts +134 -134
  76. package/src/lib/match-state.ts +94 -94
  77. package/src/lib/netease-tts.ts +83 -83
  78. package/src/lib/normalize.ts +42 -42
  79. package/src/lib/persona.test.ts +41 -41
  80. package/src/lib/persona.ts +72 -72
  81. package/src/lib/server-registry.ts +152 -152
  82. package/src/lib/skill-version.test.ts +48 -48
  83. package/src/lib/skill-version.ts +19 -19
  84. package/src/lib/strategy-export.test.ts +232 -232
  85. package/src/lib/strategy-export.ts +242 -242
  86. package/src/lib/tts-keys.ts +7 -7
  87. package/src/lib/tts-speech.test.ts +63 -63
  88. package/src/lib/tts-speech.ts +76 -76
  89. package/src/lib/workspace-argv.test.ts +49 -49
  90. package/src/lib/workspace-argv.ts +44 -44
  91. package/src/perception/player-history-store.test.ts +87 -87
  92. package/src/perception/player-history-store.ts +194 -194
  93. package/src/pipeline/event-format.test.ts +135 -135
  94. package/src/pipeline/event-format.ts +376 -376
  95. package/src/pipeline/event-hints.ts +173 -173
  96. package/src/pipeline/event-store.test.ts +28 -28
  97. package/src/pipeline/event-store.ts +193 -193
  98. package/src/pipeline/pipeline.ts +35 -35
  99. package/src/runtime/auto-upgrade.test.ts +66 -66
  100. package/src/runtime/auto-upgrade.ts +31 -31
  101. package/src/runtime/event-daemon.test.ts +107 -107
  102. package/src/runtime/event-daemon.ts +409 -409
  103. package/src/runtime/owner-control.ts +150 -150
  104. package/src/runtime/raw-ws-log.test.ts +33 -33
  105. package/src/runtime/raw-ws-log.ts +32 -32
  106. package/src/runtime/runtime-logger.ts +107 -107
  107. package/src/runtime/ws-client.test.ts +104 -104
  108. package/src/runtime/ws-client.ts +272 -272
  109. package/src/sdk/action.ts +166 -166
  110. package/src/sdk/index.ts +111 -111
  111. package/src/sdk/types.ts +159 -159
  112. package/src/strategies/avoid-lone.ts +11 -11
  113. package/src/strategies/avoid-players.knowledge.md +20 -20
  114. package/src/strategies/avoid-players.ts +15 -15
  115. package/src/strategies/corpse-patrol.ts +22 -22
  116. package/src/strategies/crab-sabotage.ts +21 -21
  117. package/src/strategies/custom-module.test.ts +269 -269
  118. package/src/strategies/find-player.ts +16 -16
  119. package/src/strategies/game-utils.test.ts +190 -190
  120. package/src/strategies/game-utils.ts +782 -782
  121. package/src/strategies/goals/anchor-linger.ts +77 -77
  122. package/src/strategies/goals/avoid-lone-top.ts +168 -168
  123. package/src/strategies/goals/avoid-players-top.test.ts +83 -83
  124. package/src/strategies/goals/avoid-players-top.ts +121 -121
  125. package/src/strategies/goals/conversation-goal.ts +51 -51
  126. package/src/strategies/goals/corpse-patrol-top.ts +91 -91
  127. package/src/strategies/goals/crab-octopus-reflexes.ts +93 -93
  128. package/src/strategies/goals/crab-sabotage-top.ts +197 -197
  129. package/src/strategies/goals/emergency-hunt-goal.ts +28 -28
  130. package/src/strategies/goals/find-player-top.ts +93 -93
  131. package/src/strategies/goals/flee-players-goal.ts +53 -53
  132. package/src/strategies/goals/follow-companion-goal.ts +106 -106
  133. package/src/strategies/goals/goal-manager.ts +41 -41
  134. package/src/strategies/goals/goal-root-strategy.ts +49 -49
  135. package/src/strategies/goals/goal.ts +28 -28
  136. package/src/strategies/goals/hide-top.ts +197 -197
  137. package/src/strategies/goals/keep-away-goal.ts +217 -217
  138. package/src/strategies/goals/kill-frenzy-top.ts +80 -80
  139. package/src/strategies/goals/kill-lone-top.ts +160 -160
  140. package/src/strategies/goals/kill-target-goal.ts +59 -59
  141. package/src/strategies/goals/kill-target-top.ts +109 -109
  142. package/src/strategies/goals/leaf-goal.ts +25 -25
  143. package/src/strategies/goals/linger-corpse-goal.ts +35 -35
  144. package/src/strategies/goals/lone-kill-core.ts +82 -82
  145. package/src/strategies/goals/lone-kill-goal.ts +24 -24
  146. package/src/strategies/goals/lone-kill-task-top.test.ts +85 -85
  147. package/src/strategies/goals/lone-kill-task-top.ts +86 -86
  148. package/src/strategies/goals/move-room-goal.ts +60 -60
  149. package/src/strategies/goals/normal-shrimp-top.test.ts +80 -80
  150. package/src/strategies/goals/normal-shrimp-top.ts +242 -242
  151. package/src/strategies/goals/paradise-fish-top.test.ts +126 -126
  152. package/src/strategies/goals/paradise-fish-top.ts +207 -207
  153. package/src/strategies/goals/patrol-top.ts +57 -57
  154. package/src/strategies/goals/report-patrol-top.ts +80 -80
  155. package/src/strategies/goals/safe-task-goal.ts +102 -102
  156. package/src/strategies/goals/social-task-top.ts +161 -161
  157. package/src/strategies/goals/task-kill-report-top.ts +163 -163
  158. package/src/strategies/goals/task-only-top.ts +57 -57
  159. package/src/strategies/goals/task-or-patrol-goal.ts +41 -41
  160. package/src/strategies/goals/task-report-top.ts +57 -57
  161. package/src/strategies/goals/wander-task-goal.ts +33 -33
  162. package/src/strategies/goals/warrior-shrimp-top.test.ts +86 -86
  163. package/src/strategies/goals/warrior-shrimp-top.ts +500 -500
  164. package/src/strategies/greeting.ts +53 -53
  165. package/src/strategies/hide-spots.ts +123 -123
  166. package/src/strategies/hide.ts +23 -23
  167. package/src/strategies/kill-frenzy.ts +12 -12
  168. package/src/strategies/kill-lone.knowledge.md +20 -20
  169. package/src/strategies/kill-lone.ts +13 -13
  170. package/src/strategies/kill-target.ts +18 -18
  171. package/src/strategies/loader.test.ts +678 -678
  172. package/src/strategies/loader.ts +172 -172
  173. package/src/strategies/lone-kill-task.ts +21 -21
  174. package/src/strategies/meeting-gate.test.ts +59 -59
  175. package/src/strategies/meeting-gate.ts +23 -23
  176. package/src/strategies/move-room.ts +15 -15
  177. package/src/strategies/new-events-backfill.ts +98 -98
  178. package/src/strategies/paradise-fish.knowledge.md +20 -20
  179. package/src/strategies/paradise-fish.ts +25 -25
  180. package/src/strategies/pathfind/distance-field.ts +150 -150
  181. package/src/strategies/pathfind/escape-planner.test.ts +197 -197
  182. package/src/strategies/pathfind/escape-planner.ts +355 -355
  183. package/src/strategies/pathfind/walkable-grid.ts +117 -117
  184. package/src/strategies/patrol.ts +11 -11
  185. package/src/strategies/player-targets.ts +13 -13
  186. package/src/strategies/report-patrol.ts +11 -11
  187. package/src/strategies/shrimp-memory.knowledge.md +20 -20
  188. package/src/strategies/shrimp-memory.ts +25 -25
  189. package/src/strategies/social-task.test.ts +28 -28
  190. package/src/strategies/social-task.ts +49 -49
  191. package/src/strategies/spawn.ts +82 -82
  192. package/src/strategies/speech-module.ts +123 -123
  193. package/src/strategies/strategy-loop.ts +771 -771
  194. package/src/strategies/task-kill-report.ts +17 -17
  195. package/src/strategies/task-only.ts +11 -11
  196. package/src/strategies/task-report.ts +22 -22
  197. package/src/strategies/types.ts +102 -102
  198. package/src/strategies/warrior-memory.knowledge.md +22 -22
  199. package/src/strategies/warrior-memory.ts +16 -16
@@ -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,73 +1,73 @@
1
- import { describe, expect, it, vi } from 'vitest';
2
- import { audioContentTypeFor, normalizeDoOptions, parseIntents, resolveSpeechAudioUrl } from './do.js';
3
-
4
- vi.mock('../lib/tts-speech.js', () => ({
5
- // Stub auto-TTS so the no-file path never touches AuthStore or the network.
6
- maybeSynthesizeSpeechAudioUrl: vi.fn().mockResolvedValue(undefined),
7
- }));
8
-
9
- describe('normalizeDoOptions', () => {
10
- it('joins unquoted speech words passed as extra arguments', () => {
11
- expect(normalizeDoOptions({ speech: 'I' }, ['saw', 'player3']).speech).toBe('I saw player3');
12
- });
13
-
14
- it('leaves extra args alone when there is no speech option', () => {
15
- expect(normalizeDoOptions({}, ['unused'])).toEqual({});
16
- });
17
- });
18
-
19
- describe('parseIntents', () => {
20
- it('builds speech intents', () => {
21
- const action = parseIntents({ speech: 'hi' })[0].build().toJSON();
22
- expect(action).toMatchObject({ action: 'speech', text: 'hi' });
23
- });
24
-
25
- it('includes audio_url when url is provided', () => {
26
- const action = parseIntents({ speech: 'hi', url: 'https://cdn.example.com/a.mp3' })[0].build().toJSON();
27
- expect(action).toMatchObject({
28
- action: 'speech',
29
- text: 'hi',
30
- audio_url: 'https://cdn.example.com/a.mp3',
31
- });
32
- });
33
-
34
- it('builds vote intents', () => {
35
- const action = parseIntents({ vote: 'player1' })[0].build().toJSON();
36
- expect(action).toMatchObject({ action: 'vote', target: 'player1' });
37
- });
38
-
39
- it('ignores removed direct-control options', () => {
40
- expect(parseIntents({ move: '2424,237', task: true, kill: 'p1', report: true, alarm: true })).toEqual([]);
41
- });
42
- });
43
-
44
- describe('audioContentTypeFor', () => {
45
- it('maps known audio extensions', () => {
46
- expect(audioContentTypeFor('/tmp/a.mp3')).toBe('audio/mpeg');
47
- expect(audioContentTypeFor('/tmp/a.wav')).toBe('audio/wav');
48
- expect(audioContentTypeFor('/tmp/a.m4a')).toBe('audio/mp4');
49
- expect(audioContentTypeFor('/tmp/A.OGG')).toBe('audio/ogg');
50
- });
51
-
52
- it('defaults to audio/mpeg for unknown or extension-less paths', () => {
53
- expect(audioContentTypeFor('/tmp/clip')).toBe('audio/mpeg');
54
- expect(audioContentTypeFor('/tmp/clip.xyz')).toBe('audio/mpeg');
55
- });
56
- });
57
-
58
- describe('resolveSpeechAudioUrl', () => {
59
- it('uploads the local file and returns the cloud audio_url', async () => {
60
- const uploadAudio = vi.fn().mockResolvedValue({ audio_url: 'https://cdn.example.com/uploaded.mp3' });
61
- const url = await resolveSpeechAudioUrl({ speech: 'hi', file: '/tmp/clip.wav' }, { uploadAudio } as any);
62
- expect(url).toBe('https://cdn.example.com/uploaded.mp3');
63
- expect(uploadAudio).toHaveBeenCalledWith('/tmp/clip.wav', undefined, 'audio/wav');
64
- });
65
-
66
- it('falls back to auto TTS (no upload) when no file is given', async () => {
67
- const uploadAudio = vi.fn();
68
- const url = await resolveSpeechAudioUrl({ speech: 'hi' }, { uploadAudio } as any);
69
- expect(uploadAudio).not.toHaveBeenCalled();
70
- // No TTS key configured in test env → auto synthesis returns undefined.
71
- expect(url).toBeUndefined();
72
- });
73
- });
1
+ import { describe, expect, it, vi } from 'vitest';
2
+ import { audioContentTypeFor, normalizeDoOptions, parseIntents, resolveSpeechAudioUrl } from './do.js';
3
+
4
+ vi.mock('../lib/tts-speech.js', () => ({
5
+ // Stub auto-TTS so the no-file path never touches AuthStore or the network.
6
+ maybeSynthesizeSpeechAudioUrl: vi.fn().mockResolvedValue(undefined),
7
+ }));
8
+
9
+ describe('normalizeDoOptions', () => {
10
+ it('joins unquoted speech words passed as extra arguments', () => {
11
+ expect(normalizeDoOptions({ speech: 'I' }, ['saw', 'player3']).speech).toBe('I saw player3');
12
+ });
13
+
14
+ it('leaves extra args alone when there is no speech option', () => {
15
+ expect(normalizeDoOptions({}, ['unused'])).toEqual({});
16
+ });
17
+ });
18
+
19
+ describe('parseIntents', () => {
20
+ it('builds speech intents', () => {
21
+ const action = parseIntents({ speech: 'hi' })[0].build().toJSON();
22
+ expect(action).toMatchObject({ action: 'speech', text: 'hi' });
23
+ });
24
+
25
+ it('includes audio_url when url is provided', () => {
26
+ const action = parseIntents({ speech: 'hi', url: 'https://cdn.example.com/a.mp3' })[0].build().toJSON();
27
+ expect(action).toMatchObject({
28
+ action: 'speech',
29
+ text: 'hi',
30
+ audio_url: 'https://cdn.example.com/a.mp3',
31
+ });
32
+ });
33
+
34
+ it('builds vote intents', () => {
35
+ const action = parseIntents({ vote: 'player1' })[0].build().toJSON();
36
+ expect(action).toMatchObject({ action: 'vote', target: 'player1' });
37
+ });
38
+
39
+ it('ignores removed direct-control options', () => {
40
+ expect(parseIntents({ move: '2424,237', task: true, kill: 'p1', report: true, alarm: true })).toEqual([]);
41
+ });
42
+ });
43
+
44
+ describe('audioContentTypeFor', () => {
45
+ it('maps known audio extensions', () => {
46
+ expect(audioContentTypeFor('/tmp/a.mp3')).toBe('audio/mpeg');
47
+ expect(audioContentTypeFor('/tmp/a.wav')).toBe('audio/wav');
48
+ expect(audioContentTypeFor('/tmp/a.m4a')).toBe('audio/mp4');
49
+ expect(audioContentTypeFor('/tmp/A.OGG')).toBe('audio/ogg');
50
+ });
51
+
52
+ it('defaults to audio/mpeg for unknown or extension-less paths', () => {
53
+ expect(audioContentTypeFor('/tmp/clip')).toBe('audio/mpeg');
54
+ expect(audioContentTypeFor('/tmp/clip.xyz')).toBe('audio/mpeg');
55
+ });
56
+ });
57
+
58
+ describe('resolveSpeechAudioUrl', () => {
59
+ it('uploads the local file and returns the cloud audio_url', async () => {
60
+ const uploadAudio = vi.fn().mockResolvedValue({ audio_url: 'https://cdn.example.com/uploaded.mp3' });
61
+ const url = await resolveSpeechAudioUrl({ speech: 'hi', file: '/tmp/clip.wav' }, { uploadAudio } as any);
62
+ expect(url).toBe('https://cdn.example.com/uploaded.mp3');
63
+ expect(uploadAudio).toHaveBeenCalledWith('/tmp/clip.wav', undefined, 'audio/wav');
64
+ });
65
+
66
+ it('falls back to auto TTS (no upload) when no file is given', async () => {
67
+ const uploadAudio = vi.fn();
68
+ const url = await resolveSpeechAudioUrl({ speech: 'hi' }, { uploadAudio } as any);
69
+ expect(uploadAudio).not.toHaveBeenCalled();
70
+ // No TTS key configured in test env → auto synthesis returns undefined.
71
+ expect(url).toBeUndefined();
72
+ });
73
+ });