pi-harness-delegate 0.1.0

package/extensions/config.ts

@@ -0,0 +1,158 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { DEFAULT_TIMEOUT_MS } from './harnesses/types.ts';
+
+export interface HarnessConfig {
+	model?: string;
+	timeoutMs?: number;
+	allowDangerous?: boolean;
+	maxBudgetUsd?: number;
+}
+
+export interface DelegateConfig {
+	model?: string;
+	timeoutMs: number;
+	defaultMode: string;
+	defaultHarness: string;
+	allowDangerous: boolean;
+	inspectThinking: boolean;
+	maxBudgetUsd?: number;
+	autoDelegateHints: boolean;
+	modelAliases: Record<string, string>;
+	maxConcurrent: number | { global?: number; perHarness?: Record<string, number> };
+	maxTranscripts: number;
+	harnesses: Record<string, HarnessConfig>;
+}
+
+export function agentDir(): string {
+	return process.env.PI_CODING_AGENT_DIR ?? join(homedir(), '.pi', 'agent');
+}
+
+export function outputsDir(harness?: string): string {
+	const base = join(agentDir(), 'delegate', 'outputs');
+	return harness ? join(base, harness) : base;
+}
+
+export function legacyOutputsDir(): string {
+	return join(agentDir(), 'claude-delegate', 'outputs');
+}
+
+export function loadConfig(): DelegateConfig {
+	const cfg: DelegateConfig = {
+		timeoutMs: DEFAULT_TIMEOUT_MS,
+		defaultMode: 'general',
+		defaultHarness: 'claude',
+		allowDangerous: false,
+		inspectThinking: false,
+		autoDelegateHints: false,
+		modelAliases: { economy: 'haiku', balanced: 'sonnet', max: 'opus' },
+		maxConcurrent: 1,
+		maxTranscripts: 100,
+		harnesses: {},
+	};
+	try {
+		const file = join(agentDir(), 'settings.json');
+		if (!existsSync(file)) return cfg;
+		const settings = JSON.parse(readFileSync(file, 'utf8')) as {
+			delegate?: Partial<DelegateConfig & { harnesses: Record<string, HarnessConfig> }>;
+			claudeDelegate?: Partial<DelegateConfig & { model?: string }>;
+		};
+		// Legacy claudeDelegate -> delegate.harnesses.claude migration
+		if (settings.claudeDelegate && !settings.delegate) {
+			const c = settings.claudeDelegate as Partial<DelegateConfig>;
+			if (typeof c.model === 'string') cfg.harnesses['claude'] = { ...(cfg.harnesses['claude'] ?? {}), model: c.model };
+			if (typeof c.timeoutMs === 'number' && c.timeoutMs > 0) cfg.timeoutMs = c.timeoutMs;
+			if (typeof c.defaultMode === 'string') cfg.defaultMode = c.defaultMode;
+			if (typeof c.allowDangerous === 'boolean') cfg.allowDangerous = c.allowDangerous;
+			if (typeof c.inspectThinking === 'boolean') cfg.inspectThinking = c.inspectThinking;
+			if (typeof (c as DelegateConfig).maxBudgetUsd === 'number' && (c as DelegateConfig).maxBudgetUsd! > 0) cfg.maxBudgetUsd = (c as DelegateConfig).maxBudgetUsd;
+			if (typeof c.autoDelegateHints === 'boolean') cfg.autoDelegateHints = c.autoDelegateHints;
+			if ((c as DelegateConfig).modelAliases && typeof (c as DelegateConfig).modelAliases === 'object') {
+				for (const [k, v] of Object.entries((c as DelegateConfig).modelAliases!)) {
+					if (typeof v === 'string' && v) cfg.modelAliases[k] = v;
+				}
+			}
+			if (typeof c.maxConcurrent === 'number' && c.maxConcurrent >= 0) cfg.maxConcurrent = c.maxConcurrent;
+			else if (c.maxConcurrent && typeof c.maxConcurrent === 'object') {
+				const obj = c.maxConcurrent as { global?: unknown; perHarness?: unknown };
+				const out: { global?: number; perHarness?: Record<string, number> } = {};
+				if (typeof obj.global === 'number' && obj.global >= 0) out.global = obj.global;
+				if (obj.perHarness && typeof obj.perHarness === 'object') {
+					const ph: Record<string, number> = {};
+					for (const [k, v] of Object.entries(obj.perHarness as Record<string, unknown>)) {
+						if (typeof v === 'number' && v >= 0) ph[k] = v;
+					}
+					if (Object.keys(ph).length > 0) out.perHarness = ph;
+				}
+				if (out.global !== undefined || out.perHarness) cfg.maxConcurrent = out;
+			}
+			if (typeof c.maxTranscripts === 'number' && c.maxTranscripts >= 0) cfg.maxTranscripts = c.maxTranscripts;
+			if (c.harnesses && typeof c.harnesses === 'object') {
+				for (const [k, v] of Object.entries(c.harnesses)) {
+					if (v && typeof v === 'object') cfg.harnesses[k] = { ...(cfg.harnesses[k] ?? {}), ...(v as HarnessConfig) };
+				}
+			}
+			// also map harnesses.claude if any
+			return cfg;
+		}
+		const d = settings.delegate ?? {};
+		if (typeof d.defaultHarness === 'string' && d.defaultHarness) cfg.defaultHarness = d.defaultHarness;
+		if (typeof d.defaultMode === 'string') cfg.defaultMode = d.defaultMode;
+		if (typeof d.model === 'string') cfg.model = d.model;
+		if (typeof d.timeoutMs === 'number' && d.timeoutMs > 0) cfg.timeoutMs = d.timeoutMs;
+		if (typeof d.allowDangerous === 'boolean') cfg.allowDangerous = d.allowDangerous;
+		if (typeof d.inspectThinking === 'boolean') cfg.inspectThinking = d.inspectThinking;
+		if (typeof d.maxBudgetUsd === 'number' && d.maxBudgetUsd > 0) cfg.maxBudgetUsd = d.maxBudgetUsd;
+		if (typeof d.autoDelegateHints === 'boolean') cfg.autoDelegateHints = d.autoDelegateHints;
+		if (d.modelAliases && typeof d.modelAliases === 'object') {
+			for (const [k, v] of Object.entries(d.modelAliases)) {
+				if (typeof v === 'string' && v) cfg.modelAliases[k] = v;
+			}
+		}
+		if (typeof d.maxConcurrent === 'number' && d.maxConcurrent >= 0) cfg.maxConcurrent = d.maxConcurrent;
+		else if (d.maxConcurrent && typeof d.maxConcurrent === 'object') {
+			const obj = d.maxConcurrent as { global?: unknown; perHarness?: unknown };
+			const out: { global?: number; perHarness?: Record<string, number> } = {};
+			if (typeof obj.global === 'number' && obj.global >= 0) out.global = obj.global;
+			if (obj.perHarness && typeof obj.perHarness === 'object') {
+				const ph: Record<string, number> = {};
+				for (const [k, v] of Object.entries(obj.perHarness as Record<string, unknown>)) {
+					if (typeof v === 'number' && v >= 0) ph[k] = v;
+				}
+				if (Object.keys(ph).length > 0) out.perHarness = ph;
+			}
+			if (out.global !== undefined || out.perHarness) cfg.maxConcurrent = out;
+		}
+		if (typeof d.maxTranscripts === 'number' && d.maxTranscripts >= 0) cfg.maxTranscripts = d.maxTranscripts;
+		if (d.harnesses && typeof d.harnesses === 'object') {
+			for (const [k, v] of Object.entries(d.harnesses)) {
+				if (v && typeof v === 'object') cfg.harnesses[k] = { ...(v as HarnessConfig) };
+			}
+		}
+		// also support legacy claudeDelegate merged when delegate also present (delegate wins)
+		if (settings.claudeDelegate) {
+			const c = settings.claudeDelegate as Partial<DelegateConfig>;
+			if (typeof c.model === 'string' && !cfg.harnesses['claude']?.model) {
+				cfg.harnesses['claude'] = { ...(cfg.harnesses['claude'] ?? {}), model: c.model };
+			}
+		}
+	} catch {
+		// invalid settings — fall back to defaults
+	}
+	return cfg;
+}
+
+export function resolveModelForHarness(cfg: DelegateConfig, harness: string, model?: string, templateModel?: string): string | undefined {
+	const resolve = (m?: string) => (m ? (cfg.modelAliases[m] ?? m) : undefined);
+	return resolve(model) ?? resolve(templateModel) ?? resolve(cfg.harnesses[harness]?.model) ?? resolve(cfg.model);
+}
+
+export function getMaxConcurrent(cfg: DelegateConfig, harness?: string): number {
+	if (typeof cfg.maxConcurrent === 'number') return cfg.maxConcurrent;
+	// if object shape {global, perHarness}
+	const mc = cfg.maxConcurrent as unknown as { global?: number; perHarness?: Record<string, number> };
+	if (harness && mc.perHarness && typeof mc.perHarness[harness] === 'number') return mc.perHarness[harness]!;
+	if (typeof mc.global === 'number') return mc.global;
+	return 1;
+}

package/extensions/harnesses/amp.ts

@@ -0,0 +1,137 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import type { Harness, BuildArgsOpts, NormalizedPermission, ParseOutcome, ParseState, StreamedResult } from './types.ts';
+
+const execFileAsync = promisify(execFile);
+
+function isRecord(v: unknown): v is Record<string, unknown> {
+	return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+
+const PERMISSION_MAP: Record<NormalizedPermission, string> = {
+	readonly: 'read-only',
+	edit: 'workspace',
+	danger: 'danger',
+};
+
+function extractAmpText(o: Record<string, unknown>): string | undefined {
+	if (typeof o.text === 'string') return o.text;
+	if (typeof o.output === 'string') return o.output;
+	if (typeof o.delta === 'string') return o.delta;
+	if (typeof o.content === 'string') return o.content;
+	return undefined;
+}
+
+export function parseAmpLine(line: string, state: ParseState): ParseOutcome {
+	let o: unknown;
+	try {
+		o = JSON.parse(line);
+	} catch {
+		if (line.trim().length > 0) return { streamedText: line + '\n', activities: [] };
+		return { activities: [] };
+	}
+	if (!isRecord(o)) return { activities: [] };
+	const activities: ParseOutcome['activities'] = [];
+	let streamedText: string | undefined;
+	const typeStr = typeof o.type === 'string' ? o.type : '';
+
+	if (typeStr.includes('tool') || o.type === 'tool_use') {
+		const name = typeof o.name === 'string' ? o.name : 'tool';
+		if (typeStr.includes('start') || o.type === 'tool_use') {
+			activities.push({ kind: 'tool_start', name });
+			if (isRecord(o.input)) activities.push({ kind: 'tool_input', name, input: o.input as Record<string, unknown> });
+		} else {
+			activities.push({ kind: 'tool_result', isError: o.is_error === true });
+		}
+	}
+	if (typeStr.includes('thinking')) activities.push({ kind: 'thinking', chars: 10 });
+
+	const text = extractAmpText(o);
+	if (text && !typeStr.includes('tool')) streamedText = text;
+
+	if (o.type === 'result' || o.type === 'done' || o.type === 'completed') {
+		const usage = isRecord(o.usage) ? o.usage : null;
+		const result: StreamedResult = {
+			result: typeof o.result === 'string' ? o.result : state.streamedText + (streamedText ?? ''),
+			isError: o.is_error === true,
+			numTurns: typeof o.num_turns === 'number' ? o.num_turns : 0,
+			totalCostUsd: typeof o.total_cost_usd === 'number' ? o.total_cost_usd : 0,
+			sessionId: typeof o.session_id === 'string' ? o.session_id : null,
+			stopReason: typeof o.stop_reason === 'string' ? o.stop_reason : null,
+			permissionDenials: [],
+			durationMs: typeof o.duration_ms === 'number' ? o.duration_ms : null,
+			durationApiMs: null,
+			ttftMs: null,
+			model: typeof o.model === 'string' ? o.model : null,
+			contextWindow: null,
+			maxOutputTokens: null,
+			usage: usage
+				? {
+						inputTokens: typeof usage.input_tokens === 'number' ? usage.input_tokens : 0,
+						outputTokens: typeof usage.output_tokens === 'number' ? usage.output_tokens : 0,
+						cacheCreationInputTokens: 0,
+						cacheReadInputTokens: 0,
+					}
+				: null,
+		};
+		return { activities, streamedText, result };
+	}
+	return { activities, streamedText };
+}
+
+export const ampHarness: Harness = {
+	name: 'amp',
+	displayName: 'Amp',
+	binary: 'amp',
+	async detect() {
+		try {
+			const { stdout } = await execFileAsync('amp', ['--version'], { timeout: 5000 });
+			return { ok: true, version: stdout.trim() };
+		} catch {
+			try {
+				const { stdout } = await execFileAsync('omp', ['--version'], { timeout: 5000 });
+				return { ok: true, version: stdout.trim() };
+			} catch {
+				return { ok: false, hint: 'Install Amp: https://ampcode.com' };
+			}
+		}
+	},
+	buildArgs(opts: BuildArgsOpts): string[] {
+		const perm = opts.nativePermission ?? PERMISSION_MAP[opts.permission] ?? 'workspace';
+		const args = ['--output', 'jsonl', opts.prompt, '--permission', perm];
+		if (opts.model) args.push('--model', opts.model);
+		if (opts.resumeSessionId) args.push('--resume', opts.resumeSessionId);
+		for (const dir of opts.addDirs ?? []) args.push('--add-dir', dir);
+		return args;
+	},
+	parseLine(line: string, state: ParseState): ParseOutcome {
+		return parseAmpLine(line, state);
+	},
+	extractResult(state: ParseState): StreamedResult | null {
+		if (state.result) return state.result;
+		if (state.streamedText.trim().length > 0) {
+			return {
+				result: state.streamedText,
+				isError: false,
+				numTurns: 1,
+				totalCostUsd: 0,
+				sessionId: null,
+				stopReason: null,
+				permissionDenials: [],
+				durationMs: null,
+				durationApiMs: null,
+				ttftMs: null,
+				model: null,
+				contextWindow: null,
+				maxOutputTokens: null,
+				usage: null,
+			};
+		}
+		return null;
+	},
+	permissionMap: {
+		readonly: ['read-only'],
+		edit: ['workspace'],
+		danger: ['danger'],
+	},
+};

package/extensions/harnesses/claude.ts

@@ -0,0 +1,129 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import type { Harness, BuildArgsOpts, NormalizedPermission, ParseOutcome, ParseState, StreamedResult } from './types.ts';
+
+const execFileAsync = promisify(execFile);
+
+function isRecord(v: unknown): v is Record<string, unknown> {
+	return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+
+const PERMISSION_MAP: Record<NormalizedPermission, string> = {
+	readonly: 'plan',
+	edit: 'acceptEdits',
+	danger: 'bypassPermissions',
+};
+
+export function parseClaudeLine(line: string, state: ParseState): ParseOutcome {
+	let o: unknown;
+	try {
+		o = JSON.parse(line);
+	} catch {
+		return { activities: [] };
+	}
+	if (!isRecord(o)) return { activities: [] };
+	const activities: ParseOutcome['activities'] = [];
+	let streamedText: string | undefined;
+
+	if (o.type === 'stream_event' && isRecord(o.event)) {
+		const ev = o.event;
+		const delta = isRecord(ev.delta) ? ev.delta : undefined;
+		if (ev.type === 'content_block_delta' && delta?.type === 'text_delta' && typeof delta.text === 'string') {
+			streamedText = delta.text;
+		} else if (ev.type === 'content_block_delta' && delta?.type === 'thinking_delta' && typeof delta.thinking === 'string') {
+			activities.push({ kind: 'thinking', chars: delta.thinking.length });
+		} else if (ev.type === 'content_block_start' && isRecord(ev.content_block)) {
+			const cb = ev.content_block;
+			if (cb.type === 'tool_use' && typeof cb.name === 'string') {
+				activities.push({ kind: 'tool_start', name: cb.name });
+			}
+		}
+	} else if (o.type === 'assistant' && isRecord(o.message)) {
+		for (const block of Array.isArray(o.message.content) ? o.message.content : []) {
+			if (isRecord(block) && block.type === 'tool_use' && typeof block.name === 'string') {
+				activities.push({ kind: 'tool_input', name: block.name, input: isRecord(block.input) ? block.input : {} });
+			}
+		}
+	} else if (o.type === 'user' && isRecord(o.message)) {
+		for (const block of Array.isArray(o.message.content) ? o.message.content : []) {
+			if (isRecord(block) && block.type === 'tool_result') {
+				activities.push({ kind: 'tool_result', isError: block.is_error === true });
+			}
+		}
+	} else if (o.type === 'result') {
+		const u = isRecord(o.usage) ? o.usage : null;
+		let model: string | null = null;
+		let contextWindow: number | null = null;
+		let maxOutputTokens: number | null = null;
+		if (isRecord(o.modelUsage)) {
+			const first = Object.entries(o.modelUsage)[0]?.[1];
+			const firstKey = Object.keys(o.modelUsage)[0];
+			if (firstKey) model = firstKey;
+			if (isRecord(first)) {
+				if (typeof first.contextWindow === 'number') contextWindow = first.contextWindow;
+				if (typeof first.maxOutputTokens === 'number') maxOutputTokens = first.maxOutputTokens;
+			}
+		}
+		const result: StreamedResult = {
+			result: typeof o.result === 'string' ? o.result : state.streamedText,
+			isError: o.is_error === true,
+			numTurns: typeof o.num_turns === 'number' ? o.num_turns : 0,
+			totalCostUsd: typeof o.total_cost_usd === 'number' ? o.total_cost_usd : 0,
+			sessionId: typeof o.session_id === 'string' ? o.session_id : null,
+			stopReason: typeof o.stop_reason === 'string' ? o.stop_reason : null,
+			permissionDenials: Array.isArray(o.permission_denials) ? o.permission_denials : [],
+			durationMs: typeof o.duration_ms === 'number' ? o.duration_ms : null,
+			durationApiMs: typeof o.duration_api_ms === 'number' ? o.duration_api_ms : null,
+			ttftMs: typeof o.ttft_ms === 'number' ? o.ttft_ms : null,
+			model,
+			contextWindow,
+			maxOutputTokens,
+			usage: u
+				? {
+						inputTokens: typeof u.input_tokens === 'number' ? u.input_tokens : 0,
+						outputTokens: typeof u.output_tokens === 'number' ? u.output_tokens : 0,
+						cacheCreationInputTokens: typeof u.cache_creation_input_tokens === 'number' ? u.cache_creation_input_tokens : 0,
+						cacheReadInputTokens: typeof u.cache_read_input_tokens === 'number' ? u.cache_read_input_tokens : 0,
+					}
+				: null,
+		};
+		return { activities, streamedText, result };
+	}
+
+	return { activities, streamedText };
+}
+
+export const claudeHarness: Harness = {
+	name: 'claude',
+	displayName: 'Claude Code',
+	binary: 'claude',
+	async detect() {
+		try {
+			const { stdout } = await execFileAsync('claude', ['--version'], { timeout: 5000 });
+			return { ok: true, version: stdout.trim() };
+		} catch {
+			return { ok: false, hint: 'Install Claude Code: https://docs.anthropic.com/en/docs/claude-code' };
+		}
+	},
+	buildArgs(opts: BuildArgsOpts): string[] {
+		const mode = opts.nativePermission ?? PERMISSION_MAP[opts.permission] ?? 'acceptEdits';
+		const args = ['-p', opts.prompt, '--output-format', 'stream-json', '--verbose', '--include-partial-messages', '--permission-mode', mode];
+		if (opts.resumeSessionId) args.push('--resume', opts.resumeSessionId);
+		else args.push('--no-session-persistence');
+		if (opts.model) args.push('--model', opts.model);
+		if (opts.maxBudgetUsd !== undefined) args.push('--max-budget-usd', String(opts.maxBudgetUsd));
+		for (const dir of opts.addDirs ?? []) args.push('--add-dir', dir);
+		return args;
+	},
+	parseLine(line: string, state: ParseState): ParseOutcome {
+		return parseClaudeLine(line, state);
+	},
+	extractResult(state: ParseState): StreamedResult | null {
+		return state.result;
+	},
+	permissionMap: {
+		readonly: ['plan'],
+		edit: ['acceptEdits'],
+		danger: ['bypassPermissions'],
+	},
+};

package/extensions/harnesses/codex.ts

@@ -0,0 +1,172 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import type { Harness, BuildArgsOpts, NormalizedPermission, ParseOutcome, ParseState, StreamedResult } from './types.ts';
+
+const execFileAsync = promisify(execFile);
+
+function isRecord(v: unknown): v is Record<string, unknown> {
+	return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+
+const SANDBOX_MAP: Record<NormalizedPermission, string> = {
+	readonly: 'read-only',
+	edit: 'workspace-write',
+	danger: 'danger-full-access',
+};
+
+function extractTextFromCodexEvent(o: Record<string, unknown>, state: ParseState): string | undefined {
+	// Codex JSON variants: try common shapes
+	// 1. {type:"item.completed", item:{type:"agent_message", text:"..."}}
+	// 2. {type:"thread.item.completed", item:{type:"agent_message", ...}}
+	// 3. {type:"event", event:{type:"response.output_text.delta", delta:"..."}}
+	// 4. Plain {"text":"..."} or {"output":"..."}
+	if (typeof o.text === 'string' && o.type !== 'tool_use') return o.text;
+	if (typeof o.output === 'string') return o.output;
+	if (typeof o.delta === 'string') return o.delta;
+	if (isRecord(o.event) && typeof o.event.text === 'string') return o.event.text;
+	if (isRecord(o.event) && typeof (o.event as Record<string, unknown>).delta === 'string') return (o.event as Record<string, unknown>).delta as string;
+	if (isRecord(o.item) && typeof o.item.text === 'string') return o.item.text;
+	if (isRecord(o.item) && typeof o.item.output === 'string') return o.item.output;
+	// agent_message
+	if (o.type === 'agent_message' && typeof o.text === 'string') return o.text;
+	return undefined;
+}
+
+export function parseCodexLine(line: string, state: ParseState): ParseOutcome {
+	let o: unknown;
+	try {
+		o = JSON.parse(line);
+	} catch {
+		// Non-JSON line: treat as streamed text (codex may emit plain text)
+		if (line.trim().length > 0) return { streamedText: line + '\n', activities: [] };
+		return { activities: [] };
+	}
+	if (!isRecord(o)) return { activities: [] };
+
+	const activities: ParseOutcome['activities'] = [];
+	let streamedText: string | undefined;
+
+	// Tool activity heuristics
+	// Codex may emit: {type:"item.started", item:{type:"tool_use", name:"...", input:{}}}
+	// or {type:"tool_use", name:"..."}
+	const item = isRecord(o.item) ? o.item : null;
+	const typeStr = typeof o.type === 'string' ? o.type : '';
+
+	if (typeStr.includes('tool') || typeStr.includes('item.started') || typeStr.includes('function_call')) {
+		const toolName = (item && typeof item.name === 'string' ? item.name : typeof o.name === 'string' ? o.name : null) as string | null;
+		if (toolName) {
+			if (typeStr.includes('started') || o.type === 'tool_use') {
+				activities.push({ kind: 'tool_start', name: toolName });
+				if (item && isRecord(item.input)) activities.push({ kind: 'tool_input', name: toolName, input: item.input as Record<string, unknown> });
+				else if (isRecord(o.input)) activities.push({ kind: 'tool_input', name: toolName, input: o.input as Record<string, unknown> });
+			} else if (typeStr.includes('completed') || typeStr.includes('result')) {
+				activities.push({ kind: 'tool_result', isError: o.is_error === true || o.error === true });
+			}
+		}
+	}
+	if (o.type === 'tool_result' || typeStr === 'item.completed' && item?.type === 'tool_result') {
+		activities.push({ kind: 'tool_result', isError: (o as Record<string, unknown>).is_error === true });
+	}
+	if (typeStr.includes('thinking') || o.type === 'reasoning' || item?.type === 'reasoning') {
+		const thinkingText = extractTextFromCodexEvent(o, state);
+		if (thinkingText) activities.push({ kind: 'thinking', chars: thinkingText.length });
+		else activities.push({ kind: 'thinking', chars: 10 });
+	}
+
+	// Text extraction
+	const text = extractTextFromCodexEvent(o, state);
+	if (text && !typeStr.includes('tool') && !typeStr.includes('thinking')) {
+		// Avoid double-counting tool inputs as text
+		streamedText = text;
+	}
+
+	// Result detection: final result often {type:"result", result:"...", total_cost_usd, usage, ...}
+	// or {type:"thread.completed", ...}
+	if (o.type === 'result' || o.type === 'thread.completed' || o.type === 'task.completed') {
+		const usage = isRecord(o.usage) ? o.usage : null;
+		const result: StreamedResult = {
+			result: typeof o.result === 'string' ? o.result : typeof o.output === 'string' ? o.output : state.streamedText + (streamedText ?? ''),
+			isError: o.is_error === true || o.error === true,
+			numTurns: typeof o.num_turns === 'number' ? o.num_turns : typeof o.turns === 'number' ? o.turns : 0,
+			totalCostUsd: typeof o.total_cost_usd === 'number' ? o.total_cost_usd : typeof o.cost === 'number' ? o.cost : 0,
+			sessionId: typeof o.session_id === 'string' ? o.session_id : typeof o.thread_id === 'string' ? o.thread_id : typeof o.id === 'string' ? o.id : null,
+			stopReason: typeof o.stop_reason === 'string' ? o.stop_reason : null,
+			permissionDenials: Array.isArray(o.permission_denials) ? o.permission_denials : [],
+			durationMs: typeof o.duration_ms === 'number' ? o.duration_ms : null,
+			durationApiMs: typeof o.duration_api_ms === 'number' ? o.duration_api_ms : null,
+			ttftMs: typeof o.ttft_ms === 'number' ? o.ttft_ms : null,
+			model: typeof o.model === 'string' ? o.model : null,
+			contextWindow: typeof o.context_window === 'number' ? o.context_window : null,
+			maxOutputTokens: null,
+			usage: usage
+				? {
+						inputTokens: typeof usage.input_tokens === 'number' ? usage.input_tokens : typeof (usage as Record<string, unknown>).inputTokens === 'number' ? (usage as Record<string, unknown>).inputTokens as number : 0,
+						outputTokens: typeof usage.output_tokens === 'number' ? usage.output_tokens : typeof (usage as Record<string, unknown>).outputTokens === 'number' ? (usage as Record<string, unknown>).outputTokens as number : 0,
+						cacheCreationInputTokens: typeof (usage as Record<string, unknown>).cache_creation_input_tokens === 'number' ? (usage as Record<string, unknown>).cache_creation_input_tokens as number : 0,
+						cacheReadInputTokens: typeof (usage as Record<string, unknown>).cache_read_input_tokens === 'number' ? (usage as Record<string, unknown>).cache_read_input_tokens as number : 0,
+					}
+				: null,
+		};
+		return { activities, streamedText, result };
+	}
+
+	return { activities, streamedText };
+}
+
+export const codexHarness: Harness = {
+	name: 'codex',
+	displayName: 'Muse',
+	binary: 'codex',
+	async detect() {
+		try {
+			const { stdout } = await execFileAsync('codex', ['--version'], { timeout: 5000 });
+			return { ok: true, version: stdout.trim() };
+		} catch {
+			return { ok: false, hint: 'Install Muse: https://github.com/openai/codex' };
+		}
+	},
+	buildArgs(opts: BuildArgsOpts): string[] {
+		// codex exec --json <prompt> --sandbox <level> --ask-for-approval <level>
+		const sandbox = opts.nativePermission ?? SANDBOX_MAP[opts.permission] ?? 'workspace-write';
+		const args = ['exec', '--json', opts.prompt, '--sandbox', sandbox];
+		if (opts.permission === 'danger' || sandbox === 'danger-full-access') args.push('--ask-for-approval', 'never');
+		else if (opts.permission === 'readonly') args.push('--ask-for-approval', 'never');
+		else args.push('--ask-for-approval', 'on-request');
+		if (opts.model) args.push('--model', opts.model);
+		if (opts.resumeSessionId) args.push('--thread-id', opts.resumeSessionId);
+		// maxBudgetUsd not natively supported; pass as env hint via --config if needed
+		for (const dir of opts.addDirs ?? []) args.push('--add-dir', dir);
+		return args;
+	},
+	parseLine(line: string, state: ParseState): ParseOutcome {
+		return parseCodexLine(line, state);
+	},
+	extractResult(state: ParseState): StreamedResult | null {
+		if (state.result) return state.result;
+		// Fallback: if no explicit result, synthesize from streamed text if any
+		if (state.streamedText.trim().length > 0) {
+			return {
+				result: state.streamedText,
+				isError: false,
+				numTurns: 1,
+				totalCostUsd: 0,
+				sessionId: null,
+				stopReason: null,
+				permissionDenials: [],
+				durationMs: null,
+				durationApiMs: null,
+				ttftMs: null,
+				model: null,
+				contextWindow: null,
+				maxOutputTokens: null,
+				usage: null,
+			};
+		}
+		return null;
+	},
+	permissionMap: {
+		readonly: ['read-only'],
+		edit: ['workspace-write'],
+		danger: ['danger-full-access'],
+	},
+};