mirror of
https://github.com/paperclipai/paperclip.git
synced 2026-10-12 08:19:54 +02:00
## Thinking Path > - Paperclip manages AI agents and their provider connections. > - Product E2E checks real tasks through the browser, server, and runner. > - Grok qualification needs separate API-key and subscription evidence. > - Product subscription tests and direct Grok protocol evals need explicit credential delivery. > - This change supplies each credential only to its selected profile and prepares the pinned binary. > - Maintainer authorization and protected-environment gates remain required. ## Linked Issues or Issue Description Refs #13845, #13847, #13850, #13882. The Grok feature branch has a manual subscription qualification profile. The trusted master workflow must admit its selected credential and prepare the same verified binary and artifact verifier as the API profile. Direct protocol evals also need the selected xAI key and pinned Grok binary. These prerequisites do not register or schedule the new profiles on master. ## What Changed - Deliver `GROK_AUTH_JSON` from the protected paid environment only when the selected profile requests that credential. - Install the checksum-verified Grok binary for the local subscription profile. - Prepare the pinned artifact verifier for the manual subscription suite. - Extend workflow security assertions to cover the new credential and profile. - Add the ACPX Grok credential mapping to the trusted-master catalog, then deliver only the selected `XAI_API_KEY` to direct protocol cells and install the target’s checksum-verified Grok binary before packaging. - Allow a direct-protocol concurrency override from two cases up to the existing configured ceiling; it can only lower concurrency. - Document the Grok protocol workflow and its API-only credential boundary. - Render missing LLM usage and cost as Unavailable, and label partial observations with coverage. Preserve raw records, grades, and actual zero costs. - Preserve measured campaign source metadata during report regeneration instead of inheriting the renderer checkout or CI event; skip empty legacy source records when recovering older provenance. ## Verification - Latest commit `05d05801477104c8155977bbbe3e119a5241f960`: all 54 reported checks successful, two intentional skips, Greptile 5/5, and zero unresolved review threads. [CI run](https://github.com/paperclipai/paperclip/actions/runs/35890978288). - After merging current master, all 17 workflow security/image tests and 23 catalog/workflow policy tests passed. The trusted catalog also generated all 39 pinned Grok cells with `XAI_API_KEY` and one case per shard. The new policy tests execute the concurrency guard against valid, out-of-range, and malformed values. - The Grok branch separately passed 450 Product harness unit tests, including private company credential staging, cleanup, and token-fragment redaction. - The fresh-login native subscription smoke passed three repetitions of tool execution, session resume, restrictive permissions, and cleanup. These are setup evidence; full subscription Product qualification remains pending. - All 72 focused report/billing/history/catalog tests and the Product harness typecheck passed for the report-display change. The initial sandbox run could not open the tsx IPC socket; the permitted rerun passed. A zero-provider-call replay of the actual 16-cell Grok campaign preserved all result records, grades, timing, and source provenance while correcting missing usage labels. - Review the thirteen-file diff. Provider credentials still enter only the selected paid-test step; default-branch, numeric-actor, and environment restrictions are unchanged. ## Risks This admits a refreshable subscription credential to explicitly selected trusted tests. Store it only in `runner-e2e-paid`, use a test login, and remove it after qualification. Unselected profiles receive an empty value. Pull requests cannot trigger the paid workflow. This PR changes no fleet admission or actor allowlist. ## Model Used OpenAI GPT-6 through Codex, with tool use and code execution. The exact serving model identifier and context-window size are not exposed in this session. ## Checklist - [x] I have included a thinking path that traces from project context to this change - [x] I have specified the model used (with version and capability details) - [x] I have checked ROADMAP.md and confirmed this PR does not duplicate planned core work - [x] I have searched GitHub for duplicate or related PRs and linked them above - [x] I have either (a) linked existing issues with `Fixes: #` / `Closes #` / `Refs #` OR (b) described the issue in-PR following the relevant issue template - [x] I have not referenced internal/instance-local Paperclip issues or links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip` URLs) - [x] My branch name describes the change (e.g. `docs/...`, `fix/...`) and contains no internal Paperclip ticket id or instance-derived details - [x] I have run tests locally and they pass - [x] I have added or updated tests where applicable - [x] I have updated relevant documentation to reflect my changes - [x] I have considered and documented any risks above - [x] All Paperclip CI gates are green - [x] Greptile is 5/5 with no open P2s, recommendations, or follow-ups - [x] I will address all Greptile and reviewer comments before requesting merge --------- Co-authored-by: Paperclip <noreply@paperclip.ing>
769 lines
25 KiB
JavaScript
769 lines
25 KiB
JavaScript
#!/usr/bin/env node
|
|
import { createHash } from "node:crypto";
|
|
import {
|
|
appendFile,
|
|
cp,
|
|
lstat,
|
|
mkdir,
|
|
readFile,
|
|
readdir,
|
|
rm,
|
|
writeFile,
|
|
} from "node:fs/promises";
|
|
import { basename, dirname, join, relative, resolve, sep } from "node:path";
|
|
import { sumAttemptCosts } from "./runner-protocol-eval-metrics.mjs";
|
|
import {
|
|
publicChatView,
|
|
PUBLIC_CHAT_SCHEMA,
|
|
PUBLIC_CHAT_NOTICE,
|
|
} from "./public-eval-chat.mjs";
|
|
|
|
const SAFE_ID = /^[A-Za-z0-9][A-Za-z0-9._-]{0,199}$/;
|
|
const ATTEMPT_FILES = new Set([
|
|
"request.json",
|
|
"artifact.json",
|
|
"score.json",
|
|
"compiled-fixture.json",
|
|
"case.json",
|
|
"config.json",
|
|
]);
|
|
|
|
function json(value) {
|
|
return `${JSON.stringify(value, null, 2)}\n`;
|
|
}
|
|
|
|
async function loadObject(path) {
|
|
const value = JSON.parse(await readFile(path, "utf8"));
|
|
if (value === null || Array.isArray(value) || typeof value !== "object") {
|
|
throw new Error(`Expected a JSON object: ${path}`);
|
|
}
|
|
return value;
|
|
}
|
|
|
|
function safeId(value, label = "identifier") {
|
|
const result = String(value ?? "");
|
|
if (!SAFE_ID.test(result)) throw new Error(`Unsafe ${label}: ${result}`);
|
|
return result;
|
|
}
|
|
|
|
function inside(root, candidate, label) {
|
|
const rel = relative(resolve(root), resolve(candidate));
|
|
if (!rel || rel === ".." || rel.startsWith(`..${sep}`)) {
|
|
throw new Error(`${label} escapes its declared root`);
|
|
}
|
|
return resolve(candidate);
|
|
}
|
|
|
|
export function credentialForConfig(config) {
|
|
if (config.provider === "opencode") return "OPENROUTER_API_KEY";
|
|
if (config.provider === "claude_managed") return "ANTHROPIC_API_KEY";
|
|
if (config.provider === "aws_agentcore") return "AWS_AGENTCORE_OIDC";
|
|
if (config.provider === "codex" || config.provider === undefined) {
|
|
return "OPENAI_API_KEY";
|
|
}
|
|
if (config.provider === "acpx") {
|
|
if (config.acpxAgent === "pi") return "OPENROUTER_API_KEY";
|
|
if (config.acpxAgent === "claude") return "ANTHROPIC_API_KEY";
|
|
if (config.acpxAgent === "grok") return "XAI_API_KEY";
|
|
if (config.acpxAgent === "codex") return "OPENAI_API_KEY";
|
|
}
|
|
throw new Error(
|
|
`No credential policy for ${config.provider ?? "codex"}/${config.acpxAgent ?? "default"}`,
|
|
);
|
|
}
|
|
|
|
function parseRosterSelection(value) {
|
|
if (!value?.trim() || value.trim() === "all") return null;
|
|
const selected = value
|
|
.split(",")
|
|
.map((entry) => entry.trim())
|
|
.filter(Boolean);
|
|
if (selected.length === 0 || new Set(selected).size !== selected.length) {
|
|
throw new Error("Roster selection must contain unique comma-separated IDs");
|
|
}
|
|
return new Set(selected);
|
|
}
|
|
|
|
async function maintainedRosterSelection(programRoot) {
|
|
const campaignPath = resolve(programRoot, "campaigns/live-direct-full.json");
|
|
const campaign = await loadObject(campaignPath);
|
|
if (
|
|
campaign.schema !== "paperclip-runner/live-campaign/v1" ||
|
|
!Array.isArray(campaign.lanes)
|
|
) {
|
|
throw new Error(`Unsupported live campaign schema in ${campaignPath}`);
|
|
}
|
|
const selected = campaign.lanes
|
|
.filter((lane) => lane.executionClass !== "disabled")
|
|
.map((lane) => {
|
|
const rosterPath = inside(
|
|
programRoot,
|
|
resolve(dirname(campaignPath), String(lane.roster ?? "")),
|
|
"Campaign roster",
|
|
);
|
|
return basename(rosterPath);
|
|
});
|
|
if (selected.length === 0 || new Set(selected).size !== selected.length) {
|
|
throw new Error(
|
|
"Maintained live campaign must contain unique enabled rosters",
|
|
);
|
|
}
|
|
return new Set(selected);
|
|
}
|
|
|
|
export async function buildProtocolEvalCatalog({
|
|
evalsRoot,
|
|
rosterSelection = "all",
|
|
campaignId,
|
|
source = {},
|
|
maxParallel = 100,
|
|
}) {
|
|
safeId(campaignId, "campaign ID");
|
|
if (
|
|
!Number.isSafeInteger(maxParallel) ||
|
|
maxParallel < 2 ||
|
|
maxParallel > 100
|
|
) {
|
|
throw new Error("maxParallel must be an integer from 2 through 100");
|
|
}
|
|
const programRoot = resolve(evalsRoot, "evals/paperclip-runner");
|
|
const rosterRoot = resolve(programRoot, "rosters");
|
|
const requested = parseRosterSelection(rosterSelection);
|
|
const selected = requested ?? (await maintainedRosterSelection(programRoot));
|
|
const rosterFiles = (await readdir(rosterRoot, { withFileTypes: true }))
|
|
.filter(
|
|
(entry) =>
|
|
entry.isFile() &&
|
|
entry.name.startsWith("live-") &&
|
|
entry.name.endsWith(".json"),
|
|
)
|
|
.map((entry) => entry.name)
|
|
.sort();
|
|
const rosters = [];
|
|
for (const rosterFile of rosterFiles) {
|
|
const rosterPath = resolve(rosterRoot, rosterFile);
|
|
const roster = await loadObject(rosterPath);
|
|
const rosterId = safeId(roster.id, "roster ID");
|
|
if (selected && !selected.has(rosterId) && !selected.has(rosterFile)) {
|
|
continue;
|
|
}
|
|
if (roster.schema !== "paperclip-runner/live-roster/v1") {
|
|
throw new Error(`Unsupported live roster schema in ${rosterFile}`);
|
|
}
|
|
if (!Array.isArray(roster.cases) || roster.cases.length === 0) {
|
|
throw new Error(`Live roster ${rosterId} has no cases`);
|
|
}
|
|
const configPath = inside(
|
|
programRoot,
|
|
resolve(rosterRoot, String(roster.config ?? "")),
|
|
`Config for ${rosterId}`,
|
|
);
|
|
const config = await loadObject(configPath);
|
|
const credentialName = credentialForConfig(config);
|
|
const cases = roster.cases.map((caseId) => safeId(caseId, "case ID"));
|
|
if (new Set(cases).size !== cases.length) {
|
|
throw new Error(`Live roster ${rosterId} repeats a case`);
|
|
}
|
|
rosters.push({
|
|
rosterId,
|
|
rosterFile,
|
|
configFile: relative(programRoot, configPath).split(sep).join("/"),
|
|
model: String(roster.model ?? config.model ?? "unknown"),
|
|
provider: String(config.provider ?? "codex"),
|
|
driver: String(config.driver ?? "codex_app_server"),
|
|
credentialName,
|
|
cases,
|
|
});
|
|
}
|
|
if (selected) {
|
|
const found = new Set(
|
|
rosters.flatMap((roster) => [roster.rosterId, roster.rosterFile]),
|
|
);
|
|
const missing = [...selected].filter((entry) => !found.has(entry));
|
|
if (missing.length > 0) {
|
|
throw new Error(`Unknown live roster selection: ${missing.join(", ")}`);
|
|
}
|
|
}
|
|
if (rosters.length === 0) throw new Error("No live rosters were selected");
|
|
|
|
const cells = rosters.flatMap((roster) =>
|
|
roster.cases.map((caseId) => ({
|
|
cellId: safeId(`${roster.rosterId}--${caseId}`, "cell ID"),
|
|
rosterId: roster.rosterId,
|
|
rosterFile: roster.rosterFile,
|
|
caseId,
|
|
model: roster.model,
|
|
provider: roster.provider,
|
|
driver: roster.driver,
|
|
credentialName: roster.credentialName,
|
|
})),
|
|
);
|
|
const shards = [[], []];
|
|
cells.forEach((cell, index) => shards[index % shards.length].push(cell));
|
|
if (shards.some((shard) => shard.length > 256)) {
|
|
throw new Error(
|
|
"Protocol eval catalog exceeds the two-shard GitHub matrix limit",
|
|
);
|
|
}
|
|
return {
|
|
schema: "paperclip.runner-protocol-eval.catalog/v1",
|
|
campaignId,
|
|
source,
|
|
selection: { kind: requested === null ? "maintained_full" : "subset", rosters: rosterSelection },
|
|
rosters,
|
|
cells,
|
|
matrices: shards.map((include) => ({ include })),
|
|
maxParallel,
|
|
maxParallelPerShard: Math.floor(maxParallel / 2),
|
|
};
|
|
}
|
|
|
|
async function writeGithubOutput(entries) {
|
|
const output = process.env.GITHUB_OUTPUT;
|
|
if (!output) return;
|
|
await appendFile(
|
|
output,
|
|
Object.entries(entries)
|
|
.map(([key, value]) => `${key}=${value}\n`)
|
|
.join(""),
|
|
);
|
|
}
|
|
|
|
async function copyAttempt(source, destination) {
|
|
const metadata = await lstat(source);
|
|
if (!metadata.isDirectory() || metadata.isSymbolicLink()) {
|
|
throw new Error(`Attempt source is not a real directory: ${source}`);
|
|
}
|
|
await mkdir(destination, { recursive: false, mode: 0o700 });
|
|
for (const entry of await readdir(source, { withFileTypes: true })) {
|
|
if (
|
|
!entry.isFile() ||
|
|
entry.isSymbolicLink() ||
|
|
!ATTEMPT_FILES.has(entry.name)
|
|
) {
|
|
throw new Error(`Unexpected attempt path ${join(source, entry.name)}`);
|
|
}
|
|
await cp(join(source, entry.name), join(destination, entry.name), {
|
|
errorOnExist: true,
|
|
});
|
|
}
|
|
for (const required of [
|
|
"artifact.json",
|
|
"score.json",
|
|
"case.json",
|
|
"config.json",
|
|
]) {
|
|
await lstat(join(destination, required));
|
|
}
|
|
}
|
|
|
|
async function findFiles(root, name) {
|
|
const metadata = await lstat(root).catch(() => null);
|
|
if (!metadata) return [];
|
|
if (!metadata.isDirectory() || metadata.isSymbolicLink()) {
|
|
throw new Error(`Download root must be a real directory: ${root}`);
|
|
}
|
|
const found = [];
|
|
async function visit(directory) {
|
|
for (const entry of await readdir(directory, { withFileTypes: true })) {
|
|
const absolute = join(directory, entry.name);
|
|
if (entry.isSymbolicLink())
|
|
throw new Error(`Refusing downloaded symlink: ${absolute}`);
|
|
if (entry.isDirectory()) await visit(absolute);
|
|
else if (entry.isFile() && entry.name === name) found.push(absolute);
|
|
}
|
|
}
|
|
await visit(root);
|
|
return found.sort();
|
|
}
|
|
|
|
function safeUsage(usage) {
|
|
const fields = [
|
|
"agentTurns",
|
|
"providerRequests",
|
|
"inputTokens",
|
|
"outputTokens",
|
|
"cachedInputTokens",
|
|
"reasoningTokens",
|
|
"providerReportedCostNanodollars",
|
|
"estimatedCostNanodollars",
|
|
];
|
|
return Object.fromEntries(
|
|
fields
|
|
.filter((field) => Number.isFinite(usage?.[field]) && usage[field] >= 0)
|
|
.map((field) => [field, usage[field]]),
|
|
);
|
|
}
|
|
|
|
async function syntheticAttempt({ evalsRoot, runsOut, cell, campaignId }) {
|
|
const programRoot = resolve(evalsRoot, "evals/paperclip-runner");
|
|
const roster = await loadObject(
|
|
resolve(programRoot, "rosters", cell.rosterFile),
|
|
);
|
|
const casePath = resolve(programRoot, "cases", `${cell.caseId}.json`);
|
|
const configPath = inside(
|
|
programRoot,
|
|
resolve(programRoot, "rosters", String(roster.config)),
|
|
`Config for ${cell.rosterId}`,
|
|
);
|
|
const [evalCase, config] = await Promise.all([
|
|
loadObject(casePath),
|
|
loadObject(configPath),
|
|
]);
|
|
const attemptId = safeId(
|
|
`${cell.cellId}-${campaignId}-missing`,
|
|
"synthetic attempt ID",
|
|
);
|
|
const directory = resolve(runsOut, attemptId);
|
|
await mkdir(directory, { recursive: false, mode: 0o700 });
|
|
const createdAt = new Date().toISOString();
|
|
const artifact = {
|
|
schema: "paperclip-runner/eval-session-artifact/v1",
|
|
attemptId,
|
|
createdAt,
|
|
requestedModel: config.model,
|
|
provider: config.provider ?? "codex",
|
|
driver: config.driver ?? "codex_app_server",
|
|
providerVersion: config.opencodeVersion ?? null,
|
|
usage: {},
|
|
turn: { status: "failed" },
|
|
snapshot: {
|
|
createdAt,
|
|
providerModel: {
|
|
id: config.model,
|
|
provider: config.modelProvider ?? config.provider ?? "unknown",
|
|
},
|
|
transcript: [],
|
|
evidence: [],
|
|
},
|
|
devtools: { revisions: [] },
|
|
infrastructureFailure: {
|
|
class: "ci_cell_artifact_missing",
|
|
category: "campaign_orchestration",
|
|
retryable: false,
|
|
},
|
|
};
|
|
const score = {
|
|
schema: "paperclip-runner/eval-score/v1",
|
|
attemptId,
|
|
caseId: cell.caseId,
|
|
disposition: "infrastructure_failure",
|
|
passed: false,
|
|
infrastructureErrors: [
|
|
"The matrix cell did not retain a complete attempt artifact.",
|
|
],
|
|
checks: [],
|
|
};
|
|
score.digest = `sha256:${createHash("sha256").update(JSON.stringify(score)).digest("hex")}`;
|
|
await Promise.all([
|
|
writeFile(join(directory, "artifact.json"), json(artifact), {
|
|
mode: 0o600,
|
|
}),
|
|
writeFile(join(directory, "score.json"), json(score), { mode: 0o600 }),
|
|
writeFile(join(directory, "case.json"), json(evalCase), { mode: 0o600 }),
|
|
writeFile(join(directory, "config.json"), json(config), { mode: 0o600 }),
|
|
]);
|
|
return attemptId;
|
|
}
|
|
|
|
export async function aggregateProtocolEvalCampaign({
|
|
catalogPath,
|
|
downloadsRoot,
|
|
evalsRoot,
|
|
runsOut,
|
|
campaignOut,
|
|
source,
|
|
}) {
|
|
const catalog = await loadObject(catalogPath);
|
|
if (catalog.schema !== "paperclip.runner-protocol-eval.catalog/v1") {
|
|
throw new Error("Unsupported protocol eval catalog");
|
|
}
|
|
await rm(runsOut, { recursive: true, force: true });
|
|
await mkdir(runsOut, { recursive: true });
|
|
const retainedByCell = new Map();
|
|
const expectedByCell = new Map(
|
|
catalog.cells.map((cell) => [cell.cellId, cell]),
|
|
);
|
|
const copiedAttemptIds = new Set();
|
|
for (const statusPath of await findFiles(downloadsRoot, "cell.json")) {
|
|
const status = await loadObject(statusPath);
|
|
const cellId = safeId(status.cellId, "recorded cell ID");
|
|
if (retainedByCell.has(cellId))
|
|
throw new Error(`Duplicate cell artifact ${cellId}`);
|
|
const expected = expectedByCell.get(cellId);
|
|
if (!expected)
|
|
throw new Error(`Downloaded artifact names an unexpected cell ${cellId}`);
|
|
if (
|
|
status.caseId !== expected.caseId ||
|
|
status.rosterFile !== expected.rosterFile
|
|
) {
|
|
throw new Error(`Downloaded cell metadata drifted for ${cellId}`);
|
|
}
|
|
const attemptRoot = resolve(dirname(statusPath), "runs");
|
|
const attemptIds = [];
|
|
const attemptMetadata = await lstat(attemptRoot).catch(() => null);
|
|
if (attemptMetadata?.isDirectory() && !attemptMetadata.isSymbolicLink()) {
|
|
for (const entry of (
|
|
await readdir(attemptRoot, { withFileTypes: true })
|
|
).sort((a, b) => a.name.localeCompare(b.name))) {
|
|
if (!entry.isDirectory() || entry.isSymbolicLink()) {
|
|
throw new Error(
|
|
`Unexpected cell run path ${join(attemptRoot, entry.name)}`,
|
|
);
|
|
}
|
|
const attemptId = safeId(entry.name, "attempt ID");
|
|
if (copiedAttemptIds.has(attemptId))
|
|
throw new Error(`Duplicate attempt artifact ${attemptId}`);
|
|
const [score, artifact, config] = await Promise.all([
|
|
loadObject(join(attemptRoot, entry.name, "score.json")),
|
|
loadObject(join(attemptRoot, entry.name, "artifact.json")),
|
|
loadObject(join(attemptRoot, entry.name, "config.json")),
|
|
]);
|
|
if (
|
|
score.attemptId !== attemptId ||
|
|
artifact.attemptId !== attemptId ||
|
|
score.caseId !== expected.caseId ||
|
|
config.model !== expected.model ||
|
|
(config.provider ?? "codex") !== expected.provider ||
|
|
(config.driver ?? "codex_app_server") !== expected.driver
|
|
) {
|
|
throw new Error(`Downloaded attempt identity drifted for ${cellId}`);
|
|
}
|
|
await copyAttempt(
|
|
join(attemptRoot, entry.name),
|
|
join(runsOut, attemptId),
|
|
);
|
|
copiedAttemptIds.add(attemptId);
|
|
attemptIds.push(attemptId);
|
|
}
|
|
}
|
|
retainedByCell.set(cellId, { status, attemptIds });
|
|
}
|
|
|
|
const results = [];
|
|
const attemptUsages = [];
|
|
for (const cell of catalog.cells) {
|
|
const retained = retainedByCell.get(cell.cellId);
|
|
const attemptIds = retained?.attemptIds?.length
|
|
? retained.attemptIds
|
|
: [
|
|
await syntheticAttempt({
|
|
evalsRoot,
|
|
runsOut,
|
|
cell,
|
|
campaignId: catalog.campaignId,
|
|
}),
|
|
];
|
|
const finalAttemptId = attemptIds.at(-1);
|
|
for (const attemptId of attemptIds) {
|
|
const attempt = await loadObject(join(runsOut, attemptId, "artifact.json"));
|
|
attemptUsages.push(attempt.usage);
|
|
}
|
|
const [score, artifact] = await Promise.all([
|
|
loadObject(join(runsOut, finalAttemptId, "score.json")),
|
|
loadObject(join(runsOut, finalAttemptId, "artifact.json")),
|
|
]);
|
|
if (score.caseId !== cell.caseId || score.attemptId !== finalAttemptId) {
|
|
throw new Error(`Final attempt identity drifted for ${cell.cellId}`);
|
|
}
|
|
results.push({
|
|
cellId: cell.cellId,
|
|
rosterId: cell.rosterId,
|
|
caseId: cell.caseId,
|
|
model: cell.model,
|
|
provider: cell.provider,
|
|
driver: cell.driver,
|
|
attemptIds,
|
|
finalAttemptId,
|
|
disposition: score.disposition,
|
|
passed: score.passed === true,
|
|
usage: safeUsage(artifact.usage),
|
|
cellExitCode: Number.isSafeInteger(retained?.status?.exitCode)
|
|
? retained.status.exitCode
|
|
: null,
|
|
});
|
|
}
|
|
const totals = {
|
|
selected: results.length,
|
|
passed: results.filter((result) => result.passed).length,
|
|
behaviorFailures: results.filter(
|
|
(result) => result.disposition === "behavior_failure",
|
|
).length,
|
|
infrastructureFailures: results.filter(
|
|
(result) => result.disposition === "infrastructure_failure",
|
|
).length,
|
|
};
|
|
const generatedAt = new Date().toISOString();
|
|
const campaign = {
|
|
schema: "paperclip.runner-protocol-eval.campaign/v1",
|
|
campaignId: catalog.campaignId,
|
|
generatedAt,
|
|
selection: catalog.selection,
|
|
costs: sumAttemptCosts(attemptUsages),
|
|
source: {
|
|
paperclip: source.paperclip,
|
|
evals: source.evals,
|
|
workflowRunUrl: source.workflowRunUrl,
|
|
},
|
|
complete: results.length === catalog.cells.length,
|
|
allPassed: totals.passed === totals.selected,
|
|
totals,
|
|
rosters: catalog.rosters.map((roster) => ({
|
|
rosterId: roster.rosterId,
|
|
model: roster.model,
|
|
provider: roster.provider,
|
|
driver: roster.driver,
|
|
selected: roster.cases.length,
|
|
passed: results.filter(
|
|
(result) => result.rosterId === roster.rosterId && result.passed,
|
|
).length,
|
|
})),
|
|
results,
|
|
};
|
|
await mkdir(dirname(campaignOut), { recursive: true });
|
|
await writeFile(campaignOut, json(campaign), { mode: 0o600 });
|
|
return campaign;
|
|
}
|
|
|
|
function publicArtifact(artifact, evalCase) {
|
|
const issueThread = publicChatView(artifact, evalCase);
|
|
const model = artifact.snapshot?.providerModel ?? {};
|
|
const infrastructure = artifact.infrastructureFailure;
|
|
const providerVersion =
|
|
artifact.provider === "claude_managed" ||
|
|
artifact.provider === "aws_agentcore"
|
|
? "remote profile redacted"
|
|
: (artifact.providerVersion ?? null);
|
|
return {
|
|
schema: artifact.schema,
|
|
attemptId: artifact.attemptId,
|
|
createdAt: artifact.createdAt,
|
|
requestedModel: artifact.requestedModel,
|
|
provider: artifact.provider,
|
|
driver: artifact.driver,
|
|
providerVersion,
|
|
retainedSession: null,
|
|
retainedSessionStatus: "redacted from the public report",
|
|
usage: safeUsage(artifact.usage),
|
|
timing: {
|
|
startedAt:
|
|
typeof artifact.timing?.startedAt === "string"
|
|
? artifact.timing.startedAt
|
|
: null,
|
|
finishedAt:
|
|
typeof artifact.timing?.finishedAt === "string"
|
|
? artifact.timing.finishedAt
|
|
: null,
|
|
durationMs: Number.isFinite(artifact.timing?.durationMs)
|
|
? artifact.timing.durationMs
|
|
: null,
|
|
},
|
|
turn: {
|
|
status: artifact.turn?.status ?? "failed",
|
|
turnId: issueThread.turns.at(-1).id,
|
|
},
|
|
snapshot: {
|
|
createdAt: artifact.snapshot?.createdAt ?? artifact.createdAt,
|
|
sessionId: "public-report",
|
|
providerModel: {
|
|
id: model.id ?? artifact.requestedModel,
|
|
provider: model.provider ?? artifact.provider,
|
|
},
|
|
transcript: [],
|
|
evidence: [],
|
|
},
|
|
devtools: { revisions: [] },
|
|
publication: { schema: PUBLIC_CHAT_SCHEMA, notice: PUBLIC_CHAT_NOTICE },
|
|
issueThread,
|
|
...(infrastructure && typeof infrastructure === "object"
|
|
? {
|
|
infrastructureFailure: {
|
|
class: infrastructure.class,
|
|
category: infrastructure.category,
|
|
retryable: infrastructure.retryable === true,
|
|
},
|
|
}
|
|
: {}),
|
|
};
|
|
}
|
|
|
|
function publicScore(score) {
|
|
return {
|
|
schema: score.schema,
|
|
attemptId: score.attemptId,
|
|
caseId: score.caseId,
|
|
disposition: score.disposition,
|
|
passed: score.passed === true,
|
|
infrastructureErrors:
|
|
score.disposition === "infrastructure_failure"
|
|
? [
|
|
"Infrastructure failure; diagnostic details remain in the access-controlled artifact.",
|
|
]
|
|
: [],
|
|
checks: Array.isArray(score.checks)
|
|
? score.checks.map((check) => ({
|
|
id: check.id,
|
|
kind: check.kind,
|
|
passed: check.passed === true,
|
|
detail: check.passed === true ? "passed" : "failed",
|
|
evidenceRefs: [],
|
|
}))
|
|
: [],
|
|
digest: score.digest,
|
|
};
|
|
}
|
|
|
|
function publicConfig(config) {
|
|
return Object.fromEntries(
|
|
[
|
|
"schema",
|
|
"id",
|
|
"model",
|
|
"provider",
|
|
"driver",
|
|
"opencodeVersion",
|
|
"acpxAgent",
|
|
"modelProvider",
|
|
]
|
|
.filter((field) => config[field] !== undefined)
|
|
.map((field) => [field, config[field]]),
|
|
);
|
|
}
|
|
|
|
export async function sanitizeProtocolEvalRuns({ runsRoot, publicRunsRoot }) {
|
|
await rm(publicRunsRoot, { recursive: true, force: true });
|
|
await mkdir(publicRunsRoot, { recursive: true });
|
|
const attemptIds = [];
|
|
for (const entry of (await readdir(runsRoot, { withFileTypes: true })).sort(
|
|
(a, b) => a.name.localeCompare(b.name),
|
|
)) {
|
|
if (!entry.isDirectory() || entry.isSymbolicLink()) {
|
|
throw new Error(
|
|
`Unexpected merged run path ${join(runsRoot, entry.name)}`,
|
|
);
|
|
}
|
|
const attemptId = safeId(entry.name, "attempt ID");
|
|
const source = join(runsRoot, attemptId);
|
|
const [artifact, score, evalCase, config] = await Promise.all([
|
|
loadObject(join(source, "artifact.json")),
|
|
loadObject(join(source, "score.json")),
|
|
loadObject(join(source, "case.json")),
|
|
loadObject(join(source, "config.json")),
|
|
]);
|
|
if (artifact.attemptId !== attemptId || score.attemptId !== attemptId) {
|
|
throw new Error(`Attempt identity drifted in ${attemptId}`);
|
|
}
|
|
const destination = join(publicRunsRoot, attemptId);
|
|
await mkdir(destination, { mode: 0o700 });
|
|
await Promise.all([
|
|
writeFile(
|
|
join(destination, "artifact.json"),
|
|
json(publicArtifact(artifact, evalCase)),
|
|
{ mode: 0o600 },
|
|
),
|
|
writeFile(join(destination, "score.json"), json(publicScore(score)), {
|
|
mode: 0o600,
|
|
}),
|
|
writeFile(
|
|
join(destination, "case.json"),
|
|
json({
|
|
id: evalCase.id,
|
|
checks: (evalCase.checks ?? []).map(({ id, kind }) => ({ id, kind })),
|
|
}),
|
|
{
|
|
mode: 0o600,
|
|
},
|
|
),
|
|
writeFile(join(destination, "config.json"), json(publicConfig(config)), {
|
|
mode: 0o600,
|
|
}),
|
|
]);
|
|
attemptIds.push(attemptId);
|
|
}
|
|
return attemptIds;
|
|
}
|
|
|
|
function argument(args, name, fallback) {
|
|
const index = args.indexOf(name);
|
|
return index < 0 ? fallback : args[index + 1];
|
|
}
|
|
|
|
async function main() {
|
|
const [command, ...args] = process.argv.slice(2);
|
|
if (command === "catalog") {
|
|
const output = resolve(
|
|
argument(args, "--output", "runner-protocol-eval-catalog.json"),
|
|
);
|
|
const catalog = await buildProtocolEvalCatalog({
|
|
evalsRoot: resolve(argument(args, "--evals-root", ".paperclip-evals")),
|
|
rosterSelection: argument(args, "--rosters", "all"),
|
|
campaignId: argument(args, "--campaign-id", `local-${Date.now()}`),
|
|
maxParallel: Number(argument(args, "--max-parallel", "100")),
|
|
source: {
|
|
paperclipSha: process.env.PAPERCLIP_PROTOCOL_EVAL_SOURCE_SHA ?? null,
|
|
evalsSha: process.env.PAPERCLIP_PROTOCOL_EVALS_SHA ?? null,
|
|
},
|
|
});
|
|
await mkdir(dirname(output), { recursive: true });
|
|
await writeFile(output, json(catalog), { mode: 0o600 });
|
|
await writeGithubOutput({
|
|
matrix_0: JSON.stringify(catalog.matrices[0]),
|
|
matrix_1: JSON.stringify(catalog.matrices[1]),
|
|
matrix_1_present: String(catalog.matrices[1].include.length > 0),
|
|
max_parallel_per_shard: String(catalog.maxParallelPerShard),
|
|
selected: String(catalog.cells.length),
|
|
});
|
|
console.log(
|
|
json({
|
|
output,
|
|
selected: catalog.cells.length,
|
|
rosters: catalog.rosters.length,
|
|
}).trim(),
|
|
);
|
|
return;
|
|
}
|
|
if (command === "aggregate") {
|
|
const campaign = await aggregateProtocolEvalCampaign({
|
|
catalogPath: resolve(argument(args, "--catalog")),
|
|
downloadsRoot: resolve(argument(args, "--downloads")),
|
|
evalsRoot: resolve(argument(args, "--evals-root")),
|
|
runsOut: resolve(argument(args, "--runs-out")),
|
|
campaignOut: resolve(argument(args, "--campaign-out")),
|
|
source: {
|
|
paperclip: {
|
|
sha: process.env.PAPERCLIP_PROTOCOL_EVAL_SOURCE_SHA,
|
|
ref: process.env.PAPERCLIP_PROTOCOL_EVAL_SOURCE_REF,
|
|
},
|
|
evals: {
|
|
repository: "paperclipai/paperclip-evals",
|
|
sha: process.env.PAPERCLIP_PROTOCOL_EVALS_SHA,
|
|
},
|
|
workflowRunUrl: process.env.PAPERCLIP_PROTOCOL_EVAL_WORKFLOW_URL,
|
|
},
|
|
});
|
|
console.log(json(campaign.totals).trim());
|
|
return;
|
|
}
|
|
if (command === "sanitize") {
|
|
const attemptIds = await sanitizeProtocolEvalRuns({
|
|
runsRoot: resolve(argument(args, "--runs-root")),
|
|
publicRunsRoot: resolve(argument(args, "--output")),
|
|
});
|
|
console.log(json({ attempts: attemptIds.length }).trim());
|
|
return;
|
|
}
|
|
throw new Error(
|
|
"Usage: runner-protocol-eval-campaign.mjs <catalog|aggregate|sanitize> ...",
|
|
);
|
|
}
|
|
|
|
if (
|
|
process.argv[1] &&
|
|
resolve(process.argv[1]) === resolve(import.meta.filename)
|
|
) {
|
|
await main().catch((error) => {
|
|
console.error(error instanceof Error ? error.message : String(error));
|
|
process.exitCode = 1;
|
|
});
|
|
}
|