pi-subagents 0.69.0 → 0.70.0

package/src/runs/shared/claude-code-adapter.ts

@@ -1,133 +0,0 @@
-import { parseExternalCliJsonlEvent, type ExternalCliParser, type ExternalCliParserProgress, type ExternalCliParserTerminal } from "./external-cli-runner.ts";
-import type { ExternalCliPreflightSpec } from "./external-cli-preflight.ts";
-
-const MAX_EVENT_TYPE_LENGTH = 128;
-const MAX_ERROR_LENGTH = 4_096;
-
-export const CLAUDE_CODE_ADAPTER_ID = "claude-code" as const;
-export const CLAUDE_CODE_WRITER_ADAPTER_ID = "claude-code-writer" as const;
-export const CLAUDE_CODE_WRITER_TOOLS = "Read,Write,Edit,Glob,Grep" as const;
-export const CLAUDE_CODE_ENV_ALLOWLIST = [
-	"PATH",
-	"HOME",
-	"USERPROFILE",
-	"USER",
-	"LOGNAME",
-	"TMPDIR",
-	"CLAUDE_CONFIG_DIR",
-	"ANTHROPIC_API_KEY",
-	"ANTHROPIC_AUTH_TOKEN",
-	"ANTHROPIC_BASE_URL",
-	"CLAUDE_CODE_OAUTH_TOKEN",
-	"CLAUDE_CODE_USE_BEDROCK",
-	"CLAUDE_CODE_USE_VERTEX",
-	"CLAUDE_CODE_USE_FOUNDRY",
-	"AWS_PROFILE",
-	"AWS_REGION",
-	"AWS_DEFAULT_REGION",
-	"AWS_ACCESS_KEY_ID",
-	"AWS_SECRET_ACCESS_KEY",
-	"AWS_SESSION_TOKEN",
-	"AWS_BEARER_TOKEN_BEDROCK",
-	"GOOGLE_APPLICATION_CREDENTIALS",
-	"CLOUD_ML_REGION",
-	"ANTHROPIC_VERTEX_PROJECT_ID",
-	"HTTP_PROXY",
-	"HTTPS_PROXY",
-	"NO_PROXY",
-	"http_proxy",
-	"https_proxy",
-	"no_proxy",
-	"SSL_CERT_FILE",
-	"SSL_CERT_DIR",
-] as const;
-
-function terminalError(event: Record<string, unknown>): string {
-	for (const value of [event.error, event.result]) {
-		if (typeof value === "string" && value.trim()) return value.trim().slice(0, MAX_ERROR_LENGTH);
-	}
-	if (Array.isArray(event.errors)) {
-		const messages = event.errors.filter((value): value is string => typeof value === "string" && Boolean(value.trim()));
-		if (messages.length > 0) return messages.join("; ").slice(0, MAX_ERROR_LENGTH);
-	}
-	const subtype = typeof event.subtype === "string" && event.subtype ? event.subtype : "unknown";
-	return `Claude Code reported terminal result ${subtype}.`;
-}
-
-export function createClaudeCodeJsonlParser(): ExternalCliParser {
-	let eventCount = 0;
-	let terminal: ExternalCliParserTerminal | undefined;
-	return {
-		parseLine(line): ExternalCliParserProgress {
-			const event = parseExternalCliJsonlEvent(line, "Claude Code", MAX_EVENT_TYPE_LENGTH);
-			if (terminal && event.type === "result") throw new Error("Claude Code emitted a duplicate terminal result.");
-			eventCount += 1;
-			if (!terminal && event.type === "result") {
-				if (event.subtype === "success" && event.is_error === false && typeof event.result === "string" && event.result.trim()) {
-					terminal = { state: "completed", output: event.result.trim() };
-				} else {
-					terminal = { state: "failed", error: terminalError(event) };
-				}
-			}
-			return { phase: terminal ? terminal.state : "streaming", eventCount };
-		},
-		finish(): ExternalCliParserTerminal | undefined {
-			return terminal;
-		},
-	};
-}
-
-export function resolveClaudeCodeLaunch(input: {
-	adapter: typeof CLAUDE_CODE_ADAPTER_ID | typeof CLAUDE_CODE_WRITER_ADAPTER_ID;
-	command: string;
-	/** Test-only executable prefix for a fake Claude Code process. */
-	commandPrefixArgs?: readonly string[];
-}): {
-	command: string;
-	args: string[];
-	finalOutputPath?: undefined;
-	promptFilePath?: undefined;
-	temporaryDirectories?: undefined;
-	environment: { allowlist: readonly string[] };
-	preflight: ExternalCliPreflightSpec;
-	parser: ExternalCliParser;
-} {
-	const writer = input.adapter === CLAUDE_CODE_WRITER_ADAPTER_ID;
-	const prefix = [...(input.commandPrefixArgs ?? [])];
-	const args = [
-		...prefix,
-		"-p",
-		"--input-format", "text",
-		"--output-format", "stream-json",
-		"--verbose",
-		"--permission-mode", writer ? "acceptEdits" : "plan",
-		"--tools", writer ? CLAUDE_CODE_WRITER_TOOLS : "",
-		"--strict-mcp-config",
-		"--mcp-config", '{"mcpServers":{}}',
-		"--setting-sources", "user",
-		"--no-session-persistence",
-		"--disable-slash-commands",
-		"--no-chrome",
-	];
-	return {
-		command: input.command,
-		args,
-		environment: { allowlist: CLAUDE_CODE_ENV_ALLOWLIST },
-		preflight: {
-			id: input.adapter,
-			versionArgs: [...prefix, "--version"],
-			helpArgs: [...prefix, "--help"],
-			validate(result) {
-				// Claude Code now publishes both semver (`2.1.259 (Claude Code)`) and
-				// calendar/platform (`2026.4.24 macos-arm64 (2026-04-27)`) versions.
-				// The launch flags are validated from --help below, so only require a
-				// recognizable release identifier here rather than one display format.
-				if (!/^(?:\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)? \(Claude Code\)|\d{4}\.\d{1,2}\.\d{1,2} [A-Za-z0-9._-]+ \(\d{4}-\d{2}-\d{2}\))$/.test(result.version)) throw new Error(`Unsupported Claude Code version response: ${JSON.stringify(result.version)}.`);
-				for (const required of ["Claude Code - starts an interactive session", "--print", "--input-format", "stream-json", "--verbose", "--permission-mode", writer ? "acceptEdits" : "plan", "--tools", "--strict-mcp-config", "--mcp-config", "--setting-sources", "--no-session-persistence", "--disable-slash-commands", "--no-chrome"]) {
-					if (!result.help.includes(required)) throw new Error(`Claude Code help does not document required option ${JSON.stringify(required)}.`);
-				}
-			},
-		},
-		parser: createClaudeCodeJsonlParser(),
-	};
-}

package/src/runs/shared/codex-exec-adapter.ts

@@ -1,129 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { parseExternalCliJsonlEvent, type ExternalCliParser, type ExternalCliParserProgress, type ExternalCliParserTerminal } from "./external-cli-runner.ts";
-import type { ExternalCliPreflightSpec } from "./external-cli-preflight.ts";
-
-const MAX_FINAL_MESSAGE_BYTES = 1024 * 1024;
-const MAX_EVENT_TYPE_LENGTH = 128;
-
-export const CODEX_EXEC_ADAPTER_ID = "codex-exec" as const;
-export const CODEX_EXEC_WRITER_ADAPTER_ID = "codex-exec-writer" as const;
-export const CODEX_EXEC_ENV_ALLOWLIST = [
-	"PATH",
-	"HOME",
-	"USERPROFILE",
-	"CODEX_HOME",
-	"CODEX_API_KEY",
-	"OPENAI_API_KEY",
-	"HTTP_PROXY",
-	"HTTPS_PROXY",
-	"NO_PROXY",
-	"http_proxy",
-	"https_proxy",
-	"no_proxy",
-	"SSL_CERT_FILE",
-	"SSL_CERT_DIR",
-] as const;
-
-function eventError(event: Record<string, unknown>, fallback: string): string {
-	const error = event.error;
-	if (typeof error === "string" && error.trim()) return error.trim().slice(0, 4_096);
-	if (error && typeof error === "object" && !Array.isArray(error)) {
-		const message = (error as Record<string, unknown>).message;
-		if (typeof message === "string" && message.trim()) return message.trim().slice(0, 4_096);
-	}
-	const message = event.message;
-	return typeof message === "string" && message.trim() ? message.trim().slice(0, 4_096) : fallback;
-}
-
-export function createCodexExecJsonlParser(finalMessagePath: string): ExternalCliParser {
-	let eventCount = 0;
-	let terminal: ExternalCliParserTerminal | undefined;
-	return {
-		parseLine(line): ExternalCliParserProgress {
-			const event = parseExternalCliJsonlEvent(line, "Codex exec", MAX_EVENT_TYPE_LENGTH);
-			if (terminal) throw new Error("Codex exec emitted an event after its terminal state.");
-			eventCount += 1;
-			if (event.type === "turn.completed") terminal = { state: "completed" };
-			else if (event.type === "turn.failed") terminal = { state: "failed", error: eventError(event, "Codex exec reported turn.failed.") };
-			else if (event.type === "error") terminal = { state: "failed", error: eventError(event, "Codex exec reported an error event.") };
-			return { phase: terminal ? terminal.state : "streaming", eventCount };
-		},
-		finish(): ExternalCliParserTerminal | undefined {
-			if (!terminal || terminal.state === "failed") return terminal;
-			let descriptor: number;
-			try { descriptor = fs.openSync(finalMessagePath, "r"); }
-			catch (error) { throw new Error(`Codex exec did not write its final-message artifact: ${error instanceof Error ? error.message : String(error)}`); }
-			try {
-				const stat = fs.fstatSync(descriptor);
-				if (!stat.isFile()) throw new Error("Codex exec final-message artifact is not a file.");
-				if (stat.size > MAX_FINAL_MESSAGE_BYTES) throw new Error("Codex exec final-message artifact exceeded its byte limit.");
-				const content = Buffer.alloc(stat.size);
-				let bytesRead = 0;
-				while (bytesRead < content.length) {
-					const count = fs.readSync(descriptor, content, bytesRead, content.length - bytesRead, bytesRead);
-					if (count === 0) break;
-					bytesRead += count;
-				}
-				const output = content.subarray(0, bytesRead).toString("utf-8").trim();
-				if (!output) throw new Error("Codex exec final-message artifact is empty.");
-				return { state: "completed", output };
-			} finally { fs.closeSync(descriptor); }
-		},
-	};
-}
-
-export function resolveCodexExecLaunch(input: {
-	adapter: typeof CODEX_EXEC_ADAPTER_ID | typeof CODEX_EXEC_WRITER_ADAPTER_ID;
-	command: string;
-	asyncDir: string;
-	stepIndex: number;
-	/** Test-only executable prefix for a fake Codex process. */
-	commandPrefixArgs?: readonly string[];
-}): {
-	command: string;
-	args: string[];
-	finalOutputPath: string;
-	promptFilePath?: undefined;
-	temporaryDirectories?: undefined;
-	environment: { allowlist: readonly string[] };
-	preflight: ExternalCliPreflightSpec;
-	parser: ExternalCliParser;
-} {
-	const writer = input.adapter === CODEX_EXEC_WRITER_ADAPTER_ID;
-	const finalMessagePath = path.join(input.asyncDir, `external-${input.stepIndex}.final-message.txt`);
-	fs.rmSync(finalMessagePath, { force: true });
-	const prefix = [...(input.commandPrefixArgs ?? [])];
-	const args = [
-		...prefix,
-		"exec",
-		"--json",
-		"--color", "never",
-		"--ephemeral",
-		"--ignore-user-config",
-		"--ignore-rules",
-		"--skip-git-repo-check",
-		"-s", writer ? "workspace-write" : "read-only",
-		"-c", 'approval_policy="never"',
-		"--output-last-message", finalMessagePath,
-		"-",
-	];
-	return {
-		command: input.command,
-		args,
-		finalOutputPath: finalMessagePath,
-		environment: { allowlist: CODEX_EXEC_ENV_ALLOWLIST },
-		preflight: {
-			id: input.adapter,
-			versionArgs: [...prefix, "--version"],
-			helpArgs: [...prefix, "exec", "--help"],
-			validate(result) {
-				if (!/^codex-cli \d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/.test(result.version)) throw new Error(`Unsupported Codex version response: ${JSON.stringify(result.version)}.`);
-				for (const required of ["Run Codex non-interactively", "--json", "--output-last-message", "--ephemeral", "--ignore-user-config", "--ignore-rules", "--skip-git-repo-check", "--sandbox", writer ? "workspace-write" : "read-only", "--config"]) {
-					if (!result.help.includes(required)) throw new Error(`Codex exec help does not document required option ${JSON.stringify(required)}.`);
-				}
-			},
-		},
-		parser: createCodexExecJsonlParser(finalMessagePath),
-	};
-}

package/src/runs/shared/completion-evidence.ts

@@ -1,89 +0,0 @@
-import type {
-	FileMutationEffect,
-	SettlementDiagnostic,
-	TrackedMutationEvidence,
-} from "../../shared/types.ts";
-import type { CompletionMutationGuardResult } from "./completion-guard.ts";
-
-export const MISSING_IMPLEMENTATION_MUTATION_MESSAGE = "Subagent completed without making edits for an implementation task.";
-export const MISSING_IMPLEMENTATION_MUTATION_ERROR = `${MISSING_IMPLEMENTATION_MUTATION_MESSAGE}\nIt appears to have returned planning or scratchpad output instead of applying changes.`;
-
-export interface CompletionEvidencePlan {
-	guardTriggered: boolean;
-	guardBlocked: boolean;
-	mutationExpected: boolean;
-	mutationAttempted: boolean;
-	fileMutation?: FileMutationEffect;
-	legacyFailureError?: string;
-}
-
-export function planCompletionEvidence(input: {
-	guard?: CompletionMutationGuardResult;
-	guardTriggered?: boolean;
-	completionGuardEnabled: boolean;
-	mutationCapable: boolean;
-	implementationMutationExpected: boolean;
-	mutationAttemptObserved: boolean;
-	mutationEvidence?: TrackedMutationEvidence;
-	arbiterRescued?: boolean;
-	agentContractEnabled: boolean;
-}): CompletionEvidencePlan {
-	const guardBlocked = input.guard?.blocked === true;
-	const guardTriggered = input.guardTriggered
-		?? (input.guard?.triggered === true && !input.mutationAttemptObserved);
-	const mutationExpected = input.guard?.expectedMutation
-		?? (input.completionGuardEnabled && input.mutationCapable && input.implementationMutationExpected);
-	const mutationAttempted = input.guard?.attemptedMutation === true || input.mutationAttemptObserved;
-	const fileMutation = input.guard
-		? {
-			status: guardBlocked
-				? "blocked" as const
-				: input.guard.expectedMutation
-					? guardTriggered
-						? "missing" as const
-						: input.arbiterRescued
-							? "not-applicable" as const
-							: "observed" as const
-					: "not-applicable" as const,
-			expected: input.guard.expectedMutation,
-			attempted: guardBlocked ? false : mutationAttempted,
-			...(input.mutationEvidence ? { evidence: input.mutationEvidence } : {}),
-			...(guardBlocked && input.guard.message ? { message: input.guard.message } : {}),
-			...(guardTriggered ? { message: MISSING_IMPLEMENTATION_MUTATION_MESSAGE } : {}),
-			...(input.arbiterRescued ? { resolvedBy: "llm-intent-arbiter" as const } : {}),
-		}
-		: undefined;
-	return {
-		guardTriggered,
-		guardBlocked,
-		mutationExpected,
-		mutationAttempted,
-		fileMutation,
-		legacyFailureError: guardTriggered && !input.agentContractEnabled
-			? MISSING_IMPLEMENTATION_MUTATION_ERROR
-			: undefined,
-	};
-}
-
-export function projectSettlementDiagnostic(
-	plan: Pick<CompletionEvidencePlan, "guardTriggered" | "guardBlocked" | "mutationExpected" | "mutationAttempted">,
-	input: {
-		terminalFailed: boolean;
-		finalTextPresent: boolean;
-		mutationObserved: boolean;
-		requiredOutput?: SettlementDiagnostic["requiredOutput"];
-		afterCompactionSettlement?: boolean;
-	},
-): SettlementDiagnostic | undefined {
-	if (!input.terminalFailed && !plan.guardTriggered && !plan.guardBlocked) return undefined;
-	return {
-		finalTextPresent: input.finalTextPresent,
-		mutation: {
-			expected: plan.mutationExpected,
-			attempted: plan.mutationAttempted,
-			observed: input.mutationObserved,
-		},
-		...(input.requiredOutput ? { requiredOutput: input.requiredOutput } : {}),
-		afterCompactionSettlement: input.afterCompactionSettlement === true,
-	};
-}

package/src/runs/shared/completion-guard.ts

@@ -1,255 +0,0 @@
-import type { Message } from "@earendil-works/pi-ai";
-import type { AcceptanceRole, TrackedMutationEvidence } from "../../shared/types.ts";
-import { isMutatingTool } from "./long-running-guard.ts";
-import { classifyTaskMutationIntent, expectsImplementationMutation, taskMayMutate } from "./task-intent.ts";
-
-export { expectsImplementationMutation };
-
-const READ_ONLY_BUILTIN_TOOLS = new Set([
-	"read",
-	"grep",
-	"find",
-	"ls",
-	"web_search",
-	"fetch_content",
-	"get_search_content",
-	"source_check",
-	"intercom",
-	"contact_supervisor",
-	"structured_output",
-]);
-
-// Cursor native edit/write often land as thinking traces (inactive_trace /
-// transcript_trace) rather than toolCall parts when native tool replay is off
-// or the tool is inactive in context. Match pi-cursor-sdk display labels.
-const CURSOR_FILE_MUTATION_THINKING =
-	/(?:^|\n)\s*Cursor (?:edit|write)\s*:/i;
-
-const REVIVED_TASK_PREFIX = /^You are reviving a previous subagent conversation\.\n\nOriginal run: .+\nOriginal agent: .+(?:\nOriginal session file: .+)?\n\nUse the stored session context as background\. Answer the orchestrator's follow-up below\. Do not assume the original child session is still running\.\n\nFollow-up:\n/;
-const IMPLEMENTATION_CHALLENGE_FOLLOW_UP_PATTERN = /^(?:Run )?implementation challenge pass (?:one|two|\d+)(?:\s+and implement any better current[- ]scope change\.?|\s+for the accepted candidate\.\s+Reconsider it and implement any better current[- ]scope change\.?)?$/i;
-const NO_BETTER_CHANGE_NEEDED_PATTERN = /^\s*no (?:better|further|additional) (?:current[- ]scope )?(?:code |source |file )?(?:change|changes|edit|edits|patch|patches) (?:is|are) needed\b/i;
-const KEPT_CURRENT_IMPLEMENTATION_PATTERN = /\b(?:kept (?:the )?current (?:implementation|candidate|shape)|(?:the )?current (?:implementation|candidate|shape) was kept)\b/i;
-const NO_CHANGE_MADE_PATTERN = /\bno (?:new )?(?:(?:code|source|file|test)(?:\s*(?:,\s*or|,|\/|or)\s*(?:code|source|file|test))* changes?|changes?) (?:were|was) made\b/i;
-const NO_BETTER_CHANGE_QUALIFIER_PATTERN = /\b(?:do\s+not|don't|dont|not|never|cannot|can't|cant|unable|uncertain|unsure|unclear|disagree|wrong|false|reject|rejected|rejecting|maybe|might|may|\w+n['’]t)\b/i;
-const REPORT_SENTENCE_PATTERN = /[^.!?]+(?:[.!?]+(?=(?:["”'’]?\s)|["”'’]?$)|$)/g;
-const QUOTED_CLAIM_PATTERN = /["“]([^"”]+)["”]([.!?]?\s*[^.!?]*)/g;
-const QUOTED_CLAIM_REFERENCE_PATTERN = /\b(?:that|this|it|claim|report|message|disagree)\b/i;
-const CLAIM_CONTRADICTION_PATTERN = /\bbut\b[^.!?]*\b(?:uncertain|unsure|unclear|disagree|wrong|false|reject|rejected|rejecting)\b/i;
-const IMPLEMENTATION_RETRACTION_PATTERN = /\b(?:found|identified)\s+(?:(?:a|an|the)\s+)?(?:required|necessary|additional|better)?\s*(?:(?:code|source|file|test)\s+)?(?:changes?|edits?|patches?)\b|\b(?:(?:implementation|code|source|file|test)\s+)?work\s+(?:remains?|is\s+(?:needed|required))\b|\b(?:(?:a|an|the)\s+)?(?:(?:code|source|file|test)\s+)?(?:changes?|edits?|patches?)\s+(?:are|is)\s+(?:needed|required)\b|\b(?:required|necessary|additional|better)\s+(?:(?:code|source|file|test)\s+)?(?:changes?|edits?|patches?)\b|\b(?:I|we)?\s*need\s+(?:(?:code|source|file|test)\s+)?(?:changes?|edits?|patches?)\b|\b(?:need|needs|require|requires)\s+(?:to\s+)?(?:implement|make|apply)\b/i;
-const IMPLEMENTATION_RETRACTION_GLOBAL_PATTERN = new RegExp(IMPLEMENTATION_RETRACTION_PATTERN.source, "gi");
-const DIRECT_CLAIM_RETRACTION_PATTERN = /^\s*(?:I\s+)?(?:disagree|reject|retract)\b|\b(?:disagree|retract|retracted|retracting|reject|rejected|rejecting)\b[^.!?]*\b(?:that|this|it|claim|report|message)\b|\b(?:that|this|it|claim|report|message)\b[^.!?]*\b(?:is|was)\s+(?:rejected|retracted)\b/i;
-const NEGATED_RETRACTION_PREFIX_PATTERN = /\b(?:no|not|\w+n['’]t)\b(?:\s+\w+){0,2}\s*$/i;
-const REPORTED_CLAIM_PREFIX_PATTERN = /["“]|\b(?:prior|previous)\s+(?:message|report)\b|\b(?:said|stated|reported)\b/i;
-const POST_CLAIM_SEPARATOR_PATTERN = /^[\s,;:.—–'"“‘’-]+/;
-
-interface CompletionMutationGuardInput {
-	agent: string;
-	task: string;
-	messages: Message[];
-	tools?: string[];
-	mcpDirectTools?: string[];
-	mutationTools?: string[];
-	toolAvailabilityError?: string;
-	mutationEvidence?: TrackedMutationEvidence;
-}
-
-export interface CompletionMutationGuardResult {
-	expectedMutation: boolean;
-	attemptedMutation: boolean;
-	triggered: boolean;
-	blocked: boolean;
-	message?: string;
-}
-
-interface ReportSentence {
-	text: string;
-	offset: number;
-}
-
-export function hasMutationToolCapability(tools: string[] | undefined, mcpDirectTools: string[] | undefined): boolean {
-	if ((mcpDirectTools?.length ?? 0) > 0) return true;
-	if (tools === undefined) return true;
-	return !tools.every((tool) => READ_ONLY_BUILTIN_TOOLS.has(tool));
-}
-
-function hasBuiltinMutationTool(tools: string[] | undefined): boolean {
-	return tools === undefined || tools.some((tool) => !READ_ONLY_BUILTIN_TOOLS.has(tool));
-}
-
-function isWriterRole(agent: string, acceptanceRole: AcceptanceRole | undefined): boolean {
-	return acceptanceRole === "writer"
-		|| (acceptanceRole === undefined && /\bworker\b/i.test(agent));
-}
-
-const WRITER_DELIVERY_PATTERN = /\b(?:address|resolve|work)\s+(?:backlog\s+)?(?:item|issue)\b|\b(?:land|ship)\s+(?:the\s+)?(?:change|changes|fix|feature|implementation)\b/i;
-
-export function validateImplementationToolContract(input: {
-	agent: string;
-	task: string;
-	tools?: string[];
-	mcpDirectTools?: string[];
-	configuredExtensions?: string[];
-	requestedTools?: string[];
-	acceptanceRole?: AcceptanceRole;
-	completionGuard?: boolean;
-}): string | undefined {
-	if (input.completionGuard === false) return undefined;
-	const requestedMutationTools = input.requestedTools?.filter((tool) => !READ_ONLY_BUILTIN_TOOLS.has(tool)) ?? [];
-	const declaredMutationToolsWereRemoved = requestedMutationTools.length > 0 && !hasBuiltinMutationTool(input.tools);
-	const configuredExtensionCapability = (input.configuredExtensions?.length ?? 0) > 0 && !declaredMutationToolsWereRemoved;
-	if (hasMutationToolCapability(input.tools, input.mcpDirectTools) || configuredExtensionCapability) return undefined;
-	const intent = classifyTaskMutationIntent(input.acceptanceRole === "writer" ? "worker" : input.agent, input.task);
-	if (intent.kind === "read-only") return undefined;
-	const writerTaskMayMutate = input.acceptanceRole === "writer"
-		? true
-		: isWriterRole(input.agent, input.acceptanceRole)
-			&& (taskMayMutate(input.task) || WRITER_DELIVERY_PATTERN.test(input.task));
-	if (intent.kind !== "implementation" && !writerTaskMayMutate && !declaredMutationToolsWereRemoved) return undefined;
-	return `Agent '${input.agent}' was given an implementation task, but its tool allowlist has no mutation-capable tools. Add bash, edit, write, or another mutation-capable tool to the agent, or use a read-only task/agent.`;
-}
-
-function hasCheckpointMutationEvidence(message: Message): boolean {
-	const record = message as unknown as {
-		role?: string;
-		type?: string;
-		customType?: unknown;
-		data?: unknown;
-		details?: unknown;
-	};
-	if ((record.role !== "custom" && record.type !== "custom") || record.customType !== "pi-checkpoint") return false;
-	const details = typeof record.details === "object" && record.details !== null && !Array.isArray(record.details)
-		? record.details as Record<string, unknown>
-		: undefined;
-	const data = typeof record.data === "object" && record.data !== null && !Array.isArray(record.data)
-		? record.data as Record<string, unknown>
-		: typeof details?.beforeCommit === "string" || typeof details?.afterCommit === "string"
-			? details
-			: details?.data && typeof details.data === "object" && !Array.isArray(details.data)
-				? details.data as Record<string, unknown>
-				: undefined;
-	return typeof data?.beforeCommit === "string"
-		&& typeof data.afterCommit === "string"
-		&& data.beforeCommit !== data.afterCommit;
-}
-
-export function hasMutationToolCall(messages: Message[], mutationTools?: readonly string[]): boolean {
-	for (const message of messages) {
-		if (hasCheckpointMutationEvidence(message)) return true;
-		if (message.role !== "assistant") continue;
-		for (const part of message.content) {
-			if (part.type === "thinking" && CURSOR_FILE_MUTATION_THINKING.test(part.thinking)) return true;
-			if (part.type !== "toolCall") continue;
-			const args = typeof part.arguments === "object" && part.arguments !== null && !Array.isArray(part.arguments)
-				? part.arguments as Record<string, unknown>
-				: {};
-			if (isMutatingTool(part.name, args, mutationTools)) return true;
-		}
-	}
-	return false;
-}
-
-function hasImplementationRetraction(text: string): boolean {
-	return Array.from(text.matchAll(IMPLEMENTATION_RETRACTION_GLOBAL_PATTERN)).some((retraction) =>
-		!NEGATED_RETRACTION_PREFIX_PATTERN.test(text.slice(0, retraction.index!)));
-}
-
-function hasDirectClaimRetraction(text: string): boolean {
-	return DIRECT_CLAIM_RETRACTION_PATTERN.test(text.replace(POST_CLAIM_SEPARATOR_PATTERN, ""));
-}
-
-function isInsideQuotedText(report: string, index: number): boolean {
-	let quote: "double" | "single" | undefined;
-	for (const char of report.slice(0, index)) {
-		if (quote === "double") {
-			if (char === "\"" || char === "”") quote = undefined;
-		} else if (quote === "single") {
-			if (char === "’") quote = undefined;
-		} else if (char === "\"" || char === "“") {
-			quote = "double";
-		} else if (char === "‘") {
-			quote = "single";
-		}
-	}
-	return quote !== undefined;
-}
-
-function unqualifiedClaimIndex(report: string, sentences: ReportSentence[], pattern: RegExp): number {
-	return sentences.findIndex((sentence) => {
-		const claim = sentence.text.match(pattern);
-		if (claim === null) return false;
-		const before = sentence.text.slice(0, claim.index!);
-		const after = sentence.text.slice(claim.index! + claim[0].length);
-		const previous = before.trimEnd().at(-1);
-		return previous !== "'"
-			&& previous !== "‘"
-			&& !isInsideQuotedText(report, sentence.offset + claim.index!)
-			&& !REPORTED_CLAIM_PREFIX_PATTERN.test(before)
-			&& !NO_BETTER_CHANGE_QUALIFIER_PATTERN.test(before)
-			&& !CLAIM_CONTRADICTION_PATTERN.test(after)
-			&& !hasImplementationRetraction(after)
-			&& !hasDirectClaimRetraction(after);
-	});
-}
-
-function hasLaterClaimRetraction(sentences: ReportSentence[], claimIndex: number): boolean {
-	return sentences.slice(claimIndex + 1).some((sentence) => hasImplementationRetraction(sentence.text)
-		|| hasDirectClaimRetraction(sentence.text));
-}
-
-function explicitlyRejectsQuotedClaim(report: string): boolean {
-	for (const [, claim, response] of report.matchAll(QUOTED_CLAIM_PATTERN)) {
-		if ((KEPT_CURRENT_IMPLEMENTATION_PATTERN.test(claim!) || NO_CHANGE_MADE_PATTERN.test(claim!))
-			&& NO_BETTER_CHANGE_QUALIFIER_PATTERN.test(response!)
-			&& QUOTED_CLAIM_REFERENCE_PATTERN.test(response!)) return true;
-	}
-	return false;
-}
-
-function isImplementationChallengeTask(task: string): boolean {
-	const followUp = task.replace(REVIVED_TASK_PREFIX, "");
-	return followUp !== task && IMPLEMENTATION_CHALLENGE_FOLLOW_UP_PATTERN.test(followUp.trim());
-}
-
-function reportsNoBetterChallengeChange(messages: Message[]): boolean {
-	const report = messages
-		.filter((message) => message.role === "assistant")
-		.flatMap((message) => message.content)
-		.flatMap((part) => part.type === "text" ? [part.text] : [])
-		.join("\n");
-	if (explicitlyRejectsQuotedClaim(report)) return false;
-	const sentences = Array.from(report.matchAll(REPORT_SENTENCE_PATTERN), (match) => ({
-		text: match[0],
-		offset: match.index!,
-	}));
-	const noBetterIndex = unqualifiedClaimIndex(report, sentences, NO_BETTER_CHANGE_NEEDED_PATTERN);
-	if (noBetterIndex >= 0) return !hasLaterClaimRetraction(sentences, noBetterIndex);
-	const keptIndex = unqualifiedClaimIndex(report, sentences, KEPT_CURRENT_IMPLEMENTATION_PATTERN);
-	const noChangeIndex = unqualifiedClaimIndex(report, sentences, NO_CHANGE_MADE_PATTERN);
-	return keptIndex >= 0
-		&& noChangeIndex >= 0
-		&& !hasLaterClaimRetraction(sentences, Math.min(keptIndex, noChangeIndex));
-}
-
-export function evaluateCompletionMutationGuard(input: CompletionMutationGuardInput): CompletionMutationGuardResult {
-	if (input.toolAvailabilityError && expectsImplementationMutation(input.agent, input.task)) {
-		return {
-			expectedMutation: true,
-			attemptedMutation: false,
-			triggered: false,
-			blocked: true,
-			message: input.toolAvailabilityError,
-		};
-	}
-	const expectedMutation = hasMutationToolCapability(input.tools, input.mcpDirectTools)
-		? expectsImplementationMutation(input.agent, input.task)
-		: false;
-	const attemptedMutation = hasMutationToolCall(input.messages, input.mutationTools) || input.mutationEvidence?.attemptedMutation === true;
-	const noEditChallengeComplete = isImplementationChallengeTask(input.task)
-		&& reportsNoBetterChallengeChange(input.messages);
-	return {
-		expectedMutation,
-		attemptedMutation,
-		triggered: expectedMutation && !attemptedMutation && !noEditChallengeComplete,
-		blocked: false,
-	};
-}

package/src/runs/shared/context-mode.ts

@@ -1,44 +0,0 @@
-export type ContextMode = "fresh" | "fork";
-export type ContextSummary = ContextMode | "mixed";
-
-export function isContextMode(value: unknown): value is ContextMode {
-	return value === "fresh" || value === "fork";
-}
-
-export function isContextSummary(value: unknown): value is ContextSummary {
-	return isContextMode(value) || value === "mixed";
-}
-
-export function summarizeContextModes(modes: Array<ContextMode | undefined>): ContextSummary | undefined {
-	const resolved = modes.filter(isContextMode);
-	if (resolved.length === 0) return undefined;
-	const first = resolved[0]!;
-	return resolved.every((mode) => mode === first) ? first : "mixed";
-}
-
-export function contextModeLabel(mode: ContextMode | ContextSummary | undefined): string {
-	if (mode === "fork") return "[fork]";
-	if (mode === "fresh") return "[fresh]";
-	if (mode === "mixed") return "[mixed]";
-	return "";
-}
-
-export function contextModeBadge(
-	theme: { fg(name: string, text: string): string },
-	mode: ContextMode | ContextSummary | undefined,
-): string {
-	const label = contextModeLabel(mode);
-	if (!label) return "";
-	if (mode === "fork") return theme.fg("warning", ` ${label}`);
-	return theme.fg("dim", ` ${label}`);
-}
-
-export function contextModePrefix(
-	theme: { fg(name: string, text: string): string },
-	mode: ContextMode | ContextSummary | undefined,
-): string {
-	const label = contextModeLabel(mode);
-	if (!label) return "";
-	if (mode === "fork") return `${theme.fg("warning", label)} `;
-	return `${theme.fg("dim", label)} `;
-}