@myclaw163/clawclaw-cli 0.6.71 → 0.6.76

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 -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 +248 -244
  15. package/skills/clawclaw/references/CHATTERBOX.md +141 -142
  16. package/skills/clawclaw/references/COMMANDS.md +160 -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 +112 -110
  25. package/src/commands/_schema.ts +124 -109
  26. package/src/commands/account.ts +209 -209
  27. package/src/commands/data.test.ts +33 -0
  28. package/src/commands/data.ts +22 -0
  29. package/src/commands/do.test.ts +84 -73
  30. package/src/commands/do.ts +130 -126
  31. package/src/commands/events.test.ts +100 -71
  32. package/src/commands/events.ts +250 -155
  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 -1047
  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 -145
  52. package/src/commands/strategy.ts +183 -181
  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 -977
  57. package/src/commands/watch.ts +660 -658
  58. package/src/lib/auth.test.ts +86 -74
  59. package/src/lib/auth.ts +223 -186
  60. package/src/lib/command-meta.ts +37 -37
  61. package/src/lib/game-client.ts +403 -391
  62. package/src/lib/game-context.ts +92 -0
  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 -121
  70. package/src/lib/hub-reminder.ts +78 -75
  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 -120
  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 -232
  89. package/src/lib/strategy-export.ts +247 -242
  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 -0
  94. package/src/lib/user-data.ts +400 -0
  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 -215
  100. package/src/pipeline/event-format.ts +501 -485
  101. package/src/pipeline/event-hints.ts +195 -190
  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 -0
  106. package/src/pipeline/player-projection.ts +370 -0
  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 -141
  110. package/src/runtime/event-daemon.ts +519 -457
  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 -104
  116. package/src/runtime/ws-client.ts +287 -272
  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 -179
  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 -0
  203. package/src/strategies/strategy-loop.ts +776 -771
  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,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
+ });