The one and only agent harness for complex codebases. Project memory, planning, execution, and verified completion inside Codex.
JavaScript aiai-agentsclaudeclaude-codeclicodexdeveloper-toolslazylazycodexoh-my-openagentomoopenaiorchestrationtypescript
import { isAbsolute, join, relative, sep } from "node:path";
import { ULW_LOOP_BRIEF, ULW_LOOP_DIR, ULW_LOOP_GOALS, ULW_LOOP_LEDGER, ULW_LOOP_STATE_LOCK, UlwLoopError, } from "./types.js";
const SESSION_ENV_KEYS = ["OMO_ULW_LOOP_SESSION_ID", "CODEX_SESSION_ID", "CODEX_THREAD_ID", "PI_SESSION_ID"];
export function normalizeUlwLoopSessionId(sessionId) {
const trimmed = sessionId?.trim();
if (!trimmed)
return null;
const pathSegments = trimmed
.split(/[\\/]+/)
.filter((segment) => segment.length > 0 && segment !== "." && segment !== "..");
const candidate = (pathSegments.length > 0 ? pathSegments.join("-") : trimmed)
.replace(/[^A-Za-z0-9._-]+/g, "-")
.replace(/-+/g, "-")
.replace(/^\.+/, "")
.replace(/^[.-]+|[.-]+$/g, "");
return candidate.length > 0 ? candidate : null;
}
export function resolveUlwLoopSessionIdFromEnv(env = process.env) {
for (const key of SESSION_ENV_KEYS) {
const normalized = normalizeUlwLoopSessionId(env[key]);
if (normalized !== null)
return normalized;
}
return null;
}
export function ulwLoopRelativeDir(scope) {
const sessionId = normalizeUlwLoopSessionId(scope?.sessionId);
return sessionId === null ? ULW_LOOP_DIR : `${ULW_LOOP_DIR}/${sessionId}`;
}
export function ulwLoopDir(repoRoot, scope) {
return join(repoRoot, ulwLoopRelativeDir(scope));
}
export function ulwLoopBriefRelativePath(scope) {
return `${ulwLoopRelativeDir(scope)}/${ULW_LOOP_BRIEF}`;
}
export function ulwLoopGoalsRelativePath(scope) {
return `${ulwLoopRelativeDir(scope)}/${ULW_LOOP_GOALS}`;
}
export function ulwLoopLedgerRelativePath(scope) {
return `${ulwLoopRelativeDir(scope)}/${ULW_LOOP_LEDGER}`;
}
export function ulwLoopBriefPath(repoRoot, scope) {
return join(ulwLoopDir(repoRoot, scope), ULW_LOOP_BRIEF);
}
export function ulwLoopGoalsPath(repoRoot, scope) {
return join(ulwLoopDir(repoRoot, scope), ULW_LOOP_GOALS);
}
export function ulwLoopLedgerPath(repoRoot, scope) {
return join(ulwLoopDir(repoRoot, scope), ULW_LOOP_LEDGER);
}
// One lock per state directory covers goals.json, ledger.jsonl, and the hook
// counters beside them; the CLI mutations and the Codex hooks all take it.
export function ulwLoopStateLockPath(repoRoot, scope) {
return join(ulwLoopDir(repoRoot, scope), ULW_LOOP_STATE_LOCK);
}
export function repoRelative(absolutePath, repoRoot) {
const slashPrefix = `${repoRoot}/`;
const backslashPrefix = `${repoRoot}\\`;
if (absolutePath.startsWith(slashPrefix))
return absolutePath.slice(slashPrefix.length).split("\\").join("/");
if (absolutePath.startsWith(backslashPrefix))
return absolutePath.slice(backslashPrefix.length).split("\\").join("/");
return absolutePath.split("\\").join("/");
}
// The plan-level evidence root stays fixed for the whole run, unlike the per-goal attempt dir, so
// long lanes that span goals have one stable place to write artifacts.
export function ulwLoopEvidenceRoot(scope) {
const sessionId = normalizeUlwLoopSessionId(scope?.sessionId);
return sessionId === null ? ".omo/evidence" : `.omo/evidence/ulw/${sessionId}`;
}
// Both the status --json emitter and the checkpoint enforcement resolve the attempt dir through
// this function from the scope alone; a second resolution path (env, a literal placeholder)
// would let the gate reject its own advertised directory.
export function ulwLoopAttemptEvidenceDir(goalId, attempt, scope) {
const sessionId = normalizeUlwLoopSessionId(scope?.sessionId);
if (sessionId === null) {
throw new UlwLoopError(`Evidence for ${goalId} attempt ${attempt} needs a session scope; pass --session-id <id> so the attempt directory lives under .omo/evidence/ulw/<id>/.`, "ULW_LOOP_SESSION_SCOPE_REQUIRED", { details: { goalId, attempt } });
}
return `.omo/evidence/ulw/${sessionId}/${goalId}/a${attempt}`;
}
const PLATFORM_PATH_API = { relative, isAbsolute, sep };
export function isWithinAttemptDir(absolutePath, attemptRoot, pathApi = PLATFORM_PATH_API) {
const relativePath = pathApi.relative(attemptRoot, absolutePath);
if (relativePath === "")
return true;
if (relativePath === ".." || relativePath.startsWith(`..${pathApi.sep}`))
return false;
return !pathApi.isAbsolute(relativePath);
}