@myclaw163/clawclaw-cli 0.6.60 → 0.6.63

package/src/commands/do.ts

@@ -1,126 +1,126 @@
-import { Command } from 'commander';
-import { GameClient } from '../lib/game-client.js';
-import { maybeSynthesizeSpeechAudioUrl } from '../lib/tts-speech.js';
-import { Action } from '../sdk/action.js';
-import { EventStore } from '../pipeline/event-store.js';
-
-interface ActionIntent {
-  build(): Action;
-}
-
-/** Infer an audio MIME type from a file path's extension; defaults to audio/mpeg. */
-export function audioContentTypeFor(filePath: string): string {
-  const ext = filePath.slice(filePath.lastIndexOf('.')).toLowerCase();
-  switch (ext) {
-    case '.wav': return 'audio/wav';
-    case '.ogg': return 'audio/ogg';
-    case '.oga': return 'audio/ogg';
-    case '.m4a': return 'audio/mp4';
-    case '.aac': return 'audio/aac';
-    case '.flac': return 'audio/flac';
-    case '.webm': return 'audio/webm';
-    case '.mp3':
-    default: return 'audio/mpeg';
-  }
-}
-
-/**
- * Resolve the speech audio URL: when a local --file is given, upload it and
- * return the cloud URL; otherwise fall back to auto TTS synthesis.
- */
-export async function resolveSpeechAudioUrl(
-  opts: Record<string, any>,
-  client: { uploadAudio(filePath: string, filename?: string, contentType?: string): Promise<{ audio_url: string }> },
-): Promise<string | undefined> {
-  if (opts.file) {
-    const { audio_url } = await client.uploadAudio(opts.file, undefined, audioContentTypeFor(opts.file));
-    return audio_url;
-  }
-  return maybeSynthesizeSpeechAudioUrl(opts.speech, opts.url, client as any);
-}
-
-export function normalizeDoOptions(opts: Record<string, any>, extraArgs: string[] = []): Record<string, any> {
-  const normalized = { ...opts };
-  if (normalized.speech && extraArgs.length > 0) {
-    normalized.speech = [normalized.speech, ...extraArgs].join(' ');
-  }
-
-  return normalized;
-}
-
-export function parseIntents(opts: Record<string, any>): ActionIntent[] {
-  const intents: ActionIntent[] = [];
-  if (opts.speech) intents.push({ build: () => Action.speech(opts.speech, undefined, opts.url) });
-  if (opts.vote)   intents.push({ build: () => Action.vote(opts.vote) });
-  return intents;
-}
-
-export function createDoCommand(): Command {
-  return new Command('do')
-    .alias('d')
-    .description('Execute player communication actions (speech/vote/think)')
-    .option('-s, --speech <text>', 'Say something')
-    .option('--file <path>', 'Local audio file to upload and attach to speech')
-    .option('-v, --vote <target>', 'Vote for player')
-    .option('--think <text>', 'Send thinking content visible only to spectators. Standalone (e.g. `do --think "..."`) submits a no-op think action; combined with another action, attaches as that action\'s thinking_content.')
-    .argument('[extra...]', 'Additional unquoted speech words')
-    .action(async (extraArgs: string[], opts) => {
-      opts = normalizeDoOptions(opts, extraArgs);
-
-      if (!opts.speech && !opts.vote && !opts.think) {
-        console.error('No action specified. Use -s, -v, or --think.');
-        process.exit(1);
-      }
-
-      const { isStrategyRunning } = await import('../strategies/strategy-loop.js');
-      const strategyActive = isStrategyRunning();
-
-      if (strategyActive && !opts.speech && !opts.vote && !opts.think) {
-        console.log(JSON.stringify({
-          error: 'strategy_running',
-          message: 'Strategy is controlling the character. Speech (-s), vote (-v), and --think remain available.',
-        }, null, 2));
-        process.exit(1);
-      }
-
-      const client = GameClient.fromAuth();
-      await client.discoverGameServer();
-
-      if (opts.speech) {
-        opts.url = await resolveSpeechAudioUrl(opts, client);
-      }
-
-      const intents = parseIntents(opts);
-      if (intents.length === 0 && opts.think) {
-        intents.push({ build: () => Action.think() });
-      }
-
-      const first = intents[0];
-      let action = first.build();
-      if (opts.think) action = action.withThinking(opts.think);
-      const result = await client.submitAction(action.toJSON() as any);
-
-      try {
-        const store = EventStore.forActiveAccount();
-        store.appendNewEvents(result);
-      } catch {}
-
-      if (intents.length === 1) {
-        console.log(JSON.stringify({ action: action.toJSON(), result: result ?? 'ok' }, null, 2));
-        return;
-      }
-
-      const submitted = [{ action: action.toJSON(), result: result ?? 'ok' }];
-      for (const intent of intents.slice(1)) {
-        const nextAction = intent.build();
-        const nextResult = await client.submitAction(nextAction.toJSON() as any);
-        try {
-          const store = EventStore.forActiveAccount();
-          store.appendNewEvents(nextResult);
-        } catch {}
-        submitted.push({ action: nextAction.toJSON(), result: nextResult ?? 'ok' });
-      }
-
-      console.log(JSON.stringify({ actions: submitted }, null, 2));
-    });
-}
+import { Command } from 'commander';
+import { GameClient } from '../lib/game-client.js';
+import { maybeSynthesizeSpeechAudioUrl } from '../lib/tts-speech.js';
+import { Action } from '../sdk/action.js';
+import { EventStore } from '../pipeline/event-store.js';
+
+interface ActionIntent {
+  build(): Action;
+}
+
+/** Infer an audio MIME type from a file path's extension; defaults to audio/mpeg. */
+export function audioContentTypeFor(filePath: string): string {
+  const ext = filePath.slice(filePath.lastIndexOf('.')).toLowerCase();
+  switch (ext) {
+    case '.wav': return 'audio/wav';
+    case '.ogg': return 'audio/ogg';
+    case '.oga': return 'audio/ogg';
+    case '.m4a': return 'audio/mp4';
+    case '.aac': return 'audio/aac';
+    case '.flac': return 'audio/flac';
+    case '.webm': return 'audio/webm';
+    case '.mp3':
+    default: return 'audio/mpeg';
+  }
+}
+
+/**
+ * Resolve the speech audio URL: when a local --file is given, upload it and
+ * return the cloud URL; otherwise fall back to auto TTS synthesis.
+ */
+export async function resolveSpeechAudioUrl(
+  opts: Record<string, any>,
+  client: { uploadAudio(filePath: string, filename?: string, contentType?: string): Promise<{ audio_url: string }> },
+): Promise<string | undefined> {
+  if (opts.file) {
+    const { audio_url } = await client.uploadAudio(opts.file, undefined, audioContentTypeFor(opts.file));
+    return audio_url;
+  }
+  return maybeSynthesizeSpeechAudioUrl(opts.speech, opts.url, client as any);
+}
+
+export function normalizeDoOptions(opts: Record<string, any>, extraArgs: string[] = []): Record<string, any> {
+  const normalized = { ...opts };
+  if (normalized.speech && extraArgs.length > 0) {
+    normalized.speech = [normalized.speech, ...extraArgs].join(' ');
+  }
+
+  return normalized;
+}
+
+export function parseIntents(opts: Record<string, any>): ActionIntent[] {
+  const intents: ActionIntent[] = [];
+  if (opts.speech) intents.push({ build: () => Action.speech(opts.speech, undefined, opts.url) });
+  if (opts.vote)   intents.push({ build: () => Action.vote(opts.vote) });
+  return intents;
+}
+
+export function createDoCommand(): Command {
+  return new Command('do')
+    .alias('d')
+    .description('Execute player communication actions (speech/vote/think)')
+    .option('-s, --speech <text>', 'Say something')
+    .option('--file <path>', 'Local audio file to upload and attach to speech')
+    .option('-v, --vote <target>', 'Vote for player')
+    .option('--think <text>', 'Send thinking content visible only to spectators. Standalone (e.g. `do --think "..."`) submits a no-op think action; combined with another action, attaches as that action\'s thinking_content.')
+    .argument('[extra...]', 'Additional unquoted speech words')
+    .action(async (extraArgs: string[], opts) => {
+      opts = normalizeDoOptions(opts, extraArgs);
+
+      if (!opts.speech && !opts.vote && !opts.think) {
+        console.error('No action specified. Use -s, -v, or --think.');
+        process.exit(1);
+      }
+
+      const { isStrategyRunning } = await import('../strategies/strategy-loop.js');
+      const strategyActive = isStrategyRunning();
+
+      if (strategyActive && !opts.speech && !opts.vote && !opts.think) {
+        console.log(JSON.stringify({
+          error: 'strategy_running',
+          message: 'Strategy is controlling the character. Speech (-s), vote (-v), and --think remain available.',
+        }, null, 2));
+        process.exit(1);
+      }
+
+      const client = GameClient.fromAuth();
+      await client.discoverGameServer();
+
+      if (opts.speech) {
+        opts.url = await resolveSpeechAudioUrl(opts, client);
+      }
+
+      const intents = parseIntents(opts);
+      if (intents.length === 0 && opts.think) {
+        intents.push({ build: () => Action.think() });
+      }
+
+      const first = intents[0];
+      let action = first.build();
+      if (opts.think) action = action.withThinking(opts.think);
+      const result = await client.submitAction(action.toJSON() as any);
+
+      try {
+        const store = EventStore.forActiveAccount();
+        store.appendNewEvents(result);
+      } catch {}
+
+      if (intents.length === 1) {
+        console.log(JSON.stringify({ action: action.toJSON(), result: result ?? 'ok' }, null, 2));
+        return;
+      }
+
+      const submitted = [{ action: action.toJSON(), result: result ?? 'ok' }];
+      for (const intent of intents.slice(1)) {
+        const nextAction = intent.build();
+        const nextResult = await client.submitAction(nextAction.toJSON() as any);
+        try {
+          const store = EventStore.forActiveAccount();
+          store.appendNewEvents(nextResult);
+        } catch {}
+        submitted.push({ action: nextAction.toJSON(), result: nextResult ?? 'ok' });
+      }
+
+      console.log(JSON.stringify({ actions: submitted }, null, 2));
+    });
+}

package/src/commands/events.test.ts

@@ -0,0 +1,71 @@
+import { describe, expect, it } from 'vitest';
+import {
+  enrichEventForEvents,
+  selectMonitorEventRecordsAfterCursor,
+  selectMonitorTailEventRecords,
+} from './events.js';
+import type { EventRecord } from '../pipeline/event-store.js';
+
+function record(line: number, type: string): EventRecord {
+  return { line, event: { type, tick: line } };
+}
+
+describe('events command monitor registration filter', () => {
+  it('returns only Monitor-registered events after the cursor', () => {
+    const selected = selectMonitorEventRecordsAfterCursor([
+      record(1, 'role_assigned'),
+      record(2, 'player_spotted'),
+      record(3, 'speech'),
+      record(4, 'vote_speech'),
+    ], 1);
+
+    expect(selected.scanned.map((r) => r.event.type)).toEqual(['player_spotted', 'speech', 'vote_speech']);
+    expect(selected.returned.map((r) => r.event.type)).toEqual(['speech']);
+    expect(selected.toLine).toBe(4);
+  });
+
+  it('advances across ignored events so they are not scanned repeatedly', () => {
+    const selected = selectMonitorEventRecordsAfterCursor([
+      record(8, 'vote_speech'),
+      record(9, 'player_spotted'),
+    ], 7);
+
+    expect(selected.returned).toEqual([]);
+    expect(selected.toLine).toBe(9);
+    expect(selected.scanned).toHaveLength(2);
+  });
+
+  it('tail mode applies the Monitor registration filter before the count and type filter', () => {
+    const selected = selectMonitorTailEventRecords([
+      record(1, 'speech'),
+      record(2, 'vote_speech'),
+      record(3, 'killed'),
+      record(4, 'player_spotted'),
+      record(5, 'speech'),
+    ], 2);
+
+    expect(selected.map((r) => r.line)).toEqual([3, 5]);
+    expect(selectMonitorTailEventRecords(selected, 10, 'vote_speech')).toEqual([]);
+  });
+
+  it('enriches meeting_briefing with current speech_order only for the same caller', () => {
+    const summary = {
+      meeting: {
+        caller: '单钳渔夫',
+        speech_order: ['单钳渔夫', '洋流王子'],
+      },
+    };
+
+    expect(enrichEventForEvents({
+      type: 'meeting_briefing',
+      meeting_caller_name: '单钳渔夫',
+    }, summary)).toMatchObject({
+      speech_order: ['单钳渔夫', '洋流王子'],
+    });
+
+    expect(enrichEventForEvents({
+      type: 'meeting_briefing',
+      meeting_caller_name: '其他人',
+    }, summary)).not.toHaveProperty('speech_order');
+  });
+});

package/src/commands/events.ts

@@ -1,22 +1,155 @@
-import { Command } from 'commander';
-import { EventStore } from '../pipeline/event-store.js';
-
-export function createEventsCommand(): Command {
-  return new Command('events')
-    .alias('e')
-    .description('Query game events')
-    .option('-n, --last <count>', 'Show last N events', '10')
-    .option('--clear', 'Clear event history')
-    .option('--type <type>', 'Filter by event type')
-    .action(async (opts) => {
-      const store = EventStore.forLatestGame();
-      if (opts.clear) {
-        store.clear();
-        console.log(JSON.stringify({ message: 'Events cleared.' }));
-        return;
-      }
-      let events = store.tail(parseInt(opts.last));
-      if (opts.type) events = events.filter(e => e.type === opts.type);
-      console.log(JSON.stringify(events, null, 2));
-    });
-}
+import { Command } from 'commander';
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { AuthStore } from '../lib/auth.js';
+import { getProfileStateDir } from '../lib/init-command.js';
+import { sendOwnerControlRequest } from '../runtime/owner-control.js';
+import { EventRecord, EventStore } from '../pipeline/event-store.js';
+import { compactEventFields, compactStateForEvents } from '../pipeline/event-format.js';
+import { NOTABLE_EVENT_TYPES, nextStepForTriggers } from './watch.js';
+
+interface EventsCommandOptions {
+  last?: string;
+  clear?: boolean;
+  type?: string;
+}
+
+async function readCurrentSummary(): Promise<any | null> {
+  const auth = new AuthStore();
+  const profile = auth.getActive();
+  if (!profile) return null;
+  const stateDir = getProfileStateDir(profile);
+  try {
+    const response = await sendOwnerControlRequest(stateDir, 'snapshot');
+    if (response?.ok) return response.summary ?? null;
+  } catch {}
+  const feedPath = join(stateDir, 'feed.json');
+  if (!existsSync(feedPath)) return null;
+  try {
+    return JSON.parse(readFileSync(feedPath, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+function parseCount(value: string | undefined, fallback: number): number {
+  if (!value) return fallback;
+  const parsed = Number.parseInt(value, 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+
+function isMonitorRegisteredRecord(record: EventRecord): boolean {
+  return typeof record.event.type === 'string' && NOTABLE_EVENT_TYPES.has(record.event.type);
+}
+
+export function selectMonitorEventRecordsAfterCursor(
+  records: EventRecord[],
+  fromLine: number,
+): { scanned: EventRecord[]; returned: EventRecord[]; toLine: number } {
+  const scanned = records.filter((record) => record.line > fromLine);
+  const returned = scanned.filter(isMonitorRegisteredRecord);
+  const toLine = scanned.reduce((max, record) => Math.max(max, record.line), fromLine);
+  return { scanned, returned, toLine };
+}
+
+export function selectMonitorTailEventRecords(
+  records: EventRecord[],
+  count: number,
+  type?: string,
+): EventRecord[] {
+  let selected = records.filter(isMonitorRegisteredRecord);
+  if (type) selected = selected.filter((record) => record.event.type === type);
+  return selected.slice(-count);
+}
+
+function eventTypes(records: EventRecord[]): string[] {
+  const out: string[] = [];
+  for (const record of records) {
+    const type = record.event.type;
+    if (typeof type !== 'string' || out.includes(type)) continue;
+    out.push(type);
+  }
+  return out;
+}
+
+export function enrichEventForEvents(event: Record<string, any>, summary: any | null | undefined): Record<string, any> {
+  if (event.type !== 'meeting_briefing') return event;
+  if (event.speech_order) return event;
+  const speechOrder = summary?.meeting?.speech_order;
+  if (!Array.isArray(speechOrder)) return event;
+  const summaryCaller = summary?.meeting?.caller;
+  const eventCaller = event.caller ?? event.meeting_caller_name;
+  if (summaryCaller && eventCaller && summaryCaller !== eventCaller) return event;
+  return { ...event, speech_order: speechOrder };
+}
+
+export function createEventsCommand(): Command {
+  return new Command('events')
+    .alias('e')
+    .description('Query game events')
+    .option('-n, --last <count>', 'Show last N events')
+    .option('--clear', 'Clear event history')
+    .option('--type <type>', 'Filter by event type')
+    .action(async (opts: EventsCommandOptions) => {
+      const store = EventStore.forLatestGame();
+      if (opts.clear) {
+        store.clear();
+        console.log(JSON.stringify({ message: 'Events cleared.' }, null, 2));
+        return;
+      }
+
+      const summary = await readCurrentSummary();
+      const formatContext = {
+        summary,
+      };
+      const state = compactStateForEvents(summary);
+      const debugMode = opts.last !== undefined || opts.type !== undefined;
+
+      if (debugMode) {
+        const count = parseCount(opts.last, 10);
+        let records = selectMonitorTailEventRecords(store.eventRecords(), count, opts.type);
+        records = [...records].sort((a, b) => b.line - a.line);
+        const triggers = eventTypes(records);
+        console.log(JSON.stringify({
+          schema: 'ccl.events.v2',
+          state,
+          exit_reason: triggers,
+          next_step: nextStepForTriggers(triggers),
+          mode: 'tail',
+          session_path: store.path,
+          cursor: null,
+          counts: { returned: records.length },
+          events: records.map((record) => compactEventFields(
+            enrichEventForEvents(record.event, summary),
+            formatContext,
+            record.line,
+          )),
+        }, null, 2));
+        return;
+      }
+
+      const fromLine = store.readEventsCursor();
+      const { scanned, returned, toLine } = selectMonitorEventRecordsAfterCursor(store.eventRecords(), fromLine);
+      const sortedRecords = [...returned].sort((a, b) => b.line - a.line);
+      const triggers = eventTypes(sortedRecords);
+      if (scanned.length > 0) store.appendEventsCursor(toLine);
+
+      console.log(JSON.stringify({
+        schema: 'ccl.events.v2',
+        state,
+        exit_reason: triggers,
+        next_step: nextStepForTriggers(triggers),
+        cursor: {
+          from_line: fromLine,
+          to_line: toLine,
+          advanced: scanned.length > 0,
+        },
+        counts: { returned: sortedRecords.length },
+        events: sortedRecords.map((record) => compactEventFields(
+          enrichEventForEvents(record.event, summary),
+          formatContext,
+          record.line,
+        )),
+      }, null, 2));
+    });
+}

package/src/commands/game-map.test.ts

@@ -1,28 +1,28 @@
-import { describe, expect, it } from 'vitest';
-import { summarizeGameMap } from './game.js';
-
-const mapData = {
-  rooms: [{ name: '酒吧', polygon: [[1, 2]] }],
-  all_task_locations: [
-    { name: '修线', room: '酒吧', x: 1, y: 2, faction: 'lobster' },
-    { name: '破坏', room: '控制室', x: 3, y: 4, faction: 'crab' },
-  ],
-};
-
-describe('summarizeGameMap', () => {
-  it('does not include ASCII by default', () => {
-    const summary = summarizeGameMap(mapData);
-    expect(summary.rooms).toEqual([{ name: '酒吧', polygon: [[1, 2]] }]);
-    expect(summary.task_locations.lobster).toEqual([{ name: '修线', room: '酒吧', x: 1, y: 2 }]);
-    expect(summary.task_locations.crab).toEqual([{ name: '破坏', room: '控制室', x: 3, y: 4 }]);
-    expect(summary).not.toHaveProperty('ascii_map');
-  });
-
-  it('includes packaged ASCII map only with --ascii', () => {
-    const summary = summarizeGameMap(mapData, { ascii: true });
-    expect(typeof summary.ascii_map).toBe('string');
-    expect(summary.ascii_map).toContain('酒吧');
-    expect(summary.ascii_map).toContain('5号走廊');
-    expect(summary).not.toHaveProperty('corridors');
-  });
-});
+import { describe, expect, it } from 'vitest';
+import { summarizeGameMap } from './game.js';
+
+const mapData = {
+  rooms: [{ name: '酒吧', polygon: [[1, 2]] }],
+  all_task_locations: [
+    { name: '修线', room: '酒吧', x: 1, y: 2, faction: 'lobster' },
+    { name: '破坏', room: '控制室', x: 3, y: 4, faction: 'crab' },
+  ],
+};
+
+describe('summarizeGameMap', () => {
+  it('does not include ASCII by default', () => {
+    const summary = summarizeGameMap(mapData);
+    expect(summary.rooms).toEqual([{ name: '酒吧', polygon: [[1, 2]] }]);
+    expect(summary.task_locations.lobster).toEqual([{ name: '修线', room: '酒吧', x: 1, y: 2 }]);
+    expect(summary.task_locations.crab).toEqual([{ name: '破坏', room: '控制室', x: 3, y: 4 }]);
+    expect(summary).not.toHaveProperty('ascii_map');
+  });
+
+  it('includes packaged ASCII map only with --ascii', () => {
+    const summary = summarizeGameMap(mapData, { ascii: true });
+    expect(typeof summary.ascii_map).toBe('string');
+    expect(summary.ascii_map).toContain('酒吧');
+    expect(summary.ascii_map).toContain('5号走廊');
+    expect(summary).not.toHaveProperty('corridors');
+  });
+});