@myclaw163/clawclaw-cli 0.6.55 → 0.6.57

package/src/lib/tts-speech.ts

@@ -1,76 +1,76 @@
-import { AuthStore } from './auth.js';
-import type { GameClient } from './game-client.js';
-import { synthesizeNeteaseTTS } from './netease-tts.js';
-import {
-  DEFAULT_TTS_VOICE,
-  TTS_PROVIDER_LEIHUO,
-  TTS_TEXT_MAX_LENGTH,
-} from './tts-keys.js';
-
-export interface SynthesizeSpeechAudioOptions {
-  voice?: string;
-  provider?: string;
-  authStore?: AuthStore;
-}
-
-/**
- * Synthesize speech audio via the configured TTS provider and upload to OSS.
- * @throws when the provider key is missing, text is too long, or synthesis/upload fails.
- */
-export async function synthesizeAndUploadSpeechAudio(
-  text: string,
-  client: GameClient,
-  opts: SynthesizeSpeechAudioOptions = {},
-): Promise<string> {
-  const store = opts.authStore ?? new AuthStore();
-  const provider = opts.provider ?? TTS_PROVIDER_LEIHUO;
-  const apiKey = store.getTtsKey(provider);
-  if (!apiKey) {
-    throw new Error(
-      `TTS API key for provider "${provider}" is not configured. Use \`clawclaw-cli tts config <apiKey>\` first.`,
-    );
-  }
-  if (text.length > TTS_TEXT_MAX_LENGTH) {
-    throw new Error(`TTS text must be ${TTS_TEXT_MAX_LENGTH} characters or fewer.`);
-  }
-
-  const audio = await synthesizeNeteaseTTS({
-    apiKey,
-    text,
-    voice: opts.voice ?? store.getTtsDefaultVoice() ?? DEFAULT_TTS_VOICE,
-  });
-  const upload = await client.uploadAudio(audio.audio, 'tts-audio.mp3', audio.contentType);
-  return upload.audio_url;
-}
-
-/**
- * When the active account has a Leihuo TTS key, synthesize and upload audio for speech.
- * Returns undefined if no key, a URL was already provided, or auto-TTS was skipped (e.g. text too long).
- */
-export async function maybeSynthesizeSpeechAudioUrl(
-  text: string,
-  existingUrl: string | undefined,
-  client: GameClient,
-  opts: SynthesizeSpeechAudioOptions = {},
-): Promise<string | undefined> {
-  if (existingUrl) return existingUrl;
-
-  const store = opts.authStore ?? new AuthStore();
-  const provider = opts.provider ?? TTS_PROVIDER_LEIHUO;
-  const apiKey = store.getTtsKey(provider);
-  if (!apiKey) return undefined;
-
-  if (text.length > TTS_TEXT_MAX_LENGTH) {
-    console.error(
-      `Speech is ${text.length} characters; auto TTS supports up to ${TTS_TEXT_MAX_LENGTH}. Sending without audio.`,
-    );
-    return undefined;
-  }
-
-  try {
-    return await synthesizeAndUploadSpeechAudio(text, client, opts);
-  } catch (err: any) {
-    console.error(`Auto TTS failed: ${err?.message ?? String(err)}. Sending speech without audio.`);
-    return undefined;
-  }
-}
+import { AuthStore } from './auth.js';
+import type { GameClient } from './game-client.js';
+import { synthesizeNeteaseTTS } from './netease-tts.js';
+import {
+  DEFAULT_TTS_VOICE,
+  TTS_PROVIDER_LEIHUO,
+  TTS_TEXT_MAX_LENGTH,
+} from './tts-keys.js';
+
+export interface SynthesizeSpeechAudioOptions {
+  voice?: string;
+  provider?: string;
+  authStore?: AuthStore;
+}
+
+/**
+ * Synthesize speech audio via the configured TTS provider and upload to OSS.
+ * @throws when the provider key is missing, text is too long, or synthesis/upload fails.
+ */
+export async function synthesizeAndUploadSpeechAudio(
+  text: string,
+  client: GameClient,
+  opts: SynthesizeSpeechAudioOptions = {},
+): Promise<string> {
+  const store = opts.authStore ?? new AuthStore();
+  const provider = opts.provider ?? TTS_PROVIDER_LEIHUO;
+  const apiKey = store.getTtsKey(provider);
+  if (!apiKey) {
+    throw new Error(
+      `TTS API key for provider "${provider}" is not configured. Use \`clawclaw-cli tts config <apiKey>\` first.`,
+    );
+  }
+  if (text.length > TTS_TEXT_MAX_LENGTH) {
+    throw new Error(`TTS text must be ${TTS_TEXT_MAX_LENGTH} characters or fewer.`);
+  }
+
+  const audio = await synthesizeNeteaseTTS({
+    apiKey,
+    text,
+    voice: opts.voice ?? store.getTtsDefaultVoice() ?? DEFAULT_TTS_VOICE,
+  });
+  const upload = await client.uploadAudio(audio.audio, 'tts-audio.mp3', audio.contentType);
+  return upload.audio_url;
+}
+
+/**
+ * When the active account has a Leihuo TTS key, synthesize and upload audio for speech.
+ * Returns undefined if no key, a URL was already provided, or auto-TTS was skipped (e.g. text too long).
+ */
+export async function maybeSynthesizeSpeechAudioUrl(
+  text: string,
+  existingUrl: string | undefined,
+  client: GameClient,
+  opts: SynthesizeSpeechAudioOptions = {},
+): Promise<string | undefined> {
+  if (existingUrl) return existingUrl;
+
+  const store = opts.authStore ?? new AuthStore();
+  const provider = opts.provider ?? TTS_PROVIDER_LEIHUO;
+  const apiKey = store.getTtsKey(provider);
+  if (!apiKey) return undefined;
+
+  if (text.length > TTS_TEXT_MAX_LENGTH) {
+    console.error(
+      `Speech is ${text.length} characters; auto TTS supports up to ${TTS_TEXT_MAX_LENGTH}. Sending without audio.`,
+    );
+    return undefined;
+  }
+
+  try {
+    return await synthesizeAndUploadSpeechAudio(text, client, opts);
+  } catch (err: any) {
+    console.error(`Auto TTS failed: ${err?.message ?? String(err)}. Sending speech without audio.`);
+    return undefined;
+  }
+}

package/src/lib/workspace-argv.test.ts

@@ -1,49 +1,49 @@
-import { describe, expect, it } from 'vitest';
-import { CLAWCLAW_WORKSPACE_DIR, applyWorkspaceArgv, extractWorkspaceDirArgv } from './workspace-argv.js';
-
-describe('extractWorkspaceDirArgv', () => {
-  it('supports --workspace-dir X', () => {
-    expect(extractWorkspaceDirArgv(['node', 'cli', '--workspace-dir', 'tmp/workspace'])).toBe('tmp/workspace');
-  });
-
-  it('supports --workspace-dir=X', () => {
-    expect(extractWorkspaceDirArgv(['node', 'cli', '--workspace-dir=tmp/workspace'])).toBe('tmp/workspace');
-  });
-
-  it('returns undefined when the option is not provided', () => {
-    expect(extractWorkspaceDirArgv(['node', 'cli', 'do'])).toBeUndefined();
-  });
-
-  it('returns undefined for an empty value', () => {
-    expect(extractWorkspaceDirArgv(['node', 'cli', '--workspace-dir='])).toBeUndefined();
-    expect(extractWorkspaceDirArgv(['node', 'cli', '--workspace-dir', '   '])).toBeUndefined();
-  });
-});
-
-describe('applyWorkspaceArgv', () => {
-  it('writes an absolute workspace dir using the injected cwd', () => {
-    const env: NodeJS.ProcessEnv = {};
-
-    expect(applyWorkspaceArgv(['node', 'cli', '--workspace-dir', 'tmp/workspace'], env, 'D:\\open-claw-kill')).toBe(
-      'D:\\open-claw-kill\\tmp\\workspace',
-    );
-    expect(env[CLAWCLAW_WORKSPACE_DIR]).toBe('D:\\open-claw-kill\\tmp\\workspace');
-  });
-
-  it('lets explicit argv override an existing workspace env value', () => {
-    const env: NodeJS.ProcessEnv = { [CLAWCLAW_WORKSPACE_DIR]: 'D:\\old\\workspace' };
-
-    expect(applyWorkspaceArgv(['node', 'cli', '--workspace-dir', 'new/workspace'], env, 'D:\\open-claw-kill')).toBe(
-      'D:\\open-claw-kill\\new\\workspace',
-    );
-    expect(env[CLAWCLAW_WORKSPACE_DIR]).toBe('D:\\open-claw-kill\\new\\workspace');
-  });
-
-  it('leaves env untouched when the option is absent or empty', () => {
-    const env: NodeJS.ProcessEnv = { EXISTING: 'keep' };
-
-    expect(applyWorkspaceArgv(['node', 'cli', 'do'], env, 'D:\\open-claw-kill')).toBeUndefined();
-    expect(applyWorkspaceArgv(['node', 'cli', '--workspace-dir='], env, 'D:\\open-claw-kill')).toBeUndefined();
-    expect(env).toEqual({ EXISTING: 'keep' });
-  });
-});
+import { describe, expect, it } from 'vitest';
+import { CLAWCLAW_WORKSPACE_DIR, applyWorkspaceArgv, extractWorkspaceDirArgv } from './workspace-argv.js';
+
+describe('extractWorkspaceDirArgv', () => {
+  it('supports --workspace-dir X', () => {
+    expect(extractWorkspaceDirArgv(['node', 'cli', '--workspace-dir', 'tmp/workspace'])).toBe('tmp/workspace');
+  });
+
+  it('supports --workspace-dir=X', () => {
+    expect(extractWorkspaceDirArgv(['node', 'cli', '--workspace-dir=tmp/workspace'])).toBe('tmp/workspace');
+  });
+
+  it('returns undefined when the option is not provided', () => {
+    expect(extractWorkspaceDirArgv(['node', 'cli', 'do'])).toBeUndefined();
+  });
+
+  it('returns undefined for an empty value', () => {
+    expect(extractWorkspaceDirArgv(['node', 'cli', '--workspace-dir='])).toBeUndefined();
+    expect(extractWorkspaceDirArgv(['node', 'cli', '--workspace-dir', '   '])).toBeUndefined();
+  });
+});
+
+describe('applyWorkspaceArgv', () => {
+  it('writes an absolute workspace dir using the injected cwd', () => {
+    const env: NodeJS.ProcessEnv = {};
+
+    expect(applyWorkspaceArgv(['node', 'cli', '--workspace-dir', 'tmp/workspace'], env, 'D:\\open-claw-kill')).toBe(
+      'D:\\open-claw-kill\\tmp\\workspace',
+    );
+    expect(env[CLAWCLAW_WORKSPACE_DIR]).toBe('D:\\open-claw-kill\\tmp\\workspace');
+  });
+
+  it('lets explicit argv override an existing workspace env value', () => {
+    const env: NodeJS.ProcessEnv = { [CLAWCLAW_WORKSPACE_DIR]: 'D:\\old\\workspace' };
+
+    expect(applyWorkspaceArgv(['node', 'cli', '--workspace-dir', 'new/workspace'], env, 'D:\\open-claw-kill')).toBe(
+      'D:\\open-claw-kill\\new\\workspace',
+    );
+    expect(env[CLAWCLAW_WORKSPACE_DIR]).toBe('D:\\open-claw-kill\\new\\workspace');
+  });
+
+  it('leaves env untouched when the option is absent or empty', () => {
+    const env: NodeJS.ProcessEnv = { EXISTING: 'keep' };
+
+    expect(applyWorkspaceArgv(['node', 'cli', 'do'], env, 'D:\\open-claw-kill')).toBeUndefined();
+    expect(applyWorkspaceArgv(['node', 'cli', '--workspace-dir='], env, 'D:\\open-claw-kill')).toBeUndefined();
+    expect(env).toEqual({ EXISTING: 'keep' });
+  });
+});

package/src/lib/workspace-argv.ts

@@ -1,44 +1,44 @@
-import { resolve, win32 } from 'path';
-import { CLAWCLAW_WORKSPACE_DIR } from './init-command.js';
-
-const WORKSPACE_DIR_OPTION = '--workspace-dir';
-export { CLAWCLAW_WORKSPACE_DIR };
-
-function isPresent(value: string | undefined): value is string {
-  return typeof value === 'string' && value.trim() !== '' && !value.startsWith('-');
-}
-
-export function extractWorkspaceDirArgv(argv: readonly string[]): string | undefined {
-  for (let i = 0; i < argv.length; i += 1) {
-    const current = argv[i];
-    if (current === WORKSPACE_DIR_OPTION) {
-      const next = argv[i + 1];
-      return isPresent(next) ? next : undefined;
-    }
-
-    if (current.startsWith(`${WORKSPACE_DIR_OPTION}=`)) {
-      const value = current.slice(WORKSPACE_DIR_OPTION.length + 1);
-      return isPresent(value) ? value : undefined;
-    }
-  }
-
-  return undefined;
-}
-
-export function applyWorkspaceArgv(
-  argv: readonly string[],
-  env: NodeJS.ProcessEnv,
-  cwd: string = process.cwd(),
-): string | undefined {
-  const workspaceDir = extractWorkspaceDirArgv(argv);
-  if (!workspaceDir) {
-    return undefined;
-  }
-
-  const useWin32Path = /^[A-Za-z]:[\\/]/.test(cwd) || /^[A-Za-z]:[\\/]/.test(workspaceDir);
-  const resolvedWorkspaceDir = useWin32Path
-    ? win32.resolve(cwd, workspaceDir)
-    : resolve(cwd, workspaceDir);
-  env[CLAWCLAW_WORKSPACE_DIR] = resolvedWorkspaceDir;
-  return resolvedWorkspaceDir;
-}
+import { resolve, win32 } from 'path';
+import { CLAWCLAW_WORKSPACE_DIR } from './init-command.js';
+
+const WORKSPACE_DIR_OPTION = '--workspace-dir';
+export { CLAWCLAW_WORKSPACE_DIR };
+
+function isPresent(value: string | undefined): value is string {
+  return typeof value === 'string' && value.trim() !== '' && !value.startsWith('-');
+}
+
+export function extractWorkspaceDirArgv(argv: readonly string[]): string | undefined {
+  for (let i = 0; i < argv.length; i += 1) {
+    const current = argv[i];
+    if (current === WORKSPACE_DIR_OPTION) {
+      const next = argv[i + 1];
+      return isPresent(next) ? next : undefined;
+    }
+
+    if (current.startsWith(`${WORKSPACE_DIR_OPTION}=`)) {
+      const value = current.slice(WORKSPACE_DIR_OPTION.length + 1);
+      return isPresent(value) ? value : undefined;
+    }
+  }
+
+  return undefined;
+}
+
+export function applyWorkspaceArgv(
+  argv: readonly string[],
+  env: NodeJS.ProcessEnv,
+  cwd: string = process.cwd(),
+): string | undefined {
+  const workspaceDir = extractWorkspaceDirArgv(argv);
+  if (!workspaceDir) {
+    return undefined;
+  }
+
+  const useWin32Path = /^[A-Za-z]:[\\/]/.test(cwd) || /^[A-Za-z]:[\\/]/.test(workspaceDir);
+  const resolvedWorkspaceDir = useWin32Path
+    ? win32.resolve(cwd, workspaceDir)
+    : resolve(cwd, workspaceDir);
+  env[CLAWCLAW_WORKSPACE_DIR] = resolvedWorkspaceDir;
+  return resolvedWorkspaceDir;
+}

package/src/perception/player-history-store.test.ts

@@ -1,87 +1,87 @@
-import { existsSync, mkdtempSync, readFileSync } from 'fs';
-import { tmpdir } from 'os';
-import { join } from 'path';
-import { describe, expect, it } from 'vitest';
-import { PlayerHistoryStore, playerHistoryPathForSession } from './player-history-store.js';
-
-describe('PlayerHistoryStore', () => {
-  it('derives sidecar path from the session jsonl path', () => {
-    expect(playerHistoryPathForSession('/tmp/game.jsonl')).toBe('/tmp/game.player-history.json');
-    expect(playerHistoryPathForSession('/tmp/game')).toBe('/tmp/game.player-history.json');
-  });
-
-  it('records player_spotted by tick, fills empty frames, and merges same tick players', () => {
-    const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
-    const store = new PlayerHistoryStore(join(dir, 'session.player-history.json'));
-    store.reset(Date.parse('2026-05-21T00:00:00.000Z'));
-
-    expect(store.recordPlayerSpotted({
-      type: 'player_spotted',
-      tick: 10,
-      spotted_name: '砂锅猎手',
-      spotted_room: '动力监控室',
-      spotted_x: 1,
-      spotted_y: 2,
-    }, Date.parse('2026-05-21T00:00:01.000Z'))).toBe(true);
-    store.recordPlayerSpotted({
-      type: 'player_spotted',
-      tick: 13,
-      spotted_name: '洋流王子',
-      spotted_room: 'hallway',
-      spotted_x: 3,
-      spotted_y: 4,
-    }, Date.parse('2026-05-21T00:00:02.000Z'));
-    store.recordPlayerSpotted({
-      type: 'player_spotted',
-      tick: 13,
-      spotted_name: '测试-浮沉-0bc9',
-      spotted_room: 'hallway',
-      spotted_x: 5,
-      spotted_y: 6,
-    }, Date.parse('2026-05-21T00:00:02.000Z'));
-
-    const data = store.read()!;
-    expect(data.visible_frames.map((frame) => frame.tick)).toEqual([10, 11, 12, 13]);
-    expect(data.visible_frames[1].players).toEqual({});
-    expect(data.visible_frames[2].players).toEqual({});
-    expect(new Set(Object.keys(data.visible_frames[3].players))).toEqual(new Set(['测试-浮沉-0bc9', '洋流王子']));
-    expect(data.last_history_tick).toBe(13);
-  });
-
-  it('does not backfill a missing old tick after later ticks have been processed', () => {
-    const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
-    const store = new PlayerHistoryStore(join(dir, 'session.player-history.json'));
-    store.reset();
-    store.recordPlayerSpotted({ type: 'player_spotted', tick: 10, spotted_name: 'A', spotted_x: 1, spotted_y: 1 });
-    store.recordPlayerSpotted({ type: 'player_spotted', tick: 13, spotted_name: 'B', spotted_x: 2, spotted_y: 2 });
-    expect(store.recordPlayerSpotted({ type: 'player_spotted', tick: 9, spotted_name: 'C', spotted_x: 3, spotted_y: 3 })).toBe(false);
-    expect(store.read()!.visible_frames.some((frame) => frame.tick === 9)).toBe(false);
-  });
-
-  it('caches seats and lobster task locations from map data', () => {
-    const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
-    const store = new PlayerHistoryStore(join(dir, 'session.player-history.json'));
-    store.reset();
-    store.updateMapCache({
-      all_players: [{ name: 'A', seat: 1 }, { name: 'B', seat: 2 }],
-      all_task_locations: [
-        { name: '修线', room: '电力', x: 10, y: 20, faction: 'lobster' },
-        { name: '破坏', room: '制氧', x: 30, y: 40, faction: 'crab' },
-      ],
-    });
-    const data = store.read()!;
-    expect(data.seats).toEqual({ A: 1, B: 2 });
-    expect(data.lobster_tasks).toEqual([{ name: '修线', room: '电力', x: 10, y: 20 }]);
-  });
-
-  it('deletes the sidecar when requested', () => {
-    const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
-    const path = join(dir, 'session.player-history.json');
-    const store = new PlayerHistoryStore(path);
-    store.reset();
-    expect(existsSync(path)).toBe(true);
-    expect(JSON.parse(readFileSync(path, 'utf8')).visible_frames).toEqual([]);
-    store.delete();
-    expect(existsSync(path)).toBe(false);
-  });
-});
+import { existsSync, mkdtempSync, readFileSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { describe, expect, it } from 'vitest';
+import { PlayerHistoryStore, playerHistoryPathForSession } from './player-history-store.js';
+
+describe('PlayerHistoryStore', () => {
+  it('derives sidecar path from the session jsonl path', () => {
+    expect(playerHistoryPathForSession('/tmp/game.jsonl')).toBe('/tmp/game.player-history.json');
+    expect(playerHistoryPathForSession('/tmp/game')).toBe('/tmp/game.player-history.json');
+  });
+
+  it('records player_spotted by tick, fills empty frames, and merges same tick players', () => {
+    const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
+    const store = new PlayerHistoryStore(join(dir, 'session.player-history.json'));
+    store.reset(Date.parse('2026-05-21T00:00:00.000Z'));
+
+    expect(store.recordPlayerSpotted({
+      type: 'player_spotted',
+      tick: 10,
+      spotted_name: '砂锅猎手',
+      spotted_room: '动力监控室',
+      spotted_x: 1,
+      spotted_y: 2,
+    }, Date.parse('2026-05-21T00:00:01.000Z'))).toBe(true);
+    store.recordPlayerSpotted({
+      type: 'player_spotted',
+      tick: 13,
+      spotted_name: '洋流王子',
+      spotted_room: 'hallway',
+      spotted_x: 3,
+      spotted_y: 4,
+    }, Date.parse('2026-05-21T00:00:02.000Z'));
+    store.recordPlayerSpotted({
+      type: 'player_spotted',
+      tick: 13,
+      spotted_name: '测试-浮沉-0bc9',
+      spotted_room: 'hallway',
+      spotted_x: 5,
+      spotted_y: 6,
+    }, Date.parse('2026-05-21T00:00:02.000Z'));
+
+    const data = store.read()!;
+    expect(data.visible_frames.map((frame) => frame.tick)).toEqual([10, 11, 12, 13]);
+    expect(data.visible_frames[1].players).toEqual({});
+    expect(data.visible_frames[2].players).toEqual({});
+    expect(new Set(Object.keys(data.visible_frames[3].players))).toEqual(new Set(['测试-浮沉-0bc9', '洋流王子']));
+    expect(data.last_history_tick).toBe(13);
+  });
+
+  it('does not backfill a missing old tick after later ticks have been processed', () => {
+    const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
+    const store = new PlayerHistoryStore(join(dir, 'session.player-history.json'));
+    store.reset();
+    store.recordPlayerSpotted({ type: 'player_spotted', tick: 10, spotted_name: 'A', spotted_x: 1, spotted_y: 1 });
+    store.recordPlayerSpotted({ type: 'player_spotted', tick: 13, spotted_name: 'B', spotted_x: 2, spotted_y: 2 });
+    expect(store.recordPlayerSpotted({ type: 'player_spotted', tick: 9, spotted_name: 'C', spotted_x: 3, spotted_y: 3 })).toBe(false);
+    expect(store.read()!.visible_frames.some((frame) => frame.tick === 9)).toBe(false);
+  });
+
+  it('caches seats and lobster task locations from map data', () => {
+    const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
+    const store = new PlayerHistoryStore(join(dir, 'session.player-history.json'));
+    store.reset();
+    store.updateMapCache({
+      all_players: [{ name: 'A', seat: 1 }, { name: 'B', seat: 2 }],
+      all_task_locations: [
+        { name: '修线', room: '电力', x: 10, y: 20, faction: 'lobster' },
+        { name: '破坏', room: '制氧', x: 30, y: 40, faction: 'crab' },
+      ],
+    });
+    const data = store.read()!;
+    expect(data.seats).toEqual({ A: 1, B: 2 });
+    expect(data.lobster_tasks).toEqual([{ name: '修线', room: '电力', x: 10, y: 20 }]);
+  });
+
+  it('deletes the sidecar when requested', () => {
+    const dir = mkdtempSync(join(tmpdir(), 'player-history-'));
+    const path = join(dir, 'session.player-history.json');
+    const store = new PlayerHistoryStore(path);
+    store.reset();
+    expect(existsSync(path)).toBe(true);
+    expect(JSON.parse(readFileSync(path, 'utf8')).visible_frames).toEqual([]);
+    store.delete();
+    expect(existsSync(path)).toBe(false);
+  });
+});