@cat-factory/contracts 0.6.0

package/dist/sandbox.d.ts

@@ -0,0 +1,300 @@
+import * as v from 'valibot';
+/** Whether a prompt version is a read-only shipped baseline or a stored, editable candidate. */
+export declare const sandboxPromptOriginSchema: v.PicklistSchema<["baseline", "candidate"], undefined>;
+export type SandboxPromptOrigin = v.InferOutput<typeof sandboxPromptOriginSchema>;
+/**
+ * One version of a system prompt under test. A `candidate` is a stored, immutable
+ * row in a lineage: cloning a baseline creates version 1, and each save appends a
+ * new version with `version = parent.version + 1` sharing the lineage's first id as
+ * its root. `baseline` rows are never persisted — the management API synthesizes
+ * them from the live shipped prompts so they always reflect current source.
+ */
+export declare const sandboxPromptVersionSchema: v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    /** The lineage this version belongs to (the id of its v1); groups versions in the UI. */
+    readonly lineageId: v.StringSchema<undefined>;
+    /** The agent kind this prompt drives (`coder`, `reviewer`, `requirements-review`, …). */
+    readonly agentKind: v.StringSchema<undefined>;
+    /** Human label for the lineage (defaults to the agent kind on first clone). */
+    readonly name: v.StringSchema<undefined>;
+    readonly origin: v.PicklistSchema<["baseline", "candidate"], undefined>;
+    /** The system prompt text this version supplies (overrides the shipped role prompt). */
+    readonly systemText: v.StringSchema<undefined>;
+    /** The shipped baseline id this lineage derives from (e.g. a `PROMPT_VERSIONS` id), if any. */
+    readonly basePromptId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Monotonic version within the lineage; baselines are always 0. */
+    readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    /** The version this one was saved from (clone source / previous edit); null for v1. */
+    readonly parentId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Freeform labels for grouping/filtering candidate versions. */
+    readonly labels: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 40, undefined>]>, undefined>;
+    readonly createdAt: v.NumberSchema<undefined>;
+    readonly createdBy: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Soft-archive marker; archived versions are hidden from the default listing. */
+    readonly archivedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+}, undefined>;
+export type SandboxPromptVersion = v.InferOutput<typeof sandboxPromptVersionSchema>;
+/**
+ * The kind of starting point a fixture supplies. Inline kinds carry their whole
+ * input in `payload`; repo kinds point at a seed commit in the fixture repo and the
+ * agent works on an ephemeral branch off it.
+ */
+export declare const sandboxFixtureKindSchema: v.PicklistSchema<["requirements", "architecture", "code-review", "repo-feature", "repo-bug"], undefined>;
+export type SandboxFixtureKind = v.InferOutput<typeof sandboxFixtureKindSchema>;
+/** A pinned starting point in the dedicated fixture repo for a container-agent fixture. */
+export declare const sandboxRepoRefSchema: v.ObjectSchema<{
+    readonly owner: v.StringSchema<undefined>;
+    readonly name: v.StringSchema<undefined>;
+    /** A tag/branch/commit naming the reproducible seed; resolved to a SHA at dispatch. */
+    readonly seedRef: v.StringSchema<undefined>;
+}, undefined>;
+export type SandboxRepoRef = v.InferOutput<typeof sandboxRepoRefSchema>;
+/** Fixture kinds whose starting point is a repo seed (vs. an inline payload). */
+export declare const SANDBOX_REPO_FIXTURE_KINDS: readonly ['repo-feature', 'repo-bug'];
+/**
+ * The optional objective check a fixture declares, used alongside the LLM judge.
+ * `tests` runs a hidden command against the agent's produced branch (pass/fail);
+ * `findings` matches the candidate output against a set of planted expected findings.
+ */
+export declare const sandboxFixtureObjectiveSchema: v.VariantSchema<"kind", [v.ObjectSchema<{
+    readonly kind: v.LiteralSchema<"tests", undefined>;
+    /** Shell command run against the produced branch; exit 0 = pass. */
+    readonly testCmd: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>;
+}, undefined>, v.ObjectSchema<{
+    readonly kind: v.LiteralSchema<"findings", undefined>;
+    /** The genuine issues a good output should surface (matched for precision/recall). */
+    readonly expectedFindings: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+}, undefined>], undefined>;
+export type SandboxFixtureObjective = v.InferOutput<typeof sandboxFixtureObjectiveSchema>;
+export declare const sandboxFixtureSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly kind: v.PicklistSchema<["requirements", "architecture", "code-review", "repo-feature", "repo-bug"], undefined>;
+    readonly name: v.StringSchema<undefined>;
+    /** Inline input for prompt-only fixtures (the synthesized agent run context); null for repo fixtures. */
+    readonly payload: v.NullableSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
+    /** Seed for container fixtures; null for inline fixtures. */
+    readonly repoRef: v.NullableSchema<v.ObjectSchema<{
+        readonly owner: v.StringSchema<undefined>;
+        readonly name: v.StringSchema<undefined>;
+        /** A tag/branch/commit naming the reproducible seed; resolved to a SHA at dispatch. */
+        readonly seedRef: v.StringSchema<undefined>;
+    }, undefined>, undefined>;
+    /** Optional objective check; null when only the LLM judge grades this fixture. */
+    readonly objective: v.NullableSchema<v.VariantSchema<"kind", [v.ObjectSchema<{
+        readonly kind: v.LiteralSchema<"tests", undefined>;
+        /** Shell command run against the produced branch; exit 0 = pass. */
+        readonly testCmd: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>;
+    }, undefined>, v.ObjectSchema<{
+        readonly kind: v.LiteralSchema<"findings", undefined>;
+        /** The genuine issues a good output should surface (matched for precision/recall). */
+        readonly expectedFindings: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+    }, undefined>], undefined>, undefined>;
+    /** `builtin` fixtures are seeded from code; `custom` are workspace-authored. */
+    readonly origin: v.PicklistSchema<["builtin", "custom"], undefined>;
+    readonly createdAt: v.NumberSchema<undefined>;
+}, undefined>, v.CheckAction<{
+    id: string;
+    kind: "architecture" | "code-review" | "repo-bug" | "repo-feature" | "requirements";
+    name: string;
+    payload: {
+        [x: string]: unknown;
+    } | null;
+    repoRef: {
+        owner: string;
+        name: string;
+        seedRef: string;
+    } | null;
+    objective: {
+        kind: "tests";
+        testCmd: string;
+    } | {
+        kind: "findings";
+        expectedFindings: string[];
+    } | null;
+    origin: "builtin" | "custom";
+    createdAt: number;
+}, "Repo fixtures (repo-feature/repo-bug) require a repoRef and no payload; inline fixtures require a payload and no repoRef">]>;
+export type SandboxFixture = v.InferOutput<typeof sandboxFixtureSchema>;
+export declare const sandboxExperimentStatusSchema: v.PicklistSchema<["draft", "running", "done", "failed"], undefined>;
+export type SandboxExperimentStatus = v.InferOutput<typeof sandboxExperimentStatusSchema>;
+/** The grid an experiment expands: every (prompt version × model × fixture) is one cell. */
+export declare const sandboxMatrixSchema: v.ObjectSchema<{
+    readonly promptVersionIds: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    /** Model catalog ids (e.g. `anthropic:claude-opus-4-8`). */
+    readonly models: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    readonly fixtureIds: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export type SandboxMatrix = v.InferOutput<typeof sandboxMatrixSchema>;
+export declare const sandboxExperimentSchema: v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly name: v.StringSchema<undefined>;
+    /** The single agent kind every cell of this experiment exercises. */
+    readonly agentKind: v.StringSchema<undefined>;
+    /** Model catalog id of the judge (defaults to the latest Claude). */
+    readonly judgeModel: v.StringSchema<undefined>;
+    /** How many times each cell is run, to expose model nondeterminism (variance). */
+    readonly repeats: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
+    readonly status: v.PicklistSchema<["draft", "running", "done", "failed"], undefined>;
+    readonly matrix: v.ObjectSchema<{
+        readonly promptVersionIds: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        /** Model catalog ids (e.g. `anthropic:claude-opus-4-8`). */
+        readonly models: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        readonly fixtureIds: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>;
+    /** Optional hard token budget for the whole experiment; null = uncapped. */
+    readonly budgetTokens: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+    readonly createdAt: v.NumberSchema<undefined>;
+    readonly createdBy: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export type SandboxExperiment = v.InferOutput<typeof sandboxExperimentSchema>;
+export declare const sandboxRunStatusSchema: v.PicklistSchema<["queued", "running", "done", "failed"], undefined>;
+export type SandboxRunStatus = v.InferOutput<typeof sandboxRunStatusSchema>;
+export declare const sandboxTokenUsageSchema: v.ObjectSchema<{
+    readonly inputTokens: v.NumberSchema<undefined>;
+    readonly outputTokens: v.NumberSchema<undefined>;
+}, undefined>;
+export type SandboxTokenUsage = v.InferOutput<typeof sandboxTokenUsageSchema>;
+export declare const sandboxRunSchema: v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly experimentId: v.StringSchema<undefined>;
+    readonly promptVersionId: v.StringSchema<undefined>;
+    /** The exact model catalog id this cell ran (frozen from the matrix). */
+    readonly model: v.StringSchema<undefined>;
+    readonly fixtureId: v.StringSchema<undefined>;
+    /** 0-based repeat index within the cell. */
+    readonly repeatIndex: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+    readonly status: v.PicklistSchema<["queued", "running", "done", "failed"], undefined>;
+    /** The agent's captured output (prose, JSON, or a rendered diff). */
+    readonly outputText: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly usage: v.NullableSchema<v.ObjectSchema<{
+        readonly inputTokens: v.NumberSchema<undefined>;
+        readonly outputTokens: v.NumberSchema<undefined>;
+    }, undefined>, undefined>;
+    readonly latencyMs: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    /** Ephemeral work branch for container cells; null for inline cells. */
+    readonly branch: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly prUrl: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Captured diff for container cells (truncated by the harness). */
+    readonly diff: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly error: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Resolved fixture seed commit, pinned at dispatch for reproducibility. */
+    readonly seedSha: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Frozen `name@vN` label of the prompt version this cell ran. */
+    readonly promptLabel: v.StringSchema<undefined>;
+    readonly startedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    readonly finishedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+}, undefined>;
+export type SandboxRun = v.InferOutput<typeof sandboxRunSchema>;
+/** One rubric dimension's judged score (1–5) with the judge's rationale. */
+export declare const sandboxGradeDimensionSchema: v.ObjectSchema<{
+    readonly key: v.StringSchema<undefined>;
+    readonly score: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 5, undefined>]>;
+    readonly rationale: v.StringSchema<undefined>;
+}, undefined>;
+export type SandboxGradeDimension = v.InferOutput<typeof sandboxGradeDimensionSchema>;
+/** The objective check's outcome, recorded alongside (never blended into) the rubric grade. */
+export declare const sandboxObjectiveResultSchema: v.ObjectSchema<{
+    readonly kind: v.PicklistSchema<["tests", "findings"], undefined>;
+    readonly pass: v.BooleanSchema<undefined>;
+    readonly detail: v.StringSchema<undefined>;
+}, undefined>;
+export type SandboxObjectiveResult = v.InferOutput<typeof sandboxObjectiveResultSchema>;
+export declare const sandboxGradeSchema: v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly runId: v.StringSchema<undefined>;
+    /** Model catalog id of the judge that produced this grade. */
+    readonly judgeModel: v.StringSchema<undefined>;
+    readonly scores: v.ArraySchema<v.ObjectSchema<{
+        readonly key: v.StringSchema<undefined>;
+        readonly score: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 5, undefined>]>;
+        readonly rationale: v.StringSchema<undefined>;
+    }, undefined>, undefined>;
+    /** Weighted mean of the dimension scores using the task rubric weights. */
+    readonly weightedTotal: v.NumberSchema<undefined>;
+    /** Objective signal when the fixture declared one; null otherwise. */
+    readonly objective: v.NullableSchema<v.ObjectSchema<{
+        readonly kind: v.PicklistSchema<["tests", "findings"], undefined>;
+        readonly pass: v.BooleanSchema<undefined>;
+        readonly detail: v.StringSchema<undefined>;
+    }, undefined>, undefined>;
+    readonly createdAt: v.NumberSchema<undefined>;
+}, undefined>;
+export type SandboxGrade = v.InferOutput<typeof sandboxGradeSchema>;
+/** Clone a shipped baseline (or another version) into a fresh candidate lineage at v1. */
+export declare const cloneSandboxPromptSchema: v.ObjectSchema<{
+    readonly agentKind: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>;
+    /** The shipped baseline id to seed the text from (e.g. a `PROMPT_VERSIONS` id). */
+    readonly basePromptId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Lineage name; defaults to the agent kind when omitted. */
+    readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>, undefined>;
+    readonly labels: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 40, undefined>]>, undefined>, readonly []>;
+}, undefined>;
+export type CloneSandboxPromptInput = v.InferOutput<typeof cloneSandboxPromptSchema>;
+/** Save a new version onto an existing lineage (append-only edit). */
+export declare const saveSandboxVersionSchema: v.ObjectSchema<{
+    /** The version id this edit is based on (its lineage + version+1 are derived). */
+    readonly parentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly systemText: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly labels: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 40, undefined>]>, undefined>, readonly []>;
+}, undefined>;
+export type SaveSandboxVersionInput = v.InferOutput<typeof saveSandboxVersionSchema>;
+/** Replace the labels on a candidate version. */
+export declare const setSandboxLabelsSchema: v.ObjectSchema<{
+    readonly labels: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 40, undefined>]>, undefined>;
+}, undefined>;
+export type SetSandboxLabelsInput = v.InferOutput<typeof setSandboxLabelsSchema>;
+export declare const createSandboxFixtureSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    readonly kind: v.PicklistSchema<["requirements", "architecture", "code-review", "repo-feature", "repo-bug"], undefined>;
+    readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>;
+    readonly payload: v.OptionalSchema<v.NullableSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>, null>;
+    readonly repoRef: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+        readonly owner: v.StringSchema<undefined>;
+        readonly name: v.StringSchema<undefined>;
+        /** A tag/branch/commit naming the reproducible seed; resolved to a SHA at dispatch. */
+        readonly seedRef: v.StringSchema<undefined>;
+    }, undefined>, undefined>, null>;
+    readonly objective: v.OptionalSchema<v.NullableSchema<v.VariantSchema<"kind", [v.ObjectSchema<{
+        readonly kind: v.LiteralSchema<"tests", undefined>;
+        /** Shell command run against the produced branch; exit 0 = pass. */
+        readonly testCmd: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>;
+    }, undefined>, v.ObjectSchema<{
+        readonly kind: v.LiteralSchema<"findings", undefined>;
+        /** The genuine issues a good output should surface (matched for precision/recall). */
+        readonly expectedFindings: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+    }, undefined>], undefined>, undefined>, null>;
+}, undefined>, v.CheckAction<{
+    kind: "architecture" | "code-review" | "repo-bug" | "repo-feature" | "requirements";
+    name: string;
+    payload: {
+        [x: string]: unknown;
+    } | null;
+    repoRef: {
+        owner: string;
+        name: string;
+        seedRef: string;
+    } | null;
+    objective: {
+        kind: "tests";
+        testCmd: string;
+    } | {
+        kind: "findings";
+        expectedFindings: string[];
+    } | null;
+}, "Repo fixtures (repo-feature/repo-bug) require a repoRef and no payload; inline fixtures require a payload and no repoRef">]>;
+export type CreateSandboxFixtureInput = v.InferOutput<typeof createSandboxFixtureSchema>;
+/** Create an experiment (status `draft`); launching it expands the matrix into runs. */
+export declare const createSandboxExperimentSchema: v.ObjectSchema<{
+    readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>;
+    readonly agentKind: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>;
+    readonly matrix: v.ObjectSchema<{
+        readonly promptVersionIds: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        /** Model catalog ids (e.g. `anthropic:claude-opus-4-8`). */
+        readonly models: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        readonly fixtureIds: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>;
+    readonly judgeModel: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+    readonly repeats: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 20, undefined>]>, 1>;
+    readonly budgetTokens: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>, null>;
+}, undefined>;
+export type CreateSandboxExperimentInput = v.InferOutput<typeof createSandboxExperimentSchema>;
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/sandbox.d.ts.map

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

package/dist/sandbox.js

@@ -0,0 +1,243 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// Sandbox wire contracts. The Sandbox is a parallel, opt-in surface for the
+// organized testing of prompts and models: clone any shipped agent system prompt
+// into a versioned, labelled *candidate*, then run an experiment matrix (prompt
+// versions × models × fixtures) for one agent kind and grade every cell with a
+// judge model (default Claude) plus, where a fixture supports it, an objective
+// signal (a hidden test suite / a set of expected findings).
+//
+// The two questions it answers: "which model is best for this task?" (one prompt,
+// many models) and "does a better prompt help?" (one model, many prompt versions).
+//
+// Models are referenced the same way the rest of the product references them — by
+// model *catalog id* string (the `ModelOption.id` from `GET /models`, e.g.
+// `anthropic:claude-opus-4-8`) — not a structured ModelRef; the run resolves the id
+// at dispatch like any other step. Baselines are NOT persisted as rows; they are
+// read live from `@cat-factory/agents`. Only candidate versions are stored.
+// ---------------------------------------------------------------------------
+/** Whether a prompt version is a read-only shipped baseline or a stored, editable candidate. */
+export const sandboxPromptOriginSchema = v.picklist(['baseline', 'candidate']);
+const labelSchema = v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(40));
+/**
+ * One version of a system prompt under test. A `candidate` is a stored, immutable
+ * row in a lineage: cloning a baseline creates version 1, and each save appends a
+ * new version with `version = parent.version + 1` sharing the lineage's first id as
+ * its root. `baseline` rows are never persisted — the management API synthesizes
+ * them from the live shipped prompts so they always reflect current source.
+ */
+export const sandboxPromptVersionSchema = v.object({
+    id: v.string(),
+    /** The lineage this version belongs to (the id of its v1); groups versions in the UI. */
+    lineageId: v.string(),
+    /** The agent kind this prompt drives (`coder`, `reviewer`, `requirements-review`, …). */
+    agentKind: v.string(),
+    /** Human label for the lineage (defaults to the agent kind on first clone). */
+    name: v.string(),
+    origin: sandboxPromptOriginSchema,
+    /** The system prompt text this version supplies (overrides the shipped role prompt). */
+    systemText: v.string(),
+    /** The shipped baseline id this lineage derives from (e.g. a `PROMPT_VERSIONS` id), if any. */
+    basePromptId: v.nullable(v.string()),
+    /** Monotonic version within the lineage; baselines are always 0. */
+    version: v.pipe(v.number(), v.integer(), v.minValue(0)),
+    /** The version this one was saved from (clone source / previous edit); null for v1. */
+    parentId: v.nullable(v.string()),
+    /** Freeform labels for grouping/filtering candidate versions. */
+    labels: v.array(labelSchema),
+    createdAt: v.number(),
+    createdBy: v.nullable(v.string()),
+    /** Soft-archive marker; archived versions are hidden from the default listing. */
+    archivedAt: v.nullable(v.number()),
+});
+// ---- Fixtures -------------------------------------------------------------
+/**
+ * The kind of starting point a fixture supplies. Inline kinds carry their whole
+ * input in `payload`; repo kinds point at a seed commit in the fixture repo and the
+ * agent works on an ephemeral branch off it.
+ */
+export const sandboxFixtureKindSchema = v.picklist([
+    'requirements',
+    'architecture',
+    'code-review',
+    'repo-feature',
+    'repo-bug',
+]);
+/** A pinned starting point in the dedicated fixture repo for a container-agent fixture. */
+export const sandboxRepoRefSchema = v.object({
+    owner: v.string(),
+    name: v.string(),
+    /** A tag/branch/commit naming the reproducible seed; resolved to a SHA at dispatch. */
+    seedRef: v.string(),
+});
+/** Fixture kinds whose starting point is a repo seed (vs. an inline payload). */
+export const SANDBOX_REPO_FIXTURE_KINDS = ['repo-feature', 'repo-bug'];
+/**
+ * A fixture's shape must match its kind: repo kinds (`repo-feature`/`repo-bug`) carry a
+ * `repoRef` and no inline `payload`; inline kinds carry a `payload` and no `repoRef`.
+ * Enforced as a cross-field check so a contradictory fixture (e.g. a `repo-feature` with
+ * a null `repoRef`, or an inline fixture with a null `payload`) can never be stored and
+ * then crash the run driver when it resolves the seed/context at dispatch.
+ */
+const fixtureShapeMatchesKind = (input) => {
+    const isRepo = SANDBOX_REPO_FIXTURE_KINDS.includes(input.kind);
+    return isRepo
+        ? input.repoRef !== null && input.payload === null
+        : input.payload !== null && input.repoRef === null;
+};
+const FIXTURE_SHAPE_MESSAGE = 'Repo fixtures (repo-feature/repo-bug) require a repoRef and no payload; inline fixtures require a payload and no repoRef';
+/**
+ * The optional objective check a fixture declares, used alongside the LLM judge.
+ * `tests` runs a hidden command against the agent's produced branch (pass/fail);
+ * `findings` matches the candidate output against a set of planted expected findings.
+ */
+export const sandboxFixtureObjectiveSchema = v.variant('kind', [
+    v.object({
+        kind: v.literal('tests'),
+        /** Shell command run against the produced branch; exit 0 = pass. */
+        testCmd: v.pipe(v.string(), v.trim(), v.minLength(1)),
+    }),
+    v.object({
+        kind: v.literal('findings'),
+        /** The genuine issues a good output should surface (matched for precision/recall). */
+        expectedFindings: v.array(v.pipe(v.string(), v.trim(), v.minLength(1))),
+    }),
+]);
+const sandboxFixtureObjectSchema = v.object({
+    id: v.string(),
+    kind: sandboxFixtureKindSchema,
+    name: v.string(),
+    /** Inline input for prompt-only fixtures (the synthesized agent run context); null for repo fixtures. */
+    payload: v.nullable(v.record(v.string(), v.unknown())),
+    /** Seed for container fixtures; null for inline fixtures. */
+    repoRef: v.nullable(sandboxRepoRefSchema),
+    /** Optional objective check; null when only the LLM judge grades this fixture. */
+    objective: v.nullable(sandboxFixtureObjectiveSchema),
+    /** `builtin` fixtures are seeded from code; `custom` are workspace-authored. */
+    origin: v.picklist(['builtin', 'custom']),
+    createdAt: v.number(),
+});
+export const sandboxFixtureSchema = v.pipe(sandboxFixtureObjectSchema, v.check((f) => fixtureShapeMatchesKind(f), FIXTURE_SHAPE_MESSAGE));
+// ---- Experiments ----------------------------------------------------------
+export const sandboxExperimentStatusSchema = v.picklist(['draft', 'running', 'done', 'failed']);
+/** The grid an experiment expands: every (prompt version × model × fixture) is one cell. */
+export const sandboxMatrixSchema = v.object({
+    promptVersionIds: v.array(v.string()),
+    /** Model catalog ids (e.g. `anthropic:claude-opus-4-8`). */
+    models: v.array(v.string()),
+    fixtureIds: v.array(v.string()),
+});
+export const sandboxExperimentSchema = v.object({
+    id: v.string(),
+    name: v.string(),
+    /** The single agent kind every cell of this experiment exercises. */
+    agentKind: v.string(),
+    /** Model catalog id of the judge (defaults to the latest Claude). */
+    judgeModel: v.string(),
+    /** How many times each cell is run, to expose model nondeterminism (variance). */
+    repeats: v.pipe(v.number(), v.integer(), v.minValue(1)),
+    status: sandboxExperimentStatusSchema,
+    matrix: sandboxMatrixSchema,
+    /** Optional hard token budget for the whole experiment; null = uncapped. */
+    budgetTokens: v.nullable(v.pipe(v.number(), v.integer(), v.minValue(0))),
+    createdAt: v.number(),
+    createdBy: v.nullable(v.string()),
+});
+// ---- Runs (cells) ---------------------------------------------------------
+export const sandboxRunStatusSchema = v.picklist(['queued', 'running', 'done', 'failed']);
+export const sandboxTokenUsageSchema = v.object({
+    inputTokens: v.number(),
+    outputTokens: v.number(),
+});
+export const sandboxRunSchema = v.object({
+    id: v.string(),
+    experimentId: v.string(),
+    promptVersionId: v.string(),
+    /** The exact model catalog id this cell ran (frozen from the matrix). */
+    model: v.string(),
+    fixtureId: v.string(),
+    /** 0-based repeat index within the cell. */
+    repeatIndex: v.pipe(v.number(), v.integer(), v.minValue(0)),
+    status: sandboxRunStatusSchema,
+    /** The agent's captured output (prose, JSON, or a rendered diff). */
+    outputText: v.nullable(v.string()),
+    usage: v.nullable(sandboxTokenUsageSchema),
+    latencyMs: v.nullable(v.number()),
+    /** Ephemeral work branch for container cells; null for inline cells. */
+    branch: v.nullable(v.string()),
+    prUrl: v.nullable(v.string()),
+    /** Captured diff for container cells (truncated by the harness). */
+    diff: v.nullable(v.string()),
+    error: v.nullable(v.string()),
+    /** Resolved fixture seed commit, pinned at dispatch for reproducibility. */
+    seedSha: v.nullable(v.string()),
+    /** Frozen `name@vN` label of the prompt version this cell ran. */
+    promptLabel: v.string(),
+    startedAt: v.nullable(v.number()),
+    finishedAt: v.nullable(v.number()),
+});
+// ---- Grades ---------------------------------------------------------------
+/** One rubric dimension's judged score (1–5) with the judge's rationale. */
+export const sandboxGradeDimensionSchema = v.object({
+    key: v.string(),
+    score: v.pipe(v.number(), v.minValue(1), v.maxValue(5)),
+    rationale: v.string(),
+});
+/** The objective check's outcome, recorded alongside (never blended into) the rubric grade. */
+export const sandboxObjectiveResultSchema = v.object({
+    kind: v.picklist(['tests', 'findings']),
+    pass: v.boolean(),
+    detail: v.string(),
+});
+export const sandboxGradeSchema = v.object({
+    id: v.string(),
+    runId: v.string(),
+    /** Model catalog id of the judge that produced this grade. */
+    judgeModel: v.string(),
+    scores: v.array(sandboxGradeDimensionSchema),
+    /** Weighted mean of the dimension scores using the task rubric weights. */
+    weightedTotal: v.number(),
+    /** Objective signal when the fixture declared one; null otherwise. */
+    objective: v.nullable(sandboxObjectiveResultSchema),
+    createdAt: v.number(),
+});
+// ---- Request bodies -------------------------------------------------------
+/** Clone a shipped baseline (or another version) into a fresh candidate lineage at v1. */
+export const cloneSandboxPromptSchema = v.object({
+    agentKind: v.pipe(v.string(), v.trim(), v.minLength(1)),
+    /** The shipped baseline id to seed the text from (e.g. a `PROMPT_VERSIONS` id). */
+    basePromptId: v.nullable(v.string()),
+    /** Lineage name; defaults to the agent kind when omitted. */
+    name: v.optional(v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(80))),
+    labels: v.optional(v.array(labelSchema), []),
+});
+/** Save a new version onto an existing lineage (append-only edit). */
+export const saveSandboxVersionSchema = v.object({
+    /** The version id this edit is based on (its lineage + version+1 are derived). */
+    parentId: v.pipe(v.string(), v.minLength(1)),
+    systemText: v.pipe(v.string(), v.minLength(1)),
+    labels: v.optional(v.array(labelSchema), []),
+});
+/** Replace the labels on a candidate version. */
+export const setSandboxLabelsSchema = v.object({
+    labels: v.array(labelSchema),
+});
+/** Create a custom fixture in a workspace. */
+const createSandboxFixtureObjectSchema = v.object({
+    kind: sandboxFixtureKindSchema,
+    name: v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(80)),
+    payload: v.optional(v.nullable(v.record(v.string(), v.unknown())), null),
+    repoRef: v.optional(v.nullable(sandboxRepoRefSchema), null),
+    objective: v.optional(v.nullable(sandboxFixtureObjectiveSchema), null),
+});
+export const createSandboxFixtureSchema = v.pipe(createSandboxFixtureObjectSchema, v.check((f) => fixtureShapeMatchesKind(f), FIXTURE_SHAPE_MESSAGE));
+/** Create an experiment (status `draft`); launching it expands the matrix into runs. */
+export const createSandboxExperimentSchema = v.object({
+    name: v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(80)),
+    agentKind: v.pipe(v.string(), v.trim(), v.minLength(1)),
+    matrix: sandboxMatrixSchema,
+    judgeModel: v.optional(v.pipe(v.string(), v.trim(), v.minLength(1))),
+    repeats: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(20)), 1),
+    budgetTokens: v.optional(v.nullable(v.pipe(v.number(), v.integer(), v.minValue(0))), null),
+});
+//# sourceMappingURL=sandbox.js.map

package/dist/sandbox.js.map

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

package/dist/service-fragment-defaults.d.ts

@@ -0,0 +1,16 @@
+import * as v from 'valibot';
+/** A workspace's default service-fragment selection: the ids new services inherit. */
+export declare const serviceFragmentDefaultsSchema: v.ObjectSchema<{
+    readonly fragmentIds: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export type ServiceFragmentDefaults = v.InferOutput<typeof serviceFragmentDefaultsSchema>;
+/**
+ * Replace a workspace's default service-fragment selection wholesale. Ids are trimmed
+ * and must be non-empty; they are not validated against the catalog here (an
+ * unresolvable id is simply skipped when bodies are resolved at run time).
+ */
+export declare const setServiceFragmentDefaultsSchema: v.ObjectSchema<{
+    readonly fragmentIds: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+}, undefined>;
+export type SetServiceFragmentDefaultsInput = v.InferOutput<typeof setServiceFragmentDefaultsSchema>;
+//# sourceMappingURL=service-fragment-defaults.d.ts.map

package/dist/service-fragment-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-fragment-defaults.d.ts","sourceRoot":"","sources":["../src/service-fragment-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAW5B,sFAAsF;AACtF,eAAO,MAAM,6BAA6B;;aAExC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAIzF;;;;GAIG;AACH,eAAO,MAAM,gCAAgC;;aAE3C,CAAA;AACF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gCAAgC,CAAC,CAAA"}

package/dist/service-fragment-defaults.js

@@ -0,0 +1,23 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// Per-workspace default set of best-practice prompt fragments for NEW services.
+// When a service (frame block) is created in the workspace, its
+// `serviceFragmentIds` are seeded from this list. Changing the default does not
+// retroactively change existing services — each service owns its selection from
+// then on. The ids reference the universal fragment pool (built-in catalog plus
+// any deployment-registered fragments, served by GET /prompt-fragments).
+// ---------------------------------------------------------------------------
+/** A workspace's default service-fragment selection: the ids new services inherit. */
+export const serviceFragmentDefaultsSchema = v.object({
+    fragmentIds: v.array(v.string()),
+});
+// ---- Request bodies -------------------------------------------------------
+/**
+ * Replace a workspace's default service-fragment selection wholesale. Ids are trimmed
+ * and must be non-empty; they are not validated against the catalog here (an
+ * unresolvable id is simply skipped when bodies are resolved at run time).
+ */
+export const setServiceFragmentDefaultsSchema = v.object({
+    fragmentIds: v.array(v.pipe(v.string(), v.trim(), v.minLength(1))),
+});
+//# sourceMappingURL=service-fragment-defaults.js.map

package/dist/service-fragment-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-fragment-defaults.js","sourceRoot":"","sources":["../src/service-fragment-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,8EAA8E;AAC9E,gFAAgF;AAChF,gEAAgE;AAChE,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAChF,yEAAyE;AACzE,8EAA8E;AAE9E,sFAAsF;AACtF,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACjC,CAAC,CAAA;AAGF,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;CACnE,CAAC,CAAA"}