@myclaw163/clawclaw-cli 0.6.57 → 0.6.58

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 (195) hide show
  1. package/README.md +440 -440
  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/postinstall.mjs +20 -20
  9. package/scripts/sync-bundled-skill.mjs +244 -244
  10. package/scripts/sync-bundled-skill.test.mjs +152 -152
  11. package/skills/clawclaw/SKILL.md +244 -244
  12. package/skills/clawclaw/references/CHATTERBOX.md +142 -142
  13. package/skills/clawclaw/references/COMMANDS.md +132 -132
  14. package/skills/clawclaw/references/GAME-MECHANICS.md +186 -186
  15. package/skills/clawclaw/references/HUB.md +48 -48
  16. package/skills/clawclaw/references/KNOWLEDGE.md +43 -43
  17. package/skills/clawclaw/references/STRATEGIES.md +57 -57
  18. package/skills/clawclaw/references/STREAM.md +59 -59
  19. package/skills/clawclaw/references/TACTICS.md +65 -65
  20. package/src/assets/clawclaw-ascii-map.txt +40 -40
  21. package/src/cli.ts +110 -110
  22. package/src/commands/_schema.ts +109 -109
  23. package/src/commands/account.ts +209 -209
  24. package/src/commands/config.ts +30 -30
  25. package/src/commands/do.test.ts +37 -37
  26. package/src/commands/do.ts +95 -95
  27. package/src/commands/events.ts +22 -22
  28. package/src/commands/game-map.test.ts +28 -28
  29. package/src/commands/game-start-plan.test.ts +84 -84
  30. package/src/commands/game.ts +1027 -1027
  31. package/src/commands/history-player.test.ts +102 -102
  32. package/src/commands/history.ts +573 -573
  33. package/src/commands/hub.test.ts +96 -96
  34. package/src/commands/hub.ts +234 -234
  35. package/src/commands/knowledge.test.ts +19 -19
  36. package/src/commands/knowledge.ts +168 -168
  37. package/src/commands/load.test.ts +51 -51
  38. package/src/commands/load.ts +13 -13
  39. package/src/commands/meeting-history.test.ts +106 -106
  40. package/src/commands/memory.ts +40 -40
  41. package/src/commands/peek.ts +45 -45
  42. package/src/commands/persona.ts +57 -57
  43. package/src/commands/setup/codex.ts +248 -248
  44. package/src/commands/setup/hermes.test.ts +96 -96
  45. package/src/commands/setup/hermes.ts +76 -76
  46. package/src/commands/setup/index.ts +13 -13
  47. package/src/commands/setup/openclaw.test.ts +114 -114
  48. package/src/commands/setup/openclaw.ts +147 -147
  49. package/src/commands/skill.ts +128 -128
  50. package/src/commands/state.ts +46 -46
  51. package/src/commands/strategy.test.ts +135 -135
  52. package/src/commands/strategy.ts +180 -180
  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 +969 -969
  57. package/src/commands/watch.ts +720 -720
  58. package/src/lib/auth.test.ts +59 -59
  59. package/src/lib/auth.ts +186 -186
  60. package/src/lib/command-meta.ts +37 -37
  61. package/src/lib/game-client.ts +391 -391
  62. package/src/lib/host-config-patcher.test.ts +130 -130
  63. package/src/lib/host-config-patcher.ts +151 -151
  64. package/src/lib/http-keepalive.ts +15 -15
  65. package/src/lib/http-transport.test.ts +42 -42
  66. package/src/lib/http-transport.ts +113 -113
  67. package/src/lib/hub-client.test.ts +56 -56
  68. package/src/lib/hub-client.ts +88 -88
  69. package/src/lib/hub-install.test.ts +98 -98
  70. package/src/lib/hub-install.ts +121 -121
  71. package/src/lib/hub-reminder.ts +56 -56
  72. package/src/lib/hub-unzip.test.ts +69 -69
  73. package/src/lib/hub-unzip.ts +62 -62
  74. package/src/lib/init-command.test.ts +75 -75
  75. package/src/lib/init-command.ts +120 -120
  76. package/src/lib/knowledge-store.test.ts +180 -180
  77. package/src/lib/knowledge-store.ts +374 -374
  78. package/src/lib/load-context.test.ts +52 -52
  79. package/src/lib/load-context.ts +52 -52
  80. package/src/lib/match-state.test.ts +134 -134
  81. package/src/lib/match-state.ts +94 -94
  82. package/src/lib/netease-tts.ts +83 -83
  83. package/src/lib/normalize.ts +42 -42
  84. package/src/lib/persona.test.ts +41 -41
  85. package/src/lib/persona.ts +72 -72
  86. package/src/lib/server-registry.ts +152 -152
  87. package/src/lib/skill-version.test.ts +48 -48
  88. package/src/lib/skill-version.ts +19 -19
  89. package/src/lib/strategy-export.test.ts +232 -232
  90. package/src/lib/strategy-export.ts +242 -242
  91. package/src/lib/tts-keys.ts +7 -7
  92. package/src/lib/tts-speech.test.ts +63 -63
  93. package/src/lib/tts-speech.ts +76 -76
  94. package/src/lib/workspace-argv.test.ts +49 -49
  95. package/src/lib/workspace-argv.ts +44 -44
  96. package/src/perception/player-history-store.test.ts +87 -87
  97. package/src/perception/player-history-store.ts +194 -194
  98. package/src/pipeline/event-store.ts +124 -124
  99. package/src/pipeline/pipeline.ts +35 -35
  100. package/src/runtime/auto-upgrade.test.ts +66 -66
  101. package/src/runtime/auto-upgrade.ts +31 -31
  102. package/src/runtime/event-daemon.test.ts +107 -107
  103. package/src/runtime/event-daemon.ts +409 -409
  104. package/src/runtime/owner-control.ts +150 -150
  105. package/src/runtime/raw-ws-log.test.ts +33 -33
  106. package/src/runtime/raw-ws-log.ts +32 -32
  107. package/src/runtime/runtime-logger.ts +107 -107
  108. package/src/runtime/ws-client.test.ts +104 -104
  109. package/src/runtime/ws-client.ts +272 -272
  110. package/src/sdk/action.ts +166 -166
  111. package/src/sdk/index.ts +110 -110
  112. package/src/sdk/types.ts +146 -146
  113. package/src/strategies/avoid-lone.ts +11 -11
  114. package/src/strategies/avoid-players.knowledge.md +20 -20
  115. package/src/strategies/avoid-players.ts +15 -15
  116. package/src/strategies/corpse-patrol.ts +22 -22
  117. package/src/strategies/crab-sabotage.ts +21 -21
  118. package/src/strategies/custom-module.test.ts +269 -269
  119. package/src/strategies/find-player.ts +16 -16
  120. package/src/strategies/game-utils.test.ts +190 -164
  121. package/src/strategies/game-utils.ts +744 -737
  122. package/src/strategies/goals/avoid-lone-top.ts +168 -168
  123. package/src/strategies/goals/avoid-players-top.test.ts +83 -83
  124. package/src/strategies/goals/avoid-players-top.ts +121 -121
  125. package/src/strategies/goals/conversation-goal.ts +51 -51
  126. package/src/strategies/goals/corpse-patrol-top.ts +91 -91
  127. package/src/strategies/goals/crab-octopus-reflexes.ts +93 -93
  128. package/src/strategies/goals/crab-sabotage-top.ts +197 -197
  129. package/src/strategies/goals/emergency-hunt-goal.ts +28 -28
  130. package/src/strategies/goals/find-player-top.ts +93 -93
  131. package/src/strategies/goals/flee-players-goal.ts +53 -53
  132. package/src/strategies/goals/goal-manager.ts +41 -41
  133. package/src/strategies/goals/goal-root-strategy.ts +49 -49
  134. package/src/strategies/goals/goal.ts +28 -28
  135. package/src/strategies/goals/keep-away-goal.ts +209 -206
  136. package/src/strategies/goals/kill-frenzy-top.ts +80 -80
  137. package/src/strategies/goals/kill-lone-top.ts +160 -160
  138. package/src/strategies/goals/kill-target-goal.ts +59 -59
  139. package/src/strategies/goals/kill-target-top.ts +109 -109
  140. package/src/strategies/goals/leaf-goal.ts +25 -25
  141. package/src/strategies/goals/linger-corpse-goal.ts +79 -79
  142. package/src/strategies/goals/lone-kill-core.ts +82 -82
  143. package/src/strategies/goals/lone-kill-goal.ts +24 -24
  144. package/src/strategies/goals/lone-kill-task-top.test.ts +85 -85
  145. package/src/strategies/goals/lone-kill-task-top.ts +86 -86
  146. package/src/strategies/goals/move-room-goal.ts +60 -60
  147. package/src/strategies/goals/normal-shrimp-top.test.ts +80 -80
  148. package/src/strategies/goals/normal-shrimp-top.ts +242 -242
  149. package/src/strategies/goals/paradise-fish-top.test.ts +126 -126
  150. package/src/strategies/goals/paradise-fish-top.ts +219 -219
  151. package/src/strategies/goals/patrol-top.ts +57 -57
  152. package/src/strategies/goals/report-patrol-top.ts +80 -80
  153. package/src/strategies/goals/safe-task-goal.ts +102 -102
  154. package/src/strategies/goals/social-task-top.ts +161 -161
  155. package/src/strategies/goals/task-kill-report-top.ts +163 -163
  156. package/src/strategies/goals/task-only-top.ts +57 -57
  157. package/src/strategies/goals/task-or-patrol-goal.ts +41 -41
  158. package/src/strategies/goals/task-report-top.ts +57 -57
  159. package/src/strategies/goals/wander-task-goal.ts +33 -33
  160. package/src/strategies/goals/warrior-shrimp-top.test.ts +86 -86
  161. package/src/strategies/goals/warrior-shrimp-top.ts +248 -248
  162. package/src/strategies/greeting.ts +53 -53
  163. package/src/strategies/kill-frenzy.ts +12 -12
  164. package/src/strategies/kill-lone.knowledge.md +20 -20
  165. package/src/strategies/kill-lone.ts +13 -13
  166. package/src/strategies/kill-target.ts +18 -18
  167. package/src/strategies/loader.test.ts +678 -678
  168. package/src/strategies/loader.ts +172 -172
  169. package/src/strategies/lone-kill-task.ts +21 -21
  170. package/src/strategies/meeting-gate.test.ts +59 -59
  171. package/src/strategies/meeting-gate.ts +23 -23
  172. package/src/strategies/move-room.ts +15 -15
  173. package/src/strategies/new-events-backfill.ts +98 -98
  174. package/src/strategies/paradise-fish.knowledge.md +20 -20
  175. package/src/strategies/paradise-fish.ts +25 -25
  176. package/src/strategies/pathfind/distance-field.ts +150 -150
  177. package/src/strategies/pathfind/escape-planner.test.ts +197 -197
  178. package/src/strategies/pathfind/escape-planner.ts +355 -348
  179. package/src/strategies/pathfind/walkable-grid.ts +117 -117
  180. package/src/strategies/patrol.ts +11 -11
  181. package/src/strategies/player-targets.ts +13 -13
  182. package/src/strategies/report-patrol.ts +11 -11
  183. package/src/strategies/shrimp-memory.knowledge.md +20 -20
  184. package/src/strategies/shrimp-memory.ts +25 -25
  185. package/src/strategies/social-task.test.ts +28 -28
  186. package/src/strategies/social-task.ts +49 -49
  187. package/src/strategies/spawn.ts +82 -82
  188. package/src/strategies/speech-module.ts +123 -123
  189. package/src/strategies/strategy-loop.ts +763 -763
  190. package/src/strategies/task-kill-report.ts +17 -17
  191. package/src/strategies/task-only.ts +11 -11
  192. package/src/strategies/task-report.ts +22 -22
  193. package/src/strategies/types.ts +96 -96
  194. package/src/strategies/warrior-memory.knowledge.md +20 -20
  195. package/src/strategies/warrior-memory.ts +16 -16
@@ -1,172 +1,172 @@
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(id: string): Promise<StrategyEntry | undefined> {
140
- await ensureLoaded();
141
- return strategyMap.get(id);
142
- }
143
-
144
- export async function listStrategyEntries(): Promise<StrategyEntry[]> {
145
- await ensureLoaded();
146
- return [...strategyMap.values()];
147
- }
148
-
149
- export async function getStrategyKnowledgeDoc(id: string): Promise<string | undefined> {
150
- await ensureLoaded();
151
- const path = knowledgeDocMap.get(id);
152
- if (!path || !existsSync(path)) return undefined;
153
- try {
154
- return readFileSync(path, 'utf8');
155
- } catch {
156
- return undefined;
157
- }
158
- }
159
-
160
- export async function resolveStrategy(id: string, args?: string[]): Promise<Strategy> {
161
- const entry = await getStrategyEntry(id);
162
- if (!entry) throw new Error(`Unknown strategy '${id}'. Use 'strategy list' to see available strategies.`);
163
- return entry.create(args);
164
- }
165
-
166
- /** Reset and re-scan — call after a new strategy file is placed, so the next list/get picks it up. */
167
- export async function reload(): Promise<void> {
168
- loaded = false;
169
- strategyMap.clear();
170
- knowledgeDocMap.clear();
171
- await ensureLoaded();
172
- }
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(id: string): Promise<StrategyEntry | undefined> {
140
+ await ensureLoaded();
141
+ return strategyMap.get(id);
142
+ }
143
+
144
+ export async function listStrategyEntries(): Promise<StrategyEntry[]> {
145
+ await ensureLoaded();
146
+ return [...strategyMap.values()];
147
+ }
148
+
149
+ export async function getStrategyKnowledgeDoc(id: string): Promise<string | undefined> {
150
+ await ensureLoaded();
151
+ const path = knowledgeDocMap.get(id);
152
+ if (!path || !existsSync(path)) return undefined;
153
+ try {
154
+ return readFileSync(path, 'utf8');
155
+ } catch {
156
+ return undefined;
157
+ }
158
+ }
159
+
160
+ export async function resolveStrategy(id: string, args?: string[]): Promise<Strategy> {
161
+ const entry = await getStrategyEntry(id);
162
+ if (!entry) throw new Error(`Unknown strategy '${id}'. Use 'strategy list' to see available strategies.`);
163
+ return entry.create(args);
164
+ }
165
+
166
+ /** Reset and re-scan — call after a new strategy file is placed, so the next list/get picks it up. */
167
+ export async function reload(): Promise<void> {
168
+ loaded = false;
169
+ strategyMap.clear();
170
+ knowledgeDocMap.clear();
171
+ await ensureLoaded();
172
+ }
@@ -1,21 +1,21 @@
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
- description: '视野里只有一个非队友且冷却可用就靠近,进入50距离就立刻出刀;刀在冷却时不追不等、改做低优先级任务伪装,冷却好且目标仍落单可见再出刀(贴脸且刀好仍会立刻出刀)。发现尸体且附近有非队友、但当前不能原地出刀时,会靠近并报告尸体。视野里出现两人以上时,暂停攻击10秒并做任意阵营的真实任务伪装;选任务时会跳过紧挨已知尸体(含看见过、已离开视野的)的任务,不在命案现场做任务。没有可做任务时按房间巡逻,绝不停在原地。(章鱼默认)',
10
- create(args?: string[]) {
11
- const role = args?.[0] ?? 'neutral_octopus';
12
- let convo: ConversationGoal | null = null;
13
- return new GoalRootStrategy('lone-kill-task', () => {
14
- convo = new ConversationGoal(() => new LoneKillTaskTop(), new SpeechModule(getSpeechConfigForRole(role)));
15
- return convo;
16
- }, {
17
- resetOnMeetingResume: false,
18
- onUpdateRole: role => convo?.updateConfig(role),
19
- });
20
- },
21
- };
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
+ description: '视野里只有一个非队友且冷却可用就靠近,进入50距离就立刻出刀;刀在冷却时不追不等、改做低优先级任务伪装,冷却好且目标仍落单可见再出刀(贴脸且刀好仍会立刻出刀)。发现尸体且附近有非队友、但当前不能原地出刀时,会靠近并报告尸体。视野里出现两人以上时,暂停攻击10秒并做任意阵营的真实任务伪装;选任务时会跳过紧挨已知尸体(含看见过、已离开视野的)的任务,不在命案现场做任务。没有可做任务时按房间巡逻,绝不停在原地。(章鱼默认)',
10
+ create(args?: string[]) {
11
+ const role = args?.[0] ?? 'neutral_octopus';
12
+ let convo: ConversationGoal | null = null;
13
+ return new GoalRootStrategy('lone-kill-task', () => {
14
+ convo = new ConversationGoal(() => new LoneKillTaskTop(), new SpeechModule(getSpeechConfigForRole(role)));
15
+ return convo;
16
+ }, {
17
+ resetOnMeetingResume: false,
18
+ onUpdateRole: role => convo?.updateConfig(role),
19
+ });
20
+ },
21
+ };
@@ -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,15 +1,15 @@
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
- description: '前往指定房间,到达后停下。参数为目标房间名(如 酒吧)。单纯走位,不做任务、不打人、不报告。',
8
- create(args?: string[]) {
9
- const targetRoom = args?.join(' ').trim() ?? '';
10
- if (!targetRoom) {
11
- throw new Error('move-room strategy requires a room name. Example: move-room 酒吧');
12
- }
13
- return new GoalRootStrategy('move-room', () => new MoveRoomGoal(targetRoom));
14
- },
15
- };
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
+ description: '前往指定房间,到达后停下。参数为目标房间名(如 酒吧)。单纯走位,不做任务、不打人、不报告。',
8
+ create(args?: string[]) {
9
+ const targetRoom = args?.join(' ').trim() ?? '';
10
+ if (!targetRoom) {
11
+ throw new Error('move-room strategy requires a room name. Example: move-room 酒吧');
12
+ }
13
+ return new GoalRootStrategy('move-room', () => new MoveRoomGoal(targetRoom));
14
+ },
15
+ };