Skip to content

A desktop coding agent with free access to frontier models.

TypeScript

feat(capture): describe bounded reproducibility evidence

Task Builder984d4a953c3c
diff --git a/apps/server/src/session-uploader.ts b/apps/server/src/session-uploader.ts
index d33c339f..3bdb971d 100644
--- a/apps/server/src/session-uploader.ts
+++ b/apps/server/src/session-uploader.ts
@@ -231,8 +231,34 @@ export type UploadEnvironment = {
git_version: string | null;
/** Exact toolchain versions of the session's project (toolchain.ts); absent on older clients. */
toolchain?: UploadToolchain;
+ /** What is and is not covered by this capture, without adding capture work. */
+ reproducibility?: UploadReproducibility;
};
+/**
+ * Compact evidence about what the uploader already captured. Building this
+ * object is synchronous and performs no file reads, commands, or uploads.
+ */
+export type UploadReproducibility = {
+ schema: 1;
+ capture: "bounded_existing_data";
+ workspace: "archive_and_turn_diffs";
+ dependencies: {
+ manifests: string[];
+ lockfiles: string[];
+ toolchain_recorded: boolean;
+ };
+ external: "metadata_only";
+ replay: "not_verified";
+ performance: {
+ extra_scans: 0;
+ extra_commands: 0;
+ extra_uploads: 0;
+ };
+ limitations: string[];
+};
+
+
type TraceEvent = {
at: string;
type: string;
@@ -4032,6 +4058,30 @@ async function gitSkippedField(): Promise<{ git_skipped?: string }> {
return reason ? { git_skipped: reason } : {};
}
+function reproducibilityEvidence(toolchain: UploadToolchain | null): UploadReproducibility {
+ return {
+ schema: 1,
+ capture: "bounded_existing_data",
+ workspace: "archive_and_turn_diffs",
+ dependencies: {
+ manifests: toolchain?.manifests.slice(0, 64) ?? [],
+ lockfiles: toolchain?.lockfiles.slice(0, 64) ?? [],
+ toolchain_recorded: Boolean(toolchain),
+ },
+ external: "metadata_only",
+ replay: "not_verified",
+ performance: {
+ extra_scans: 0,
+ extra_commands: 0,
+ extra_uploads: 0,
+ },
+ limitations: [
+ "external services and network state are metadata-only",
+ "replay verification is not performed during capture",
+ ],
+ };
+}
+
function uploadEnvironment(appVersion: string | undefined, engineVersion: string | undefined, gitVersion: string | null): UploadEnvironment {
let locale: string | null = null;
let timezone: string | null = null;
@@ -4457,7 +4507,11 @@ export class SessionUploader {
private async sessionEnvironment(root: string, waitMs?: number): Promise<UploadEnvironment> {
const environment = await this.environment();
const toolchain = this.toolchains ? await this.toolchains.get(root, waitMs).catch(() => null) : null;
- return toolchain ? { ...environment, toolchain } : environment;
+ return {
+ ...environment,
+ ...(toolchain ? { toolchain } : {}),
+ reproducibility: reproducibilityEvidence(toolchain),
+ };
}
private negotiatedTraceSchema(force = false): Promise<2 | 3> {
diff --git a/apps/server/src/toolchain.test.ts b/apps/server/src/toolchain.test.ts
index a4fd096d..7762b70c 100644
--- a/apps/server/src/toolchain.test.ts
+++ b/apps/server/src/toolchain.test.ts
@@ -317,6 +317,9 @@ test.skipIf(!hasZstd)("the upload envelope carries environment.toolchain, scrubb
assert.deepEqual(environment.toolchain.pip_freeze, ["attrs==24.2.0", "secretpkg @ url"]);
assert.deepEqual(environment.toolchain.manifests, ["package.json", "requirements.txt"]);
assert.equal(environment.toolchain.python_executable_kind, "system");
+ assert.deepEqual(environment.reproducibility.dependencies.manifests, ["package.json", "requirements.txt"]);
+ assert.equal(environment.reproducibility.dependencies.toolchain_recorded, true);
+ assert.equal(environment.reproducibility.performance.extra_scans, 0);
assert.ok(!JSON.stringify(environment.toolchain).includes("hunter2"));
for (const envelope of envelopes) {
if (envelope.environment.toolchain) assert.deepEqual(envelope.environment.toolchain, environment.toolchain);
@@ -328,6 +331,12 @@ test.skipIf(!hasZstd)("toolchain: false sends the environment block as before",
assert.ok(envelopes.length >= 1);
assert.equal("toolchain" in envelopes[0].environment, false);
assert.equal(typeof envelopes[0].environment.os, "string");
+ assert.equal(envelopes[0].environment.reproducibility.dependencies.toolchain_recorded, false);
+ assert.deepEqual(envelopes[0].environment.reproducibility.performance, {
+ extra_scans: 0,
+ extra_commands: 0,
+ extra_uploads: 0,
+ });
});
test.skipIf(!hasZstd)("an upload never waits for a slow collection: the start envelope goes without it, a later one carries it", async () => {