@myclaw163/clawclaw-cli 0.6.65 → 0.6.66

package/src/sdk/action.ts

@@ -1,166 +1,166 @@
-/**
- * Action — an immutable, typed game command sent to the server each tick.
- *
- * All static factories (`move`, `kill`, `speech`, …) return frozen `Action`
- * instances. Attach spectator-visible reasoning with `.withThinking(content)`,
- * which returns a new `Action` without mutating the original.
- *
- * @example
- * ```ts
- * return Action.move('kitchen').withThinking('Heading to the kitchen for my task.');
- * return Action.kill('PlayerB').withThinking('Alone with target — safe window.');
- * ```
- */
-export class Action {
-  readonly type: string;
-  readonly payload: Record<string, any>;
-  /**
-   * Spectator-visible reasoning string sent as `thinking_content` to the server.
-   * Visible to observers only — not exposed to other in-game players.
-   */
-  readonly thinkingContent: string | null;
-
-  private constructor(type: string, payload: Record<string, any>, thinkingContent: string | null = null) {
-    this.type = type;
-    this.payload = payload;
-    this.thinkingContent = thinkingContent;
-    Object.freeze(this);
-    Object.freeze(this.payload);
-  }
-
-  /**
-   * Attach (or replace) the spectator-visible thinking content.
-   * Returns a **new** immutable `Action` — the original is unchanged.
-   *
-   * @example Action.kill('playerA').withThinking('Safe kill — only one witness.')
-   */
-  withThinking(content: string): Action {
-    return new Action(this.type, { ...this.payload }, content);
-  }
-
-  /**
-   * Attach (or replace) the speech audio URL.
-   * Returns a **new** immutable `Action` — the original is unchanged.
-   * Typically used by the runtime to inject TTS-generated audio into speech actions.
-   */
-  withAudioUrl(audioUrl: string): Action {
-    return new Action(this.type, { ...this.payload, audio_url: audioUrl }, this.thinkingContent);
-  }
-
-  /**
-   * Move toward a room (by name) or a coordinate target.
-   *
-   * @param target        Room id string, or a `{ x, y }` coordinate pair.
-   * @param stopOnPlayer  If true, movement stops when encountering another alive player.
-   */
-  static move(target: { x: number; y: number } | string, stopOnPlayer = false): Action {
-    if (typeof target === 'string') {
-      const payload: Record<string, any> = { target };
-      if (stopOnPlayer) payload.stop_on_player = true;
-      return new Action('move', payload, `前往 ${target}`);
-    }
-    const payload: Record<string, any> = { target_x: target.x, target_y: target.y };
-    if (stopOnPlayer) payload.stop_on_player = true;
-    return new Action('move', payload);
-  }
-
-  /**
-   * Kill the named player.
-   * Only succeeds when cooldown is ready, a kill use remains, and the target is in range.
-   */
-  static kill(target: string): Action {
-    return new Action('kill', { target }, `击杀 ${target}`);
-  }
-
-  /**
-   * Broadcast a speech during the wandering phase.
-   *
-   * @param text             Words spoken (audible to nearby players).
-   * @param thinkingContent  Optional spectator-visible reasoning.
-   * @param audioUrl         Optional TTS audio URL.
-   */
-  static speech(text: string, thinkingContent?: string, audioUrl?: string): Action {
-    const payload: Record<string, any> = { text };
-    if (audioUrl) {
-      payload.audio_url = audioUrl;
-    }
-    return new Action('speech', payload, thinkingContent ?? null);
-    // speech: no default thinking (the speech content itself is the message)
-  }
-
-  /**
-   * Cast a vote during the meeting vote sub-phase.
-   *
-   * @param target  Name of the player to vote out.
-   */
-  static vote(target: string): Action {
-    return new Action('vote', { target }, `投票 ${target}`);
-  }
-
-  /**
-   * Execute (or move toward) a task.
-   *
-   * @param taskName  Optional task name. Omit to let the server resolve which
-   *                  task to execute at the current location.
-   */
-  static doTask(taskName?: string): Action {
-    return new Action('task', taskName ? { task_name: taskName } : {}, taskName ? `执行任务 ${taskName}` : '执行任务');
-  }
-
-  /**
-   * Report a corpse to trigger an emergency meeting.
-   *
-   * @param corpseName  Name of the dead player (written to thinking log).
-   * @param room        Room where the corpse was found.
-   */
-  static report(corpseName?: string, room?: string): Action {
-    const thinking = corpseName
-      ? `发现尸体（${corpseName}${room ? ` 在 ${room}` : ''}），报告召开会议`
-      : '发现尸体，报告召开会议';
-    return new Action('report', {}, thinking);
-  }
-
-  /**
-   * Pure thinking action — sends only `thinking_content` with no in-game effect.
-   * Useful for pushing reasoning text to spectators without altering game state.
-   */
-  static think(): Action {
-    return new Action('think', {}, '正在思考...');
-  }
-
-  /**
-   * Trigger the emergency alarm. Crab faction exclusive.
-   * Starts a timed emergency event that Shrimp players must resolve.
-   */
-  static triggerAlarm(): Action {
-    return new Action('trigger_alarm', {}, '触发紧急警报！');
-  }
-
-  /**
-   * Deserialize an `Action` from a plain JSON object.
-   * Accepts both `{ action: "move", … }` and `{ type: "move", … }` formats.
-   *
-   * @throws {Error} If the object contains no valid action type string.
-   */
-  static fromJSON(json: Record<string, any>): Action {
-    // Support both { action: "move", ... } and { type: "move", ... } formats
-    const type = json.action ?? json.type;
-    if (!type || typeof type !== 'string') {
-      throw new Error(`Action.fromJSON: missing or invalid action type in ${JSON.stringify(json)}`);
-    }
-    const { action: _a, type: _t, thinking_content, ...payload } = json;
-    return new Action(type, payload, thinking_content ?? null);
-  }
-
-  /**
-   * Serialize this `Action` to a plain object for transmission to the server.
-   * The `thinking_content` key is omitted when `thinkingContent` is null.
-   */
-  toJSON(): Record<string, any> {
-    const obj: Record<string, any> = { action: this.type, ...this.payload };
-    if (this.thinkingContent) {
-      obj.thinking_content = this.thinkingContent;
-    }
-    return obj;
-  }
-}
+/**
+ * Action — an immutable, typed game command sent to the server each tick.
+ *
+ * All static factories (`move`, `kill`, `speech`, …) return frozen `Action`
+ * instances. Attach spectator-visible reasoning with `.withThinking(content)`,
+ * which returns a new `Action` without mutating the original.
+ *
+ * @example
+ * ```ts
+ * return Action.move('kitchen').withThinking('Heading to the kitchen for my task.');
+ * return Action.kill('PlayerB').withThinking('Alone with target — safe window.');
+ * ```
+ */
+export class Action {
+  readonly type: string;
+  readonly payload: Record<string, any>;
+  /**
+   * Spectator-visible reasoning string sent as `thinking_content` to the server.
+   * Visible to observers only — not exposed to other in-game players.
+   */
+  readonly thinkingContent: string | null;
+
+  private constructor(type: string, payload: Record<string, any>, thinkingContent: string | null = null) {
+    this.type = type;
+    this.payload = payload;
+    this.thinkingContent = thinkingContent;
+    Object.freeze(this);
+    Object.freeze(this.payload);
+  }
+
+  /**
+   * Attach (or replace) the spectator-visible thinking content.
+   * Returns a **new** immutable `Action` — the original is unchanged.
+   *
+   * @example Action.kill('playerA').withThinking('Safe kill — only one witness.')
+   */
+  withThinking(content: string): Action {
+    return new Action(this.type, { ...this.payload }, content);
+  }
+
+  /**
+   * Attach (or replace) the speech audio URL.
+   * Returns a **new** immutable `Action` — the original is unchanged.
+   * Typically used by the runtime to inject TTS-generated audio into speech actions.
+   */
+  withAudioUrl(audioUrl: string): Action {
+    return new Action(this.type, { ...this.payload, audio_url: audioUrl }, this.thinkingContent);
+  }
+
+  /**
+   * Move toward a room (by name) or a coordinate target.
+   *
+   * @param target        Room id string, or a `{ x, y }` coordinate pair.
+   * @param stopOnPlayer  If true, movement stops when encountering another alive player.
+   */
+  static move(target: { x: number; y: number } | string, stopOnPlayer = false): Action {
+    if (typeof target === 'string') {
+      const payload: Record<string, any> = { target };
+      if (stopOnPlayer) payload.stop_on_player = true;
+      return new Action('move', payload, `前往 ${target}`);
+    }
+    const payload: Record<string, any> = { target_x: target.x, target_y: target.y };
+    if (stopOnPlayer) payload.stop_on_player = true;
+    return new Action('move', payload);
+  }
+
+  /**
+   * Kill the named player.
+   * Only succeeds when cooldown is ready, a kill use remains, and the target is in range.
+   */
+  static kill(target: string): Action {
+    return new Action('kill', { target }, `击杀 ${target}`);
+  }
+
+  /**
+   * Broadcast a speech during the wandering phase.
+   *
+   * @param text             Words spoken (audible to nearby players).
+   * @param thinkingContent  Optional spectator-visible reasoning.
+   * @param audioUrl         Optional TTS audio URL.
+   */
+  static speech(text: string, thinkingContent?: string, audioUrl?: string): Action {
+    const payload: Record<string, any> = { text };
+    if (audioUrl) {
+      payload.audio_url = audioUrl;
+    }
+    return new Action('speech', payload, thinkingContent ?? null);
+    // speech: no default thinking (the speech content itself is the message)
+  }
+
+  /**
+   * Cast a vote during the meeting vote sub-phase.
+   *
+   * @param target  Name of the player to vote out.
+   */
+  static vote(target: string): Action {
+    return new Action('vote', { target }, `投票 ${target}`);
+  }
+
+  /**
+   * Execute (or move toward) a task.
+   *
+   * @param taskName  Optional task name. Omit to let the server resolve which
+   *                  task to execute at the current location.
+   */
+  static doTask(taskName?: string): Action {
+    return new Action('task', taskName ? { task_name: taskName } : {}, taskName ? `执行任务 ${taskName}` : '执行任务');
+  }
+
+  /**
+   * Report a corpse to trigger an emergency meeting.
+   *
+   * @param corpseName  Name of the dead player (written to thinking log).
+   * @param room        Room where the corpse was found.
+   */
+  static report(corpseName?: string, room?: string): Action {
+    const thinking = corpseName
+      ? `发现尸体（${corpseName}${room ? ` 在 ${room}` : ''}），报告召开会议`
+      : '发现尸体，报告召开会议';
+    return new Action('report', {}, thinking);
+  }
+
+  /**
+   * Pure thinking action — sends only `thinking_content` with no in-game effect.
+   * Useful for pushing reasoning text to spectators without altering game state.
+   */
+  static think(): Action {
+    return new Action('think', {}, '正在思考...');
+  }
+
+  /**
+   * Trigger the emergency alarm. Crab faction exclusive.
+   * Starts a timed emergency event that Shrimp players must resolve.
+   */
+  static triggerAlarm(): Action {
+    return new Action('trigger_alarm', {}, '触发紧急警报！');
+  }
+
+  /**
+   * Deserialize an `Action` from a plain JSON object.
+   * Accepts both `{ action: "move", … }` and `{ type: "move", … }` formats.
+   *
+   * @throws {Error} If the object contains no valid action type string.
+   */
+  static fromJSON(json: Record<string, any>): Action {
+    // Support both { action: "move", ... } and { type: "move", ... } formats
+    const type = json.action ?? json.type;
+    if (!type || typeof type !== 'string') {
+      throw new Error(`Action.fromJSON: missing or invalid action type in ${JSON.stringify(json)}`);
+    }
+    const { action: _a, type: _t, thinking_content, ...payload } = json;
+    return new Action(type, payload, thinking_content ?? null);
+  }
+
+  /**
+   * Serialize this `Action` to a plain object for transmission to the server.
+   * The `thinking_content` key is omitted when `thinkingContent` is null.
+   */
+  toJSON(): Record<string, any> {
+    const obj: Record<string, any> = { action: this.type, ...this.payload };
+    if (this.thinkingContent) {
+      obj.thinking_content = this.thinkingContent;
+    }
+    return obj;
+  }
+}

package/src/sdk/index.ts

@@ -1,111 +1,111 @@
-/**
- * @myclaw163/clawclaw-cli — Public SDK
- * ─────────────────────────────────
- * 此文件是 @myclaw163/clawclaw-cli 对外的**公开 API**入口,通过 `package.json` 的
- * `exports` 字段同时暴露在 `@myclaw163/clawclaw-cli` 与 `@myclaw163/clawclaw-cli/sdk` 两个 sub-path。
- *
- * 下游项目(适配器、MCP server、其他 agent 集成等)应当只 import 本文件
- * 重新 export 的符号;凡是从 `@myclaw163/clawclaw-cli/src/...` 深路径直接 import 的,
- * 视为内部实现,**不在 SemVer 承诺范围内**,可能在任意 minor 版本变更。
- *
- * 公开符号:
- *   · Action            — 不可变动作工厂(move/kill/speech/vote/...)
- *   · GameClient        — HTTP + WebSocket 游戏客户端
- *   · GameClientConfig  — 客户端配置类型
- *   · GameState / PlayerSelf / PlayerInfo / CorpseInfo / TaskInfo /
- *     EmergencyInfo / Position / GameEvent / MapRoom / GameResult
- *   · WsConnectionState / ActionErrorCode (enums)
- *   · Strategy / StrategyContext / StrategyEntry / CustomModule /
- *     BehaviorDecision / CorpseTarget / RoomTarget
- *   · game-utils: dist / firstAvailableTask / nearestKnownCorpse / nearestKnownCorpseNav /
- *     hasKnownCorpse / corpseAtScene / nearestReportableCorpse / safePatrolStep /
- *     nonTeammatesVisible / matchesTarget / isTargetAlive / nearestVisibleTarget /
- *     pursueVisibleTarget / killCooldownSecs / hasKillUseRemaining / canUseKill / killRangeFor / killCommitRange /
- *     isKnowledgeHostile / isKnowledgeThreat / isKnowledgeTrusted
- *     (含 @deprecated 别名 isKnowledgeKillTarget / isKnowledgeAvoid / isKnowledgeProtected) /
- *     PatrolState / SafeTaskOptions / SafePatrolOptions + 常量(TASK_SUBMIT_RADIUS /
- *     SHRIMP_VISION_RANGE / SHRIMP_VISION_EXIT_BUFFER / SHRIMP_VISION_RELEASE_RANGE /
- *     FOLLOW_RANGE / PATROL_REACHED_DISTANCE / PROGRESS_INTERVAL_MS)
- *   · Knowledge (ctx.knowledge): KnowledgeView / SubjectEntry / FactMeta /
- *     TagMeta / KnowledgeFile / KnowledgeScope / KnowledgeSource /
- *     PlayerRef / SubjectRef / KnowledgeRef
- *   · Greeting: parseGreetingArgs / GreetingTracker / MAX_GREETING_PHRASES /
- *     GREETING_COOLDOWN_MS
- *
- * 新增 / 删除本文件的 export 必须走 minor / major 版本号;字段语义变更同理。
- */
-
-export { Action } from './action.js';
-export { GameClient } from '../lib/game-client.js';
-export type { GameClientConfig } from '../lib/game-client.js';
-export type {
-  GameState, PlayerInfo, PlayerSelf, CorpseInfo, TaskInfo, TaskLocation, EmergencyInfo,
-  Position, GameEvent, MapRoom, GameResult,
-  WsConnectionState, ActionErrorCode,
-} from './types.js';
-
-// Strategy framework (for user strategies)
-export type {
-  Strategy, StrategyContext, StrategyEntry, CustomModule,
-  BehaviorDecision, CorpseTarget, RoomTarget,
-} from '../strategies/types.js';
-
-// Game utilities (for user strategies)
-export {
-  dist, firstAvailableTask, nearestKnownCorpse, nearestKnownCorpseNav, hasKnownCorpse, corpseAtScene, nearestReportableCorpse,
-  safePatrolStep,
-  nonTeammatesVisible, matchesTarget, isTargetAlive,
-  nearestVisibleTarget, pursueVisibleTarget,
-  killCooldownSecs, hasKillUseRemaining, canUseKill, killRangeFor, killCommitRange,
-  isKnowledgeHostile, isKnowledgeThreat, isKnowledgeTrusted,
-  isKnowledgeKillTarget, isKnowledgeAvoid, isKnowledgeProtected,
-  PatrolState,
-  TASK_SUBMIT_RADIUS, SHRIMP_VISION_RANGE, SHRIMP_VISION_EXIT_BUFFER, SHRIMP_VISION_RELEASE_RANGE,
-  FOLLOW_RANGE, PATROL_REACHED_DISTANCE,
-  PROGRESS_INTERVAL_MS,
-} from '../strategies/game-utils.js';
-export type { SafeTaskOptions, SafePatrolOptions } from '../strategies/game-utils.js';
-
-export type {
-  KnowledgeView, SubjectEntry, FactMeta, TagMeta, KnowledgeFile,
-  KnowledgeScope, KnowledgeSource, PlayerMark, PlayerRef, SubjectRef, KnowledgeRef,
-} from '../lib/knowledge-store.js';
-
-// Speech module (for exported strategies that use speech synthesis)
-export { SpeechModule, getSpeechConfigForRole } from '../strategies/speech-module.js';
-export type { SpeechModuleConfig, SpeechEvalResult } from '../strategies/speech-module.js';
-
-// Greeting utilities (for exported strategies that use greeting phrases)
-export { parseGreetingArgs, GreetingTracker, MAX_GREETING_PHRASES, GREETING_COOLDOWN_MS } from '../strategies/greeting.js';
-
-// TTS configuration (for exported strategies that use TTS)
-export { TTS_TEXT_MAX_LENGTH } from '../lib/tts-keys.js';
-
-// Player targeting utilities (for exported strategies)
-export { parseTargetArgs, stripRoleIds } from '../strategies/player-targets.js';
-
-// Goal system (for exported strategies that use the goal framework)
-export { GoalRootStrategy } from '../strategies/goals/goal-root-strategy.js';
-export { TaskOnlyTop } from '../strategies/goals/task-only-top.js';
-export { TaskReportTop } from '../strategies/goals/task-report-top.js';
-export { TaskKillReportTop } from '../strategies/goals/task-kill-report-top.js';
-export { KillFrenzyTop } from '../strategies/goals/kill-frenzy-top.js';
-export { KillLoneTop } from '../strategies/goals/kill-lone-top.js';
-export { KillTargetTop } from '../strategies/goals/kill-target-top.js';
-export { LoneKillTaskTop } from '../strategies/goals/lone-kill-task-top.js';
-export { CrabSabotageTop } from '../strategies/goals/crab-sabotage-top.js';
-export { CorpsePatrolTop } from '../strategies/goals/corpse-patrol-top.js';
-export { ReportPatrolTop } from '../strategies/goals/report-patrol-top.js';
-export { PatrolTop } from '../strategies/goals/patrol-top.js';
-export { NormalShrimpTop } from '../strategies/goals/normal-shrimp-top.js';
-export { WarriorShrimpTop } from '../strategies/goals/warrior-shrimp-top.js';
-export { ParadiseFishTop } from '../strategies/goals/paradise-fish-top.js';
-export { FindPlayerTop } from '../strategies/goals/find-player-top.js';
-export { SocialTaskTop } from '../strategies/goals/social-task-top.js';
-export { AvoidLoneTop } from '../strategies/goals/avoid-lone-top.js';
-export { AvoidPlayersTop } from '../strategies/goals/avoid-players-top.js';
-export { HideTop } from '../strategies/goals/hide-top.js';
-export { MoveRoomGoal } from '../strategies/goals/move-room-goal.js';
-export { ConversationGoal } from '../strategies/goals/conversation-goal.js';
-
-export type { SocialTarget } from '../strategies/goals/social-task-top.js';
+/**
+ * @myclaw163/clawclaw-cli — Public SDK
+ * ─────────────────────────────────
+ * 此文件是 @myclaw163/clawclaw-cli 对外的**公开 API**入口,通过 `package.json` 的
+ * `exports` 字段同时暴露在 `@myclaw163/clawclaw-cli` 与 `@myclaw163/clawclaw-cli/sdk` 两个 sub-path。
+ *
+ * 下游项目(适配器、MCP server、其他 agent 集成等)应当只 import 本文件
+ * 重新 export 的符号;凡是从 `@myclaw163/clawclaw-cli/src/...` 深路径直接 import 的,
+ * 视为内部实现,**不在 SemVer 承诺范围内**,可能在任意 minor 版本变更。
+ *
+ * 公开符号:
+ *   · Action            — 不可变动作工厂(move/kill/speech/vote/...)
+ *   · GameClient        — HTTP + WebSocket 游戏客户端
+ *   · GameClientConfig  — 客户端配置类型
+ *   · GameState / PlayerSelf / PlayerInfo / CorpseInfo / TaskInfo /
+ *     EmergencyInfo / Position / GameEvent / MapRoom / GameResult
+ *   · WsConnectionState / ActionErrorCode (enums)
+ *   · Strategy / StrategyContext / StrategyEntry / CustomModule /
+ *     BehaviorDecision / CorpseTarget / RoomTarget
+ *   · game-utils: dist / firstAvailableTask / nearestKnownCorpse / nearestKnownCorpseNav /
+ *     hasKnownCorpse / corpseAtScene / nearestReportableCorpse / safePatrolStep /
+ *     nonTeammatesVisible / matchesTarget / isTargetAlive / nearestVisibleTarget /
+ *     pursueVisibleTarget / killCooldownSecs / hasKillUseRemaining / canUseKill / killRangeFor / killCommitRange /
+ *     isKnowledgeHostile / isKnowledgeThreat / isKnowledgeTrusted
+ *     (含 @deprecated 别名 isKnowledgeKillTarget / isKnowledgeAvoid / isKnowledgeProtected) /
+ *     PatrolState / SafeTaskOptions / SafePatrolOptions + 常量(TASK_SUBMIT_RADIUS /
+ *     SHRIMP_VISION_RANGE / SHRIMP_VISION_EXIT_BUFFER / SHRIMP_VISION_RELEASE_RANGE /
+ *     FOLLOW_RANGE / PATROL_REACHED_DISTANCE / PROGRESS_INTERVAL_MS)
+ *   · Knowledge (ctx.knowledge): KnowledgeView / SubjectEntry / FactMeta /
+ *     TagMeta / KnowledgeFile / KnowledgeScope / KnowledgeSource /
+ *     PlayerRef / SubjectRef / KnowledgeRef
+ *   · Greeting: parseGreetingArgs / GreetingTracker / MAX_GREETING_PHRASES /
+ *     GREETING_COOLDOWN_MS
+ *
+ * 新增 / 删除本文件的 export 必须走 minor / major 版本号;字段语义变更同理。
+ */
+
+export { Action } from './action.js';
+export { GameClient } from '../lib/game-client.js';
+export type { GameClientConfig } from '../lib/game-client.js';
+export type {
+  GameState, PlayerInfo, PlayerSelf, CorpseInfo, TaskInfo, TaskLocation, EmergencyInfo,
+  Position, GameEvent, MapRoom, GameResult,
+  WsConnectionState, ActionErrorCode,
+} from './types.js';
+
+// Strategy framework (for user strategies)
+export type {
+  Strategy, StrategyContext, StrategyEntry, CustomModule,
+  BehaviorDecision, CorpseTarget, RoomTarget,
+} from '../strategies/types.js';
+
+// Game utilities (for user strategies)
+export {
+  dist, firstAvailableTask, nearestKnownCorpse, nearestKnownCorpseNav, hasKnownCorpse, corpseAtScene, nearestReportableCorpse,
+  safePatrolStep,
+  nonTeammatesVisible, matchesTarget, isTargetAlive,
+  nearestVisibleTarget, pursueVisibleTarget,
+  killCooldownSecs, hasKillUseRemaining, canUseKill, killRangeFor, killCommitRange,
+  isKnowledgeHostile, isKnowledgeThreat, isKnowledgeTrusted,
+  isKnowledgeKillTarget, isKnowledgeAvoid, isKnowledgeProtected,
+  PatrolState,
+  TASK_SUBMIT_RADIUS, SHRIMP_VISION_RANGE, SHRIMP_VISION_EXIT_BUFFER, SHRIMP_VISION_RELEASE_RANGE,
+  FOLLOW_RANGE, PATROL_REACHED_DISTANCE,
+  PROGRESS_INTERVAL_MS,
+} from '../strategies/game-utils.js';
+export type { SafeTaskOptions, SafePatrolOptions } from '../strategies/game-utils.js';
+
+export type {
+  KnowledgeView, SubjectEntry, FactMeta, TagMeta, KnowledgeFile,
+  KnowledgeScope, KnowledgeSource, PlayerMark, PlayerRef, SubjectRef, KnowledgeRef,
+} from '../lib/knowledge-store.js';
+
+// Speech module (for exported strategies that use speech synthesis)
+export { SpeechModule, getSpeechConfigForRole } from '../strategies/speech-module.js';
+export type { SpeechModuleConfig, SpeechEvalResult } from '../strategies/speech-module.js';
+
+// Greeting utilities (for exported strategies that use greeting phrases)
+export { parseGreetingArgs, GreetingTracker, MAX_GREETING_PHRASES, GREETING_COOLDOWN_MS } from '../strategies/greeting.js';
+
+// TTS configuration (for exported strategies that use TTS)
+export { TTS_TEXT_MAX_LENGTH } from '../lib/tts-keys.js';
+
+// Player targeting utilities (for exported strategies)
+export { parseTargetArgs, stripRoleIds } from '../strategies/player-targets.js';
+
+// Goal system (for exported strategies that use the goal framework)
+export { GoalRootStrategy } from '../strategies/goals/goal-root-strategy.js';
+export { TaskOnlyTop } from '../strategies/goals/task-only-top.js';
+export { TaskReportTop } from '../strategies/goals/task-report-top.js';
+export { TaskKillReportTop } from '../strategies/goals/task-kill-report-top.js';
+export { KillFrenzyTop } from '../strategies/goals/kill-frenzy-top.js';
+export { KillLoneTop } from '../strategies/goals/kill-lone-top.js';
+export { KillTargetTop } from '../strategies/goals/kill-target-top.js';
+export { LoneKillTaskTop } from '../strategies/goals/lone-kill-task-top.js';
+export { CrabSabotageTop } from '../strategies/goals/crab-sabotage-top.js';
+export { CorpsePatrolTop } from '../strategies/goals/corpse-patrol-top.js';
+export { ReportPatrolTop } from '../strategies/goals/report-patrol-top.js';
+export { PatrolTop } from '../strategies/goals/patrol-top.js';
+export { NormalShrimpTop } from '../strategies/goals/normal-shrimp-top.js';
+export { WarriorShrimpTop } from '../strategies/goals/warrior-shrimp-top.js';
+export { ParadiseFishTop } from '../strategies/goals/paradise-fish-top.js';
+export { FindPlayerTop } from '../strategies/goals/find-player-top.js';
+export { SocialTaskTop } from '../strategies/goals/social-task-top.js';
+export { AvoidLoneTop } from '../strategies/goals/avoid-lone-top.js';
+export { AvoidPlayersTop } from '../strategies/goals/avoid-players-top.js';
+export { HideTop } from '../strategies/goals/hide-top.js';
+export { MoveRoomGoal } from '../strategies/goals/move-room-goal.js';
+export { ConversationGoal } from '../strategies/goals/conversation-goal.js';
+
+export type { SocialTarget } from '../strategies/goals/social-task-top.js';