mirror of
https://github.com/paperclipai/paperclip.git
synced 2026-10-25 02:26:12 +02:00
perf(evals): tighten measured campaign resource ceilings (#17381)
## Thinking Path > - Paperclip is the open source app people use to manage AI agents for work. > - Product E2E checks real provider behavior under a campaign budget. > - Its request and trace limits also determine the operating-cost forecast. > - The initial limits greatly exceed the measured marker and feedback cases. > - This pull request lowers those defaults while keeping the same selected cases and full model context limits. > - The benefit is a smaller bounded resource envelope with explicit quota failures and readable historical evidence. ## Linked Issues or Issue Description Refs: #17365 Refs: #17371 **What existing behavior does this improve?** The resource ceilings for bounded Product E2E campaigns and their OTLP relay. **Current behavior** Daily and weekly campaigns allow 60 and 120 model requests. The native relay defaults to 256 MiB of expanded source and 16,384 records per attempt. Both October 23 two-case qualification campaigns used ten model requests. The largest native attempt used 6,531,801 expanded source bytes and 2,455 records. **Proposed behavior** Use 30 daily and 60 weekly model requests. Default native exports to 16 MiB of expanded source and 4,096 records. Preserve the older explicit relay maxima so prior receipts remain valid and deliberate controller overrides still work. **Reason and benefit** The smaller limits leave headroom for the measured cases and reduce the maximum source traffic in the operating forecast. They do not change the daily or weekly dollar cap, model context ceiling, per-request reservation, selected cases, or attempt policy. **Breaking changes** A new bounded attempt that exceeds the smaller default trace allowance receives a quota error. It cannot silently omit required evidence. Existing receipts remain readable. No paid recurrence is enabled by this change. ## What Changed - Set scheduled model request caps to 30 daily and 60 weekly. - Add smaller native relay defaults while preserving the existing explicit maximum and historical receipt validation. - Exercise default count and expanded-source exhaustion through the HTTP relay. Keep a regression for larger historical receipt policies. - Document the measured basis, default capacities, and failure behavior. ## Verification - `pnpm test:e2e:runner:unit`: 4,095 Vitest tests passed, two existing skips; 137 Node contract tests passed. - `pnpm test:e2e:runner:typecheck`: passed. - `git diff --check`: passed. - The relay test accepts two 3-MiB log payloads, rejects the third before upstream dispatch, and retains its quota receipt. - Read-only replay of the prior real hosted campaign preserved all five ingestion receipts and 123,044 payload bytes exactly. Its accounting journal remained byte-for-byte unchanged; zero provider calls. - Full repository typecheck, tests, build and reviews are pending hosted CI. No paid model call was made for this change. Live qualification of the smaller defaults remains open. ## Risks - More verbose future cases may exhaust the new defaults. Such a failure remains visible and requires evidence before increasing a limit. - Source-byte ceilings are not Braintrust invoice units. Operating-cost qualification and reconciliation remain separate requirements. - Manual controller overrides can still use the earlier larger maxima; their cost audit must account for the limits actually recorded in the receipt. ## Model Used OpenAI Codex, GPT-6 family, with reasoning, code execution and tool use. The host does not expose an exact model build identifier or context window size for 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 - [ ] All Paperclip CI gates are green - [ ] 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>
This commit is contained in:
1 parent
515ff0f284
commit
52a66af29d
6 files changed
+44
-8
No files matched your search
@@ -364,8 +364,10 @@ rejects ambiguous singular fields and routing values.
|
||||
|
||||
Each relay allows at most 2,048 admitted exports, 8 MiB per request before and
|
||||
after decompression, 64 MiB of forwarded payloads, and four simultaneous exports.
|
||||
It also limits each attempt to 16,384 records and 256 MiB of expanded source
|
||||
JSON. This measurement includes the full decoded source plus each record in
|
||||
The default allowance limits each attempt to 4,096 records and 16 MiB of
|
||||
expanded source JSON. Historical receipts with up to 16,384 records and 256 MiB
|
||||
remain readable; controller callers may still supply explicit limits up to
|
||||
those maxima. This measurement includes the full decoded source plus each record in
|
||||
its own envelope with the shared resource and scope fields repeated. It counts
|
||||
span names, IDs, times, events, links and log bodies, not only routing attributes.
|
||||
Protobuf fields use the pinned OTLP v1.9 schema; unknown fields fail admission
|
||||
@@ -408,7 +410,7 @@ or an invoice. Vendor charges remain unreconciled. The current two-attempt daily
|
||||
maximum is 132.125 MiB and the four-attempt weekly maximum is 260.25 MiB,
|
||||
including finalization and the campaign's experiment payload allowance. These
|
||||
bounds do not include other projects, standalone imports or retained storage.
|
||||
The corresponding expanded-source ceilings are 514 MiB daily and 1,028 MiB
|
||||
The corresponding default expanded-source ceilings are 34 MiB daily and 68 MiB
|
||||
weekly before the separate 4-MiB experiment allowance. These source measurements
|
||||
support a priced forecast; they are not Braintrust's processed-data meter or a
|
||||
vendor-enforced dollar limit. Gateway auto-logging is a separate input to that
|
||||
@@ -463,7 +465,12 @@ the existing AWS/GitHub runner choice.
|
||||
|
||||
Daily selects native Claude's marker and feedback-persistence cases with a shared
|
||||
$20 allowance. Weekly adds native Codex's two corresponding cases with a
|
||||
shared $100 allowance. Model requests and declared operating overhead share
|
||||
shared $100 allowance. Daily campaigns admit at most 30 model requests; weekly
|
||||
campaigns admit at most 60. The October 23 qualification campaigns used 10 model
|
||||
requests each. The largest observed native attempt exported 6,531,801 expanded
|
||||
source bytes and 2,455 records. The defaults retain headroom for those measured
|
||||
cases; exhausting a limit remains visible and never silently drops required
|
||||
evidence. Model requests and declared operating overhead share
|
||||
this limit. Each campaign runs sequentially in one job with one
|
||||
journal, one attempt per execution, zero automatic retries, a 30-minute request
|
||||
deadline and a finite request count. Codex's worst-case request reservation exceeds
|
||||
|
||||
@@ -239,7 +239,7 @@ it.each(["json", "protobuf"])("meters repeated resource/scope data and full reco
|
||||
|
||||
it("accepts thousands of small native records while bounding their total count", async () => {
|
||||
const upstream = vi.fn<typeof fetch>(async () => Response.json({}));
|
||||
const f = await fixture({ transport: upstream, limits: { ...EVAL_OTLP_LIMITS, maxRecords: 3000 } });
|
||||
const f = await fixture({ transport: upstream });
|
||||
const body = JSON.stringify({ resource_logs: [{ scope_logs: [{ log_records: Array.from({ length: 2533 }, () => ({ body: { stringValue: "event" } })) }] }] });
|
||||
expect((await f.send(body, {}, "/v1/logs")).status).toBe(200);
|
||||
expect((await f.send(body, {}, "/v1/logs")).status).toBe(429);
|
||||
@@ -247,6 +247,23 @@ it("accepts thousands of small native records while bounding their total count",
|
||||
expect((await f.records()).find(row => row.type === "admitted").recordCount).toBe(2533);
|
||||
});
|
||||
|
||||
it("enforces the smaller default expanded-source allowance before export", async () => {
|
||||
const upstream = vi.fn<typeof fetch>(async () => Response.json({}));
|
||||
const f = await fixture({ transport: upstream });
|
||||
const body = JSON.stringify({ resourceLogs: [{ scopeLogs: [{ logRecords: [
|
||||
{ body: { stringValue: "x".repeat(3 * 1024 * 1024) } },
|
||||
] }] }] });
|
||||
expect((await f.send(body, {}, "/v1/logs")).status).toBe(200);
|
||||
expect((await f.send(body, {}, "/v1/logs")).status).toBe(200);
|
||||
expect((await f.send(body, {}, "/v1/logs")).status).toBe(429);
|
||||
expect(upstream).toHaveBeenCalledTimes(2);
|
||||
await f.relay.close();
|
||||
const rows = await f.records();
|
||||
expect(rows[0].limits.maxExpandedBytes).toBe(16 * 1024 * 1024);
|
||||
expect(rows.at(-1).admittedExpandedBytes).toBeGreaterThan(12 * 1024 * 1024);
|
||||
expect(rows.filter(row => row.type === "quota_exhausted")).toHaveLength(1);
|
||||
});
|
||||
|
||||
it("rejects unknown protobuf fields instead of excluding forwarded data from sizing", async () => {
|
||||
const upstream = vi.fn<typeof fetch>(async () => Response.json({}));
|
||||
const f = await fixture({ transport: upstream });
|
||||
|
||||
@@ -9,12 +9,14 @@ import { evalOtlpRejected, evalOtlpResponse, isEvalProjectId, validateEvalOtlpPa
|
||||
export const EVAL_OTLP_LIMITS = { maxRequests: 2048, maxRequestBytes: 8 * 1024 * 1024,
|
||||
maxTotalBytes: 64 * 1024 * 1024, maxConcurrent: 4,
|
||||
maxExpandedBytes: 256 * 1024 * 1024, maxRecords: 16_384 } as const;
|
||||
export const EVAL_OTLP_DEFAULT_LIMITS = { ...EVAL_OTLP_LIMITS,
|
||||
maxExpandedBytes: 16 * 1024 * 1024, maxRecords: 4096 } as const;
|
||||
|
||||
export async function startEvalOtlpRelay(input: {
|
||||
projectId: string; apiKey: string; campaignId: string; attemptId: string; receiptPath: string; deadlineAt: number;
|
||||
limits?: { [K in keyof typeof EVAL_OTLP_LIMITS]: number }; transport?: typeof fetch;
|
||||
}) {
|
||||
const limits = input.limits ?? EVAL_OTLP_LIMITS;
|
||||
const limits = input.limits ?? EVAL_OTLP_DEFAULT_LIMITS;
|
||||
if (!isEvalProjectId(input.projectId) || !input.apiKey.trim() || /[\r\n]/.test(input.apiKey)
|
||||
|| ![input.campaignId, input.attemptId].every(value => /^[A-Za-z0-9_.:-]{1,512}$/.test(value))
|
||||
|| !path.isAbsolute(input.receiptPath) || !Number.isFinite(input.deadlineAt)
|
||||
|
||||
@@ -80,6 +80,16 @@ it("binds the expected receipt set to admitted attempts and retains unstarted se
|
||||
await expect(collectScheduledIngestion({ ...f.input, campaignId: "foreign" })).rejects.toThrow("campaign mismatch");
|
||||
});
|
||||
|
||||
it("keeps historical native receipts with the larger policy limits readable", async () => {
|
||||
const f = await fixture(), file = f.files[0]!;
|
||||
const rows = (await readFile(file, "utf8")).trim().split("\n").map(line => JSON.parse(line));
|
||||
rows[0].limits.maxExpandedBytes = 256 * 1024 * 1024;
|
||||
rows[0].limits.maxRecords = 16_384;
|
||||
await writeFile(file, rows.map(row => JSON.stringify(row)).join("\n") + "\n");
|
||||
expect(await collectScheduledIngestion(f.input)).toMatchObject({ status: "complete",
|
||||
totalAdmittedPayloadBytes: f.expectedBytes, billedCostUsd: null });
|
||||
});
|
||||
|
||||
it("keeps version 1 transport receipts readable without inventing expanded data measurements", async () => {
|
||||
const f = await fixture(), file = f.files[0]!;
|
||||
const rows = (await readFile(file, "utf8")).trim().split("\n").map(line => JSON.parse(line));
|
||||
|
||||
@@ -19,7 +19,7 @@ it.each(["daily", "weekly"] as const)("runs the exact %s selection through one s
|
||||
const manifest = scheduledManifest({ ...input, cadence });
|
||||
const selected = selectRunnerExecutions(parseRunnerSelectors(manifest.executionIds.flatMap(id => ["--id", id])), runnerMatrix);
|
||||
expect(selected.map(row => row.id).sort()).toEqual([...scheduledSelection(cadence)].sort());
|
||||
expect(manifest.limits).toMatchObject({ maxUsd: cadence === "daily" ? "20" : "100", maxConcurrent: 1, maxAttemptsPerExecution: 1 });
|
||||
expect(manifest.limits).toMatchObject({ maxUsd: cadence === "daily" ? "20" : "100", maxRequests: cadence === "daily" ? 30 : 60, maxConcurrent: 1, maxAttemptsPerExecution: 1 });
|
||||
expect(Date.parse(manifest.limits.deadlineAt) - input.now).toBe(30 * 60_000);
|
||||
expect(scheduledMatrix(cadence).include).toHaveLength(1);
|
||||
expect(manifest.executionIds).toHaveLength(cadence === "daily" ? 2 : 4);
|
||||
|
||||
@@ -64,7 +64,7 @@ export function scheduledManifest(input: {
|
||||
const { executionIds, executions, models } = validateScheduledBudget(input);
|
||||
const manifest: EvalOperationsManifest = {
|
||||
version: 1, limits: { campaignId: input.campaignId, maxUsd: budget(input.cadence), overhead: input.overhead,
|
||||
deadlineAt: new Date(input.now + 30 * 60_000).toISOString(), maxRequests: input.cadence === "daily" ? 60 : 120,
|
||||
deadlineAt: new Date(input.now + 30 * 60_000).toISOString(), maxRequests: input.cadence === "daily" ? 30 : 60,
|
||||
maxConcurrent: 1, maxAttemptsPerExecution: 1 },
|
||||
ledgerPath: input.ledgerPath, executionIds, maxAttemptsPerExecution: 1, route: "braintrust", projectId: input.projectId,
|
||||
models,
|
||||
|
||||
Reference in new issue
Block a user