@myclaw163/clawclaw-cli 0.6.66 → 0.6.67

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 (199) hide show
  1. package/README.md +427 -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/find-hide-spots.py +157 -157
  10. package/scripts/postinstall.mjs +20 -20
  11. package/scripts/sync-bundled-skill.mjs +245 -245
  12. package/scripts/sync-bundled-skill.test.mjs +152 -152
  13. package/skills/clawclaw/SKILL.md +244 -245
  14. package/skills/clawclaw/references/CHATTERBOX.md +142 -142
  15. package/skills/clawclaw/references/COMMANDS.md +148 -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 +43 -43
  19. package/skills/clawclaw/references/STRATEGIES.md +57 -57
  20. package/skills/clawclaw/references/STREAM.md +91 -92
  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 +109 -109
  25. package/src/commands/account.ts +209 -209
  26. package/src/commands/do.test.ts +73 -73
  27. package/src/commands/do.ts +126 -126
  28. package/src/commands/events.test.ts +71 -71
  29. package/src/commands/events.ts +155 -155
  30. package/src/commands/game-map.test.ts +28 -28
  31. package/src/commands/game-start-plan.test.ts +84 -84
  32. package/src/commands/game.ts +1027 -1027
  33. package/src/commands/history-player.test.ts +102 -102
  34. package/src/commands/history.ts +573 -573
  35. package/src/commands/hub.test.ts +96 -96
  36. package/src/commands/hub.ts +234 -234
  37. package/src/commands/knowledge.test.ts +19 -19
  38. package/src/commands/knowledge.ts +168 -168
  39. package/src/commands/load.test.ts +51 -51
  40. package/src/commands/load.ts +13 -13
  41. package/src/commands/meeting-history.test.ts +106 -106
  42. package/src/commands/memory.ts +40 -40
  43. package/src/commands/peek.ts +45 -45
  44. package/src/commands/persona.ts +57 -57
  45. package/src/commands/setup/codex.ts +266 -248
  46. package/src/commands/skill.ts +128 -128
  47. package/src/commands/state.ts +46 -46
  48. package/src/commands/strategy.test.ts +135 -135
  49. package/src/commands/strategy.ts +180 -180
  50. package/src/commands/tts.ts +128 -128
  51. package/src/commands/upgrade.test.ts +82 -82
  52. package/src/commands/upgrade.ts +148 -148
  53. package/src/commands/watch.test.ts +966 -966
  54. package/src/commands/watch.ts +659 -659
  55. package/src/lib/auth.test.ts +59 -59
  56. package/src/lib/auth.ts +186 -186
  57. package/src/lib/command-meta.ts +37 -37
  58. package/src/lib/game-client.ts +391 -391
  59. package/src/lib/http-keepalive.ts +15 -15
  60. package/src/lib/http-transport.test.ts +42 -42
  61. package/src/lib/http-transport.ts +113 -113
  62. package/src/lib/hub-client.test.ts +56 -56
  63. package/src/lib/hub-client.ts +88 -88
  64. package/src/lib/hub-install.test.ts +98 -98
  65. package/src/lib/hub-install.ts +121 -121
  66. package/src/lib/hub-reminder.ts +75 -75
  67. package/src/lib/hub-unzip.test.ts +69 -69
  68. package/src/lib/hub-unzip.ts +62 -62
  69. package/src/lib/init-command.test.ts +75 -75
  70. package/src/lib/init-command.ts +120 -120
  71. package/src/lib/knowledge-store.test.ts +180 -180
  72. package/src/lib/knowledge-store.ts +374 -374
  73. package/src/lib/load-context.test.ts +52 -52
  74. package/src/lib/load-context.ts +52 -52
  75. package/src/lib/match-state.test.ts +134 -134
  76. package/src/lib/match-state.ts +94 -94
  77. package/src/lib/netease-tts.ts +83 -83
  78. package/src/lib/normalize.ts +42 -42
  79. package/src/lib/persona.test.ts +41 -41
  80. package/src/lib/persona.ts +72 -72
  81. package/src/lib/server-registry.ts +152 -152
  82. package/src/lib/skill-version.test.ts +48 -48
  83. package/src/lib/skill-version.ts +19 -19
  84. package/src/lib/strategy-export.test.ts +232 -232
  85. package/src/lib/strategy-export.ts +242 -242
  86. package/src/lib/tts-keys.ts +7 -7
  87. package/src/lib/tts-speech.test.ts +63 -63
  88. package/src/lib/tts-speech.ts +76 -76
  89. package/src/lib/workspace-argv.test.ts +49 -49
  90. package/src/lib/workspace-argv.ts +44 -44
  91. package/src/perception/player-history-store.test.ts +87 -87
  92. package/src/perception/player-history-store.ts +194 -194
  93. package/src/pipeline/event-format.test.ts +135 -135
  94. package/src/pipeline/event-format.ts +376 -376
  95. package/src/pipeline/event-hints.ts +173 -173
  96. package/src/pipeline/event-store.test.ts +28 -28
  97. package/src/pipeline/event-store.ts +193 -193
  98. package/src/pipeline/pipeline.ts +35 -35
  99. package/src/runtime/auto-upgrade.test.ts +66 -66
  100. package/src/runtime/auto-upgrade.ts +31 -31
  101. package/src/runtime/event-daemon.test.ts +107 -107
  102. package/src/runtime/event-daemon.ts +409 -409
  103. package/src/runtime/owner-control.ts +150 -150
  104. package/src/runtime/raw-ws-log.test.ts +33 -33
  105. package/src/runtime/raw-ws-log.ts +32 -32
  106. package/src/runtime/runtime-logger.ts +107 -107
  107. package/src/runtime/ws-client.test.ts +104 -104
  108. package/src/runtime/ws-client.ts +272 -272
  109. package/src/sdk/action.ts +166 -166
  110. package/src/sdk/index.ts +111 -111
  111. package/src/sdk/types.ts +159 -159
  112. package/src/strategies/avoid-lone.ts +11 -11
  113. package/src/strategies/avoid-players.knowledge.md +20 -20
  114. package/src/strategies/avoid-players.ts +15 -15
  115. package/src/strategies/corpse-patrol.ts +22 -22
  116. package/src/strategies/crab-sabotage.ts +21 -21
  117. package/src/strategies/custom-module.test.ts +269 -269
  118. package/src/strategies/find-player.ts +16 -16
  119. package/src/strategies/game-utils.test.ts +190 -190
  120. package/src/strategies/game-utils.ts +782 -782
  121. package/src/strategies/goals/anchor-linger.ts +77 -77
  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/follow-companion-goal.ts +106 -106
  133. package/src/strategies/goals/goal-manager.ts +41 -41
  134. package/src/strategies/goals/goal-root-strategy.ts +49 -49
  135. package/src/strategies/goals/goal.ts +28 -28
  136. package/src/strategies/goals/hide-top.ts +197 -197
  137. package/src/strategies/goals/keep-away-goal.ts +217 -217
  138. package/src/strategies/goals/kill-frenzy-top.ts +80 -80
  139. package/src/strategies/goals/kill-lone-top.ts +160 -160
  140. package/src/strategies/goals/kill-target-goal.ts +59 -59
  141. package/src/strategies/goals/kill-target-top.ts +109 -109
  142. package/src/strategies/goals/leaf-goal.ts +25 -25
  143. package/src/strategies/goals/linger-corpse-goal.ts +35 -35
  144. package/src/strategies/goals/lone-kill-core.ts +82 -82
  145. package/src/strategies/goals/lone-kill-goal.ts +24 -24
  146. package/src/strategies/goals/lone-kill-task-top.test.ts +85 -85
  147. package/src/strategies/goals/lone-kill-task-top.ts +86 -86
  148. package/src/strategies/goals/move-room-goal.ts +60 -60
  149. package/src/strategies/goals/normal-shrimp-top.test.ts +80 -80
  150. package/src/strategies/goals/normal-shrimp-top.ts +242 -242
  151. package/src/strategies/goals/paradise-fish-top.test.ts +126 -126
  152. package/src/strategies/goals/paradise-fish-top.ts +207 -207
  153. package/src/strategies/goals/patrol-top.ts +57 -57
  154. package/src/strategies/goals/report-patrol-top.ts +80 -80
  155. package/src/strategies/goals/safe-task-goal.ts +102 -102
  156. package/src/strategies/goals/social-task-top.ts +161 -161
  157. package/src/strategies/goals/task-kill-report-top.ts +163 -163
  158. package/src/strategies/goals/task-only-top.ts +57 -57
  159. package/src/strategies/goals/task-or-patrol-goal.ts +41 -41
  160. package/src/strategies/goals/task-report-top.ts +57 -57
  161. package/src/strategies/goals/wander-task-goal.ts +33 -33
  162. package/src/strategies/goals/warrior-shrimp-top.test.ts +86 -86
  163. package/src/strategies/goals/warrior-shrimp-top.ts +500 -500
  164. package/src/strategies/greeting.ts +53 -53
  165. package/src/strategies/hide-spots.ts +123 -123
  166. package/src/strategies/hide.ts +23 -23
  167. package/src/strategies/kill-frenzy.ts +12 -12
  168. package/src/strategies/kill-lone.knowledge.md +20 -20
  169. package/src/strategies/kill-lone.ts +13 -13
  170. package/src/strategies/kill-target.ts +18 -18
  171. package/src/strategies/loader.test.ts +678 -678
  172. package/src/strategies/loader.ts +172 -172
  173. package/src/strategies/lone-kill-task.ts +21 -21
  174. package/src/strategies/meeting-gate.test.ts +59 -59
  175. package/src/strategies/meeting-gate.ts +23 -23
  176. package/src/strategies/move-room.ts +15 -15
  177. package/src/strategies/new-events-backfill.ts +98 -98
  178. package/src/strategies/paradise-fish.knowledge.md +20 -20
  179. package/src/strategies/paradise-fish.ts +25 -25
  180. package/src/strategies/pathfind/distance-field.ts +150 -150
  181. package/src/strategies/pathfind/escape-planner.test.ts +197 -197
  182. package/src/strategies/pathfind/escape-planner.ts +355 -355
  183. package/src/strategies/pathfind/walkable-grid.ts +117 -117
  184. package/src/strategies/patrol.ts +11 -11
  185. package/src/strategies/player-targets.ts +13 -13
  186. package/src/strategies/report-patrol.ts +11 -11
  187. package/src/strategies/shrimp-memory.knowledge.md +20 -20
  188. package/src/strategies/shrimp-memory.ts +25 -25
  189. package/src/strategies/social-task.test.ts +28 -28
  190. package/src/strategies/social-task.ts +49 -49
  191. package/src/strategies/spawn.ts +82 -82
  192. package/src/strategies/speech-module.ts +123 -123
  193. package/src/strategies/strategy-loop.ts +771 -771
  194. package/src/strategies/task-kill-report.ts +17 -17
  195. package/src/strategies/task-only.ts +11 -11
  196. package/src/strategies/task-report.ts +22 -22
  197. package/src/strategies/types.ts +102 -102
  198. package/src/strategies/warrior-memory.knowledge.md +22 -22
  199. 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
+ };