@myclaw163/clawclaw-cli 0.6.76 → 0.6.78

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,84 +1,84 @@
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
- it('maps the deprecated think alias to comment', () => {
19
- expect(normalizeDoOptions({ think: 'watch-only note' })).toMatchObject({
20
- think: 'watch-only note',
21
- comment: 'watch-only note',
22
- });
23
- });
24
-
25
- it('keeps explicit comment when both comment and think are present', () => {
26
- expect(normalizeDoOptions({ think: 'old', comment: 'new' }).comment).toBe('new');
27
- });
28
- });
29
-
30
- describe('parseIntents', () => {
31
- it('builds speech intents', () => {
32
- const action = parseIntents({ speech: 'hi' })[0].build().toJSON();
33
- expect(action).toMatchObject({ action: 'speech', text: 'hi' });
34
- });
35
-
36
- it('includes audio_url when url is provided', () => {
37
- const action = parseIntents({ speech: 'hi', url: 'https://cdn.example.com/a.mp3' })[0].build().toJSON();
38
- expect(action).toMatchObject({
39
- action: 'speech',
40
- text: 'hi',
41
- audio_url: 'https://cdn.example.com/a.mp3',
42
- });
43
- });
44
-
45
- it('builds vote intents', () => {
46
- const action = parseIntents({ vote: 'player1' })[0].build().toJSON();
47
- expect(action).toMatchObject({ action: 'vote', target: 'player1' });
48
- });
49
-
50
- it('ignores removed direct-control options', () => {
51
- expect(parseIntents({ move: '2424,237', task: true, kill: 'p1', report: true, alarm: true })).toEqual([]);
52
- });
53
- });
54
-
55
- describe('audioContentTypeFor', () => {
56
- it('maps known audio extensions', () => {
57
- expect(audioContentTypeFor('/tmp/a.mp3')).toBe('audio/mpeg');
58
- expect(audioContentTypeFor('/tmp/a.wav')).toBe('audio/wav');
59
- expect(audioContentTypeFor('/tmp/a.m4a')).toBe('audio/mp4');
60
- expect(audioContentTypeFor('/tmp/A.OGG')).toBe('audio/ogg');
61
- });
62
-
63
- it('defaults to audio/mpeg for unknown or extension-less paths', () => {
64
- expect(audioContentTypeFor('/tmp/clip')).toBe('audio/mpeg');
65
- expect(audioContentTypeFor('/tmp/clip.xyz')).toBe('audio/mpeg');
66
- });
67
- });
68
-
69
- describe('resolveSpeechAudioUrl', () => {
70
- it('uploads the local file and returns the cloud audio_url', async () => {
71
- const uploadAudio = vi.fn().mockResolvedValue({ audio_url: 'https://cdn.example.com/uploaded.mp3' });
72
- const url = await resolveSpeechAudioUrl({ speech: 'hi', file: '/tmp/clip.wav' }, { uploadAudio } as any);
73
- expect(url).toBe('https://cdn.example.com/uploaded.mp3');
74
- expect(uploadAudio).toHaveBeenCalledWith('/tmp/clip.wav', undefined, 'audio/wav');
75
- });
76
-
77
- it('falls back to auto TTS (no upload) when no file is given', async () => {
78
- const uploadAudio = vi.fn();
79
- const url = await resolveSpeechAudioUrl({ speech: 'hi' }, { uploadAudio } as any);
80
- expect(uploadAudio).not.toHaveBeenCalled();
81
- // No TTS key configured in test env → auto synthesis returns undefined.
82
- expect(url).toBeUndefined();
83
- });
84
- });
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
+ it('maps the deprecated think alias to comment', () => {
19
+ expect(normalizeDoOptions({ think: 'watch-only note' })).toMatchObject({
20
+ think: 'watch-only note',
21
+ comment: 'watch-only note',
22
+ });
23
+ });
24
+
25
+ it('keeps explicit comment when both comment and think are present', () => {
26
+ expect(normalizeDoOptions({ think: 'old', comment: 'new' }).comment).toBe('new');
27
+ });
28
+ });
29
+
30
+ describe('parseIntents', () => {
31
+ it('builds speech intents', () => {
32
+ const action = parseIntents({ speech: 'hi' })[0].build().toJSON();
33
+ expect(action).toMatchObject({ action: 'speech', text: 'hi' });
34
+ });
35
+
36
+ it('includes audio_url when url is provided', () => {
37
+ const action = parseIntents({ speech: 'hi', url: 'https://cdn.example.com/a.mp3' })[0].build().toJSON();
38
+ expect(action).toMatchObject({
39
+ action: 'speech',
40
+ text: 'hi',
41
+ audio_url: 'https://cdn.example.com/a.mp3',
42
+ });
43
+ });
44
+
45
+ it('builds vote intents', () => {
46
+ const action = parseIntents({ vote: 'player1' })[0].build().toJSON();
47
+ expect(action).toMatchObject({ action: 'vote', target: 'player1' });
48
+ });
49
+
50
+ it('ignores removed direct-control options', () => {
51
+ expect(parseIntents({ move: '2424,237', task: true, kill: 'p1', report: true, alarm: true })).toEqual([]);
52
+ });
53
+ });
54
+
55
+ describe('audioContentTypeFor', () => {
56
+ it('maps known audio extensions', () => {
57
+ expect(audioContentTypeFor('/tmp/a.mp3')).toBe('audio/mpeg');
58
+ expect(audioContentTypeFor('/tmp/a.wav')).toBe('audio/wav');
59
+ expect(audioContentTypeFor('/tmp/a.m4a')).toBe('audio/mp4');
60
+ expect(audioContentTypeFor('/tmp/A.OGG')).toBe('audio/ogg');
61
+ });
62
+
63
+ it('defaults to audio/mpeg for unknown or extension-less paths', () => {
64
+ expect(audioContentTypeFor('/tmp/clip')).toBe('audio/mpeg');
65
+ expect(audioContentTypeFor('/tmp/clip.xyz')).toBe('audio/mpeg');
66
+ });
67
+ });
68
+
69
+ describe('resolveSpeechAudioUrl', () => {
70
+ it('uploads the local file and returns the cloud audio_url', async () => {
71
+ const uploadAudio = vi.fn().mockResolvedValue({ audio_url: 'https://cdn.example.com/uploaded.mp3' });
72
+ const url = await resolveSpeechAudioUrl({ speech: 'hi', file: '/tmp/clip.wav' }, { uploadAudio } as any);
73
+ expect(url).toBe('https://cdn.example.com/uploaded.mp3');
74
+ expect(uploadAudio).toHaveBeenCalledWith('/tmp/clip.wav', undefined, 'audio/wav');
75
+ });
76
+
77
+ it('falls back to auto TTS (no upload) when no file is given', async () => {
78
+ const uploadAudio = vi.fn();
79
+ const url = await resolveSpeechAudioUrl({ speech: 'hi' }, { uploadAudio } as any);
80
+ expect(uploadAudio).not.toHaveBeenCalled();
81
+ // No TTS key configured in test env → auto synthesis returns undefined.
82
+ expect(url).toBeUndefined();
83
+ });
84
+ });
@@ -1,130 +1,130 @@
1
- import { Command, Option } from 'commander';
2
- import { GameClient } from '../lib/game-client.js';
3
- import { maybeSynthesizeSpeechAudioUrl } from '../lib/tts-speech.js';
4
- import { Action } from '../sdk/action.js';
5
- import { EventStore } from '../pipeline/event-store.js';
6
-
7
- interface ActionIntent {
8
- build(): Action;
9
- }
10
-
11
- /** Infer an audio MIME type from a file path's extension; defaults to audio/mpeg. */
12
- export function audioContentTypeFor(filePath: string): string {
13
- const ext = filePath.slice(filePath.lastIndexOf('.')).toLowerCase();
14
- switch (ext) {
15
- case '.wav': return 'audio/wav';
16
- case '.ogg': return 'audio/ogg';
17
- case '.oga': return 'audio/ogg';
18
- case '.m4a': return 'audio/mp4';
19
- case '.aac': return 'audio/aac';
20
- case '.flac': return 'audio/flac';
21
- case '.webm': return 'audio/webm';
22
- case '.mp3':
23
- default: return 'audio/mpeg';
24
- }
25
- }
26
-
27
- /**
28
- * Resolve the speech audio URL: when a local --file is given, upload it and
29
- * return the cloud URL; otherwise fall back to auto TTS synthesis.
30
- */
31
- export async function resolveSpeechAudioUrl(
32
- opts: Record<string, any>,
33
- client: { uploadAudio(filePath: string, filename?: string, contentType?: string): Promise<{ audio_url: string }> },
34
- ): Promise<string | undefined> {
35
- if (opts.file) {
36
- const { audio_url } = await client.uploadAudio(opts.file, undefined, audioContentTypeFor(opts.file));
37
- return audio_url;
38
- }
39
- return maybeSynthesizeSpeechAudioUrl(opts.speech, opts.url, client as any);
40
- }
41
-
42
- export function normalizeDoOptions(opts: Record<string, any>, extraArgs: string[] = []): Record<string, any> {
43
- const normalized = { ...opts };
44
- if (normalized.speech && extraArgs.length > 0) {
45
- normalized.speech = [normalized.speech, ...extraArgs].join(' ');
46
- }
47
- if (normalized.think && !normalized.comment) {
48
- normalized.comment = normalized.think;
49
- }
50
-
51
- return normalized;
52
- }
53
-
54
- export function parseIntents(opts: Record<string, any>): ActionIntent[] {
55
- const intents: ActionIntent[] = [];
56
- if (opts.speech) intents.push({ build: () => Action.speech(opts.speech, undefined, opts.url) });
57
- if (opts.vote) intents.push({ build: () => Action.vote(opts.vote) });
58
- return intents;
59
- }
60
-
61
- export function createDoCommand(): Command {
62
- return new Command('do')
63
- .alias('d')
64
- .description('Execute player communication actions (speech/vote/comment)')
65
- .option('-s, --speech <text>', 'Say something')
66
- .addOption(new Option('--file <path>', 'Local audio file to upload and attach to speech').hideHelp())
67
- .option('-v, --vote <target>', 'Vote for player')
68
- .option('--comment <text>', 'Send a comment visible only to the user/spectators; not public in-game speech')
69
- .addOption(new Option('--think <text>', 'Deprecated alias for --comment').hideHelp())
70
- .argument('[extra...]', 'Additional unquoted speech words')
71
- .action(async (extraArgs: string[], opts) => {
72
- opts = normalizeDoOptions(opts, extraArgs);
73
-
74
- if (!opts.speech && !opts.vote && !opts.comment) {
75
- console.error('No action specified. Use -s, -v, or --comment.');
76
- process.exit(1);
77
- }
78
-
79
- const { isStrategyRunning } = await import('../strategies/strategy-loop.js');
80
- const strategyActive = isStrategyRunning();
81
-
82
- if (strategyActive && !opts.speech && !opts.vote && !opts.comment) {
83
- console.log(JSON.stringify({
84
- error: 'strategy_running',
85
- message: 'Strategy is controlling the character. Speech (-s), vote (-v), and --comment remain available.',
86
- }, null, 2));
87
- process.exit(1);
88
- }
89
-
90
- const client = GameClient.fromAuth();
91
- await client.discoverGameServer();
92
-
93
- if (opts.speech) {
94
- opts.url = await resolveSpeechAudioUrl(opts, client);
95
- }
96
-
97
- const intents = parseIntents(opts);
98
- if (intents.length === 0 && opts.comment) {
99
- intents.push({ build: () => Action.think() });
100
- }
101
-
102
- const first = intents[0];
103
- let action = first.build();
104
- if (opts.comment) action = action.withThinking(opts.comment);
105
- const result = await client.submitAction(action.toJSON() as any);
106
-
107
- try {
108
- const store = EventStore.forActiveAccount();
109
- store.appendNewEvents(result);
110
- } catch {}
111
-
112
- if (intents.length === 1) {
113
- console.log(JSON.stringify({ action: action.toJSON(), result: result ?? 'ok' }, null, 2));
114
- return;
115
- }
116
-
117
- const submitted = [{ action: action.toJSON(), result: result ?? 'ok' }];
118
- for (const intent of intents.slice(1)) {
119
- const nextAction = intent.build();
120
- const nextResult = await client.submitAction(nextAction.toJSON() as any);
121
- try {
122
- const store = EventStore.forActiveAccount();
123
- store.appendNewEvents(nextResult);
124
- } catch {}
125
- submitted.push({ action: nextAction.toJSON(), result: nextResult ?? 'ok' });
126
- }
127
-
128
- console.log(JSON.stringify({ actions: submitted }, null, 2));
129
- });
130
- }
1
+ import { Command, Option } from 'commander';
2
+ import { GameClient } from '../lib/game-client.js';
3
+ import { maybeSynthesizeSpeechAudioUrl } from '../lib/tts-speech.js';
4
+ import { Action } from '../sdk/action.js';
5
+ import { EventStore } from '../pipeline/event-store.js';
6
+
7
+ interface ActionIntent {
8
+ build(): Action;
9
+ }
10
+
11
+ /** Infer an audio MIME type from a file path's extension; defaults to audio/mpeg. */
12
+ export function audioContentTypeFor(filePath: string): string {
13
+ const ext = filePath.slice(filePath.lastIndexOf('.')).toLowerCase();
14
+ switch (ext) {
15
+ case '.wav': return 'audio/wav';
16
+ case '.ogg': return 'audio/ogg';
17
+ case '.oga': return 'audio/ogg';
18
+ case '.m4a': return 'audio/mp4';
19
+ case '.aac': return 'audio/aac';
20
+ case '.flac': return 'audio/flac';
21
+ case '.webm': return 'audio/webm';
22
+ case '.mp3':
23
+ default: return 'audio/mpeg';
24
+ }
25
+ }
26
+
27
+ /**
28
+ * Resolve the speech audio URL: when a local --file is given, upload it and
29
+ * return the cloud URL; otherwise fall back to auto TTS synthesis.
30
+ */
31
+ export async function resolveSpeechAudioUrl(
32
+ opts: Record<string, any>,
33
+ client: { uploadAudio(filePath: string, filename?: string, contentType?: string): Promise<{ audio_url: string }> },
34
+ ): Promise<string | undefined> {
35
+ if (opts.file) {
36
+ const { audio_url } = await client.uploadAudio(opts.file, undefined, audioContentTypeFor(opts.file));
37
+ return audio_url;
38
+ }
39
+ return maybeSynthesizeSpeechAudioUrl(opts.speech, opts.url, client as any);
40
+ }
41
+
42
+ export function normalizeDoOptions(opts: Record<string, any>, extraArgs: string[] = []): Record<string, any> {
43
+ const normalized = { ...opts };
44
+ if (normalized.speech && extraArgs.length > 0) {
45
+ normalized.speech = [normalized.speech, ...extraArgs].join(' ');
46
+ }
47
+ if (normalized.think && !normalized.comment) {
48
+ normalized.comment = normalized.think;
49
+ }
50
+
51
+ return normalized;
52
+ }
53
+
54
+ export function parseIntents(opts: Record<string, any>): ActionIntent[] {
55
+ const intents: ActionIntent[] = [];
56
+ if (opts.speech) intents.push({ build: () => Action.speech(opts.speech, undefined, opts.url) });
57
+ if (opts.vote) intents.push({ build: () => Action.vote(opts.vote) });
58
+ return intents;
59
+ }
60
+
61
+ export function createDoCommand(): Command {
62
+ return new Command('do')
63
+ .alias('d')
64
+ .description('Execute player communication actions (speech/vote/comment)')
65
+ .option('-s, --speech <text>', 'Say something')
66
+ .addOption(new Option('--file <path>', 'Local audio file to upload and attach to speech').hideHelp())
67
+ .option('-v, --vote <target>', 'Vote for player')
68
+ .option('--comment <text>', 'Send a comment visible only to the user/spectators; not public in-game speech')
69
+ .addOption(new Option('--think <text>', 'Deprecated alias for --comment').hideHelp())
70
+ .argument('[extra...]', 'Additional unquoted speech words')
71
+ .action(async (extraArgs: string[], opts) => {
72
+ opts = normalizeDoOptions(opts, extraArgs);
73
+
74
+ if (!opts.speech && !opts.vote && !opts.comment) {
75
+ console.error('No action specified. Use -s, -v, or --comment.');
76
+ process.exit(1);
77
+ }
78
+
79
+ const { isStrategyRunning } = await import('../strategies/strategy-loop.js');
80
+ const strategyActive = isStrategyRunning();
81
+
82
+ if (strategyActive && !opts.speech && !opts.vote && !opts.comment) {
83
+ console.log(JSON.stringify({
84
+ error: 'strategy_running',
85
+ message: 'Strategy is controlling the character. Speech (-s), vote (-v), and --comment remain available.',
86
+ }, null, 2));
87
+ process.exit(1);
88
+ }
89
+
90
+ const client = GameClient.fromAuth();
91
+ await client.discoverGameServer();
92
+
93
+ if (opts.speech) {
94
+ opts.url = await resolveSpeechAudioUrl(opts, client);
95
+ }
96
+
97
+ const intents = parseIntents(opts);
98
+ if (intents.length === 0 && opts.comment) {
99
+ intents.push({ build: () => Action.think() });
100
+ }
101
+
102
+ const first = intents[0];
103
+ let action = first.build();
104
+ if (opts.comment) action = action.withThinking(opts.comment);
105
+ const result = await client.submitAction(action.toJSON() as any);
106
+
107
+ try {
108
+ const store = EventStore.forActiveAccount();
109
+ store.appendNewEvents(result);
110
+ } catch {}
111
+
112
+ if (intents.length === 1) {
113
+ console.log(JSON.stringify({ action: action.toJSON(), result: result ?? 'ok' }, null, 2));
114
+ return;
115
+ }
116
+
117
+ const submitted = [{ action: action.toJSON(), result: result ?? 'ok' }];
118
+ for (const intent of intents.slice(1)) {
119
+ const nextAction = intent.build();
120
+ const nextResult = await client.submitAction(nextAction.toJSON() as any);
121
+ try {
122
+ const store = EventStore.forActiveAccount();
123
+ store.appendNewEvents(nextResult);
124
+ } catch {}
125
+ submitted.push({ action: nextAction.toJSON(), result: nextResult ?? 'ok' });
126
+ }
127
+
128
+ console.log(JSON.stringify({ actions: submitted }, null, 2));
129
+ });
130
+ }
@@ -1,100 +1,100 @@
1
- import { describe, expect, it } from 'vitest';
2
- import {
3
- enrichEventsForState,
4
- enrichEventForEvents,
5
- selectMonitorEventRecordsAfterCursor,
6
- selectMonitorTailEventRecords,
7
- } from './events.js';
8
- import type { EventRecord } from '../pipeline/event-store.js';
9
-
10
- function record(line: number, type: string): EventRecord {
11
- return { line, event: { type, tick: line } };
12
- }
13
-
14
- describe('events command monitor registration filter', () => {
15
- it('returns only Monitor-registered events after the cursor', () => {
16
- const selected = selectMonitorEventRecordsAfterCursor([
17
- record(1, 'role_assigned'),
18
- record(2, 'player_spotted'),
19
- record(3, 'speech'),
20
- record(4, 'vote_speech'),
21
- ], 1);
22
-
23
- expect(selected.scanned.map((r) => r.event.type)).toEqual(['player_spotted', 'speech', 'vote_speech']);
24
- expect(selected.returned.map((r) => r.event.type)).toEqual(['speech']);
25
- expect(selected.toLine).toBe(4);
26
- });
27
-
28
- it('advances across ignored events so they are not scanned repeatedly', () => {
29
- const selected = selectMonitorEventRecordsAfterCursor([
30
- record(8, 'vote_speech'),
31
- record(9, 'player_spotted'),
32
- ], 7);
33
-
34
- expect(selected.returned).toEqual([]);
35
- expect(selected.toLine).toBe(9);
36
- expect(selected.scanned).toHaveLength(2);
37
- });
38
-
39
- it('tail mode applies the Monitor registration filter before the count and type filter', () => {
40
- const selected = selectMonitorTailEventRecords([
41
- record(1, 'speech'),
42
- record(2, 'vote_speech'),
43
- record(3, 'killed'),
44
- record(4, 'player_spotted'),
45
- record(5, 'speech'),
46
- ], 2);
47
-
48
- expect(selected.map((r) => r.line)).toEqual([3, 5]);
49
- expect(selectMonitorTailEventRecords(selected, 10, 'vote_speech')).toEqual([]);
50
- });
51
-
52
- it('enriches meeting_briefing with current speech_order only for the same caller', () => {
53
- const summary = {
54
- meeting: {
55
- caller: '单钳渔夫',
56
- speech_order: ['单钳渔夫', '洋流王子'],
57
- },
58
- };
59
-
60
- expect(enrichEventForEvents({
61
- type: 'meeting_briefing',
62
- meeting_caller_name: '单钳渔夫',
63
- }, summary)).toMatchObject({
64
- speech_order: ['单钳渔夫', '洋流王子'],
65
- });
66
-
67
- expect(enrichEventForEvents({
68
- type: 'meeting_briefing',
69
- meeting_caller_name: '其他人',
70
- }, summary)).not.toHaveProperty('speech_order');
71
- });
72
- });
73
-
74
- describe('events command state enrichment', () => {
75
- it('adds opening roster context to raw game_started events for state projection', () => {
76
- const events = [
77
- { type: 'role_assigned', tick: 0, role: 'shrimp_generic' },
78
- { type: 'game_started', tick: 0, player_count: 3 },
79
- { type: 'speech', tick: 5, actor_name: 'Red' },
80
- ];
81
-
82
- const enriched = enrichEventsForState(events, {
83
- players: [
84
- { name: 'Self', seat: 1 },
85
- { name: 'Blue', seat: 2 },
86
- { name: 'Red', seat: 3 },
87
- ],
88
- });
89
-
90
- expect(enriched[1]).toMatchObject({
91
- type: 'game_started',
92
- players: [
93
- { name: 'Self', seat: 1 },
94
- { name: 'Blue', seat: 2 },
95
- { name: 'Red', seat: 3 },
96
- ],
97
- });
98
- expect(events[1]).not.toHaveProperty('players');
99
- });
100
- });
1
+ import { describe, expect, it } from 'vitest';
2
+ import {
3
+ enrichEventsForState,
4
+ enrichEventForEvents,
5
+ selectMonitorEventRecordsAfterCursor,
6
+ selectMonitorTailEventRecords,
7
+ } from './events.js';
8
+ import type { EventRecord } from '../pipeline/event-store.js';
9
+
10
+ function record(line: number, type: string): EventRecord {
11
+ return { line, event: { type, tick: line } };
12
+ }
13
+
14
+ describe('events command monitor registration filter', () => {
15
+ it('returns only Monitor-registered events after the cursor', () => {
16
+ const selected = selectMonitorEventRecordsAfterCursor([
17
+ record(1, 'role_assigned'),
18
+ record(2, 'player_spotted'),
19
+ record(3, 'speech'),
20
+ record(4, 'vote_speech'),
21
+ ], 1);
22
+
23
+ expect(selected.scanned.map((r) => r.event.type)).toEqual(['player_spotted', 'speech', 'vote_speech']);
24
+ expect(selected.returned.map((r) => r.event.type)).toEqual(['speech']);
25
+ expect(selected.toLine).toBe(4);
26
+ });
27
+
28
+ it('advances across ignored events so they are not scanned repeatedly', () => {
29
+ const selected = selectMonitorEventRecordsAfterCursor([
30
+ record(8, 'vote_speech'),
31
+ record(9, 'player_spotted'),
32
+ ], 7);
33
+
34
+ expect(selected.returned).toEqual([]);
35
+ expect(selected.toLine).toBe(9);
36
+ expect(selected.scanned).toHaveLength(2);
37
+ });
38
+
39
+ it('tail mode applies the Monitor registration filter before the count and type filter', () => {
40
+ const selected = selectMonitorTailEventRecords([
41
+ record(1, 'speech'),
42
+ record(2, 'vote_speech'),
43
+ record(3, 'killed'),
44
+ record(4, 'player_spotted'),
45
+ record(5, 'speech'),
46
+ ], 2);
47
+
48
+ expect(selected.map((r) => r.line)).toEqual([3, 5]);
49
+ expect(selectMonitorTailEventRecords(selected, 10, 'vote_speech')).toEqual([]);
50
+ });
51
+
52
+ it('enriches meeting_briefing with current speech_order only for the same caller', () => {
53
+ const summary = {
54
+ meeting: {
55
+ caller: '单钳渔夫',
56
+ speech_order: ['单钳渔夫', '洋流王子'],
57
+ },
58
+ };
59
+
60
+ expect(enrichEventForEvents({
61
+ type: 'meeting_briefing',
62
+ meeting_caller_name: '单钳渔夫',
63
+ }, summary)).toMatchObject({
64
+ speech_order: ['单钳渔夫', '洋流王子'],
65
+ });
66
+
67
+ expect(enrichEventForEvents({
68
+ type: 'meeting_briefing',
69
+ meeting_caller_name: '其他人',
70
+ }, summary)).not.toHaveProperty('speech_order');
71
+ });
72
+ });
73
+
74
+ describe('events command state enrichment', () => {
75
+ it('adds opening roster context to raw game_started events for state projection', () => {
76
+ const events = [
77
+ { type: 'role_assigned', tick: 0, role: 'shrimp_generic' },
78
+ { type: 'game_started', tick: 0, player_count: 3 },
79
+ { type: 'speech', tick: 5, actor_name: 'Red' },
80
+ ];
81
+
82
+ const enriched = enrichEventsForState(events, {
83
+ players: [
84
+ { name: 'Self', seat: 1 },
85
+ { name: 'Blue', seat: 2 },
86
+ { name: 'Red', seat: 3 },
87
+ ],
88
+ });
89
+
90
+ expect(enriched[1]).toMatchObject({
91
+ type: 'game_started',
92
+ players: [
93
+ { name: 'Self', seat: 1 },
94
+ { name: 'Blue', seat: 2 },
95
+ { name: 'Red', seat: 3 },
96
+ ],
97
+ });
98
+ expect(events[1]).not.toHaveProperty('players');
99
+ });
100
+ });