Skip to content

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

1.5 KB
Raw Blame
// Explicit selectors, pinned by a test to the bundled role TOMLs. The generated
// default is a non-fork fallback, not a selector: a user can opt out of owning it.
export const LAZYCODEX_SPAWN_ROLES: ReadonlySet<string> = new Set([
	"explorer",
	"lazycodex-clone-fidelity-reviewer",
	"lazycodex-code-reviewer",
	"lazycodex-gate-reviewer",
	"lazycodex-qa-executor",
	"lazycodex-worker-high",
	"lazycodex-worker-low",
	"lazycodex-worker-medium",
	"librarian",
	"metis",
	"momus",
	"plan",
]);

export function spawnRoleDenial(
	input: unknown,
	registeredRoles: () => ReadonlySet<string> = () => new Set(),
): string | null {
	const role = typeof input === "object" && input !== null && "agent_type" in input ? input.agent_type : undefined;
	if (typeof role === "string" && LAZYCODEX_SPAWN_ROLES.has(role)) return null;
	const registered = typeof role === "string" && role.trim() !== "" ? registeredRoles() : new Set<string>();
	if (typeof role === "string" && registered.has(role)) return null;
	const known = [...new Set([...LAZYCODEX_SPAWN_ROLES, ...registered])];
	return `LazyCodex requires an explicit registered agent_type: ${known.join(", ")}. Received ${JSON.stringify(role) ?? "no agent_type"}. Use the matching role and fork_turns: "none" (V2) or fork_context: false (V1), unless full history is deliberately required. The hook cannot see the tool schema; if agent_type is unavailable, stop and report incompatible role routing rather than spawning a generic agent. Describing a role in message does not select its TOML.`;
}