TypeScript
/**
* 러너 레지스트리 (PRD §7).
* runnerFor(agent, name, {bench}) — name 이 none/''/'auto' 면 조합별 자동 디스패치
* (cc→claudeCode, codex→codexCli; 로컬-스타일 미설치 시 mock 폴백; 외부 벤치 tb).
* 명시 name 은 강제. ('auto' 를 강제 러너명으로 오인하지 말 것 — 과거 버그.)
*/
import { isLocalBench } from "../benches/index";
import type { RunnerAdapter } from "./base";
import { ClaudeCodeRunner } from "./claudeCode";
import { CodexCliRunner } from "./codexCli";
import { MockRunner } from "./mock";
import { MULTIMODEL_SPECS, MultiModelRunner } from "./multiModel";
import { TerminalBenchRunner } from "./terminalBench";
export interface RunnerChoice {
runner: RunnerAdapter;
mock: boolean; // mock 폴백/강제 여부(provenance 배너)
}
const AUTO_NAMES = new Set(["", "none", "auto"]);
function agentRunner(agent: string): RunnerAdapter | null {
if (agent === "cc") return new ClaudeCodeRunner();
if (agent === "codex") return new CodexCliRunner();
const spec = MULTIMODEL_SPECS[agent];
return spec ? new MultiModelRunner(spec) : null;
}
export function getRunner(name: string, failRate = 0): RunnerAdapter {
if (name === "tb") return new TerminalBenchRunner();
const r = agentRunner(name);
if (r) return r;
return new MockRunner(failRate);
}
export function runnerFor(
agent: string,
name: string,
opts: { bench: string },
failRate = 0,
): RunnerChoice {
const opt = (name ?? "auto").toLowerCase();
if (opt === "mock") return { runner: new MockRunner(failRate), mock: true };
// 명시 러너 강제 (cc / codex / opencode / openclaw / hermes)
const forced = agentRunner(opt);
if (forced) return { runner: forced, mock: false };
if (opt === "tb") {
const tb = new TerminalBenchRunner();
return tb.isAvailable()
? { runner: tb, mock: false }
: { runner: new MockRunner(failRate), mock: true };
}
// 자동 디스패치
if (AUTO_NAMES.has(opt)) {
if (isLocalBench(opts.bench)) {
const r = agentRunner(agent);
if (r) {
return r.isAvailable()
? { runner: r, mock: false }
: { runner: new MockRunner(failRate), mock: true };
}
return { runner: new MockRunner(failRate), mock: true };
}
// 외부 벤치 → tb, 미설치 시 mock
const tb = new TerminalBenchRunner();
return tb.isAvailable()
? { runner: tb, mock: false }
: { runner: new MockRunner(failRate), mock: true };
}
// 알 수 없는 이름 → mock 안전 폴백
return { runner: new MockRunner(failRate), mock: true };
}