@cat-factory/orchestration 0.20.0 → 0.21.0

package/dist/modules/sandbox/SandboxRunService.js

@@ -0,0 +1,248 @@
+import { assertFound, ConflictError, inlineModelRef, requireWorkspace, resolveScopedModelProvider, ValidationError, } from '@cat-factory/kernel';
+import { catFactoryObservability } from '@cat-factory/agents';
+import { SANDBOX_REPO_FIXTURE_KINDS } from '@cat-factory/contracts';
+import { expandMatrix, listBaselines, listBuiltinFixtures, rubricFor, sandboxKindMeta, versionLabel, weightedTotal, } from '@cat-factory/sandbox';
+import { generateText } from 'ai';
+import { composeExperimentDetail } from './SandboxService.js';
+import { buildJudgePrompt, coerceJudgeScores, extractJson, gradedDimensionCount, JUDGE_SYSTEM_PROMPT, objectiveFor, parseModelCatalogId, renderFixtureInput, } from './sandbox.logic.js';
+/**
+ * The Sandbox run-driver + judge. {@link launch} expands a draft experiment's matrix
+ * into cells, runs each inline candidate (one LLM call against the prompt-version's
+ * system text + the fixture's rendered input), grades it with the judge model against
+ * the task rubric, and records the deterministic objective score alongside. It drives
+ * synchronously to completion (bounded by a cell cap at create time + an optional token
+ * budget) — every cell is a single inline LLM call, so there is no durable fan-out.
+ *
+ * Container/repo fixtures (a real checkout) are not yet supported here and are refused at
+ * launch with a clear message; the builtin fixtures are all inline. Both runtimes wire
+ * this identically, so the refusal — like the run itself — is runtime-symmetric.
+ */
+export class SandboxRunService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async launch(workspaceId, experimentId) {
+        await requireWorkspace(this.deps.workspaceRepository, workspaceId);
+        const experiment = assertFound(await this.deps.sandboxExperimentRepository.get(workspaceId, experimentId), 'SandboxExperiment', experimentId);
+        if (experiment.status === 'running') {
+            throw new ConflictError('This experiment is already running.');
+        }
+        const meta = sandboxKindMeta(experiment.agentKind);
+        if (!meta)
+            throw new ValidationError(`"${experiment.agentKind}" is not a Sandbox-testable kind`);
+        if (meta.bucket === 'container') {
+            throw new ValidationError(`The "${experiment.agentKind}" agent runs in a container; container experiments are not yet supported in the Sandbox.`);
+        }
+        const provider = await this.providerFor(workspaceId);
+        const prompts = await this.resolvePrompts(workspaceId, experiment);
+        const fixtures = await this.resolveFixtures(workspaceId, experiment);
+        const rubric = rubricFor(meta.rubric);
+        // Atomically claim the run BEFORE touching the grid: the conditional transition to
+        // `running` lets exactly one concurrent launch win, so two simultaneous launches can't
+        // both clear + re-expand the grid (duplicating cells) or race the grid-clearing deletes.
+        // The fast-path read above is just a friendly early error; THIS is the authoritative gate.
+        // Validation/resolution runs first, so a bad request never mutates state or strands the
+        // experiment `running`. The `finally` below settles the terminal status from here on.
+        if (!(await this.deps.sandboxExperimentRepository.claimForRun(workspaceId, experimentId))) {
+            throw new ConflictError('This experiment is already running.');
+        }
+        // The experiment is a SCORED comparison: a cell only counts toward a successful
+        // experiment once it is actually graded. A cell that produced candidate output but
+        // whose grading failed is kept inspectable (status `done` + an error), but it does
+        // NOT make the experiment look healthy — an experiment whose every grade failed
+        // settles `failed`, not `done` with a grid of unscored `—` cells.
+        let graded = 0;
+        // Everything that mutates the grid runs INSIDE this try, so the `finally` settles the
+        // terminal status no matter where it throws — the claim above already set `running`, so
+        // a failure anywhere below can never strand the experiment in `running`.
+        try {
+            // A relaunch re-runs from scratch: drop the prior result grid (grades before runs, so
+            // the grade scoping subquery still resolves the cells) so cells don't accumulate.
+            await this.deps.sandboxGradeRepository.removeByExperiment(workspaceId, experimentId);
+            await this.deps.sandboxRunRepository.removeByExperiment(workspaceId, experimentId);
+            // Persist the queued grid first, then drive each cell. (The claim above already set
+            // the experiment `running`.)
+            const now = this.deps.clock.now();
+            const runs = expandMatrix(experiment, {
+                makeId: () => this.deps.idGenerator.next('sbr'),
+                labelFor: (id) => prompts.get(id)?.label ?? id,
+                now,
+            });
+            for (const run of runs)
+                await this.deps.sandboxRunRepository.upsert(workspaceId, run);
+            // Drive every cell synchronously to completion. The terminal status is derived from
+            // the cell outcomes and ALWAYS settled in `finally` — a thrown error (or every cell
+            // failing) leaves the experiment `failed`, never stuck `running`. NOTE: this runs the
+            // whole matrix inline in the request; the cell cap + token budget bound it, but a true
+            // durable fan-out (Workflows / pg-boss, like execution+bootstrap) is the proper home
+            // for large matrices and the tracked follow-up.
+            const budget = experiment.budgetTokens;
+            let spent = 0;
+            for (const run of runs) {
+                if (budget !== null && spent >= budget) {
+                    await this.failRun(workspaceId, run, 'Token budget exhausted before this cell ran.');
+                    continue;
+                }
+                const prompt = prompts.get(run.promptVersionId);
+                const fixture = fixtures.get(run.fixtureId);
+                if (!prompt || !fixture) {
+                    await this.failRun(workspaceId, run, prompt
+                        ? `Unknown fixture "${run.fixtureId}"`
+                        : `Unknown prompt version "${run.promptVersionId}"`);
+                    continue;
+                }
+                const taskInput = renderFixtureInput(fixture);
+                // Phase 1 — run the candidate. A failure here means the cell produced nothing,
+                // so the whole cell is `failed`.
+                let done;
+                try {
+                    const candidateRef = this.refFor(run.model);
+                    const started = this.deps.clock.now();
+                    const candidate = await generateText({
+                        model: provider.resolve(candidateRef),
+                        system: prompt.systemText,
+                        prompt: taskInput,
+                        temperature: 0.2,
+                        maxOutputTokens: 4000,
+                        providerOptions: catFactoryObservability({
+                            agentKind: `sandbox:${experiment.agentKind}`,
+                            workspaceId,
+                        }),
+                    });
+                    const latencyMs = this.deps.clock.now() - started;
+                    const usage = {
+                        inputTokens: candidate.usage.inputTokens ?? 0,
+                        outputTokens: candidate.usage.outputTokens ?? 0,
+                    };
+                    spent += usage.inputTokens + usage.outputTokens;
+                    done = {
+                        ...run,
+                        status: 'done',
+                        outputText: candidate.text,
+                        usage,
+                        latencyMs,
+                        startedAt: started,
+                        finishedAt: this.deps.clock.now(),
+                    };
+                    await this.deps.sandboxRunRepository.upsert(workspaceId, done);
+                }
+                catch (e) {
+                    await this.failRun(workspaceId, run, e instanceof Error ? e.message : String(e));
+                    continue;
+                }
+                // Phase 2 — grade the cell (rubric + objective). A grading failure must NOT
+                // discard the candidate output: keep the `done` run and record the grading error
+                // on it so the produced output stays inspectable.
+                try {
+                    const judgeRef = this.refFor(experiment.judgeModel);
+                    const judged = await generateText({
+                        model: provider.resolve(judgeRef),
+                        system: JUDGE_SYSTEM_PROMPT,
+                        prompt: buildJudgePrompt(rubric, taskInput, done.outputText ?? '', expectationsOf(fixture)),
+                        temperature: 0,
+                        maxOutputTokens: 2000,
+                        providerOptions: catFactoryObservability({ agentKind: 'sandbox:judge', workspaceId }),
+                    });
+                    spent += (judged.usage.inputTokens ?? 0) + (judged.usage.outputTokens ?? 0);
+                    // Treat an unparseable / empty / reasoning-only judge reply as a grading
+                    // FAILURE rather than recording a confident weightedTotal ≈ 1.0: if the judge
+                    // scored not a single rubric dimension, coerceJudgeScores would silently floor
+                    // every dimension to 1, which is indistinguishable from a real bottom grade and
+                    // would pollute the comparison grid. Throw instead so the cell records the error.
+                    const parsed = extractJson(judged.text);
+                    if (gradedDimensionCount(rubric, parsed) === 0) {
+                        throw new Error('The judge returned no parseable rubric scores (empty or non-JSON reply).');
+                    }
+                    const scores = coerceJudgeScores(rubric, parsed);
+                    const grade = {
+                        id: this.deps.idGenerator.next('sbg'),
+                        runId: run.id,
+                        judgeModel: experiment.judgeModel,
+                        scores,
+                        weightedTotal: weightedTotal(meta.rubric, scores),
+                        objective: objectiveFor(fixture, done.outputText ?? ''),
+                        createdAt: this.deps.clock.now(),
+                    };
+                    await this.deps.sandboxGradeRepository.upsert(workspaceId, grade);
+                    graded++;
+                }
+                catch (e) {
+                    await this.deps.sandboxRunRepository.upsert(workspaceId, {
+                        ...done,
+                        error: `Grading failed: ${e instanceof Error ? e.message : String(e)}`,
+                    });
+                }
+            }
+        }
+        finally {
+            // Settle the terminal status from the outcomes: any cell that was actually graded
+            // → `done`, otherwise `failed` (every candidate failed, OR every grade failed — the
+            // grid carries no usable scores either way). This always runs, so the experiment is
+            // never left `running`.
+            await this.deps.sandboxExperimentRepository.setStatus(workspaceId, experimentId, graded > 0 ? 'done' : 'failed');
+        }
+        return this.detail(workspaceId, experimentId);
+    }
+    // ---- internals ------------------------------------------------------------
+    async failRun(workspaceId, run, error) {
+        await this.deps.sandboxRunRepository.upsert(workspaceId, {
+            ...run,
+            status: 'failed',
+            error,
+            finishedAt: this.deps.clock.now(),
+        });
+    }
+    /** Resolve every prompt version referenced by the matrix to its system text + label. */
+    async resolvePrompts(workspaceId, experiment) {
+        const baselines = listBaselines(this.deps.clock.now());
+        const map = new Map();
+        for (const id of new Set(experiment.matrix.promptVersionIds)) {
+            if (id.startsWith('baseline:')) {
+                const baseline = baselines.find((b) => b.id === id);
+                if (!baseline)
+                    throw new ValidationError(`Unknown baseline prompt "${id}"`);
+                map.set(id, { systemText: baseline.systemText, label: baseline.name });
+            }
+            else {
+                const version = assertFound(await this.deps.sandboxPromptVersionRepository.get(workspaceId, id), 'SandboxPromptVersion', id);
+                map.set(id, { systemText: version.systemText, label: versionLabel(version) });
+            }
+        }
+        return map;
+    }
+    /** Resolve every fixture referenced by the matrix (stored, else builtin), refusing repo fixtures. */
+    async resolveFixtures(workspaceId, experiment) {
+        const builtins = new Map(listBuiltinFixtures(this.deps.clock.now()).map((f) => [f.id, f]));
+        const map = new Map();
+        for (const id of new Set(experiment.matrix.fixtureIds)) {
+            const fixture = (await this.deps.sandboxFixtureRepository.get(workspaceId, id)) ?? builtins.get(id);
+            if (!fixture)
+                throw new ValidationError(`Unknown fixture "${id}"`);
+            if (SANDBOX_REPO_FIXTURE_KINDS.includes(fixture.kind)) {
+                throw new ValidationError(`Fixture "${fixture.name}" needs a repository checkout; repo fixtures are not yet supported in the Sandbox.`);
+            }
+            map.set(id, fixture);
+        }
+        return map;
+    }
+    /** The model provider for a workspace's scope (per-scope DB pool, else the static one). */
+    async providerFor(workspaceId) {
+        const provider = await resolveScopedModelProvider(workspaceId, this.deps);
+        if (!provider)
+            throw new ValidationError('No model provider is configured for the Sandbox');
+        return provider;
+    }
+    /** A catalog id → inline-servable {@link ModelRef} (subscription models degrade to the default). */
+    refFor(modelId) {
+        const resolved = this.deps.resolveModelId?.(modelId) ?? parseModelCatalogId(modelId);
+        return inlineModelRef(resolved, this.deps.defaultModelRef ?? resolved);
+    }
+    detail(workspaceId, experimentId) {
+        return composeExperimentDetail(this.deps, workspaceId, experimentId);
+    }
+}
+function expectationsOf(fixture) {
+    return fixture.objective?.kind === 'findings' ? fixture.objective.expectations : [];
+}
+//# sourceMappingURL=SandboxRunService.js.map

package/dist/modules/sandbox/SandboxRunService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SandboxRunService.js","sourceRoot":"","sources":["../../../src/modules/sandbox/SandboxRunService.ts"],"names":[],"mappings":"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"}

package/dist/modules/sandbox/SandboxService.d.ts

@@ -0,0 +1,94 @@
+import type { Clock, IdGenerator, ModelRef, SandboxExperiment, SandboxExperimentRepository, SandboxFixture, SandboxFixtureRepository, SandboxGrade, SandboxGradeRepository, SandboxPromptVersion, SandboxPromptVersionRepository, SandboxRun, SandboxRunRepository, WorkspaceRepository } from '@cat-factory/kernel';
+import type { CreateSandboxExperimentInput, CreateSandboxFixtureInput, CloneSandboxPromptInput, SaveSandboxVersionInput, SetSandboxLabelsInput } from '@cat-factory/contracts';
+import { type SandboxAgentKindMeta } from '@cat-factory/sandbox';
+/** A safety ceiling on how many cells one experiment may expand to (cost guard). */
+export declare const MAX_SANDBOX_CELLS = 100;
+/** The composed experiment view: the experiment plus its result grid (cells + grades). */
+export interface SandboxExperimentDetail {
+    experiment: SandboxExperiment;
+    runs: SandboxRun[];
+    grades: SandboxGrade[];
+}
+/** The three repositories needed to compose an {@link SandboxExperimentDetail}. */
+export interface SandboxDetailRepositories {
+    sandboxExperimentRepository: SandboxExperimentRepository;
+    sandboxRunRepository: SandboxRunRepository;
+    sandboxGradeRepository: SandboxGradeRepository;
+}
+/**
+ * Load an experiment and its result grid (cells + grades). Shared by the read endpoint
+ * (`SandboxService.getExperiment`) and the run-driver's returned grid
+ * (`SandboxRunService.launch`) so the two can never compose a divergent detail shape.
+ */
+export declare function composeExperimentDetail(repos: SandboxDetailRepositories, workspaceId: string, experimentId: string): Promise<SandboxExperimentDetail>;
+/** The opt-in Sandbox overview the management surface loads on open. */
+export interface SandboxOverview {
+    agentKinds: readonly SandboxAgentKindMeta[];
+    prompts: SandboxPromptVersion[];
+    fixtures: SandboxFixture[];
+    experiments: SandboxExperiment[];
+    /**
+     * The matrix cell cap (the cost guard {@link MAX_SANDBOX_CELLS} enforced at create). Surfaced
+     * so the UI gates the builder on the SAME limit instead of re-encoding the literal, which
+     * would silently disagree if the cap ever changes.
+     */
+    maxCells: number;
+}
+export interface SandboxServiceDependencies {
+    sandboxPromptVersionRepository: SandboxPromptVersionRepository;
+    sandboxFixtureRepository: SandboxFixtureRepository;
+    sandboxExperimentRepository: SandboxExperimentRepository;
+    sandboxRunRepository: SandboxRunRepository;
+    sandboxGradeRepository: SandboxGradeRepository;
+    workspaceRepository: WorkspaceRepository;
+    idGenerator: IdGenerator;
+    clock: Clock;
+    /** The routing default model ref, used to default an experiment's judge model. */
+    defaultModelRef?: ModelRef;
+}
+/**
+ * Management CRUD for the Sandbox (the parallel prompt/model testing surface): the
+ * shipped baselines + stored candidate prompt versions, the fixture library (builtins
+ * seeded lazily on first list, plus workspace-authored ones), and experiment definitions
+ * + their result grids. Running an experiment lives in {@link SandboxRunService}; this
+ * service is the persistence-facing half. Everything is workspace-scoped.
+ */
+export declare class SandboxService {
+    private readonly deps;
+    constructor(deps: SandboxServiceDependencies);
+    /** The full opt-in overview the UI loads when the Sandbox surface opens. */
+    overview(workspaceId: string): Promise<SandboxOverview>;
+    /** The shipped baselines (synthetic) followed by stored candidate versions. */
+    listPrompts(workspaceId: string, agentKind?: string): Promise<SandboxPromptVersion[]>;
+    /** Clone a shipped baseline into a fresh editable candidate lineage at version 1. */
+    clonePrompt(workspaceId: string, input: CloneSandboxPromptInput): Promise<SandboxPromptVersion>;
+    /** Append a new candidate version. The parent may be a baseline (starts a lineage) or a candidate. */
+    saveVersion(workspaceId: string, input: SaveSandboxVersionInput): Promise<SandboxPromptVersion>;
+    /** Replace a candidate version's labels. */
+    setLabels(workspaceId: string, id: string, input: SetSandboxLabelsInput): Promise<SandboxPromptVersion>;
+    /** Soft-archive a candidate version (hidden from the default listing). */
+    archivePrompt(workspaceId: string, id: string): Promise<void>;
+    /** The fixture library, seeding the builtin fixtures on first use. */
+    listFixtures(workspaceId: string): Promise<SandboxFixture[]>;
+    /** Create a workspace-authored fixture. */
+    createFixture(workspaceId: string, input: CreateSandboxFixtureInput): Promise<SandboxFixture>;
+    /** Remove a workspace-authored fixture. Builtin fixtures cannot be removed. */
+    removeFixture(workspaceId: string, id: string): Promise<void>;
+    listExperiments(workspaceId: string): Promise<SandboxExperiment[]>;
+    /** An experiment with its result grid (cells + grades). */
+    getExperiment(workspaceId: string, id: string): Promise<SandboxExperimentDetail>;
+    /** Create a draft experiment. Launching it (the run-driver) expands + grades the matrix. */
+    createExperiment(workspaceId: string, input: CreateSandboxExperimentInput): Promise<SandboxExperiment>;
+    /** Resolve the shipped baseline a clone derives from (by base-prompt id, else by kind). */
+    private resolveBaseline;
+    /** Seed the builtin fixture library for a workspace that has none yet. Idempotent. */
+    private ensureBuiltinFixtures;
+    /**
+     * The judge model to use when the caller didn't pick one: the deployment's routing
+     * default. We do NOT guess a provider — if no default is configured (e.g. a minimal
+     * deployment), require an explicit `judgeModel` at create time rather than defaulting to
+     * a vendor that may have no key, which would otherwise fail every cell's grade at launch.
+     */
+    private defaultJudgeModel;
+}
+//# sourceMappingURL=SandboxService.d.ts.map

package/dist/modules/sandbox/SandboxService.d.ts.map

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

package/dist/modules/sandbox/SandboxService.js

@@ -0,0 +1,227 @@
+import { assertFound, ConflictError, requireWorkspace, ValidationError } from '@cat-factory/kernel';
+import { cellCount, firstVersionFromBaseline, isRunnableMatrix, listBaselines, listBuiltinFixtures, nextVersion, SANDBOX_AGENT_KINDS, baselineVersionId, sandboxKindMeta, } from '@cat-factory/sandbox';
+/** A safety ceiling on how many cells one experiment may expand to (cost guard). */
+export const MAX_SANDBOX_CELLS = 100;
+/**
+ * Load an experiment and its result grid (cells + grades). Shared by the read endpoint
+ * (`SandboxService.getExperiment`) and the run-driver's returned grid
+ * (`SandboxRunService.launch`) so the two can never compose a divergent detail shape.
+ */
+export async function composeExperimentDetail(repos, workspaceId, experimentId) {
+    const experiment = assertFound(await repos.sandboxExperimentRepository.get(workspaceId, experimentId), 'SandboxExperiment', experimentId);
+    const [runs, grades] = await Promise.all([
+        repos.sandboxRunRepository.listByExperiment(workspaceId, experimentId),
+        repos.sandboxGradeRepository.listByExperiment(workspaceId, experimentId),
+    ]);
+    return { experiment, runs, grades };
+}
+/**
+ * Management CRUD for the Sandbox (the parallel prompt/model testing surface): the
+ * shipped baselines + stored candidate prompt versions, the fixture library (builtins
+ * seeded lazily on first list, plus workspace-authored ones), and experiment definitions
+ * + their result grids. Running an experiment lives in {@link SandboxRunService}; this
+ * service is the persistence-facing half. Everything is workspace-scoped.
+ */
+export class SandboxService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** The full opt-in overview the UI loads when the Sandbox surface opens. */
+    async overview(workspaceId) {
+        await requireWorkspace(this.deps.workspaceRepository, workspaceId);
+        const [prompts, fixtures, experiments] = await Promise.all([
+            this.listPrompts(workspaceId),
+            this.listFixtures(workspaceId),
+            this.deps.sandboxExperimentRepository.list(workspaceId),
+        ]);
+        return {
+            agentKinds: SANDBOX_AGENT_KINDS,
+            prompts,
+            fixtures,
+            experiments,
+            maxCells: MAX_SANDBOX_CELLS,
+        };
+    }
+    // ---- prompt versions ------------------------------------------------------
+    /** The shipped baselines (synthetic) followed by stored candidate versions. */
+    async listPrompts(workspaceId, agentKind) {
+        await requireWorkspace(this.deps.workspaceRepository, workspaceId);
+        const baselines = listBaselines(this.deps.clock.now());
+        const candidates = agentKind
+            ? await this.deps.sandboxPromptVersionRepository.listByKind(workspaceId, agentKind)
+            : await this.deps.sandboxPromptVersionRepository.list(workspaceId);
+        const baseSlice = agentKind ? baselines.filter((b) => b.agentKind === agentKind) : baselines;
+        return [...baseSlice, ...candidates];
+    }
+    /** Clone a shipped baseline into a fresh editable candidate lineage at version 1. */
+    async clonePrompt(workspaceId, input) {
+        await requireWorkspace(this.deps.workspaceRepository, workspaceId);
+        const source = this.resolveBaseline(input.agentKind, input.basePromptId);
+        const meta = sandboxKindMeta(input.agentKind);
+        const name = input.name ?? meta?.label ?? input.agentKind;
+        const version = firstVersionFromBaseline({
+            agentKind: source.agentKind,
+            systemText: source.systemText,
+            basePromptId: source.basePromptId,
+        }, name, {
+            id: this.deps.idGenerator.next('sbp'),
+            createdAt: this.deps.clock.now(),
+            createdBy: null,
+            labels: input.labels ?? [],
+        });
+        await this.deps.sandboxPromptVersionRepository.upsert(workspaceId, version);
+        return version;
+    }
+    /** Append a new candidate version. The parent may be a baseline (starts a lineage) or a candidate. */
+    async saveVersion(workspaceId, input) {
+        await requireWorkspace(this.deps.workspaceRepository, workspaceId);
+        const fields = {
+            id: this.deps.idGenerator.next('sbp'),
+            createdAt: this.deps.clock.now(),
+            createdBy: null,
+            labels: input.labels ?? [],
+        };
+        if (input.parentId.startsWith('baseline:')) {
+            const baseline = listBaselines(this.deps.clock.now()).find((b) => b.id === input.parentId);
+            if (!baseline)
+                throw new ValidationError(`Unknown baseline prompt "${input.parentId}"`);
+            const meta = sandboxKindMeta(baseline.agentKind);
+            const version = firstVersionFromBaseline({
+                agentKind: baseline.agentKind,
+                systemText: input.systemText,
+                basePromptId: baseline.basePromptId,
+            }, meta?.label ?? baseline.agentKind, fields);
+            await this.deps.sandboxPromptVersionRepository.upsert(workspaceId, version);
+            return version;
+        }
+        const parent = assertFound(await this.deps.sandboxPromptVersionRepository.get(workspaceId, input.parentId), 'SandboxPromptVersion', input.parentId);
+        const version = nextVersion(parent, input.systemText, fields);
+        await this.deps.sandboxPromptVersionRepository.upsert(workspaceId, version);
+        return version;
+    }
+    /** Replace a candidate version's labels. */
+    async setLabels(workspaceId, id, input) {
+        await requireWorkspace(this.deps.workspaceRepository, workspaceId);
+        const existing = assertFound(await this.deps.sandboxPromptVersionRepository.get(workspaceId, id), 'SandboxPromptVersion', id);
+        const updated = { ...existing, labels: input.labels };
+        await this.deps.sandboxPromptVersionRepository.upsert(workspaceId, updated);
+        return updated;
+    }
+    /** Soft-archive a candidate version (hidden from the default listing). */
+    async archivePrompt(workspaceId, id) {
+        await requireWorkspace(this.deps.workspaceRepository, workspaceId);
+        await this.deps.sandboxPromptVersionRepository.archive(workspaceId, id, this.deps.clock.now());
+    }
+    // ---- fixtures -------------------------------------------------------------
+    /** The fixture library, seeding the builtin fixtures on first use. */
+    async listFixtures(workspaceId) {
+        await requireWorkspace(this.deps.workspaceRepository, workspaceId);
+        await this.ensureBuiltinFixtures(workspaceId);
+        return this.deps.sandboxFixtureRepository.list(workspaceId);
+    }
+    /** Create a workspace-authored fixture. */
+    async createFixture(workspaceId, input) {
+        await requireWorkspace(this.deps.workspaceRepository, workspaceId);
+        const fixture = {
+            id: this.deps.idGenerator.next('sbf'),
+            kind: input.kind,
+            name: input.name,
+            payload: input.payload ?? null,
+            repoRef: input.repoRef ?? null,
+            objective: input.objective ?? null,
+            origin: 'custom',
+            createdAt: this.deps.clock.now(),
+        };
+        await this.deps.sandboxFixtureRepository.upsert(workspaceId, fixture);
+        return fixture;
+    }
+    /** Remove a workspace-authored fixture. Builtin fixtures cannot be removed. */
+    async removeFixture(workspaceId, id) {
+        await requireWorkspace(this.deps.workspaceRepository, workspaceId);
+        const existing = await this.deps.sandboxFixtureRepository.get(workspaceId, id);
+        if (existing?.origin === 'builtin') {
+            throw new ConflictError('Builtin fixtures cannot be deleted.');
+        }
+        await this.deps.sandboxFixtureRepository.remove(workspaceId, id);
+    }
+    // ---- experiments ----------------------------------------------------------
+    async listExperiments(workspaceId) {
+        await requireWorkspace(this.deps.workspaceRepository, workspaceId);
+        return this.deps.sandboxExperimentRepository.list(workspaceId);
+    }
+    /** An experiment with its result grid (cells + grades). */
+    async getExperiment(workspaceId, id) {
+        await requireWorkspace(this.deps.workspaceRepository, workspaceId);
+        return composeExperimentDetail(this.deps, workspaceId, id);
+    }
+    /** Create a draft experiment. Launching it (the run-driver) expands + grades the matrix. */
+    async createExperiment(workspaceId, input) {
+        await requireWorkspace(this.deps.workspaceRepository, workspaceId);
+        const meta = sandboxKindMeta(input.agentKind);
+        if (!meta) {
+            throw new ValidationError(`"${input.agentKind}" is not a Sandbox-testable agent kind`);
+        }
+        // Refuse container kinds up front: the in-product run driver only runs inline cells,
+        // so a container experiment could be persisted but never launched. Reject at create
+        // time rather than leaving an un-launchable draft in the workspace.
+        if (meta.bucket === 'container') {
+            throw new ValidationError(`The "${input.agentKind}" agent runs in a container; container experiments are not yet supported in the Sandbox.`);
+        }
+        if (!isRunnableMatrix(input.matrix)) {
+            throw new ValidationError('The experiment matrix needs at least one prompt, model and fixture');
+        }
+        const repeats = input.repeats ?? 1;
+        const total = cellCount(input.matrix, repeats);
+        if (total > MAX_SANDBOX_CELLS) {
+            throw new ValidationError(`This matrix expands to ${total} cells; the limit is ${MAX_SANDBOX_CELLS}. Narrow the selection.`);
+        }
+        const experiment = {
+            id: this.deps.idGenerator.next('sbx'),
+            name: input.name,
+            agentKind: input.agentKind,
+            judgeModel: input.judgeModel ?? this.defaultJudgeModel(),
+            repeats,
+            status: 'draft',
+            matrix: input.matrix,
+            budgetTokens: input.budgetTokens ?? null,
+            createdAt: this.deps.clock.now(),
+            createdBy: null,
+        };
+        await this.deps.sandboxExperimentRepository.upsert(workspaceId, experiment);
+        return experiment;
+    }
+    // ---- internals ------------------------------------------------------------
+    /** Resolve the shipped baseline a clone derives from (by base-prompt id, else by kind). */
+    resolveBaseline(agentKind, basePromptId) {
+        const baselines = listBaselines(this.deps.clock.now());
+        const wantedId = basePromptId ? `baseline:${basePromptId}` : baselineVersionId(agentKind);
+        const source = baselines.find((b) => b.id === wantedId) ?? baselines.find((b) => b.agentKind === agentKind);
+        if (!source)
+            throw new ValidationError(`No baseline prompt for agent kind "${agentKind}"`);
+        return source;
+    }
+    /** Seed the builtin fixture library for a workspace that has none yet. Idempotent. */
+    async ensureBuiltinFixtures(workspaceId) {
+        const current = await this.deps.sandboxFixtureRepository.list(workspaceId);
+        if (current.length > 0)
+            return;
+        for (const fixture of listBuiltinFixtures(this.deps.clock.now())) {
+            await this.deps.sandboxFixtureRepository.upsert(workspaceId, fixture);
+        }
+    }
+    /**
+     * The judge model to use when the caller didn't pick one: the deployment's routing
+     * default. We do NOT guess a provider — if no default is configured (e.g. a minimal
+     * deployment), require an explicit `judgeModel` at create time rather than defaulting to
+     * a vendor that may have no key, which would otherwise fail every cell's grade at launch.
+     */
+    defaultJudgeModel() {
+        const ref = this.deps.defaultModelRef;
+        if (!ref) {
+            throw new ValidationError('No default model is configured for the Sandbox judge; specify judgeModel explicitly.');
+        }
+        return `${ref.provider}:${ref.model}`;
+    }
+}
+//# sourceMappingURL=SandboxService.js.map

package/dist/modules/sandbox/SandboxService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SandboxService.js","sourceRoot":"","sources":["../../../src/modules/sandbox/SandboxService.ts"],"names":[],"mappings":"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"}