import { humanize } from "./lib"; export const REASONING_OPTIONS = [ ["off", "None"], ["minimal", "Minimal"], ["low", "Low"], ["medium", "Medium"], ["high", "High"], ["xhigh", "Extra high"], ] as const; export type ReasoningOption = (typeof REASONING_OPTIONS)[number][0]; export type DeploymentKind = "providers" | "endpoints"; export type LaunchSelection = { model: string; harnessAgent: string; reasoning: ReasoningOption; deploymentKind: DeploymentKind; }; type ApprovedProfile = { alias: string; spec: Record; }; export function approvedAlias( selected: string, available: readonly string[], kind = "profile", ): string { if (!available.includes(selected)) throw new Error(`approved ${kind} ${selected || "selection"} is missing`); return selected; } export function doubleReservationMicrousd(estimatedMicrousd: number): number { return estimatedMicrousd * 2; } export function counted(count: number, noun: string): string { return `${count} ${noun}${count === 1 ? "" : "s"}`; } export function deploymentKind( spec: Record, ): DeploymentKind | "other" { if (typeof spec.inference_provider === "string" && spec.inference_provider.length > 0) return "providers"; const template = spec.trial_job_template; if (!template || typeof template !== "object") return "other"; const upstream = (template as Record).inference_upstream; if (typeof upstream !== "string" || upstream.length === 0) return "other"; if (upstream.includes("router.huggingface.co")) return "providers"; if (upstream === "") return "other"; return "endpoints"; } export function harnessAgent(spec: Record): string { const agent = spec.agent; if (typeof agent !== "string" || agent.length === 0) throw new Error("harness profile is missing agent"); return agent; } export function harnessReasoning(spec: Record): ReasoningOption { const value = spec.reasoning_effort; return REASONING_OPTIONS.some(([option]) => option === value) ? (value as ReasoningOption) : "off"; } export function profileLabel( kind: string, alias: string, spec: Record, ): string { if (kind === "benchmark") { const benchmark = typeof spec.benchmark === "string" ? spec.benchmark : alias; const sources = Array.isArray(spec.source_task_ids) ? new Set(spec.source_task_ids).size : 0; const tasks = sources > 0 ? sources : Array.isArray(spec.task_ids) ? spec.task_ids.length : 0; const trials = Array.isArray(spec.trial_indices) ? new Set(spec.trial_indices).size : 0; const name = benchmark === "terminal-bench-2-1" ? "Terminal-Bench 2.1" : humanize(benchmark); if (tasks === 0) return name; if (trials > 1) return `${name} · ${counted(tasks, "task")} with ${counted(trials, "trial")} each`; return `${name} · ${counted(tasks, "task")}`; } if (kind === "model") return typeof spec.model_id === "string" ? spec.model_id : alias; if (kind === "harness") { const agent = typeof spec.agent === "string" ? spec.agent : alias; if (agent === "dsh" || agent.startsWith("dsh-") || alias.startsWith("dsh")) return "DeepSeek Harness"; if (agent === "opencode") return "OpenCode"; if (agent === "fx") return "FX"; if (agent === "pi") return "Pi"; if (agent === "control-smoke") return "Control smoke"; return humanize(agent); } return alias; } /** Operator-facing harness name. Profile aliases such as `dsh` stay as data. */ export function labeledHarness(value: string | null | undefined): string { if (!value) return "—"; return profileLabel("harness", value, { agent: value }); } export function selectHarnessAlias( harnesses: ReadonlyArray<{ alias: string; spec: Record }>, agent: string, reasoning: string, ): string { const match = harnesses.find( (item) => harnessAgent(item.spec) === agent && harnessReasoning(item.spec) === reasoning, ); if (!match) throw new Error( `no approved ${agent} harness with reasoning ${reasoning} is available`, ); return match.alias; } export function selectDeploymentAlias( deployments: ReadonlyArray, kind: DeploymentKind, model: string, harness: string, ): string { const match = deployments.find((item) => { const models = item.spec.models; const harnesses = item.spec.harnesses; return ( deploymentKind(item.spec) === kind && Array.isArray(models) && models.includes(model) && Array.isArray(harnesses) && harnesses.includes(harness) ); }); if (!match) throw new Error( `no approved ${kind} deployment is available for ${model} and ${harness}`, ); return match.alias; } export function firstCompatibleLaunchSelection( models: ReadonlyArray, harnesses: ReadonlyArray, deployments: ReadonlyArray, ): LaunchSelection { const modelAliases = new Set(models.map((profile) => profile.alias)); const harnessByAlias = new Map(harnesses.map((profile) => [profile.alias, profile])); for (const deployment of deployments) { const kind = deploymentKind(deployment.spec); if (kind === "other") continue; const deploymentModels = deployment.spec.models; const deploymentHarnesses = deployment.spec.harnesses; if (!Array.isArray(deploymentModels) || !Array.isArray(deploymentHarnesses)) continue; for (const model of deploymentModels) { if (typeof model !== "string" || !modelAliases.has(model)) continue; for (const harnessAlias of deploymentHarnesses) { if (typeof harnessAlias !== "string") continue; const harness = harnessByAlias.get(harnessAlias); if (!harness) continue; const agent = harnessAgent(harness.spec); const reasoning = harnessReasoning(harness.spec); const selectedHarness = harnesses.find( (profile) => harnessAgent(profile.spec) === agent && harnessReasoning(profile.spec) === reasoning, ); if (!selectedHarness || !deploymentHarnesses.includes(selectedHarness.alias)) continue; return { model, harnessAgent: agent, reasoning, deploymentKind: kind, }; } } } throw new Error("no compatible approved launch profile combination is available"); }