@myclaw163/clawclaw-cli 0.6.71 → 0.6.74

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 (205) hide show
  1. package/README.md +377 -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/check-skill-command-surface.mjs +116 -0
  10. package/scripts/find-hide-spots.py +157 -157
  11. package/scripts/postinstall.mjs +20 -20
  12. package/scripts/sync-bundled-skill.mjs +245 -245
  13. package/scripts/sync-bundled-skill.test.mjs +152 -152
  14. package/skills/clawclaw/SKILL.md +246 -244
  15. package/skills/clawclaw/references/CHATTERBOX.md +141 -142
  16. package/skills/clawclaw/references/COMMANDS.md +155 -148
  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 -45
  20. package/skills/clawclaw/references/STRATEGIES.md +59 -59
  21. package/skills/clawclaw/references/STREAM.md +93 -91
  22. package/skills/clawclaw/references/TACTICS.md +65 -65
  23. package/src/assets/clawclaw-ascii-map.txt +40 -40
  24. package/src/cli.ts +110 -110
  25. package/src/commands/_schema.ts +124 -109
  26. package/src/commands/account.ts +209 -209
  27. package/src/commands/do.test.ts +84 -73
  28. package/src/commands/do.ts +130 -126
  29. package/src/commands/events.test.ts +71 -71
  30. package/src/commands/events.ts +221 -155
  31. package/src/commands/game-map.test.ts +28 -28
  32. package/src/commands/game-start-plan.test.ts +84 -84
  33. package/src/commands/game.ts +1113 -1047
  34. package/src/commands/history-player.test.ts +102 -102
  35. package/src/commands/history.ts +573 -573
  36. package/src/commands/hub.test.ts +96 -96
  37. package/src/commands/hub.ts +234 -234
  38. package/src/commands/knowledge.test.ts +13 -13
  39. package/src/commands/knowledge.ts +139 -139
  40. package/src/commands/load.test.ts +51 -51
  41. package/src/commands/load.ts +13 -13
  42. package/src/commands/meeting-history.test.ts +106 -106
  43. package/src/commands/memory.ts +40 -40
  44. package/src/commands/peek.ts +45 -45
  45. package/src/commands/persona.ts +57 -57
  46. package/src/commands/setup/codex.ts +266 -266
  47. package/src/commands/skill.ts +128 -128
  48. package/src/commands/state.ts +46 -46
  49. package/src/commands/strategy.test.ts +145 -145
  50. package/src/commands/strategy.ts +181 -181
  51. package/src/commands/tts.ts +128 -128
  52. package/src/commands/upgrade.test.ts +82 -82
  53. package/src/commands/upgrade.ts +148 -148
  54. package/src/commands/watch.test.ts +999 -977
  55. package/src/commands/watch.ts +660 -658
  56. package/src/lib/auth.test.ts +74 -74
  57. package/src/lib/auth.ts +186 -186
  58. package/src/lib/command-meta.ts +37 -37
  59. package/src/lib/game-client.ts +403 -391
  60. package/src/lib/game-context.ts +92 -0
  61. package/src/lib/http-keepalive.ts +15 -15
  62. package/src/lib/http-transport.test.ts +42 -42
  63. package/src/lib/http-transport.ts +113 -113
  64. package/src/lib/hub-client.test.ts +56 -56
  65. package/src/lib/hub-client.ts +88 -88
  66. package/src/lib/hub-install.test.ts +98 -98
  67. package/src/lib/hub-install.ts +121 -121
  68. package/src/lib/hub-reminder.ts +75 -75
  69. package/src/lib/hub-unzip.test.ts +69 -69
  70. package/src/lib/hub-unzip.ts +62 -62
  71. package/src/lib/init-command.test.ts +75 -75
  72. package/src/lib/init-command.ts +120 -120
  73. package/src/lib/knowledge-store.test.ts +170 -170
  74. package/src/lib/knowledge-store.ts +369 -369
  75. package/src/lib/load-context.test.ts +52 -52
  76. package/src/lib/load-context.ts +52 -52
  77. package/src/lib/match-state.test.ts +134 -134
  78. package/src/lib/match-state.ts +94 -94
  79. package/src/lib/netease-tts.ts +83 -83
  80. package/src/lib/normalize.ts +42 -42
  81. package/src/lib/persona.test.ts +41 -41
  82. package/src/lib/persona.ts +72 -72
  83. package/src/lib/server-registry.ts +152 -152
  84. package/src/lib/skill-version.test.ts +48 -48
  85. package/src/lib/skill-version.ts +19 -19
  86. package/src/lib/strategy-export.test.ts +232 -232
  87. package/src/lib/strategy-export.ts +242 -242
  88. package/src/lib/tts-keys.ts +7 -7
  89. package/src/lib/tts-speech.test.ts +63 -63
  90. package/src/lib/tts-speech.ts +76 -76
  91. package/src/lib/workspace-argv.test.ts +49 -49
  92. package/src/lib/workspace-argv.ts +44 -44
  93. package/src/perception/player-history-store.test.ts +87 -87
  94. package/src/perception/player-history-store.ts +194 -194
  95. package/src/pipeline/event-format.test.ts +243 -215
  96. package/src/pipeline/event-format.ts +501 -485
  97. package/src/pipeline/event-hints.ts +195 -190
  98. package/src/pipeline/event-store.test.ts +28 -28
  99. package/src/pipeline/event-store.ts +193 -193
  100. package/src/pipeline/pipeline.ts +35 -35
  101. package/src/pipeline/player-projection.test.ts +119 -0
  102. package/src/pipeline/player-projection.ts +380 -0
  103. package/src/runtime/auto-upgrade.test.ts +66 -66
  104. package/src/runtime/auto-upgrade.ts +31 -31
  105. package/src/runtime/event-daemon.test.ts +209 -141
  106. package/src/runtime/event-daemon.ts +519 -457
  107. package/src/runtime/owner-control.ts +150 -150
  108. package/src/runtime/raw-ws-log.test.ts +33 -33
  109. package/src/runtime/raw-ws-log.ts +32 -32
  110. package/src/runtime/runtime-logger.ts +107 -107
  111. package/src/runtime/ws-client.test.ts +125 -104
  112. package/src/runtime/ws-client.ts +287 -272
  113. package/src/sdk/action.ts +166 -166
  114. package/src/sdk/index.ts +110 -110
  115. package/src/sdk/types.ts +161 -161
  116. package/src/strategies/avoid-lone.ts +12 -12
  117. package/src/strategies/avoid-players.knowledge.md +19 -19
  118. package/src/strategies/avoid-players.ts +16 -16
  119. package/src/strategies/corpse-patrol.ts +23 -23
  120. package/src/strategies/crab-sabotage.ts +22 -22
  121. package/src/strategies/custom-module.test.ts +270 -270
  122. package/src/strategies/find-player.ts +17 -17
  123. package/src/strategies/game-utils.test.ts +242 -242
  124. package/src/strategies/game-utils.ts +846 -846
  125. package/src/strategies/goals/anchor-linger.ts +77 -77
  126. package/src/strategies/goals/avoid-lone-top.ts +168 -168
  127. package/src/strategies/goals/avoid-players-top.test.ts +83 -83
  128. package/src/strategies/goals/avoid-players-top.ts +121 -121
  129. package/src/strategies/goals/conversation-goal.ts +51 -51
  130. package/src/strategies/goals/corpse-patrol-top.ts +113 -113
  131. package/src/strategies/goals/crab-octopus-reflexes.ts +101 -101
  132. package/src/strategies/goals/crab-sabotage-top.ts +197 -197
  133. package/src/strategies/goals/emergency-hunt-goal.ts +28 -28
  134. package/src/strategies/goals/find-player-top.ts +93 -93
  135. package/src/strategies/goals/flee-players-goal.ts +53 -53
  136. package/src/strategies/goals/follow-companion-goal.ts +106 -106
  137. package/src/strategies/goals/goal-manager.ts +41 -41
  138. package/src/strategies/goals/goal-root-strategy.ts +49 -49
  139. package/src/strategies/goals/goal.ts +28 -28
  140. package/src/strategies/goals/hide-top.ts +197 -197
  141. package/src/strategies/goals/keep-away-goal.ts +221 -221
  142. package/src/strategies/goals/kill-frenzy-top.ts +80 -80
  143. package/src/strategies/goals/kill-lone-top.ts +160 -160
  144. package/src/strategies/goals/kill-target-goal.ts +59 -59
  145. package/src/strategies/goals/kill-target-top.ts +109 -109
  146. package/src/strategies/goals/leaf-goal.ts +27 -27
  147. package/src/strategies/goals/linger-corpse-goal.ts +35 -35
  148. package/src/strategies/goals/lone-kill-core.ts +82 -82
  149. package/src/strategies/goals/lone-kill-goal.ts +24 -24
  150. package/src/strategies/goals/lone-kill-task-top.test.ts +85 -85
  151. package/src/strategies/goals/lone-kill-task-top.ts +133 -133
  152. package/src/strategies/goals/move-room-goal.ts +60 -60
  153. package/src/strategies/goals/normal-shrimp-top.test.ts +80 -80
  154. package/src/strategies/goals/normal-shrimp-top.ts +242 -242
  155. package/src/strategies/goals/paradise-fish-top.test.ts +126 -126
  156. package/src/strategies/goals/paradise-fish-top.ts +224 -224
  157. package/src/strategies/goals/patrol-top.ts +57 -57
  158. package/src/strategies/goals/report-patrol-top.ts +80 -80
  159. package/src/strategies/goals/safe-task-goal.ts +102 -102
  160. package/src/strategies/goals/social-task-top.ts +161 -161
  161. package/src/strategies/goals/task-kill-report-top.ts +163 -163
  162. package/src/strategies/goals/task-only-top.ts +57 -57
  163. package/src/strategies/goals/task-or-patrol-goal.ts +41 -41
  164. package/src/strategies/goals/task-report-top.ts +57 -57
  165. package/src/strategies/goals/wander-task-goal.ts +33 -33
  166. package/src/strategies/goals/warrior-shrimp-top.test.ts +87 -87
  167. package/src/strategies/goals/warrior-shrimp-top.ts +267 -267
  168. package/src/strategies/greeting.ts +53 -53
  169. package/src/strategies/hide-spots.ts +59 -59
  170. package/src/strategies/hide.ts +24 -24
  171. package/src/strategies/kill-frenzy.ts +13 -13
  172. package/src/strategies/kill-lone.knowledge.md +17 -17
  173. package/src/strategies/kill-lone.ts +14 -14
  174. package/src/strategies/kill-target.ts +19 -19
  175. package/src/strategies/loader.test.ts +678 -678
  176. package/src/strategies/loader.ts +179 -179
  177. package/src/strategies/lone-kill-task.ts +22 -22
  178. package/src/strategies/meeting-gate.test.ts +59 -59
  179. package/src/strategies/meeting-gate.ts +23 -23
  180. package/src/strategies/move-room.ts +16 -16
  181. package/src/strategies/new-events-backfill.ts +98 -98
  182. package/src/strategies/off-route-points.ts +105 -105
  183. package/src/strategies/paradise-fish.knowledge.md +19 -19
  184. package/src/strategies/paradise-fish.ts +26 -26
  185. package/src/strategies/pathfind/distance-field.ts +150 -150
  186. package/src/strategies/pathfind/escape-planner.test.ts +197 -197
  187. package/src/strategies/pathfind/escape-planner.ts +355 -355
  188. package/src/strategies/pathfind/walkable-grid.ts +117 -117
  189. package/src/strategies/patrol.ts +12 -12
  190. package/src/strategies/player-targets.ts +13 -13
  191. package/src/strategies/report-patrol.ts +12 -12
  192. package/src/strategies/shrimp-memory.knowledge.md +19 -19
  193. package/src/strategies/shrimp-memory.ts +26 -26
  194. package/src/strategies/social-task.test.ts +28 -28
  195. package/src/strategies/social-task.ts +50 -50
  196. package/src/strategies/spawn.ts +82 -82
  197. package/src/strategies/speech-module.ts +123 -123
  198. package/src/strategies/strategy-loop.test.ts +15 -0
  199. package/src/strategies/strategy-loop.ts +776 -771
  200. package/src/strategies/task-kill-report.ts +18 -18
  201. package/src/strategies/task-only.ts +12 -12
  202. package/src/strategies/task-report.ts +23 -23
  203. package/src/strategies/types.ts +109 -109
  204. package/src/strategies/warrior-memory.knowledge.md +21 -21
  205. package/src/strategies/warrior-memory.ts +17 -17
@@ -1,104 +1,125 @@
1
- import { beforeEach, describe, expect, it, vi } from 'vitest';
2
-
3
- const wsMock = vi.hoisted(() => ({
4
- constructed: [] as Array<{ url: string; options: any; instance: any }>,
5
- }));
6
-
7
- vi.mock('ws', () => {
8
- class MockWebSocket {
9
- onopen: ((event: any) => void) | null = null;
10
- onerror: ((event: any) => void) | null = null;
11
- onclose: ((event: any) => void) | null = null;
12
- onmessage: ((event: any) => void) | null = null;
13
- send = vi.fn();
14
- close = vi.fn();
15
-
16
- constructor(url: string, options: any) {
17
- wsMock.constructed.push({ url, options, instance: this });
18
- }
19
- }
20
-
21
- return { default: MockWebSocket };
22
- });
23
-
24
- describe('WsClient', () => {
25
- beforeEach(() => {
26
- wsMock.constructed.length = 0;
27
- });
28
-
29
- it('connects with Authorization header instead of api_key query', async () => {
30
- const { WsClient } = await import('./ws-client.js');
31
- const client = new WsClient({
32
- url: 'wss://host.example/api/v1/game/stream',
33
- apiKey: 'claw_secret',
34
- });
35
-
36
- const connected = client.connect();
37
- expect(wsMock.constructed).toHaveLength(1);
38
- expect(wsMock.constructed[0].url).toBe('wss://host.example/api/v1/game/stream');
39
- expect(wsMock.constructed[0].url).not.toContain('api_key');
40
- expect(wsMock.constructed[0].options).toMatchObject({
41
- headers: { Authorization: 'Bearer claw_secret' },
42
- });
43
-
44
- wsMock.constructed[0].instance.onopen?.({});
45
- await connected;
46
- });
47
-
48
- it('dispatches state.new_events before the _state snapshot', async () => {
49
- const { WsClient } = await import('./ws-client.js');
50
- const client = new WsClient({
51
- url: 'wss://host.example/api/v1/game/stream',
52
- apiKey: 'claw_secret',
53
- });
54
- const seen: Record<string, any>[] = [];
55
- client.on('*', (event) => seen.push(event));
56
-
57
- (client as any).handleMessage({
58
- type: 'state',
59
- data: {
60
- phase: 'wandering',
61
- tick: 20,
62
- new_events: [{ type: 'game_over', tick: 20, winner: 'crab' }],
63
- },
64
- });
65
-
66
- expect(seen).toEqual([
67
- { type: 'game_over', tick: 20, winner: 'crab' },
68
- {
69
- type: '_state',
70
- phase: 'wandering',
71
- tick: 20,
72
- new_events: [{ type: 'game_over', tick: 20, winner: 'crab' }],
73
- },
74
- ]);
75
- });
76
-
77
- it('dispatches a _state snapshot when phase is game_over without new_events', async () => {
78
- const { WsClient } = await import('./ws-client.js');
79
- const client = new WsClient({
80
- url: 'wss://host.example/api/v1/game/stream',
81
- apiKey: 'claw_secret',
82
- });
83
- const seen: Record<string, any>[] = [];
84
- client.on('*', (event) => seen.push(event));
85
-
86
- (client as any).handleMessage({
87
- type: 'state',
88
- data: {
89
- phase: 'game_over',
90
- tick: 21,
91
- new_events: [],
92
- },
93
- });
94
-
95
- expect(seen).toEqual([
96
- {
97
- type: '_state',
98
- phase: 'game_over',
99
- tick: 21,
100
- new_events: [],
101
- },
102
- ]);
103
- });
104
- });
1
+ import { beforeEach, describe, expect, it, vi } from 'vitest';
2
+
3
+ const wsMock = vi.hoisted(() => ({
4
+ constructed: [] as Array<{ url: string; options: any; instance: any }>,
5
+ }));
6
+
7
+ vi.mock('ws', () => {
8
+ class MockWebSocket {
9
+ onopen: ((event: any) => void) | null = null;
10
+ onerror: ((event: any) => void) | null = null;
11
+ onclose: ((event: any) => void) | null = null;
12
+ onmessage: ((event: any) => void) | null = null;
13
+ send = vi.fn();
14
+ close = vi.fn();
15
+
16
+ constructor(url: string, options: any) {
17
+ wsMock.constructed.push({ url, options, instance: this });
18
+ }
19
+ }
20
+
21
+ return { default: MockWebSocket };
22
+ });
23
+
24
+ describe('WsClient', () => {
25
+ beforeEach(() => {
26
+ wsMock.constructed.length = 0;
27
+ });
28
+
29
+ it('connects with Authorization header instead of api_key query', async () => {
30
+ const { WsClient } = await import('./ws-client.js');
31
+ const client = new WsClient({
32
+ url: 'wss://host.example/api/v1/game/stream',
33
+ apiKey: 'claw_secret',
34
+ });
35
+
36
+ const connected = client.connect();
37
+ expect(wsMock.constructed).toHaveLength(1);
38
+ expect(wsMock.constructed[0].url).toBe('wss://host.example/api/v1/game/stream');
39
+ expect(wsMock.constructed[0].url).not.toContain('api_key');
40
+ expect(wsMock.constructed[0].options).toMatchObject({
41
+ headers: { Authorization: 'Bearer claw_secret' },
42
+ });
43
+
44
+ wsMock.constructed[0].instance.onopen?.({});
45
+ await connected;
46
+ });
47
+
48
+ it('passes WebSocket close code and reason to disconnect handlers', async () => {
49
+ const { WsClient } = await import('./ws-client.js');
50
+ const client = new WsClient({
51
+ url: 'wss://host.example/api/v1/game/stream',
52
+ apiKey: 'claw_secret',
53
+ });
54
+ const closes: Record<string, any>[] = [];
55
+ client.onDisconnect((info) => closes.push(info));
56
+
57
+ const connected = client.connect();
58
+ wsMock.constructed[0].instance.onopen?.({});
59
+ await connected;
60
+
61
+ wsMock.constructed[0].instance.onclose?.({ code: 1000, reason: 'Left game', wasClean: true });
62
+ client.disconnect();
63
+
64
+ expect(closes).toEqual([
65
+ { code: 1000, reason: 'Left game', wasClean: true },
66
+ ]);
67
+ });
68
+
69
+ it('dispatches state.new_events before the _state snapshot', async () => {
70
+ const { WsClient } = await import('./ws-client.js');
71
+ const client = new WsClient({
72
+ url: 'wss://host.example/api/v1/game/stream',
73
+ apiKey: 'claw_secret',
74
+ });
75
+ const seen: Record<string, any>[] = [];
76
+ client.on('*', (event) => seen.push(event));
77
+
78
+ (client as any).handleMessage({
79
+ type: 'state',
80
+ data: {
81
+ phase: 'wandering',
82
+ tick: 20,
83
+ new_events: [{ type: 'game_over', tick: 20, winner: 'crab' }],
84
+ },
85
+ });
86
+
87
+ expect(seen).toEqual([
88
+ { type: 'game_over', tick: 20, winner: 'crab' },
89
+ {
90
+ type: '_state',
91
+ phase: 'wandering',
92
+ tick: 20,
93
+ new_events: [{ type: 'game_over', tick: 20, winner: 'crab' }],
94
+ },
95
+ ]);
96
+ });
97
+
98
+ it('dispatches a _state snapshot when phase is game_over without new_events', async () => {
99
+ const { WsClient } = await import('./ws-client.js');
100
+ const client = new WsClient({
101
+ url: 'wss://host.example/api/v1/game/stream',
102
+ apiKey: 'claw_secret',
103
+ });
104
+ const seen: Record<string, any>[] = [];
105
+ client.on('*', (event) => seen.push(event));
106
+
107
+ (client as any).handleMessage({
108
+ type: 'state',
109
+ data: {
110
+ phase: 'game_over',
111
+ tick: 21,
112
+ new_events: [],
113
+ },
114
+ });
115
+
116
+ expect(seen).toEqual([
117
+ {
118
+ type: '_state',
119
+ phase: 'game_over',
120
+ tick: 21,
121
+ new_events: [],
122
+ },
123
+ ]);
124
+ });
125
+ });