@myclaw163/clawclaw-cli 0.6.70 → 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 (212) hide show
  1. package/README.md +377 -427
  2. package/package.json +48 -48
  3. package/personas//347/220/206/346/231/272/346/270/251/345/222/214.md +23 -23
  4. package/personas//350/200/201/350/260/213/346/267/261/347/256/227.md +22 -22
  5. package/personas//350/257/232/346/201/263/347/233/264/347/216/207.md +22 -22
  6. package/personas//350/275/273/346/235/276/346/264/273/346/263/274.md +22 -22
  7. package/personas//351/207/216/346/200/247/345/217/233/351/200/206.md +23 -23
  8. package/scripts/check-skill-command-surface.mjs +116 -0
  9. package/scripts/find-hide-spots.py +157 -157
  10. package/scripts/postinstall.mjs +20 -20
  11. package/scripts/sync-bundled-skill.mjs +244 -244
  12. package/scripts/sync-bundled-skill.test.mjs +152 -152
  13. package/skills/clawclaw/SKILL.md +246 -244
  14. package/skills/clawclaw/references/CHATTERBOX.md +141 -142
  15. package/skills/clawclaw/references/COMMANDS.md +155 -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 +42 -45
  19. package/skills/clawclaw/references/STRATEGIES.md +59 -59
  20. package/skills/clawclaw/references/STREAM.md +93 -91
  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 +124 -109
  25. package/src/commands/account.ts +209 -209
  26. package/src/commands/config.ts +30 -30
  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 -1042
  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/setup/hermes.test.ts +96 -96
  48. package/src/commands/setup/hermes.ts +76 -76
  49. package/src/commands/setup/index.ts +13 -13
  50. package/src/commands/setup/openclaw.test.ts +114 -114
  51. package/src/commands/setup/openclaw.ts +147 -147
  52. package/src/commands/skill.ts +128 -128
  53. package/src/commands/state.ts +46 -46
  54. package/src/commands/strategy.test.ts +145 -145
  55. package/src/commands/strategy.ts +181 -181
  56. package/src/commands/tts.ts +128 -128
  57. package/src/commands/upgrade.test.ts +82 -82
  58. package/src/commands/upgrade.ts +148 -148
  59. package/src/commands/watch.test.ts +999 -977
  60. package/src/commands/watch.ts +660 -658
  61. package/src/lib/auth.test.ts +74 -74
  62. package/src/lib/auth.ts +186 -186
  63. package/src/lib/command-meta.ts +37 -37
  64. package/src/lib/game-client.ts +403 -391
  65. package/src/lib/game-context.ts +92 -0
  66. package/src/lib/host-config-patcher.test.ts +130 -130
  67. package/src/lib/host-config-patcher.ts +151 -151
  68. package/src/lib/http-keepalive.ts +15 -15
  69. package/src/lib/http-transport.test.ts +42 -42
  70. package/src/lib/http-transport.ts +113 -113
  71. package/src/lib/hub-client.test.ts +56 -56
  72. package/src/lib/hub-client.ts +88 -88
  73. package/src/lib/hub-install.test.ts +98 -98
  74. package/src/lib/hub-install.ts +121 -121
  75. package/src/lib/hub-reminder.ts +56 -56
  76. package/src/lib/hub-unzip.test.ts +69 -69
  77. package/src/lib/hub-unzip.ts +62 -62
  78. package/src/lib/init-command.test.ts +75 -75
  79. package/src/lib/init-command.ts +120 -120
  80. package/src/lib/knowledge-store.test.ts +170 -170
  81. package/src/lib/knowledge-store.ts +369 -369
  82. package/src/lib/load-context.test.ts +52 -52
  83. package/src/lib/load-context.ts +52 -52
  84. package/src/lib/match-state.test.ts +134 -134
  85. package/src/lib/match-state.ts +94 -94
  86. package/src/lib/netease-tts.ts +83 -83
  87. package/src/lib/normalize.ts +42 -42
  88. package/src/lib/persona.test.ts +41 -41
  89. package/src/lib/persona.ts +72 -72
  90. package/src/lib/server-registry.ts +152 -152
  91. package/src/lib/skill-version.test.ts +48 -48
  92. package/src/lib/skill-version.ts +19 -19
  93. package/src/lib/strategy-export.test.ts +232 -232
  94. package/src/lib/strategy-export.ts +242 -242
  95. package/src/lib/tts-keys.ts +7 -7
  96. package/src/lib/tts-speech.test.ts +63 -63
  97. package/src/lib/tts-speech.ts +76 -76
  98. package/src/lib/workspace-argv.test.ts +49 -49
  99. package/src/lib/workspace-argv.ts +44 -44
  100. package/src/perception/player-history-store.test.ts +87 -87
  101. package/src/perception/player-history-store.ts +194 -194
  102. package/src/pipeline/event-format.test.ts +243 -215
  103. package/src/pipeline/event-format.ts +501 -485
  104. package/src/pipeline/event-hints.ts +195 -190
  105. package/src/pipeline/event-store.test.ts +28 -28
  106. package/src/pipeline/event-store.ts +193 -193
  107. package/src/pipeline/pipeline.ts +35 -35
  108. package/src/pipeline/player-projection.test.ts +119 -0
  109. package/src/pipeline/player-projection.ts +380 -0
  110. package/src/runtime/auto-upgrade.test.ts +66 -66
  111. package/src/runtime/auto-upgrade.ts +31 -31
  112. package/src/runtime/event-daemon.test.ts +209 -141
  113. package/src/runtime/event-daemon.ts +519 -457
  114. package/src/runtime/owner-control.ts +150 -150
  115. package/src/runtime/raw-ws-log.test.ts +33 -33
  116. package/src/runtime/raw-ws-log.ts +32 -32
  117. package/src/runtime/runtime-logger.ts +107 -107
  118. package/src/runtime/ws-client.test.ts +125 -104
  119. package/src/runtime/ws-client.ts +287 -272
  120. package/src/sdk/action.ts +166 -166
  121. package/src/sdk/index.ts +110 -110
  122. package/src/sdk/types.ts +161 -161
  123. package/src/strategies/avoid-lone.ts +12 -12
  124. package/src/strategies/avoid-players.knowledge.md +19 -19
  125. package/src/strategies/avoid-players.ts +16 -16
  126. package/src/strategies/corpse-patrol.ts +23 -23
  127. package/src/strategies/crab-sabotage.ts +22 -22
  128. package/src/strategies/custom-module.test.ts +270 -270
  129. package/src/strategies/find-player.ts +17 -17
  130. package/src/strategies/game-utils.test.ts +242 -242
  131. package/src/strategies/game-utils.ts +846 -846
  132. package/src/strategies/goals/anchor-linger.ts +77 -77
  133. package/src/strategies/goals/avoid-lone-top.ts +168 -168
  134. package/src/strategies/goals/avoid-players-top.test.ts +83 -83
  135. package/src/strategies/goals/avoid-players-top.ts +121 -121
  136. package/src/strategies/goals/conversation-goal.ts +51 -51
  137. package/src/strategies/goals/corpse-patrol-top.ts +113 -113
  138. package/src/strategies/goals/crab-octopus-reflexes.ts +101 -101
  139. package/src/strategies/goals/crab-sabotage-top.ts +197 -197
  140. package/src/strategies/goals/emergency-hunt-goal.ts +28 -28
  141. package/src/strategies/goals/find-player-top.ts +93 -93
  142. package/src/strategies/goals/flee-players-goal.ts +53 -53
  143. package/src/strategies/goals/follow-companion-goal.ts +106 -106
  144. package/src/strategies/goals/goal-manager.ts +41 -41
  145. package/src/strategies/goals/goal-root-strategy.ts +49 -49
  146. package/src/strategies/goals/goal.ts +28 -28
  147. package/src/strategies/goals/hide-top.ts +197 -197
  148. package/src/strategies/goals/keep-away-goal.ts +221 -221
  149. package/src/strategies/goals/kill-frenzy-top.ts +80 -80
  150. package/src/strategies/goals/kill-lone-top.ts +160 -160
  151. package/src/strategies/goals/kill-target-goal.ts +59 -59
  152. package/src/strategies/goals/kill-target-top.ts +109 -109
  153. package/src/strategies/goals/leaf-goal.ts +27 -27
  154. package/src/strategies/goals/linger-corpse-goal.ts +35 -35
  155. package/src/strategies/goals/lone-kill-core.ts +82 -82
  156. package/src/strategies/goals/lone-kill-goal.ts +24 -24
  157. package/src/strategies/goals/lone-kill-task-top.test.ts +85 -85
  158. package/src/strategies/goals/lone-kill-task-top.ts +133 -133
  159. package/src/strategies/goals/move-room-goal.ts +60 -60
  160. package/src/strategies/goals/normal-shrimp-top.test.ts +80 -80
  161. package/src/strategies/goals/normal-shrimp-top.ts +242 -242
  162. package/src/strategies/goals/paradise-fish-top.test.ts +126 -126
  163. package/src/strategies/goals/paradise-fish-top.ts +224 -224
  164. package/src/strategies/goals/patrol-top.ts +57 -57
  165. package/src/strategies/goals/report-patrol-top.ts +80 -80
  166. package/src/strategies/goals/safe-task-goal.ts +102 -102
  167. package/src/strategies/goals/social-task-top.ts +161 -161
  168. package/src/strategies/goals/task-kill-report-top.ts +163 -163
  169. package/src/strategies/goals/task-only-top.ts +57 -57
  170. package/src/strategies/goals/task-or-patrol-goal.ts +41 -41
  171. package/src/strategies/goals/task-report-top.ts +57 -57
  172. package/src/strategies/goals/wander-task-goal.ts +33 -33
  173. package/src/strategies/goals/warrior-shrimp-top.test.ts +87 -87
  174. package/src/strategies/goals/warrior-shrimp-top.ts +267 -267
  175. package/src/strategies/greeting.ts +53 -53
  176. package/src/strategies/hide-spots.ts +59 -59
  177. package/src/strategies/hide.ts +24 -24
  178. package/src/strategies/kill-frenzy.ts +13 -13
  179. package/src/strategies/kill-lone.knowledge.md +17 -17
  180. package/src/strategies/kill-lone.ts +14 -14
  181. package/src/strategies/kill-target.ts +19 -19
  182. package/src/strategies/loader.test.ts +678 -678
  183. package/src/strategies/loader.ts +179 -179
  184. package/src/strategies/lone-kill-task.ts +22 -22
  185. package/src/strategies/meeting-gate.test.ts +59 -59
  186. package/src/strategies/meeting-gate.ts +23 -23
  187. package/src/strategies/move-room.ts +16 -16
  188. package/src/strategies/new-events-backfill.ts +98 -98
  189. package/src/strategies/off-route-points.ts +105 -105
  190. package/src/strategies/paradise-fish.knowledge.md +19 -19
  191. package/src/strategies/paradise-fish.ts +26 -26
  192. package/src/strategies/pathfind/distance-field.ts +150 -150
  193. package/src/strategies/pathfind/escape-planner.test.ts +197 -197
  194. package/src/strategies/pathfind/escape-planner.ts +355 -355
  195. package/src/strategies/pathfind/walkable-grid.ts +117 -117
  196. package/src/strategies/patrol.ts +12 -12
  197. package/src/strategies/player-targets.ts +13 -13
  198. package/src/strategies/report-patrol.ts +12 -12
  199. package/src/strategies/shrimp-memory.knowledge.md +19 -19
  200. package/src/strategies/shrimp-memory.ts +26 -26
  201. package/src/strategies/social-task.test.ts +28 -28
  202. package/src/strategies/social-task.ts +50 -50
  203. package/src/strategies/spawn.ts +82 -82
  204. package/src/strategies/speech-module.ts +123 -123
  205. package/src/strategies/strategy-loop.test.ts +15 -0
  206. package/src/strategies/strategy-loop.ts +776 -771
  207. package/src/strategies/task-kill-report.ts +18 -18
  208. package/src/strategies/task-only.ts +12 -12
  209. package/src/strategies/task-report.ts +23 -23
  210. package/src/strategies/types.ts +109 -109
  211. package/src/strategies/warrior-memory.knowledge.md +21 -21
  212. package/src/strategies/warrior-memory.ts +17 -17
@@ -1,179 +1,179 @@
1
- import { existsSync, readdirSync, readFileSync, realpathSync, mkdtempSync, writeFileSync, rmSync } from 'fs';
2
- import { dirname, join, resolve, basename } from 'path';
3
- import { tmpdir } from 'os';
4
- import { fileURLToPath, pathToFileURL } from 'url';
5
- import { getWorkspaceDir } from '../lib/init-command.js';
6
- import type { Plugin, OnResolveArgs } from 'esbuild';
7
- import type { Strategy, StrategyEntry } from './types.js';
8
-
9
- const __filename = fileURLToPath(import.meta.url);
10
- const __dirname = dirname(__filename);
11
-
12
- // Resolve SDK path for user strategy imports (raw filesystem path, not URL).
13
- // realpathSync ensures dedup against built-in strategies even under --preserve-symlinks.
14
- const SDK_PATH = realpathSync(resolve(__dirname, '../sdk/index.ts'));
15
-
16
- const strategyMap = new Map<string, StrategyEntry>();
17
- const knowledgeDocMap = new Map<string, string>();
18
- let loaded = false;
19
-
20
- const INFRA_FILES = new Set(['loader', 'types', 'game-utils', 'player-targets', 'greeting', 'spawn', 'strategy-loop', 'new-events-backfill']);
21
-
22
- function resolveUserStrategiesDir(): string | undefined {
23
- const workspaceDir = getWorkspaceDir();
24
- if (!existsSync(workspaceDir)) return undefined;
25
- const strategiesDir = join(workspaceDir, 'strategies');
26
- if (!existsSync(strategiesDir)) return undefined;
27
- return strategiesDir;
28
- }
29
-
30
- /**
31
- * Create an esbuild plugin that intercepts `@myclaw163/clawclaw-cli` and
32
- * `@myclaw163/clawclaw-cli/*` imports (and the legacy bare `clawclaw-cli`
33
- * name for backward compat) and redirects them to the local SDK path
34
- * (marked external so Node resolves the same module instance at runtime).
35
- *
36
- * `require()` calls fail the build with a clear error, since `require` is
37
- * unavailable in ESM output and would otherwise crash at runtime.
38
- */
39
- function createSdkPlugin(): { plugin: Plugin } {
40
- const sdkUrl = pathToFileURL(SDK_PATH).href;
41
-
42
- const plugin: Plugin = {
43
- name: 'clawclaw-cli-sdk',
44
- setup(build) {
45
- build.onResolve({ filter: /^(?:@myclaw163\/)?clawclaw-cli(?:\/.*)?$/ }, (args: OnResolveArgs) => {
46
- if (args.kind === 'require-call') {
47
- return {
48
- errors: [{
49
- text: `require('${args.path}') is not supported in user strategies. Use static imports: import { ... } from '${args.path}'.`,
50
- }],
51
- };
52
- }
53
- return { path: sdkUrl, external: true };
54
- });
55
- },
56
- };
57
-
58
- return { plugin };
59
- }
60
-
61
- // Returns Record<string, unknown> — slightly less precise than native import()'s
62
- // Module type, but both are cast to StrategyEntry via `as` in loadFromDir.
63
- export async function importUserFile(filePath: string): Promise<Record<string, unknown>> {
64
- const { plugin } = createSdkPlugin();
65
- const { build } = await import('esbuild');
66
- const result = await build({
67
- stdin: {
68
- contents: readFileSync(filePath, 'utf8'),
69
- resolveDir: dirname(filePath),
70
- sourcefile: basename(filePath),
71
- loader: filePath.endsWith('.ts') ? 'ts' : 'js',
72
- },
73
- bundle: true,
74
- format: 'esm',
75
- write: false,
76
- platform: 'node',
77
- packages: 'external',
78
- plugins: [plugin],
79
- });
80
-
81
- // Write to temporary file so Node's module cache deduplicates the SDK —
82
- // data URLs load as separate module instances, breaking instanceof checks.
83
- const tmpDir = mkdtempSync(join(tmpdir(), 'ccl-strategy-'));
84
- const tmpFile = join(tmpDir, basename(filePath).replace(/\.(ts|js)$/, '.mjs'));
85
- try {
86
- writeFileSync(tmpFile, result.outputFiles[0].text);
87
- return await import(pathToFileURL(tmpFile).href);
88
- } finally {
89
- try { rmSync(tmpDir, { recursive: true, force: true }); } catch {}
90
- }
91
- }
92
-
93
- async function loadFromDir(dir: string, skipInfra: boolean): Promise<void> {
94
- let files: string[];
95
- try {
96
- files = readdirSync(dir).filter(f => {
97
- if (f.startsWith('_')) return false;
98
- const match = f.match(/^(.+)\.(ts|js)$/);
99
- if (!match) return false;
100
- if (match[1].endsWith('.d')) return false;
101
- if (match[1].endsWith('.test')) return false;
102
- return !skipInfra || !INFRA_FILES.has(match[1]);
103
- });
104
- } catch {
105
- return;
106
- }
107
- for (const file of files) {
108
- try {
109
- const filePath = realpathSync(join(dir, file));
110
- const mod = skipInfra
111
- ? await import(pathToFileURL(filePath).href)
112
- : await importUserFile(filePath);
113
- const entry: StrategyEntry | undefined = mod.strategy as StrategyEntry | undefined;
114
- if (entry?.id && typeof entry.description === 'string' && typeof entry.create === 'function') {
115
- strategyMap.set(entry.id, entry);
116
- const sidecar = filePath.replace(/\.(ts|js)$/, '.knowledge.md');
117
- if (existsSync(sidecar)) knowledgeDocMap.set(entry.id, sidecar);
118
- }
119
- } catch (err) {
120
- if (!skipInfra) {
121
- // Strip temp-dir paths from error messages — they leak internal
122
- // implementation details (e.g., /tmp/ccl-strategy-XXXX/strategy.mjs)
123
- const raw = err instanceof Error ? err.message : String(err);
124
- const cleaned = raw.replace(/\S*ccl-strategy-[^/]*\//g, '');
125
- console.error(`[ccl] Failed to load user strategy ${file}: ${cleaned}`);
126
- }
127
- }
128
- }
129
- }
130
-
131
- async function ensureLoaded(): Promise<void> {
132
- if (loaded) return;
133
- loaded = true;
134
- await loadFromDir(__dirname, true);
135
- const userDir = resolveUserStrategiesDir();
136
- if (userDir) await loadFromDir(userDir, false);
137
- }
138
-
139
- export async function getStrategyEntry(idOrName: string): Promise<StrategyEntry | undefined> {
140
- await ensureLoaded();
141
- const byId = strategyMap.get(idOrName);
142
- if (byId) return byId;
143
- // Fall back to the Chinese display name (StrategyEntry.name). id always wins,
144
- // so this only resolves an alias when no id matched.
145
- for (const entry of strategyMap.values()) {
146
- if (entry.name === idOrName) return entry;
147
- }
148
- return undefined;
149
- }
150
-
151
- export async function listStrategyEntries(): Promise<StrategyEntry[]> {
152
- await ensureLoaded();
153
- return [...strategyMap.values()];
154
- }
155
-
156
- export async function getStrategyKnowledgeDoc(id: string): Promise<string | undefined> {
157
- await ensureLoaded();
158
- const path = knowledgeDocMap.get(id);
159
- if (!path || !existsSync(path)) return undefined;
160
- try {
161
- return readFileSync(path, 'utf8');
162
- } catch {
163
- return undefined;
164
- }
165
- }
166
-
167
- export async function resolveStrategy(id: string, args?: string[]): Promise<Strategy> {
168
- const entry = await getStrategyEntry(id);
169
- if (!entry) throw new Error(`Unknown strategy '${id}'. Use 'strategy list' to see available strategies.`);
170
- return entry.create(args);
171
- }
172
-
173
- /** Reset and re-scan — call after a new strategy file is placed, so the next list/get picks it up. */
174
- export async function reload(): Promise<void> {
175
- loaded = false;
176
- strategyMap.clear();
177
- knowledgeDocMap.clear();
178
- await ensureLoaded();
179
- }
1
+ import { existsSync, readdirSync, readFileSync, realpathSync, mkdtempSync, writeFileSync, rmSync } from 'fs';
2
+ import { dirname, join, resolve, basename } from 'path';
3
+ import { tmpdir } from 'os';
4
+ import { fileURLToPath, pathToFileURL } from 'url';
5
+ import { getWorkspaceDir } from '../lib/init-command.js';
6
+ import type { Plugin, OnResolveArgs } from 'esbuild';
7
+ import type { Strategy, StrategyEntry } from './types.js';
8
+
9
+ const __filename = fileURLToPath(import.meta.url);
10
+ const __dirname = dirname(__filename);
11
+
12
+ // Resolve SDK path for user strategy imports (raw filesystem path, not URL).
13
+ // realpathSync ensures dedup against built-in strategies even under --preserve-symlinks.
14
+ const SDK_PATH = realpathSync(resolve(__dirname, '../sdk/index.ts'));
15
+
16
+ const strategyMap = new Map<string, StrategyEntry>();
17
+ const knowledgeDocMap = new Map<string, string>();
18
+ let loaded = false;
19
+
20
+ const INFRA_FILES = new Set(['loader', 'types', 'game-utils', 'player-targets', 'greeting', 'spawn', 'strategy-loop', 'new-events-backfill']);
21
+
22
+ function resolveUserStrategiesDir(): string | undefined {
23
+ const workspaceDir = getWorkspaceDir();
24
+ if (!existsSync(workspaceDir)) return undefined;
25
+ const strategiesDir = join(workspaceDir, 'strategies');
26
+ if (!existsSync(strategiesDir)) return undefined;
27
+ return strategiesDir;
28
+ }
29
+
30
+ /**
31
+ * Create an esbuild plugin that intercepts `@myclaw163/clawclaw-cli` and
32
+ * `@myclaw163/clawclaw-cli/*` imports (and the legacy bare `clawclaw-cli`
33
+ * name for backward compat) and redirects them to the local SDK path
34
+ * (marked external so Node resolves the same module instance at runtime).
35
+ *
36
+ * `require()` calls fail the build with a clear error, since `require` is
37
+ * unavailable in ESM output and would otherwise crash at runtime.
38
+ */
39
+ function createSdkPlugin(): { plugin: Plugin } {
40
+ const sdkUrl = pathToFileURL(SDK_PATH).href;
41
+
42
+ const plugin: Plugin = {
43
+ name: 'clawclaw-cli-sdk',
44
+ setup(build) {
45
+ build.onResolve({ filter: /^(?:@myclaw163\/)?clawclaw-cli(?:\/.*)?$/ }, (args: OnResolveArgs) => {
46
+ if (args.kind === 'require-call') {
47
+ return {
48
+ errors: [{
49
+ text: `require('${args.path}') is not supported in user strategies. Use static imports: import { ... } from '${args.path}'.`,
50
+ }],
51
+ };
52
+ }
53
+ return { path: sdkUrl, external: true };
54
+ });
55
+ },
56
+ };
57
+
58
+ return { plugin };
59
+ }
60
+
61
+ // Returns Record<string, unknown> — slightly less precise than native import()'s
62
+ // Module type, but both are cast to StrategyEntry via `as` in loadFromDir.
63
+ export async function importUserFile(filePath: string): Promise<Record<string, unknown>> {
64
+ const { plugin } = createSdkPlugin();
65
+ const { build } = await import('esbuild');
66
+ const result = await build({
67
+ stdin: {
68
+ contents: readFileSync(filePath, 'utf8'),
69
+ resolveDir: dirname(filePath),
70
+ sourcefile: basename(filePath),
71
+ loader: filePath.endsWith('.ts') ? 'ts' : 'js',
72
+ },
73
+ bundle: true,
74
+ format: 'esm',
75
+ write: false,
76
+ platform: 'node',
77
+ packages: 'external',
78
+ plugins: [plugin],
79
+ });
80
+
81
+ // Write to temporary file so Node's module cache deduplicates the SDK —
82
+ // data URLs load as separate module instances, breaking instanceof checks.
83
+ const tmpDir = mkdtempSync(join(tmpdir(), 'ccl-strategy-'));
84
+ const tmpFile = join(tmpDir, basename(filePath).replace(/\.(ts|js)$/, '.mjs'));
85
+ try {
86
+ writeFileSync(tmpFile, result.outputFiles[0].text);
87
+ return await import(pathToFileURL(tmpFile).href);
88
+ } finally {
89
+ try { rmSync(tmpDir, { recursive: true, force: true }); } catch {}
90
+ }
91
+ }
92
+
93
+ async function loadFromDir(dir: string, skipInfra: boolean): Promise<void> {
94
+ let files: string[];
95
+ try {
96
+ files = readdirSync(dir).filter(f => {
97
+ if (f.startsWith('_')) return false;
98
+ const match = f.match(/^(.+)\.(ts|js)$/);
99
+ if (!match) return false;
100
+ if (match[1].endsWith('.d')) return false;
101
+ if (match[1].endsWith('.test')) return false;
102
+ return !skipInfra || !INFRA_FILES.has(match[1]);
103
+ });
104
+ } catch {
105
+ return;
106
+ }
107
+ for (const file of files) {
108
+ try {
109
+ const filePath = realpathSync(join(dir, file));
110
+ const mod = skipInfra
111
+ ? await import(pathToFileURL(filePath).href)
112
+ : await importUserFile(filePath);
113
+ const entry: StrategyEntry | undefined = mod.strategy as StrategyEntry | undefined;
114
+ if (entry?.id && typeof entry.description === 'string' && typeof entry.create === 'function') {
115
+ strategyMap.set(entry.id, entry);
116
+ const sidecar = filePath.replace(/\.(ts|js)$/, '.knowledge.md');
117
+ if (existsSync(sidecar)) knowledgeDocMap.set(entry.id, sidecar);
118
+ }
119
+ } catch (err) {
120
+ if (!skipInfra) {
121
+ // Strip temp-dir paths from error messages — they leak internal
122
+ // implementation details (e.g., /tmp/ccl-strategy-XXXX/strategy.mjs)
123
+ const raw = err instanceof Error ? err.message : String(err);
124
+ const cleaned = raw.replace(/\S*ccl-strategy-[^/]*\//g, '');
125
+ console.error(`[ccl] Failed to load user strategy ${file}: ${cleaned}`);
126
+ }
127
+ }
128
+ }
129
+ }
130
+
131
+ async function ensureLoaded(): Promise<void> {
132
+ if (loaded) return;
133
+ loaded = true;
134
+ await loadFromDir(__dirname, true);
135
+ const userDir = resolveUserStrategiesDir();
136
+ if (userDir) await loadFromDir(userDir, false);
137
+ }
138
+
139
+ export async function getStrategyEntry(idOrName: string): Promise<StrategyEntry | undefined> {
140
+ await ensureLoaded();
141
+ const byId = strategyMap.get(idOrName);
142
+ if (byId) return byId;
143
+ // Fall back to the Chinese display name (StrategyEntry.name). id always wins,
144
+ // so this only resolves an alias when no id matched.
145
+ for (const entry of strategyMap.values()) {
146
+ if (entry.name === idOrName) return entry;
147
+ }
148
+ return undefined;
149
+ }
150
+
151
+ export async function listStrategyEntries(): Promise<StrategyEntry[]> {
152
+ await ensureLoaded();
153
+ return [...strategyMap.values()];
154
+ }
155
+
156
+ export async function getStrategyKnowledgeDoc(id: string): Promise<string | undefined> {
157
+ await ensureLoaded();
158
+ const path = knowledgeDocMap.get(id);
159
+ if (!path || !existsSync(path)) return undefined;
160
+ try {
161
+ return readFileSync(path, 'utf8');
162
+ } catch {
163
+ return undefined;
164
+ }
165
+ }
166
+
167
+ export async function resolveStrategy(id: string, args?: string[]): Promise<Strategy> {
168
+ const entry = await getStrategyEntry(id);
169
+ if (!entry) throw new Error(`Unknown strategy '${id}'. Use 'strategy list' to see available strategies.`);
170
+ return entry.create(args);
171
+ }
172
+
173
+ /** Reset and re-scan — call after a new strategy file is placed, so the next list/get picks it up. */
174
+ export async function reload(): Promise<void> {
175
+ loaded = false;
176
+ strategyMap.clear();
177
+ knowledgeDocMap.clear();
178
+ await ensureLoaded();
179
+ }
@@ -1,22 +1,22 @@
1
- import type { StrategyEntry } from './types.js';
2
- import { GoalRootStrategy } from './goals/goal-root-strategy.js';
3
- import { LoneKillTaskTop } from './goals/lone-kill-task-top.js';
4
- import { ConversationGoal } from './goals/conversation-goal.js';
5
- import { SpeechModule, getSpeechConfigForRole } from './speech-module.js';
6
-
7
- export const strategy: StrategyEntry = {
8
- id: 'lone-kill-task',
9
- name: '潜伏猎手',
10
- description: '视野里只有一个非队友且冷却可用就靠近,进入50距离就立刻出刀;刀在冷却时不追不等、改做低优先级任务伪装,冷却好且目标仍落单可见再出刀(贴脸且刀好仍会立刻出刀)。发现尸体且附近有非队友、但当前不能原地出刀时,会靠近并报告尸体。视野里出现两人以上时,暂停攻击10秒并做任意阵营的真实任务伪装;选任务时会跳过紧挨已知尸体(含看见过、已离开视野的)的任务,不在命案现场做任务。没有可做任务时按房间巡逻,绝不停在原地。残局(已知存活≤6)出现紧急维修任务时,会高优先级抢着去做(仍低于击杀落单),阻止蟹靠破坏倒计时取胜。(章鱼默认)',
11
- create(args?: string[]) {
12
- const role = args?.[0] ?? 'neutral_octopus';
13
- let convo: ConversationGoal | null = null;
14
- return new GoalRootStrategy('lone-kill-task', () => {
15
- convo = new ConversationGoal(() => new LoneKillTaskTop(), new SpeechModule(getSpeechConfigForRole(role)));
16
- return convo;
17
- }, {
18
- resetOnMeetingResume: false,
19
- onUpdateRole: role => convo?.updateConfig(role),
20
- });
21
- },
22
- };
1
+ import type { StrategyEntry } from './types.js';
2
+ import { GoalRootStrategy } from './goals/goal-root-strategy.js';
3
+ import { LoneKillTaskTop } from './goals/lone-kill-task-top.js';
4
+ import { ConversationGoal } from './goals/conversation-goal.js';
5
+ import { SpeechModule, getSpeechConfigForRole } from './speech-module.js';
6
+
7
+ export const strategy: StrategyEntry = {
8
+ id: 'lone-kill-task',
9
+ name: '潜伏猎手',
10
+ description: '视野里只有一个非队友且冷却可用就靠近,进入50距离就立刻出刀;刀在冷却时不追不等、改做低优先级任务伪装,冷却好且目标仍落单可见再出刀(贴脸且刀好仍会立刻出刀)。发现尸体且附近有非队友、但当前不能原地出刀时,会靠近并报告尸体。视野里出现两人以上时,暂停攻击10秒并做任意阵营的真实任务伪装;选任务时会跳过紧挨已知尸体(含看见过、已离开视野的)的任务,不在命案现场做任务。没有可做任务时按房间巡逻,绝不停在原地。残局(已知存活≤6)出现紧急维修任务时,会高优先级抢着去做(仍低于击杀落单),阻止蟹靠破坏倒计时取胜。(章鱼默认)',
11
+ create(args?: string[]) {
12
+ const role = args?.[0] ?? 'neutral_octopus';
13
+ let convo: ConversationGoal | null = null;
14
+ return new GoalRootStrategy('lone-kill-task', () => {
15
+ convo = new ConversationGoal(() => new LoneKillTaskTop(), new SpeechModule(getSpeechConfigForRole(role)));
16
+ return convo;
17
+ }, {
18
+ resetOnMeetingResume: false,
19
+ onUpdateRole: role => convo?.updateConfig(role),
20
+ });
21
+ },
22
+ };
@@ -1,59 +1,59 @@
1
- import { describe, expect, it } from 'vitest';
2
- import {
3
- meetingEndedInEvents,
4
- meetingStartedInEvents,
5
- shouldPauseForMeeting,
6
- } from './meeting-gate.js';
7
- import type { GameState } from '../sdk/types.js';
8
-
9
- function baseState(overrides: Partial<GameState> = {}): GameState {
10
- return {
11
- phase: 'wandering',
12
- tick: 1,
13
- you: {
14
- name: 'me',
15
- x: 0,
16
- y: 0,
17
- room: '酒吧',
18
- role: 'crab_generic',
19
- faction: 'crab',
20
- is_alive: true,
21
- },
22
- your_tasks: [],
23
- players: [],
24
- corpses: [],
25
- stale: false,
26
- ...overrides,
27
- };
28
- }
29
-
30
- describe('meeting-gate', () => {
31
- it('detects meeting end events', () => {
32
- expect(meetingEndedInEvents([{ type: 'meeting_ended' }])).toBe(true);
33
- expect(meetingEndedInEvents([{ type: 'meeting_result_pending' }])).toBe(true);
34
- expect(meetingEndedInEvents([{ type: 'speech' }])).toBe(false);
35
- });
36
-
37
- it('keeps pausing during meeting until end events arrive', () => {
38
- const during = baseState({ phase: 'meeting', new_events: [{ type: 'speech' }] });
39
- expect(shouldPauseForMeeting(during)).toBe(true);
40
-
41
- const ending = baseState({ phase: 'meeting', new_events: [{ type: 'meeting_ended' }] });
42
- expect(shouldPauseForMeeting(ending)).toBe(false);
43
-
44
- const wandering = baseState({ phase: 'wandering' });
45
- expect(shouldPauseForMeeting(wandering)).toBe(false);
46
- });
47
-
48
- it('does not re-pause after releasedEarly while HTTP phase still meeting', () => {
49
- const lingering = baseState({ phase: 'meeting', new_events: [] });
50
- expect(shouldPauseForMeeting(lingering, true)).toBe(false);
51
- expect(shouldPauseForMeeting(lingering, false)).toBe(true);
52
- });
53
-
54
- it('detects meeting start events for cycle reset', () => {
55
- expect(meetingStartedInEvents([{ type: 'meeting_start' }])).toBe(true);
56
- expect(meetingStartedInEvents([{ type: 'meeting_started' }])).toBe(true);
57
- expect(meetingStartedInEvents([{ type: 'speech' }])).toBe(false);
58
- });
59
- });
1
+ import { describe, expect, it } from 'vitest';
2
+ import {
3
+ meetingEndedInEvents,
4
+ meetingStartedInEvents,
5
+ shouldPauseForMeeting,
6
+ } from './meeting-gate.js';
7
+ import type { GameState } from '../sdk/types.js';
8
+
9
+ function baseState(overrides: Partial<GameState> = {}): GameState {
10
+ return {
11
+ phase: 'wandering',
12
+ tick: 1,
13
+ you: {
14
+ name: 'me',
15
+ x: 0,
16
+ y: 0,
17
+ room: '酒吧',
18
+ role: 'crab_generic',
19
+ faction: 'crab',
20
+ is_alive: true,
21
+ },
22
+ your_tasks: [],
23
+ players: [],
24
+ corpses: [],
25
+ stale: false,
26
+ ...overrides,
27
+ };
28
+ }
29
+
30
+ describe('meeting-gate', () => {
31
+ it('detects meeting end events', () => {
32
+ expect(meetingEndedInEvents([{ type: 'meeting_ended' }])).toBe(true);
33
+ expect(meetingEndedInEvents([{ type: 'meeting_result_pending' }])).toBe(true);
34
+ expect(meetingEndedInEvents([{ type: 'speech' }])).toBe(false);
35
+ });
36
+
37
+ it('keeps pausing during meeting until end events arrive', () => {
38
+ const during = baseState({ phase: 'meeting', new_events: [{ type: 'speech' }] });
39
+ expect(shouldPauseForMeeting(during)).toBe(true);
40
+
41
+ const ending = baseState({ phase: 'meeting', new_events: [{ type: 'meeting_ended' }] });
42
+ expect(shouldPauseForMeeting(ending)).toBe(false);
43
+
44
+ const wandering = baseState({ phase: 'wandering' });
45
+ expect(shouldPauseForMeeting(wandering)).toBe(false);
46
+ });
47
+
48
+ it('does not re-pause after releasedEarly while HTTP phase still meeting', () => {
49
+ const lingering = baseState({ phase: 'meeting', new_events: [] });
50
+ expect(shouldPauseForMeeting(lingering, true)).toBe(false);
51
+ expect(shouldPauseForMeeting(lingering, false)).toBe(true);
52
+ });
53
+
54
+ it('detects meeting start events for cycle reset', () => {
55
+ expect(meetingStartedInEvents([{ type: 'meeting_start' }])).toBe(true);
56
+ expect(meetingStartedInEvents([{ type: 'meeting_started' }])).toBe(true);
57
+ expect(meetingStartedInEvents([{ type: 'speech' }])).toBe(false);
58
+ });
59
+ });
@@ -1,23 +1,23 @@
1
- import type { GameState } from '../sdk/types.js';
2
-
3
- const MEETING_END_EVENT_TYPES = new Set(['meeting_ended', 'meeting_result_pending']);
4
- const MEETING_START_EVENT_TYPES = new Set(['meeting_start', 'meeting_started']);
5
-
6
- export function meetingEndedInEvents(events: any[] | undefined): boolean {
7
- return (events ?? []).some((e) => MEETING_END_EVENT_TYPES.has(e.type));
8
- }
9
-
10
- export function meetingStartedInEvents(events: any[] | undefined): boolean {
11
- return (events ?? []).some((e) => MEETING_START_EVENT_TYPES.has(e.type));
12
- }
13
-
14
- /**
15
- * Keep pausing while HTTP phase is still `meeting`.
16
- * `releasedEarly` is set after we have seen meeting end once — avoids re-pausing
17
- * on later polls where phase lags but `new_events` no longer repeats `meeting_ended`.
18
- */
19
- export function shouldPauseForMeeting(state: GameState, releasedEarly = false): boolean {
20
- if (state.phase !== 'meeting') return false;
21
- if (releasedEarly) return false;
22
- return !meetingEndedInEvents(state.new_events);
23
- }
1
+ import type { GameState } from '../sdk/types.js';
2
+
3
+ const MEETING_END_EVENT_TYPES = new Set(['meeting_ended', 'meeting_result_pending']);
4
+ const MEETING_START_EVENT_TYPES = new Set(['meeting_start', 'meeting_started']);
5
+
6
+ export function meetingEndedInEvents(events: any[] | undefined): boolean {
7
+ return (events ?? []).some((e) => MEETING_END_EVENT_TYPES.has(e.type));
8
+ }
9
+
10
+ export function meetingStartedInEvents(events: any[] | undefined): boolean {
11
+ return (events ?? []).some((e) => MEETING_START_EVENT_TYPES.has(e.type));
12
+ }
13
+
14
+ /**
15
+ * Keep pausing while HTTP phase is still `meeting`.
16
+ * `releasedEarly` is set after we have seen meeting end once — avoids re-pausing
17
+ * on later polls where phase lags but `new_events` no longer repeats `meeting_ended`.
18
+ */
19
+ export function shouldPauseForMeeting(state: GameState, releasedEarly = false): boolean {
20
+ if (state.phase !== 'meeting') return false;
21
+ if (releasedEarly) return false;
22
+ return !meetingEndedInEvents(state.new_events);
23
+ }
@@ -1,16 +1,16 @@
1
- import type { StrategyEntry } from './types.js';
2
- import { GoalRootStrategy } from './goals/goal-root-strategy.js';
3
- import { MoveRoomGoal } from './goals/move-room-goal.js';
4
-
5
- export const strategy: StrategyEntry = {
6
- id: 'move-room',
7
- name: '前往',
8
- description: '前往指定房间,到达后停下。参数为目标房间名(如 酒吧)。单纯走位,不做任务、不打人、不报告。',
9
- create(args?: string[]) {
10
- const targetRoom = args?.join(' ').trim() ?? '';
11
- if (!targetRoom) {
12
- throw new Error('move-room strategy requires a room name. Example: move-room 酒吧');
13
- }
14
- return new GoalRootStrategy('move-room', () => new MoveRoomGoal(targetRoom));
15
- },
16
- };
1
+ import type { StrategyEntry } from './types.js';
2
+ import { GoalRootStrategy } from './goals/goal-root-strategy.js';
3
+ import { MoveRoomGoal } from './goals/move-room-goal.js';
4
+
5
+ export const strategy: StrategyEntry = {
6
+ id: 'move-room',
7
+ name: '前往',
8
+ description: '前往指定房间,到达后停下。参数为目标房间名(如 酒吧)。单纯走位,不做任务、不打人、不报告。',
9
+ create(args?: string[]) {
10
+ const targetRoom = args?.join(' ').trim() ?? '';
11
+ if (!targetRoom) {
12
+ throw new Error('move-room strategy requires a room name. Example: move-room 酒吧');
13
+ }
14
+ return new GoalRootStrategy('move-room', () => new MoveRoomGoal(targetRoom));
15
+ },
16
+ };