Skip to content

The one and only agent harness for complex codebases. Project memory, planning, execution, and verified completion inside Codex.

8.5 KB
Raw Blame
import { readFileSync, realpathSync } from "node:fs";
import { homedir } from "node:os";
import { join, resolve } from "node:path";

import { callDiagnosticsViaDaemon } from "@code-yeongyu/lsp-daemon/client";
import { collectPostEditDiagnostics, type PostEditDiagnosticsOutcome } from "@oh-my-opencode/lsp-core/post-edit";
import { type LspRequestContext, parseLspRequestContext } from "@oh-my-opencode/lsp-core/request-context";

import { ensureLspDaemonCliEnv } from "./daemon-cli-path.js";
import {
	isLspDaemonUnreachableDiagnostics,
	markLspSessionCompacted,
	readLspPostEditCache,
	sessionIdFrom,
	writeLspPostEditCache,
} from "./lsp-session-state.js";
import { extractMutatedFilePaths } from "./mutated-file-paths.js";

export { extractMutatedFilePaths } from "./mutated-file-paths.js";

export type DiagnosticsRunner = (filePath: string) => Promise<PostEditDiagnosticsOutcome>;

export interface CodexPostToolUseInput {
	session_id?: unknown;
	tool_name?: unknown;
	tool_input?: unknown;
	tool_response?: unknown;
	transcript_path?: unknown;
}

export interface CodexPostCompactInput {
	session_id?: unknown;
}

interface DiagnosticBlock {
	filePath: string;
	diagnostics: string;
	blocking: boolean;
}

interface PostToolUseHookContext {
	hookSpecificOutput: {
		hookEventName: "PostToolUse";
		additionalContext: string;
	};
}

interface PostToolUseHookOutput extends PostToolUseHookContext {
	decision: "block";
	reason: string;
}

const DIAGNOSTIC_START_PATTERN = /(?:error|warning|information|hint)\[[^\]\r\n]+\] \(\d+\) at \d+:\d+:/g;
const DIAGNOSTIC_CHUNK_PATTERN = /^(?:error|warning|information|hint)\[[^\]\r\n]+\] \(\d+\) at \d+:\d+:/;
const DEFAULT_MAX_HOOK_FEEDBACK_CHARS = 8000;
const CONTEXT_PRESSURE_MAX_HOOK_FEEDBACK_CHARS = 1200;
const CONTEXT_PRESSURE_MARKERS = [
	"context compacted",
	"context_length_exceeded",
	"skill descriptions were shortened",
	"context_too_large",
	"codex ran out of room in the model's context window",
	"your input exceeds the context window",
	"long threads and multiple compactions",
] as const;

export async function runLspDiagnosticsText(filePath: string): Promise<PostEditDiagnosticsOutcome> {
	ensureLspDaemonCliEnv();
	const result = await callDiagnosticsViaDaemon(filePath, { context: codexLspRequestContext() });
	return postEditOutcomeFromDaemonResult(result);
}

function postEditOutcomeFromDaemonResult(result: {
	readonly content: readonly { readonly type: string; readonly text?: string }[];
	readonly details?: unknown;
}): PostEditDiagnosticsOutcome {
	const text = result.content.map((block) => block.text).join("\n");
	const availability = availabilityDetails(result.details);
	if (availability === undefined) return text;
	if (availability["kind"] === "not_configured") {
		const extension = availability["extension"];
		return typeof extension === "string" && extension.length > 0 ? { kind: "not_configured", extension } : text;
	}
	if (availability["kind"] === "not_installed") return notInstalledOutcome(availability, text) ?? text;
	return text;
}

function availabilityDetails(details: unknown): Record<string, unknown> | undefined {
	if (!isRecord(details)) return undefined;
	const availability = details["availability"];
	return isRecord(availability) ? availability : undefined;
}

function notInstalledOutcome(
	availability: Record<string, unknown>,
	text: string,
): PostEditDiagnosticsOutcome | undefined {
	const serverId = availability["serverId"];
	const installDecisionTool = availability["installDecisionTool"];
	if (typeof serverId !== "string" || serverId.length === 0 || typeof installDecisionTool !== "boolean")
		return undefined;
	const decision = availability["decision"];
	const base = { kind: "not_installed", serverId, installDecisionTool, text } as const;
	return decision === "declined" || decision === "allowed" ? { ...base, decision } : base;
}

export function codexLspRequestContext(
	env: Record<string, string | undefined> = process.env,
	cwd: string = process.cwd(),
): LspRequestContext {
	const canonicalCwd = realpathSync(resolve(cwd));
	const codexHome = resolve(env["CODEX_HOME"]?.trim() || join(homedir(), ".codex"));
	return parseLspRequestContext({
		cwd: canonicalCwd,
		projectConfigPaths: [join(canonicalCwd, ".codex", "lsp-client.json")],
		userConfigPath: join(codexHome, "lsp-client.json"),
		installDecisionsPath: join(codexHome, "lsp-install-decisions.json"),
		capabilities: { installDecisionTool: true },
	});
}

export async function runLspPostToolUseHook(
	input: CodexPostToolUseInput,
	runDiagnostics: DiagnosticsRunner = runLspDiagnosticsText,
): Promise<string> {
	const sessionId = sessionIdFrom(input);
	const filePaths = extractMutatedFilePaths(input);
	if (filePaths.length === 0) return "";

	const cache = readLspPostEditCache(sessionId);
	const result = await collectPostEditDiagnostics({ filePaths, runDiagnostics, cache });
	writeLspPostEditCache(sessionId, cache);
	const blocks = result.blocks.filter(({ diagnostics }) => !isLspDaemonUnreachableDiagnostics(diagnostics));

	if (blocks.length === 0) return "";

	const rawReason = blocks.map(formatDiagnosticBlock).join("\n\n");
	const reason = limitHookText(rawReason, hookFeedbackLimit(input.transcript_path));
	const context: PostToolUseHookContext = {
		hookSpecificOutput: { hookEventName: "PostToolUse", additionalContext: reason },
	};
	// Missing-server guidance alone is a note for the model; only real diagnostics block the edit.
	if (!blocks.some((block) => block.blocking)) return `${JSON.stringify(context)}\n`;
	const output: PostToolUseHookOutput = { decision: "block", reason, ...context };
	return `${JSON.stringify(output)}\n`;
}

export async function runLspPostCompactHook(input: CodexPostCompactInput): Promise<string> {
	markLspSessionCompacted(sessionIdFrom(input));
	return "";
}

function formatDiagnosticBlock({ filePath, diagnostics }: DiagnosticBlock): string {
	return `LSP diagnostics after editing ${filePath}:\n\n${formatDiagnosticsForDisplay(diagnostics)}`;
}

function formatDiagnosticsForDisplay(diagnostics: string): string {
	const chunks = splitDiagnosticChunks(diagnostics);
	if (!chunks.some(isDiagnosticChunk)) return chunks.join("\n").trim();
	return chunks.map(formatDiagnosticChunk).join("\n");
}

function splitDiagnosticChunks(diagnostics: string): string[] {
	const normalized = diagnostics.replace(/\r\n/g, "\n").replace(/\r/g, "\n").trim();
	if (normalized.length === 0) return [];

	const matches = Array.from(normalized.matchAll(DIAGNOSTIC_START_PATTERN));
	const firstMatch = matches[0];
	if (firstMatch?.index === undefined) return [normalized];

	const chunks: string[] = [];
	const leadingText = normalized.slice(0, firstMatch.index).trim();
	if (leadingText.length > 0) chunks.push(leadingText);

	for (const [index, match] of matches.entries()) {
		if (match.index === undefined) continue;
		const nextMatch = matches[index + 1];
		const end = nextMatch?.index ?? normalized.length;
		const chunk = normalized.slice(match.index, end).trim();
		if (chunk.length > 0) chunks.push(chunk);
	}

	return chunks;
}

function formatDiagnosticChunk(chunk: string): string {
	const lines = chunk.split("\n");
	const firstLine = lines[0];
	if (firstLine === undefined) return "";
	if (!isDiagnosticChunk(firstLine)) return chunk;
	const followingLines = lines.slice(1).map((line) => `  ${line}`);
	return [`- ${firstLine}`, ...followingLines].join("\n");
}

function isDiagnosticChunk(chunk: string): boolean {
	return DIAGNOSTIC_CHUNK_PATTERN.test(chunk);
}

function hookFeedbackLimit(transcriptPath: unknown): number {
	return isContextPressureTranscript(transcriptPath)
		? CONTEXT_PRESSURE_MAX_HOOK_FEEDBACK_CHARS
		: DEFAULT_MAX_HOOK_FEEDBACK_CHARS;
}

function isContextPressureTranscript(transcriptPath: unknown): boolean {
	if (typeof transcriptPath !== "string") return false;
	try {
		return hasContextPressureMarker(readFileSync(transcriptPath, "utf8"));
	} catch (error) {
		if (error instanceof Error) return false;
		throw error;
	}
}

function hasContextPressureMarker(text: string): boolean {
	const normalizedText = text.toLowerCase();
	return CONTEXT_PRESSURE_MARKERS.some((marker) => normalizedText.includes(marker));
}

function limitHookText(text: string, maxChars: number): string {
	if (text.length <= maxChars) return text;
	const marker = `\n\n[Truncated hook output to ${maxChars} chars to avoid Codex context overflow.]`;
	if (marker.length >= maxChars) return marker.slice(0, maxChars);
	const head = text.slice(0, maxChars - marker.length).replace(/[ \t\r\n]+$/, "");
	return `${head}${marker}`;
}

export function isRecord(value: unknown): value is Record<string, unknown> {
	return typeof value === "object" && value !== null && !Array.isArray(value);
}