@workbench-ai/workbench 0.0.50 → 0.0.51

package/dist/local-archive.d.ts

@@ -1,4 +1,4 @@
-import { type CandidateRecord, type EvaluationScorecard, type HostedWorkbenchJob, type RunSummary, type RuntimeEvent, type SurfaceSnapshotFile, type WorkbenchExecutionTrace, type WorkbenchTraceSession } from "@workbench-ai/workbench-core";
+import { type CandidateRecord, type EvaluationScorecard, type HostedWorkbenchJob, type RunSummary, type RuntimeEvent, type SurfaceSnapshotFile, type WorkbenchRuntimeBundle, type WorkbenchRuntimeBundleStats, type WorkbenchRuntimeImportResult, type WorkbenchExecutionTrace, type WorkbenchTraceSession } from "@workbench-ai/workbench-core";
 export interface LocalArchiveSnapshot {
     activeId: string | null;
     candidates: CandidateRecord[];
@@ -23,6 +23,10 @@ export declare function loadLocalArchive(workspace: string): Promise<LocalArchiv
 export declare function loadLocalArchiveIndex(workspace: string): Promise<LocalArchiveIndex>;
 export declare function saveLocalArchive(workspace: string, snapshot: LocalArchiveSnapshot): Promise<void>;
 export declare function saveLocalJobs(workspace: string, jobs: readonly HostedWorkbenchJob[]): Promise<void>;
+export declare function exportLocalRuntimeBundle(workspace: string): Promise<WorkbenchRuntimeBundle>;
+export declare function importLocalRuntimeBundle(workspace: string, bundle: WorkbenchRuntimeBundle): Promise<WorkbenchRuntimeImportResult>;
+export declare function runtimeBundleStats(bundle: WorkbenchRuntimeBundle): WorkbenchRuntimeBundleStats;
+export declare function sanitizeRuntimeJobForExchange(job: HostedWorkbenchJob): HostedWorkbenchJob;
 export declare function readLocalExecutionFiles(workspace: string, jobId: string): Promise<SurfaceSnapshotFile[]>;
 export declare function readLocalCandidateRecord(workspace: string, candidateId: string): Promise<CandidateRecord>;
 export declare function readLocalCandidateFilesForId(workspace: string, candidateId: string): Promise<SurfaceSnapshotFile[]>;

package/dist/local-archive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-archive.d.ts","sourceRoot":"","sources":["../src/local-archive.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"local-archive.d.ts","sourceRoot":"","sources":["../src/local-archive.ts"],"names":[],"mappings":"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"}

package/dist/local-archive.js

@@ -1,6 +1,6 @@
 import { promises as fs } from "node:fs";
 import path from "node:path";
-import { buildWorkbenchTraceSessionsFromFiles, candidateRecordWithoutDerivedFields, selectExecutionOutputFilesForInspection, } from "@workbench-ai/workbench-core";
+import { buildWorkbenchTraceSessionsFromFiles, candidateRecordWithoutDerivedFields, sanitizeWorkbenchRuntimeCandidateForExchange, sanitizeWorkbenchRuntimeJobForExchange, selectExecutionOutputFilesForInspection, workbenchRuntimeBundleStats, workbenchSurfaceFilesEqualForExchange, } from "@workbench-ai/workbench-core";
 const RUNTIME_DIR = ".workbench/runtime";
 const CANDIDATE_RECORDS_DIR = "candidates";
 export function localRuntimeDir(workspace) {
@@ -66,6 +66,142 @@ export async function saveLocalArchive(workspace, snapshot) {
     await writeJson(path.join(root, "events.json"), snapshot.events);
 }
 export async function saveLocalJobs(workspace, jobs) {
+    if (jobs.length === 0) {
+        return;
+    }
+    await writeArchivedLocalJobs(workspace, jobs, new Map());
+}
+export async function exportLocalRuntimeBundle(workspace) {
+    const snapshot = await loadLocalArchive(workspace);
+    const jobs = (await readLocalJobs(workspace)).map(sanitizeRuntimeJobForExchange);
+    const executionFiles = await Promise.all(jobs.map(async (job) => ({
+        jobId: job.id,
+        files: await readLocalExecutionFiles(workspace, job.id),
+    })));
+    return {
+        schema: "workbench.runtime.bundle.v1",
+        activeId: snapshot.activeId,
+        candidates: snapshot.candidates.map(sanitizeWorkbenchRuntimeCandidateForExchange),
+        candidateFiles: Object.entries(snapshot.candidateFiles).map(([candidateId, files]) => ({
+            candidateId,
+            files: copySurfaceFiles(files),
+        })),
+        evaluations: snapshot.evaluations.map((evaluation) => ({ ...evaluation })),
+        runs: snapshot.runs.map((run) => ({ ...run })),
+        jobs,
+        executionFiles,
+        events: snapshot.events.map((event) => ({ ...event })),
+    };
+}
+export async function importLocalRuntimeBundle(workspace, bundle) {
+    validateRuntimeBundleSchema(bundle);
+    const snapshot = await loadLocalArchive(workspace);
+    const existingJobs = (await readLocalJobs(workspace)).map(sanitizeRuntimeJobForExchange);
+    let changed = false;
+    const existingCandidates = snapshot.candidates.map(sanitizeWorkbenchRuntimeCandidateForExchange);
+    if (JSON.stringify(existingCandidates) !== JSON.stringify(snapshot.candidates)) {
+        changed = true;
+    }
+    const incomingCandidates = bundle.candidates.map(sanitizeWorkbenchRuntimeCandidateForExchange);
+    const candidates = mergeRecordsById(existingCandidates, incomingCandidates, (candidate) => candidate.id, (didChange) => {
+        changed ||= didChange;
+    }).sort(compareLocalCandidateRecords);
+    const candidateFiles = { ...snapshot.candidateFiles };
+    for (const group of bundle.candidateFiles) {
+        const candidateId = localRecordName(group.candidateId);
+        const files = copySurfaceFiles(group.files);
+        const existing = candidateFiles[candidateId];
+        if (existing) {
+            if (!workbenchSurfaceFilesEqualForExchange(existing, files)) {
+                throw new Error(`Runtime history conflict for candidate files ${candidateId}.`);
+            }
+        }
+        else {
+            changed = true;
+        }
+        candidateFiles[candidateId] = files;
+    }
+    const candidateIds = new Set(candidates.map((candidate) => candidate.id));
+    const activeId = bundle.activeId && candidateIds.has(bundle.activeId)
+        ? bundle.activeId
+        : snapshot.activeId && candidateIds.has(snapshot.activeId)
+            ? snapshot.activeId
+            : null;
+    if (activeId !== snapshot.activeId) {
+        changed = true;
+    }
+    const evaluations = mergeRecordsById(snapshot.evaluations, bundle.evaluations, (evaluation) => evaluation.id, (didChange) => {
+        changed ||= didChange;
+    }).sort((left, right) => left.createdAt.localeCompare(right.createdAt) || left.id.localeCompare(right.id));
+    const runs = mergeRecordsById(snapshot.runs, bundle.runs, (run) => run.id, (didChange) => {
+        changed ||= didChange;
+    }).sort((left, right) => left.startedAt.localeCompare(right.startedAt) || left.id.localeCompare(right.id));
+    const events = mergeRecordsById(snapshot.events, bundle.events, runtimeEventKey, (didChange) => {
+        changed ||= didChange;
+    }).sort((left, right) => left.at.localeCompare(right.at) || left.id.localeCompare(right.id));
+    const executionFilesByJobId = new Map();
+    await Promise.all(existingJobs.map(async (job) => {
+        executionFilesByJobId.set(job.id, await readLocalExecutionFiles(workspace, job.id));
+    }));
+    for (const group of bundle.executionFiles) {
+        const jobId = localRecordName(group.jobId);
+        const files = copySurfaceFiles(group.files);
+        const existing = executionFilesByJobId.get(jobId);
+        if (existing) {
+            if (!workbenchSurfaceFilesEqualForExchange(existing, files)) {
+                throw new Error(`Runtime history conflict for execution files ${jobId}.`);
+            }
+        }
+        else {
+            changed = true;
+        }
+        executionFilesByJobId.set(jobId, files);
+    }
+    const jobs = mergeRecordsById(existingJobs, bundle.jobs.map(sanitizeRuntimeJobForExchange), (job) => job.id, (didChange) => {
+        changed ||= didChange;
+    }, runtimeJobsEqualForExchange).sort((left, right) => (left.startedAt ?? left.createdAt).localeCompare(right.startedAt ?? right.createdAt) ||
+        left.id.localeCompare(right.id));
+    await saveLocalArchive(workspace, {
+        activeId,
+        candidates,
+        candidateFiles,
+        evaluations,
+        runs,
+        events,
+    });
+    await writeArchivedLocalJobs(workspace, jobs, executionFilesByJobId);
+    return {
+        changed,
+        stats: runtimeBundleStats({
+            schema: "workbench.runtime.bundle.v1",
+            activeId,
+            candidates,
+            candidateFiles: Object.entries(candidateFiles).map(([candidateId, files]) => ({
+                candidateId,
+                files,
+            })),
+            evaluations,
+            runs,
+            jobs,
+            executionFiles: [...executionFilesByJobId.entries()].map(([jobId, files]) => ({
+                jobId,
+                files,
+            })),
+            events,
+        }),
+    };
+}
+export function runtimeBundleStats(bundle) {
+    return workbenchRuntimeBundleStats(bundle);
+}
+export function sanitizeRuntimeJobForExchange(job) {
+    return sanitizeWorkbenchRuntimeJobForExchange(job);
+}
+function sanitizeRuntimeJobForArchive(job) {
+    const { leaseUntil: _leaseUntil, wakeupLeaseUntil: _wakeupLeaseUntil, hostId: _hostId, workerId: _workerId, claimTokenHash: _claimTokenHash, ...portable } = job;
+    return { ...portable };
+}
+async function writeArchivedLocalJobs(workspace, jobs, executionFilesByJobId) {
     if (jobs.length === 0) {
         return;
     }
@@ -77,14 +213,18 @@ export async function saveLocalJobs(workspace, jobs) {
         fs.mkdir(executionFilesDir, { recursive: true }),
     ]);
     for (const job of jobs) {
+        const sanitizedJob = sanitizeRuntimeJobForArchive(job);
         const safeJobId = localRecordName(job.id);
-        const traceSourceFiles = filterArchivedExecutionFiles(completedJobOutputFiles(job));
-        const outputFiles = selectExecutionOutputFilesForInspection({
-            purpose: readExecutionPurpose(job),
-            files: traceSourceFiles,
-            output: jsonRecord(job.output),
-        });
-        await writeJson(path.join(jobsDir, `${safeJobId}.json`), archivedLocalJob(job, outputFiles, traceSourceFiles));
+        const explicitOutputFiles = executionFilesByJobId.get(job.id);
+        const traceSourceFiles = filterArchivedExecutionFiles(completedJobOutputFiles(sanitizedJob));
+        const outputFiles = explicitOutputFiles
+            ? copySurfaceFiles(explicitOutputFiles)
+            : selectExecutionOutputFilesForInspection({
+                purpose: readExecutionPurpose(sanitizedJob),
+                files: traceSourceFiles,
+                output: jsonRecord(sanitizedJob.output),
+            });
+        await writeJson(path.join(jobsDir, `${safeJobId}.json`), archivedLocalJob(sanitizedJob, outputFiles, traceSourceFiles.length > 0 ? traceSourceFiles : outputFiles));
         const filesRoot = path.join(executionFilesDir, safeJobId);
         await fs.rm(filesRoot, { force: true, recursive: true });
         await writeSurfaceFiles(filesRoot, outputFiles);
@@ -187,6 +327,70 @@ export function readLocalCandidateFiles(snapshot, candidateId) {
 function validateLocalArchiveSnapshot(snapshot) {
     validateLocalArchiveIndex(snapshot);
 }
+function validateRuntimeBundleSchema(bundle) {
+    if (!bundle || bundle.schema !== "workbench.runtime.bundle.v1") {
+        throw new Error("Unsupported Workbench runtime bundle.");
+    }
+}
+function mergeRecordsById(existing, incoming, idFor, markChanged, equal = runtimeRecordsEqual) {
+    const records = new Map();
+    for (const record of existing) {
+        records.set(localRecordName(idFor(record)), record);
+    }
+    for (const record of incoming) {
+        const id = localRecordName(idFor(record));
+        const previous = records.get(id);
+        if (!previous || !equal(previous, record)) {
+            if (previous) {
+                throw new Error(`Runtime history conflict for id ${id}.`);
+            }
+            markChanged(true);
+        }
+        records.set(id, record);
+    }
+    return [...records.values()];
+}
+function runtimeRecordsEqual(left, right) {
+    return JSON.stringify(canonicalRuntimeJson(left)) ===
+        JSON.stringify(canonicalRuntimeJson(right));
+}
+function runtimeJobsEqualForExchange(left, right) {
+    return runtimeRecordsEqual(runtimeComparableJob(left), runtimeComparableJob(right));
+}
+function runtimeComparableJob(job) {
+    const comparable = sanitizeRuntimeJobForExchange(job);
+    const output = comparable.output;
+    if (!output || typeof output !== "object" || Array.isArray(output)) {
+        return comparable;
+    }
+    const { files: _files, fileSet: _fileSet, ...portableOutput } = output;
+    return {
+        ...comparable,
+        output: portableOutput,
+    };
+}
+function canonicalRuntimeJson(value) {
+    if (Array.isArray(value)) {
+        return value.map(canonicalRuntimeJson);
+    }
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.keys(value)
+            .sort()
+            .map((key) => [key, canonicalRuntimeJson(value[key])]));
+    }
+    return value;
+}
+function runtimeEventKey(event) {
+    return [
+        event.runId ?? "_",
+        event.jobId ?? "_",
+        event.at,
+        event.id,
+    ].join("#");
+}
+function copySurfaceFiles(files) {
+    return files.map((file) => ({ ...file }));
+}
 function validateLocalArchiveIndex(snapshot) {
     const candidateIds = new Set(snapshot.candidates.map((candidate) => candidate.id));
     if (snapshot.activeId && !candidateIds.has(snapshot.activeId)) {
@@ -260,16 +464,41 @@ function compareLocalCandidateRecords(left, right) {
 }
 function archivedLocalJob(job, outputFiles, traceSourceFiles) {
     const output = jsonRecord(job.output);
-    const traceSessions = buildLocalJobTraceSessions(job, traceSourceFiles);
+    const existingTrace = readExistingTrace(job);
+    const existingTraceSessions = readExistingTraceSessions(job);
+    const traceSessions = existingTraceSessions.length > 0
+        ? existingTraceSessions
+        : buildLocalJobTraceSessions(job, traceSourceFiles);
     return {
         ...job,
         ...(Object.keys(output).length > 0
             ? { output: { ...output, files: traceSourceFiles } }
             : {}),
-        trace: buildLocalJobTrace(job),
+        trace: existingTrace ?? buildLocalJobTrace(job),
         traceSessions,
     };
 }
+function readExistingTrace(job) {
+    const trace = job.trace;
+    if (!trace || typeof trace !== "object" || Array.isArray(trace)) {
+        return null;
+    }
+    return {
+        trace_id: typeof trace.trace_id === "string" && trace.trace_id.length > 0
+            ? trace.trace_id
+            : job.id,
+        spans: Array.isArray(trace.spans) ? trace.spans : [],
+        events: Array.isArray(trace.events) ? trace.events : [],
+        summaries: Array.isArray(trace.summaries) ? trace.summaries : [],
+    };
+}
+function readExistingTraceSessions(job) {
+    const sessions = job.traceSessions;
+    if (!Array.isArray(sessions)) {
+        return [];
+    }
+    return sessions.map((session) => ({ ...session }));
+}
 function filterArchivedExecutionFiles(files) {
     return files.filter((file) => file.path.startsWith(".workbench/traces/") ||
         !isWorkbenchReservedArchivePath(file.path));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workbench-ai/workbench",
-  "version": "0.0.50",
+  "version": "0.0.51",
   "type": "module",
   "repository": {
     "type": "git",
@@ -21,9 +21,9 @@
   ],
   "dependencies": {
     "yaml": "^2.8.2",
-    "@workbench-ai/workbench-built-in-adapters": "0.0.50",
-    "@workbench-ai/workbench-protocol": "0.0.50",
-    "@workbench-ai/workbench-core": "0.0.50"
+    "@workbench-ai/workbench-core": "0.0.51",
+    "@workbench-ai/workbench-protocol": "0.0.51",
+    "@workbench-ai/workbench-built-in-adapters": "0.0.51"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.2.2",