oh-my-codex 0.8.11 → 0.8.13

package/dist/session-history/search.js

@@ -0,0 +1,326 @@
+import { createReadStream, existsSync } from 'node:fs';
+import { readdir, stat } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { createInterface } from 'node:readline';
+import { codexHome } from '../utils/paths.js';
+const DEFAULT_LIMIT = 10;
+const DEFAULT_CONTEXT = 80;
+const MAX_LIMIT = 100;
+const MAX_CONTEXT = 400;
+const DURATION_RE = /^(\d+)([smhdw])$/i;
+function clampInteger(value, fallback, max) {
+    if (!Number.isInteger(value) || value < 0)
+        return fallback;
+    return Math.min(value, max);
+}
+function normalizeProjectFilter(project, cwd) {
+    if (!project)
+        return undefined;
+    const trimmed = project.trim();
+    if (trimmed === '')
+        return undefined;
+    if (trimmed === 'current')
+        return cwd;
+    if (trimmed === 'all')
+        return undefined;
+    return trimmed;
+}
+export function parseSinceSpec(value, now = Date.now()) {
+    if (!value)
+        return null;
+    const trimmed = value.trim();
+    if (trimmed === '')
+        return null;
+    const durationMatch = DURATION_RE.exec(trimmed);
+    if (durationMatch) {
+        const amount = Number(durationMatch[1]);
+        const unit = durationMatch[2].toLowerCase();
+        const multipliers = {
+            s: 1000,
+            m: 60_000,
+            h: 3_600_000,
+            d: 86_400_000,
+            w: 604_800_000,
+        };
+        return now - amount * multipliers[unit];
+    }
+    const timestamp = Date.parse(trimmed);
+    if (!Number.isNaN(timestamp))
+        return timestamp;
+    throw new Error(`Invalid --since value "${value}". Use formats like 7d, 24h, or 2026-03-10.`);
+}
+async function listRolloutFiles(root) {
+    if (!existsSync(root))
+        return [];
+    const files = [];
+    const queue = [root];
+    while (queue.length > 0) {
+        const dir = queue.pop();
+        if (!dir)
+            continue;
+        const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
+        for (const entry of entries) {
+            const path = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                queue.push(path);
+                continue;
+            }
+            if (entry.isFile() && entry.name.startsWith('rollout-') && entry.name.endsWith('.jsonl')) {
+                files.push(path);
+            }
+        }
+    }
+    return files.sort((a, b) => b.localeCompare(a));
+}
+function safeParseJson(line) {
+    try {
+        const parsed = JSON.parse(line);
+        return parsed && typeof parsed === 'object' ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function asString(value) {
+    return typeof value === 'string' && value.trim() !== '' ? value : null;
+}
+function collectTextFragments(value, fragments) {
+    if (typeof value === 'string') {
+        if (value.trim() !== '')
+            fragments.push(value);
+        return;
+    }
+    if (Array.isArray(value)) {
+        for (const item of value)
+            collectTextFragments(item, fragments);
+        return;
+    }
+    if (!value || typeof value !== 'object')
+        return;
+    for (const [key, child] of Object.entries(value)) {
+        if (key === 'base_instructions' || key === 'developer_instructions')
+            continue;
+        collectTextFragments(child, fragments);
+    }
+}
+function extractSessionMeta(parsed) {
+    if (!parsed || parsed.type !== 'session_meta')
+        return null;
+    const payload = parsed.payload;
+    if (!payload || typeof payload !== 'object')
+        return null;
+    const typedPayload = payload;
+    const sessionId = asString(typedPayload.id);
+    if (!sessionId)
+        return null;
+    return {
+        sessionId,
+        timestamp: asString(typedPayload.timestamp),
+        cwd: asString(typedPayload.cwd),
+    };
+}
+function extractSearchableTexts(parsed, rawLine) {
+    if (!parsed) {
+        return [{ text: rawLine, recordType: 'raw' }];
+    }
+    const topType = asString(parsed.type) ?? 'unknown';
+    const texts = [];
+    if (topType === 'session_meta') {
+        const payload = parsed.payload;
+        if (payload && typeof payload === 'object') {
+            const meta = payload;
+            const summary = [meta.id, meta.cwd, meta.agent_role, meta.agent_nickname]
+                .flatMap((value) => (typeof value === 'string' && value.trim() !== '') ? [value] : [])
+                .join(' ')
+                .trim();
+            if (summary)
+                texts.push({ text: summary, recordType: 'session_meta' });
+        }
+        return texts;
+    }
+    if (topType === 'event_msg') {
+        const payload = parsed.payload;
+        const payloadType = payload && typeof payload === 'object'
+            ? asString(payload.type) ?? 'unknown'
+            : 'unknown';
+        const fragments = [];
+        collectTextFragments(payload, fragments);
+        const text = fragments.join(' \n ').trim();
+        if (text) {
+            texts.push({ text, recordType: `event_msg:${payloadType}` });
+        }
+        return texts;
+    }
+    if (topType === 'response_item') {
+        const payload = parsed.payload;
+        if (!payload || typeof payload !== 'object')
+            return texts;
+        const typedPayload = payload;
+        const payloadType = asString(typedPayload.type) ?? 'unknown';
+        if (payloadType === 'message') {
+            const role = asString(typedPayload.role) ?? 'unknown';
+            if (role !== 'assistant' && role !== 'user')
+                return texts;
+            const fragments = [];
+            collectTextFragments(typedPayload.content, fragments);
+            const text = fragments.join(' \n ').trim();
+            if (text)
+                texts.push({ text, recordType: `response_item:${payloadType}:${role}` });
+            return texts;
+        }
+        const fragments = [];
+        if (payloadType === 'function_call') {
+            const name = asString(typedPayload.name);
+            if (name)
+                fragments.push(name);
+            const argumentsText = asString(typedPayload.arguments);
+            if (argumentsText)
+                fragments.push(argumentsText);
+        }
+        else if (payloadType === 'function_call_output') {
+            const outputText = typedPayload.output;
+            collectTextFragments(outputText, fragments);
+        }
+        else {
+            collectTextFragments(typedPayload, fragments);
+        }
+        const text = fragments.join(' \n ').trim();
+        if (text)
+            texts.push({ text, recordType: `response_item:${payloadType}` });
+        return texts;
+    }
+    return [{ text: rawLine, recordType: topType }];
+}
+function buildSnippet(text, query, context, caseSensitive) {
+    if (text === '')
+        return null;
+    const haystack = caseSensitive ? text : text.toLowerCase();
+    const needle = caseSensitive ? query : query.toLowerCase();
+    const index = haystack.indexOf(needle);
+    if (index < 0)
+        return null;
+    const start = Math.max(0, index - context);
+    const end = Math.min(text.length, index + query.length + context);
+    const prefix = start > 0 ? '…' : '';
+    const suffix = end < text.length ? '…' : '';
+    return `${prefix}${text.slice(start, end).replace(/\s+/g, ' ').trim()}${suffix}`;
+}
+function matchesFilter(value, filter, caseSensitive) {
+    if (!filter)
+        return true;
+    if (!value)
+        return false;
+    if (caseSensitive)
+        return value.includes(filter);
+    return value.toLowerCase().includes(filter.toLowerCase());
+}
+async function searchRolloutFile(filePath, options) {
+    const stream = createReadStream(filePath, 'utf-8');
+    const reader = createInterface({ input: stream, crlfDelay: Infinity });
+    const results = [];
+    let meta = null;
+    let lineNumber = 0;
+    let skipFile = false;
+    try {
+        for await (const line of reader) {
+            lineNumber += 1;
+            const parsed = safeParseJson(line);
+            if (lineNumber === 1) {
+                meta = extractSessionMeta(parsed);
+                const fallbackSessionId = filePath.split('rollout-')[1]?.replace(/\.jsonl$/, '') ?? filePath;
+                if (!meta) {
+                    meta = { sessionId: fallbackSessionId, timestamp: null, cwd: null };
+                }
+                const sessionTimestamp = meta.timestamp ? Date.parse(meta.timestamp) : Number.NaN;
+                if (options.sinceCutoff != null && !Number.isNaN(sessionTimestamp) && sessionTimestamp < options.sinceCutoff) {
+                    skipFile = true;
+                    break;
+                }
+                if (!matchesFilter(meta.sessionId, options.session, options.caseSensitive)) {
+                    skipFile = true;
+                    break;
+                }
+                if (!matchesFilter(meta.cwd, options.projectFilter, options.caseSensitive)) {
+                    skipFile = true;
+                    break;
+                }
+            }
+            for (const candidate of extractSearchableTexts(parsed, line)) {
+                const snippet = buildSnippet(candidate.text, options.query, options.context, options.caseSensitive);
+                if (!snippet || !meta)
+                    continue;
+                results.push({
+                    session_id: meta.sessionId,
+                    timestamp: meta.timestamp,
+                    cwd: meta.cwd,
+                    transcript_path: filePath,
+                    transcript_path_relative: relative(options.codexHomeDir, filePath),
+                    record_type: candidate.recordType,
+                    line_number: lineNumber,
+                    snippet,
+                });
+                if (results.length >= options.limit) {
+                    return { meta, results };
+                }
+            }
+        }
+    }
+    finally {
+        reader.close();
+        stream.destroy();
+    }
+    return skipFile ? { meta, results: [] } : { meta, results };
+}
+export async function searchSessionHistory(options) {
+    const query = options.query.trim();
+    if (query === '') {
+        throw new Error('Search query must not be empty.');
+    }
+    const cwd = options.cwd ?? process.cwd();
+    const codexHomeDir = options.codexHomeDir ?? codexHome();
+    const limit = clampInteger(options.limit ?? DEFAULT_LIMIT, DEFAULT_LIMIT, MAX_LIMIT) || DEFAULT_LIMIT;
+    const context = clampInteger(options.context ?? DEFAULT_CONTEXT, DEFAULT_CONTEXT, MAX_CONTEXT) || DEFAULT_CONTEXT;
+    const caseSensitive = options.caseSensitive === true;
+    const sinceCutoff = parseSinceSpec(options.since, options.now ?? Date.now());
+    const projectFilter = normalizeProjectFilter(options.project, cwd);
+    const rolloutRoot = join(codexHomeDir, 'sessions');
+    const files = await listRolloutFiles(rolloutRoot);
+    const results = [];
+    let searchedFiles = 0;
+    const matchedSessions = new Set();
+    for (const filePath of files) {
+        if (results.length >= limit)
+            break;
+        const fileStat = await stat(filePath).catch(() => null);
+        if (!fileStat)
+            continue;
+        if (sinceCutoff != null && fileStat.mtimeMs < sinceCutoff) {
+            continue;
+        }
+        searchedFiles += 1;
+        const fileSearch = await searchRolloutFile(filePath, {
+            query,
+            context,
+            caseSensitive,
+            limit: limit - results.length,
+            session: options.session,
+            sinceCutoff,
+            projectFilter,
+            cwd,
+            codexHomeDir,
+        });
+        for (const result of fileSearch.results) {
+            results.push(result);
+            matchedSessions.add(result.session_id);
+            if (results.length >= limit)
+                break;
+        }
+    }
+    return {
+        query,
+        searched_files: searchedFiles,
+        matched_sessions: matchedSessions.size,
+        results,
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/session-history/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/session-history/search.ts"],"names":[],"mappings":"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"}

package/dist/team/__tests__/allocation-policy.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=allocation-policy.test.d.ts.map

package/dist/team/__tests__/allocation-policy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allocation-policy.test.d.ts","sourceRoot":"","sources":["../../../src/team/__tests__/allocation-policy.test.ts"],"names":[],"mappings":""}

package/dist/team/__tests__/allocation-policy.test.js

@@ -0,0 +1,39 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { allocateTasksToWorkers, chooseTaskOwner } from '../allocation-policy.js';
+describe('allocation-policy', () => {
+    it('prefers matching worker role when no prior assignments exist', () => {
+        const decision = chooseTaskOwner({ subject: 'write docs', description: 'document the feature', role: 'writer' }, [
+            { name: 'worker-1', role: 'executor' },
+            { name: 'worker-2', role: 'writer' },
+        ], []);
+        assert.equal(decision.owner, 'worker-2');
+        assert.match(decision.reason, /matches worker role writer/);
+    });
+    it('clusters same-role tasks on a specialized lane before spilling over', () => {
+        const assignments = allocateTasksToWorkers([
+            { subject: 'write docs 1', description: 'd1', role: 'writer' },
+            { subject: 'write docs 2', description: 'd2', role: 'writer' },
+            { subject: 'implement feature', description: 'd3', role: 'executor' },
+        ], [
+            { name: 'worker-1', role: 'executor' },
+            { name: 'worker-2', role: 'writer' },
+            { name: 'worker-3', role: 'test-engineer' },
+        ]);
+        assert.equal(assignments[0].owner, 'worker-2');
+        assert.equal(assignments[1].owner, 'worker-2');
+        assert.equal(assignments[2].owner, 'worker-1');
+    });
+    it('falls back to load balancing when roles do not differentiate the work', () => {
+        const assignments = allocateTasksToWorkers([
+            { subject: 'task a', description: 'a' },
+            { subject: 'task b', description: 'b' },
+            { subject: 'task c', description: 'c' },
+        ], [
+            { name: 'worker-1' },
+            { name: 'worker-2' },
+        ]);
+        assert.deepEqual(assignments.map((task) => task.owner), ['worker-1', 'worker-2', 'worker-1']);
+    });
+});
+//# sourceMappingURL=allocation-policy.test.js.map

package/dist/team/__tests__/allocation-policy.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"allocation-policy.test.js","sourceRoot":"","sources":["../../../src/team/__tests__/allocation-policy.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAElF,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,QAAQ,GAAG,eAAe,CAC9B,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,sBAAsB,EAAE,IAAI,EAAE,QAAQ,EAAE,EAC9E;YACE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE;YACtC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;SACrC,EACD,EAAE,CACH,CAAC;QAEF,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,WAAW,GAAG,sBAAsB,CACxC;YACE,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9D,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9D,EAAE,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE;SACtE,EACD;YACE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE;YACtC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;YACpC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE;SAC5C,CACF,CAAC;QAEF,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC/C,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC/C,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,MAAM,WAAW,GAAG,sBAAsB,CACxC;YACE,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE;YACvC,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE;YACvC,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE;SACxC,EACD;YACE,EAAE,IAAI,EAAE,UAAU,EAAE;YACpB,EAAE,IAAI,EAAE,UAAU,EAAE;SACrB,CACF,CAAC;QAEF,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IAChG,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/team/__tests__/api-interop.test.js

@@ -4,7 +4,7 @@ import { mkdtemp, rm, mkdir, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { tmpdir } from 'node:os';
 import { resolveTeamApiOperation, buildLegacyTeamDeprecationHint, executeTeamApiOperation, LEGACY_TEAM_MCP_TOOLS, TEAM_API_OPERATIONS, } from '../api-interop.js';
-import { initTeamState, createTask, sendDirectMessage, enqueueDispatchRequest, readDispatchRequest, appendTeamEvent, } from '../state.js';
+import { initTeamState, createTask, sendDirectMessage, enqueueDispatchRequest, readDispatchRequest, appendTeamEvent, updateWorkerHeartbeat, writeMonitorSnapshot, writeWorkerStatus, } from '../state.js';
 async function setupTeam(name) {
     const cwd = await mkdtemp(join(tmpdir(), `omx-interop-${name}-`));
     await initTeamState(name, 'test task', 'executor', 2, cwd);
@@ -30,7 +30,7 @@ describe('resolveTeamApiOperation', () => {
     it('handles whitespace and casing', () => {
         assert.equal(resolveTeamApiOperation('  SEND_MESSAGE  '), 'send-message');
     });
-    it('resolves all 30 operations from the operation list', () => {
+    it('resolves all 32 operations from the operation list', () => {
         for (const op of TEAM_API_OPERATIONS) {
             assert.equal(resolveTeamApiOperation(op), op);
         }
@@ -64,8 +64,8 @@ describe('LEGACY_TEAM_MCP_TOOLS', () => {
     });
 });
 describe('TEAM_API_OPERATIONS', () => {
-    it('contains 30 operations', () => {
-        assert.equal(TEAM_API_OPERATIONS.length, 30);
+    it('contains 32 operations', () => {
+        assert.equal(TEAM_API_OPERATIONS.length, 32);
     });
     it('all use kebab-case', () => {
         for (const op of TEAM_API_OPERATIONS) {
@@ -941,6 +941,142 @@ describe('executeTeamApiOperation: await-event', () => {
         }
     });
 });
+// ─── read-idle-state ────────────────────────────────────────────────────────
+describe('executeTeamApiOperation: read-idle-state', () => {
+    it('returns structured idle state from summary, snapshot, and recent events', async () => {
+        const { cwd, cleanup } = await setupTeam('idle-state-team');
+        try {
+            await writeMonitorSnapshot('idle-state-team', {
+                taskStatusById: { '1': 'pending' },
+                workerAliveByName: { 'worker-1': true, 'worker-2': true },
+                workerStateByName: { 'worker-1': 'idle', 'worker-2': 'working' },
+                workerTurnCountByName: { 'worker-1': 3, 'worker-2': 5 },
+                workerTaskIdByName: { 'worker-1': '1', 'worker-2': '1' },
+                mailboxNotifiedByMessageId: {},
+                completedEventTaskIds: {},
+            }, cwd);
+            await appendTeamEvent('idle-state-team', {
+                type: 'worker_idle',
+                worker: 'worker-1',
+                task_id: '1',
+                prev_state: 'working',
+            }, cwd);
+            const allIdleEvent = await appendTeamEvent('idle-state-team', {
+                type: 'all_workers_idle',
+                worker: 'worker-1',
+                worker_count: 2,
+            }, cwd);
+            const result = await executeTeamApiOperation('read-idle-state', {
+                team_name: 'idle-state-team',
+            }, cwd);
+            assert.equal(result.ok, true);
+            if (result.ok) {
+                assert.equal(result.data.team_name, 'idle-state-team');
+                assert.equal(result.data.worker_count, 2);
+                assert.equal(result.data.idle_worker_count, 1);
+                assert.deepEqual(result.data.idle_workers, ['worker-1']);
+                assert.deepEqual(result.data.non_idle_workers, ['worker-2']);
+                assert.equal(result.data.all_workers_idle, false);
+                const byWorker = result.data.last_idle_transition_by_worker;
+                assert.equal(byWorker['worker-1']?.source_type, 'worker_idle');
+                assert.equal(byWorker['worker-2'], null);
+                const lastAllIdle = result.data.last_all_workers_idle_event;
+                assert.equal(lastAllIdle?.event_id, allIdleEvent.event_id);
+                assert.equal(lastAllIdle?.type, 'all_workers_idle');
+                assert.equal(lastAllIdle?.worker_count, 2);
+            }
+        }
+        finally {
+            await cleanup();
+        }
+    });
+});
+// ─── read-stall-state ───────────────────────────────────────────────────────
+describe('executeTeamApiOperation: read-stall-state', () => {
+    it('returns structured stall state from summary, snapshot, and recent events', async () => {
+        const { cwd, cleanup } = await setupTeam('stall-state-team');
+        try {
+            const task = await createTask('stall-state-team', {
+                subject: 'Pending work',
+                description: 'Needs attention',
+                status: 'pending',
+            }, cwd);
+            await writeWorkerStatus('stall-state-team', 'worker-1', {
+                state: 'working',
+                current_task_id: task.id,
+                updated_at: '2026-03-10T10:00:00.000Z',
+            }, cwd);
+            await writeWorkerStatus('stall-state-team', 'worker-2', {
+                state: 'idle',
+                updated_at: '2026-03-10T10:00:00.000Z',
+            }, cwd);
+            await updateWorkerHeartbeat('stall-state-team', 'worker-1', {
+                alive: true,
+                pid: 101,
+                turn_count: 1,
+                last_turn_at: '2026-03-10T10:00:00.000Z',
+            }, cwd);
+            await updateWorkerHeartbeat('stall-state-team', 'worker-2', {
+                alive: true,
+                pid: 102,
+                turn_count: 1,
+                last_turn_at: '2026-03-10T10:00:00.000Z',
+            }, cwd);
+            const primed = await executeTeamApiOperation('get-summary', {
+                team_name: 'stall-state-team',
+            }, cwd);
+            assert.equal(primed.ok, true);
+            await updateWorkerHeartbeat('stall-state-team', 'worker-1', {
+                alive: true,
+                pid: 101,
+                turn_count: 8,
+                last_turn_at: '2026-03-10T10:05:00.000Z',
+            }, cwd);
+            await writeMonitorSnapshot('stall-state-team', {
+                taskStatusById: { [task.id]: 'pending' },
+                workerAliveByName: { 'worker-1': true, 'worker-2': true },
+                workerStateByName: { 'worker-1': 'idle', 'worker-2': 'idle' },
+                workerTurnCountByName: { 'worker-1': 8, 'worker-2': 1 },
+                workerTaskIdByName: { 'worker-1': task.id, 'worker-2': '' },
+                mailboxNotifiedByMessageId: {},
+                completedEventTaskIds: {},
+            }, cwd);
+            const idleEvent = await appendTeamEvent('stall-state-team', {
+                type: 'all_workers_idle',
+                worker: 'worker-2',
+                worker_count: 2,
+            }, cwd);
+            const nudgeEvent = await appendTeamEvent('stall-state-team', {
+                type: 'team_leader_nudge',
+                worker: 'leader-fixed',
+                reason: 'all_workers_idle',
+            }, cwd);
+            const result = await executeTeamApiOperation('read-stall-state', {
+                team_name: 'stall-state-team',
+            }, cwd);
+            assert.equal(result.ok, true);
+            if (result.ok) {
+                assert.equal(result.data.team_name, 'stall-state-team');
+                assert.equal(result.data.team_stalled, true);
+                assert.equal(result.data.leader_stale, true);
+                assert.deepEqual(result.data.stalled_workers, ['worker-1']);
+                assert.deepEqual(result.data.dead_workers, []);
+                assert.equal(result.data.pending_task_count, 1);
+                assert.equal(result.data.all_workers_idle, true);
+                assert.match(result.data.reasons.join(' '), /workers_non_reporting:worker-1/);
+                assert.match(result.data.reasons.join(' '), /leader_attention_pending:team_leader_nudge/);
+                const lastAllIdle = result.data.last_all_workers_idle_event;
+                const lastNudge = result.data.last_team_leader_nudge_event;
+                assert.equal(lastAllIdle?.event_id, idleEvent.event_id);
+                assert.equal(lastNudge?.event_id, nudgeEvent.event_id);
+                assert.equal(lastNudge?.reason, 'all_workers_idle');
+            }
+        }
+        finally {
+            await cleanup();
+        }
+    });
+});
 // ─── get-summary ──────────────────────────────────────────────────────────
 describe('executeTeamApiOperation: get-summary', () => {
     it('returns summary for existing team', async () => {