@interf/compiler 0.22.0 → 0.33.0

package/dist/packages/engine/lib/schema.js

@@ -1,730 +0,0 @@
-import { z } from "zod";
-import { ArtifactRefSchema, BuildRunStatusSchema, InterfRunEventSchema, ProofRecordSchema, RunObservabilitySchema, StageRunSchema, } from "../execution/lib/schema.js";
-import { RequestedArtifactSchema, SourcePreparationConfigSchema, SourceProfileSchema, SourceReadinessCheckSchema, } from "../../project/lib/schema.js";
-import { ArtifactSchema, ArtifactIdSchema, ArtifactPathShapeSchema, ArtifactStatusSchema, CheckSchema, LocatorSchema, PreparationNameSchema, ReadinessSchema, SourceBuildMaxAttemptsSchema, SourceBuildMaxLoopsSchema, BuildPlanIdSchema, TestTargetTypeSchema, } from "../../contracts/lib/schema.js";
-import { ReadinessCheckRunSchema, } from "../verify/lib/schema.js";
-const JsonObjectSchema = z.record(z.string(), z.unknown());
-// ───────────────────────────────────────────────────────────────────────────
-// 0.13 — preparation-first additions
-// ───────────────────────────────────────────────────────────────────────────
-/**
- * Source binding shape on the API. `local-folder` is the only kind the
- * local binary accepts in 0.17; `remote-folder` rides in the type
- * plumbing for the future cloud variant (B4.4 cloud-variant seam) and
- * is rejected at the validator branch in server.ts. See `TODO(cloud)`
- * marker there.
- */
-export const SourceBindingSchema = z.object({
-    kind: z.enum(["local-folder", "remote-folder"]),
-    locator: z.string().min(1),
-}).strict();
-/**
- * Discriminated locator for an artifact returned by the API. Aliases the
- * canonical `LocatorSchema` from contracts so all three kinds —
- * `local-path`, `remote-url`, `api-served` — flow through the same
- * resource-access pattern.
- */
-export const ArtifactLocatorSchema = LocatorSchema;
-/** Per-instance metadata from `GET /v1/instance` (replaces /v1/status). */
-export const InstanceResourceSchema = z.object({
-    kind: z.literal("interf-instance"),
-    version: z.literal(1),
-    url: z.string().min(1),
-    host: z.string().min(1),
-    port: z.number().int().min(1).max(65535),
-    started_at: z.string().min(1),
-    package_version: z.string().min(1).optional(),
-    preparation_count: z.number().int().min(0),
-    active_run_count: z.number().int().min(0),
-    idle_for_seconds: z.number().int().min(0),
-    auth_required: z.boolean(),
-    /**
-     * 0.16 — locator-pattern connection mode. `local` means the engine
-     * is bound to a loopback host the user's UI can target with OS-shell
-     * actions; `remote` means OS-open is unavailable and resources must
-     * be fetched via api-served / signed URLs.
-     */
-    connection_kind: z.enum(["local", "remote"]).optional(),
-}).strict();
-/** Body of `POST /v1/preparations` — the 0.13 preparation create request. */
-export const PreparationCreateRequestSchema = z.object({
-    id: PreparationNameSchema,
-    source: SourceBindingSchema,
-    /**
-     * Selected Build Plan id. Optional — a Preparation
-     * can be created with requested Artifacts first, then have a Build Plan
-     * selected or drafted later before the first build.
-     */
-    build_plan_id: BuildPlanIdSchema.nullable().optional(),
-    about: z.string().min(1).optional(),
-    requested_artifacts: z.array(RequestedArtifactSchema).default([]),
-    source_profile: SourceProfileSchema.optional(),
-    checks: z.array(SourceReadinessCheckSchema).default([]),
-    max_attempts: SourceBuildMaxAttemptsSchema.optional(),
-    max_loops: SourceBuildMaxLoopsSchema.optional(),
-}).strict();
-/** Body of `PATCH /v1/preparations/<id>` — update mutable preparation fields. */
-export const PreparationUpdateRequestSchema = z.object({
-    build_plan_id: BuildPlanIdSchema.nullable().optional(),
-    about: z.string().nullable().optional(),
-    /**
-     * Replace the full readiness-check list. Use the empty array to clear
-     * every check. Each item is a `SourceReadinessCheck`
-     * (`{ question, answer?, strictness?, expect? }`).
-     */
-    checks: z.array(SourceReadinessCheckSchema).optional(),
-    requested_artifacts: z.array(RequestedArtifactSchema).optional(),
-    source_profile: SourceProfileSchema.nullable().optional(),
-}).strict();
-/** Body of `POST /v1/build-plans` — save a Build Plan definition by path. */
-export const BuildPlanSaveRequestSchema = z.object({
-    source_path: z.string().min(1),
-    id: BuildPlanIdSchema.optional(),
-    overwrite: z.boolean().default(false),
-}).strict();
-export const BuildPlanSaveResultSchema = z.object({
-    build_plan_id: BuildPlanIdSchema,
-    installed: z.boolean(),
-    path: z.string().min(1),
-}).strict();
-export const PreparationDeleteResponseSchema = z.object({
-    deleted: z.boolean(),
-    id: PreparationNameSchema,
-}).strict();
-export const PreparationWireShapeSchema = z.object({
-    id: PreparationNameSchema,
-    source: SourceBindingSchema,
-    build_plan_id: BuildPlanIdSchema.nullable(),
-    about: z.string().min(1).nullable(),
-    config_path: z.string().min(1),
-    verifiable_context: ArtifactLocatorSchema,
-    checks: z.array(SourceReadinessCheckSchema).default([]),
-    requested_artifacts: z.array(RequestedArtifactSchema).default([]),
-    source_profile: SourceProfileSchema.nullable().optional(),
-}).strict();
-/**
- * The local service must only ever bind to a loopback interface. Any other
- * host (LAN IP, 0.0.0.0, public address) lets a remote browser tab POST at
- * the service, which is the CSRF model we are explicitly rejecting. Keep
- * the allowlist literal — refactoring to a `.refine()` over `z.string()`
- * would lose the static type narrowing.
- */
-export const LOCAL_SERVICE_LOOPBACK_HOSTS = ["127.0.0.1", "localhost", "::1"];
-export const LocalServiceHostSchema = z
-    .string()
-    .min(1)
-    .refine((value) => LOCAL_SERVICE_LOOPBACK_HOSTS.includes(value), {
-    message: `Local service host must be one of: ${LOCAL_SERVICE_LOOPBACK_HOSTS.join(", ")}.`,
-});
-export const LocalServicePortSchema = z.number().int().min(1).max(65535);
-/**
- * Per-instance bearer token. Generated at startup with crypto.randomBytes(32)
- * and rendered as a 64-char hex string. Any deviation should fail validation
- * loud and early.
- */
-export const LocalServiceAuthTokenSchema = z
-    .string()
-    .regex(/^[0-9a-f]{64}$/i, "Auth token must be a 64-character hex string.");
-export const LocalServiceConfigSchema = z.object({
-    host: LocalServiceHostSchema.default("127.0.0.1"),
-    port: LocalServicePortSchema.default(4873),
-}).strict();
-export const ServiceRegistryEntrySchema = z.preprocess((value) => {
-    if (!value || typeof value !== "object" || Array.isArray(value))
-        return value;
-    const { old_state_roots: _oldStateRoots, ...entry } = value;
-    return entry;
-}, z.object({
-    pid: z.number().int().positive(),
-    host: LocalServiceHostSchema,
-    port: LocalServicePortSchema,
-    url: z.string().min(1),
-    started_at: z.string().min(1),
-    /**
-     * Bearer token mutating clients must send. Optional in the schema so
-     * older registry files (pre-0.12.1) keep parsing; the runtime treats a
-     * missing token as "open" only when the entry already exists on disk —
-     * fresh entries always have one.
-     */
-    auth_token: LocalServiceAuthTokenSchema.optional(),
-}).strict());
-export const ServiceRegistrySchema = z.object({
-    services: z.array(ServiceRegistryEntrySchema).default([]),
-}).strict();
-export const LocalServiceHealthSchema = z.object({
-    kind: z.literal("interf-local-service-health"),
-    version: z.literal(1),
-    status: z.literal("ok"),
-    host: LocalServiceHostSchema,
-    port: LocalServicePortSchema,
-    service_url: z.string().min(1),
-    control_path: z.string().min(1).optional(),
-    source_folder_path: z.string().min(1).nullable().optional(),
-    started_at: z.string().min(1).optional(),
-    package_version: z.string().min(1).optional(),
-    instance_started_at: z.string().min(1).optional(),
-    active_runs: z.number().int().min(0).default(0),
-    idle_for_seconds: z.number().int().min(0).default(0),
-}).strict();
-export const LocalServiceErrorSchema = z.object({
-    error: z.object({
-        message: z.string().min(1),
-        code: z.string().min(1).optional(),
-    }).strict(),
-}).strict();
-export const VerifiableContextMappingSchema = z.object({
-    preparation: PreparationNameSchema,
-    path: z.string().min(1).nullable(),
-    exists: z.boolean(),
-    build_plan_id: BuildPlanIdSchema.nullable(),
-    latest_build_run_id: z.string().min(1).nullable(),
-    latest_test_run_id: z.string().min(1).nullable(),
-}).strict();
-export const PreparationRunLinkageSchema = z.object({
-    latest_build_run_id: z.string().min(1).nullable(),
-    latest_test_run_id: z.string().min(1).nullable(),
-}).strict();
-export const PreparationResourceSchema = z.object({
-    id: PreparationNameSchema,
-    name: PreparationNameSchema,
-    preparation: SourcePreparationConfigSchema,
-    source_path: z.string().min(1),
-    build_plan_id: BuildPlanIdSchema.nullable(),
-    checks: z.array(SourceReadinessCheckSchema).default([]),
-    requested_artifacts: z.array(RequestedArtifactSchema).default([]),
-    source_profile: SourceProfileSchema.nullable().optional(),
-    verifiable_context: VerifiableContextMappingSchema,
-    verifiable_context_path: z.string().min(1).nullable(),
-    readiness: ReadinessSchema,
-    runs: PreparationRunLinkageSchema,
-    latest_build_run_id: z.string().min(1).nullable().optional(),
-    latest_test_run_id: z.string().min(1).nullable().optional(),
-    // Per-Artifact status from the latest Build run, mirrored
-    // here so the UI/CLI can render artifact rows without a separate
-    // GET /v1/preparations/<id>/runs fetch. Empty when no Build run has
-    // produced artifacts yet.
-    artifacts: z.array(ArtifactStatusSchema).default([]),
-}).strict();
-export const BuildPlanResourceSchema = z.object({
-    id: BuildPlanIdSchema,
-    build_plan_id: BuildPlanIdSchema,
-    path: z.string().min(1),
-    label: z.string().min(1).optional(),
-    hint: z.string().min(1).optional(),
-    purpose: z.object({
-        label: z.string().min(1),
-        task_hint: z.string().min(1),
-    }).strict().optional(),
-    inputs: z.array(z.object({
-        id: ArtifactIdSchema,
-        label: z.string().min(1),
-        description: z.string().min(1),
-        required: z.boolean().default(false),
-        examples: z.array(z.string().min(1)).optional(),
-    }).strict()).default([]),
-    source_kind: z.enum(["builtin", "local"]).default("local"),
-    built_in: z.boolean().default(false),
-    active_for_preparations: z.array(PreparationNameSchema).default([]),
-    artifacts: z.array(ArtifactSchema).default([]),
-    stages: z.array(z.object({
-        id: z.string().min(1),
-        label: z.string().min(1),
-        description: z.string().min(1).optional(),
-        contract_type: z.string().min(1),
-        skill_dir: z.string().min(1),
-        /**
-         * Role hint Build Plans declare per stage. Defaults to
-         * `general` at the runtime layer; the wire shape mirrors that
-         * default so clients always see a string.
-         */
-        role: z.string().min(1).default("general"),
-        reads: z.array(z.string().min(1)).default([]),
-        writes: z.array(z.string().min(1)).default([]),
-    }).strict()).default([]),
-}).strict();
-export const BuildRunCreateRequestSchema = z.object({
-    preparation: PreparationNameSchema,
-    build_plan: BuildPlanIdSchema.optional(),
-    max_attempts: SourceBuildMaxAttemptsSchema.optional(),
-    max_loops: SourceBuildMaxLoopsSchema.optional(),
-    preserve_stage_shells: z.enum(["on-failure", "always"]).optional(),
-}).strict();
-export const BuildRunSummarySchema = z.object({
-    run_id: z.string().min(1),
-    status: BuildRunStatusSchema,
-    preparation: PreparationNameSchema,
-    build_plan: BuildPlanIdSchema,
-    verifiable_context_path: z.string().min(1),
-    started_at: z.string().nullable().optional(),
-    finished_at: z.string().nullable().optional(),
-    latest_event: InterfRunEventSchema.nullable().optional(),
-    latest_proof: ProofRecordSchema.nullable().optional(),
-}).strict();
-export const BuildRunSchema = z.object({
-    kind: z.literal("interf-build-run"),
-    version: z.literal(1),
-    run_id: z.string().min(1),
-    status: BuildRunStatusSchema,
-    preparation: PreparationNameSchema,
-    build_plan: BuildPlanIdSchema,
-    backend: z.string().min(1),
-    source_path: z.string().min(1),
-    verifiable_context_path: z.string().min(1),
-    created_at: z.string().min(1),
-    started_at: z.string().nullable().optional(),
-    finished_at: z.string().nullable().optional(),
-    stages: z.array(StageRunSchema).default([]),
-    events: z.array(InterfRunEventSchema).default([]),
-    latest_proof: ProofRecordSchema.nullable().optional(),
-    readiness: ReadinessSchema.nullable().optional(),
-    artifacts: z.array(ArtifactStatusSchema).default([]),
-}).strict();
-export const BuildRunResourceSchema = z.object({
-    run: BuildRunSchema,
-}).strict();
-export const LocalJobTypeSchema = z.enum([
-    "readiness-check-draft",
-    "build-plan-draft",
-    "build-plan-improvement",
-]);
-export const RunStatusSchema = z.enum([
-    "queued",
-    "running",
-    "succeeded",
-    "failed",
-    "cancelled",
-]);
-export const LocalJobStatusSchema = RunStatusSchema;
-export const LocalRunHandlerResultSchema = z.object({
-    ok: z.boolean(),
-    error: z.string().min(1).optional(),
-    readiness_run: ReadinessCheckRunSchema.nullable().optional(),
-}).strict();
-export const LocalJobAgentSchema = z.object({
-    name: z.string().min(1),
-    display_name: z.string().min(1),
-    command: z.string().min(1).nullable().optional(),
-}).strict();
-export const LocalExecutorOptionSchema = LocalJobAgentSchema.extend({
-    current: z.boolean(),
-}).strict();
-export const LocalJobStepSchema = z.object({
-    id: z.string().min(1),
-    label: z.string().min(1),
-    status: LocalJobStatusSchema,
-    started_at: z.string().nullable().optional(),
-    finished_at: z.string().nullable().optional(),
-    summary: z.string().min(1).nullable().optional(),
-    input: JsonObjectSchema.nullable().optional(),
-    output: JsonObjectSchema.nullable().optional(),
-}).strict();
-export const LocalJobEventTypeSchema = z.enum([
-    "job.started",
-    "step.started",
-    "log.appended",
-    "artifact.written",
-    "step.completed",
-    "step.failed",
-    "job.completed",
-    "job.failed",
-]);
-export const LocalJobEventSchema = z.object({
-    event_id: z.string().min(1),
-    run_id: z.string().min(1),
-    timestamp: z.string().min(1),
-    type: LocalJobEventTypeSchema,
-    step_id: z.string().min(1).optional(),
-    message: z.string().min(1).optional(),
-    artifact: ArtifactRefSchema.optional(),
-    input: JsonObjectSchema.nullable().optional(),
-    output: JsonObjectSchema.nullable().optional(),
-}).strict();
-export const LocalJobRunCreateRequestSchema = z.object({
-    job_type: LocalJobTypeSchema,
-    title: z.string().min(1),
-    preparation: PreparationNameSchema.nullable().optional(),
-    build_plan: BuildPlanIdSchema.nullable().optional(),
-    source_path: z.string().min(1).nullable().optional(),
-    output_path: z.string().min(1).nullable().optional(),
-    agent: LocalJobAgentSchema.nullable().optional(),
-    steps: z.array(z.object({
-        id: z.string().min(1),
-        label: z.string().min(1),
-        input: JsonObjectSchema.nullable().optional(),
-    }).strict()).default([]),
-}).strict();
-export const PreparationSetupCreateRequestSchema = z.object({
-    preparation: SourcePreparationConfigSchema,
-    build_after_setup: z.boolean().default(false),
-    setup_mode: z.enum(["create", "select-build-plan"]).default("create"),
-}).strict();
-export const PreparationSetupResultSchema = z.object({
-    kind: z.literal("interf-preparation-setup-result"),
-    version: z.literal(1),
-    operation: z.enum(["create", "select-build-plan"]),
-    preparation: PreparationNameSchema,
-    build_plan: BuildPlanIdSchema.nullable(),
-    source_folder_path: z.string().min(1),
-    config_path: z.string().min(1),
-    verifiable_context_path: z.string().min(1),
-    changed: z.boolean(),
-    message: z.string().min(1),
-    submitted_run_id: z.string().min(1).nullable().optional(),
-    submitted_run_type: z.literal("build-run").nullable().optional(),
-}).strict();
-export const BuildPlanChangeCreateRequestSchema = z.discriminatedUnion("operation", [
-    z.object({
-        action_type: z.literal("build-plan-change").optional(),
-        operation: z.literal("duplicate"),
-        build_plan: BuildPlanIdSchema,
-        new_build_plan_id: BuildPlanIdSchema,
-        label: z.string().min(1).optional(),
-        hint: z.string().min(1).optional(),
-    }).strict(),
-    z.object({
-        action_type: z.literal("build-plan-change").optional(),
-        operation: z.literal("remove"),
-        build_plan: BuildPlanIdSchema,
-        confirmation: BuildPlanIdSchema,
-    }).strict(),
-]);
-export const BuildPlanChangeResultSchema = z.object({
-    kind: z.literal("interf-build-plan-change-result"),
-    version: z.literal(1),
-    operation: z.enum(["duplicate", "remove"]),
-    build_plan: BuildPlanIdSchema,
-    new_build_plan_id: BuildPlanIdSchema.nullable().optional(),
-    updated_preparations: z.array(PreparationNameSchema).default([]),
-    build_plan_path: z.string().min(1),
-    changed: z.boolean(),
-    message: z.string().min(1),
-}).strict();
-export const PreparationChangeCreateRequestSchema = z.discriminatedUnion("operation", [
-    z.object({
-        action_type: z.literal("preparation-change").optional(),
-        operation: z.literal("remove"),
-        preparation: PreparationNameSchema,
-        confirmation: PreparationNameSchema,
-    }).strict(),
-]);
-export const PreparationChangeResultSchema = z.object({
-    kind: z.literal("interf-preparation-change-result"),
-    version: z.literal(1),
-    operation: z.literal("remove"),
-    preparation: PreparationNameSchema,
-    config_path: z.string().min(1),
-    verifiable_context_path: z.string().min(1),
-    verifiable_context_retained: z.boolean(),
-    changed: z.boolean(),
-    message: z.string().min(1),
-}).strict();
-export const ResetRequestSchema = z.object({
-    preparation: PreparationNameSchema,
-    scope: z.enum(["build", "all"]),
-}).strict();
-export const ResetResultSchema = z.object({
-    kind: z.literal("interf-reset-result"),
-    version: z.literal(1),
-    preparation: PreparationNameSchema,
-    scope: z.enum(["build", "all"]),
-    verifiable_context_path: z.string().min(1),
-    changed: z.boolean(),
-    message: z.string().min(1),
-}).strict();
-export const ReadinessCheckDraftCreateRequestSchema = z.object({
-    preparation: PreparationNameSchema,
-    source_folder_path: z.string().min(1),
-    about: z.string().min(1).optional(),
-    target_count: z.number().int().min(1).max(8).default(4),
-}).strict();
-export const ReadinessCheckDraftResultSchema = z.object({
-    checks: z.array(SourceReadinessCheckSchema).default([]),
-}).strict();
-export const BuildPlanAuthoringArtifactRequirementSchema = z.object({
-    id: ArtifactIdSchema,
-    description: z.string().min(1).optional(),
-    shape: ArtifactPathShapeSchema,
-    checks: z.array(CheckSchema).default([]),
-    stage_hint: z.string().min(1).optional(),
-}).strict();
-export const BuildPlanAuthoringCreateRequestSchema = z.object({
-    preparation: PreparationNameSchema.nullable().optional(),
-    source_folder_path: z.string().min(1),
-    base_build_plan_id: BuildPlanIdSchema.optional(),
-    reference_build_plan_id: BuildPlanIdSchema.optional(),
-    build_plan_id: BuildPlanIdSchema,
-    label: z.string().min(1),
-    hint: z.string().min(1),
-    task_prompt: z.string().min(1),
-    checks: z.array(SourceReadinessCheckSchema).default([]),
-    requested_artifacts: z.array(RequestedArtifactSchema).default([]),
-    source_profile: SourceProfileSchema.nullable().optional(),
-    artifact_requirements: z.array(BuildPlanAuthoringArtifactRequirementSchema).default([]),
-}).strict();
-export const BuildPlanAuthoringResultSchema = z.object({
-    status: z.enum(["updated", "no-change", "invalid", "executor-failed"]),
-    changed: z.boolean(),
-    summary: z.string().min(1),
-    build_plan_path: z.string().min(1),
-    shell_path: z.string().min(1),
-    validation: z.unknown().nullable().optional(),
-}).strict();
-export const LocalJobEventAppendRequestSchema = z.object({
-    type: LocalJobEventTypeSchema,
-    step_id: z.string().min(1).optional(),
-    message: z.string().min(1).optional(),
-    artifact: ArtifactRefSchema.optional(),
-    input: JsonObjectSchema.nullable().optional(),
-    output: JsonObjectSchema.nullable().optional(),
-}).strict();
-export const LocalJobRunResourceSchema = z.object({
-    kind: z.literal("interf-local-job-run"),
-    version: z.literal(1),
-    run_id: z.string().min(1),
-    job_type: LocalJobTypeSchema,
-    status: LocalJobStatusSchema,
-    title: z.string().min(1),
-    preparation: PreparationNameSchema.nullable().optional(),
-    build_plan: BuildPlanIdSchema.nullable().optional(),
-    source_path: z.string().min(1).nullable().optional(),
-    output_path: z.string().min(1).nullable().optional(),
-    agent: LocalJobAgentSchema.nullable().optional(),
-    created_at: z.string().min(1),
-    started_at: z.string().nullable().optional(),
-    finished_at: z.string().nullable().optional(),
-    steps: z.array(LocalJobStepSchema).default([]),
-    events: z.array(LocalJobEventSchema).default([]),
-    result: z.record(z.string(), z.unknown()).nullable().optional(),
-    error: z.string().min(1).nullable().optional(),
-}).strict();
-export const VerifyRunStatusSchema = RunStatusSchema;
-/**
- * Verify runs choose their judge target.
- */
-export const VerifyRunCreateRequestSchema = z.object({
-    preparation: PreparationNameSchema,
-    target: TestTargetTypeSchema.default("verifiable-context"),
-}).strict();
-export const VerifyRunResourceSchema = z.object({
-    run_id: z.string().min(1),
-    status: VerifyRunStatusSchema,
-    preparation: PreparationNameSchema,
-    source_path: z.string().min(1),
-    verifiable_context_path: z.string().min(1).nullable(),
-    started_at: z.string().nullable().optional(),
-    finished_at: z.string().nullable().optional(),
-    readiness_run: ReadinessCheckRunSchema.nullable(),
-    readiness: ReadinessSchema.nullable().optional(),
-    events: z.array(InterfRunEventSchema).default([]),
-    error: z.string().min(1).nullable().optional(),
-}).strict();
-export const RunObservabilityResourceSchema = RunObservabilitySchema;
-export const LocalExecutorStatusSchema = z.object({
-    kind: z.literal("interf-local-executor-status"),
-    version: z.literal(1),
-    status: z.enum(["connected", "unavailable"]),
-    checked_at: z.string().min(1),
-    executor: LocalJobAgentSchema.nullable(),
-    available_executors: z.array(LocalExecutorOptionSchema).default([]),
-    message: z.string().min(1),
-}).strict();
-export const LocalExecutorSelectRequestSchema = z.object({
-    agent: z.string().min(1),
-}).strict();
-export const ActionProposalTypeSchema = z.enum([
-    "clarification",
-    "readiness-check-draft",
-    "build-plan-draft",
-    "build-plan-improvement",
-    "build",
-    "test",
-]);
-export const ActionProposalPlanActionTypeSchema = z.enum([
-    "clarification",
-    "preparation-setup",
-    "preparation-change",
-    "readiness-check-draft",
-    "build-plan-draft",
-    "build-plan-change",
-    "build-plan-improvement",
-    "build",
-    "test",
-]);
-export const ActionProposalStatusSchema = z.enum([
-    "needs_clarification",
-    "awaiting_approval",
-    "approved",
-    "denied",
-    "submitted",
-    "failed",
-]);
-export const ActionClientOriginSchema = z.enum([
-    "ui-chat",
-    "cli",
-    "agent-cli",
-    "mcp",
-    "service",
-    "unknown",
-]);
-export const ActionProposalCreateRequestSchema = z.object({
-    message: z.string().min(1),
-    preparation: PreparationNameSchema.optional(),
-    client_origin: ActionClientOriginSchema.default("unknown"),
-    values: JsonObjectSchema.optional(),
-}).strict();
-export const ActionProposalPlanSchema = z.object({
-    action_type: ActionProposalPlanActionTypeSchema,
-    preparation: PreparationNameSchema.optional(),
-    build_plan: BuildPlanIdSchema.optional(),
-    values: JsonObjectSchema.optional(),
-    title: z.string().min(1).optional(),
-    summary: z.string().min(1).optional(),
-    assistant_message: z.string().min(1).optional(),
-    command_preview: z.string().min(1).optional(),
-}).strict();
-export const ActionProposalApprovalRequestSchema = z.object({
-    approved: z.boolean(),
-    note: z.string().min(1).optional(),
-}).strict();
-export const ActionProposalApprovalSchema = z.object({
-    approved: z.boolean(),
-    decided_at: z.string().min(1),
-    note: z.string().min(1).optional(),
-}).strict();
-const ActionProposalResourceBaseSchema = z.object({
-    kind: z.literal("interf-action-proposal"),
-    version: z.literal(1),
-    proposal_id: z.string().min(1),
-    status: ActionProposalStatusSchema,
-    title: z.string().min(1),
-    summary: z.string().min(1),
-    assistant_message: z.string().min(1).optional(),
-    command_preview: z.string().min(1).optional(),
-    message: z.string().min(1),
-    preparation: PreparationNameSchema.nullable().optional(),
-    build_plan: BuildPlanIdSchema.nullable().optional(),
-    client_origin: ActionClientOriginSchema.default("unknown"),
-    created_at: z.string().min(1),
-    updated_at: z.string().min(1),
-    proposed_by_executor: LocalJobAgentSchema.nullable().optional(),
-    approval: ActionProposalApprovalSchema.nullable().optional(),
-    submitted_run_id: z.string().min(1).nullable().optional(),
-    submitted_run_type: z.enum(["build-run", "verify-run", "job-run"]).nullable().optional(),
-    error: z.string().min(1).nullable().optional(),
-}).strict();
-export const ActionProposalResourceSchema = z.discriminatedUnion("action_type", [
-    ActionProposalResourceBaseSchema.extend({
-        action_type: z.literal("clarification"),
-        request: JsonObjectSchema,
-    }).strict(),
-    ActionProposalResourceBaseSchema.extend({
-        action_type: z.literal("build"),
-        request: BuildRunCreateRequestSchema,
-    }).strict(),
-    ActionProposalResourceBaseSchema.extend({
-        action_type: z.literal("test"),
-        request: VerifyRunCreateRequestSchema,
-    }).strict(),
-    ActionProposalResourceBaseSchema.extend({
-        action_type: z.literal("readiness-check-draft"),
-        request: ReadinessCheckDraftCreateRequestSchema,
-    }).strict(),
-    ActionProposalResourceBaseSchema.extend({
-        action_type: z.literal("build-plan-draft"),
-        request: BuildPlanAuthoringCreateRequestSchema,
-    }).strict(),
-    ActionProposalResourceBaseSchema.extend({
-        action_type: z.literal("build-plan-improvement"),
-        request: BuildPlanAuthoringCreateRequestSchema,
-    }).strict(),
-]);
-export const VerifiableContextResourceSchema = z.object({
-    preparation: PreparationNameSchema,
-    path: z.string().min(1),
-    exists: z.boolean(),
-    readiness: ReadinessSchema,
-    build_plan: BuildPlanIdSchema.nullable().optional(),
-    latest_build_run_id: z.string().min(1).nullable().optional(),
-    latest_test_run_id: z.string().min(1).nullable().optional(),
-    artifacts: z.array(ArtifactRefSchema).default([]),
-}).strict();
-export const ReadinessResourceSchema = ReadinessSchema;
-export const SourceFileResourceSchema = z.object({
-    preparation: PreparationNameSchema,
-    path: z.string().min(1),
-    absolute_path: z.string().min(1),
-    size_bytes: z.number().int().min(0),
-    modified_at: z.string().min(1).nullable(),
-    source_folder_path: z.string().min(1),
-}).strict();
-export const LocalServiceDiscoverySchema = z.object({
-    kind: z.literal("interf-local-service-discovery"),
-    version: z.literal(1),
-    resources: z.object({
-        instance: z.string().min(1),
-        preparations: z.string().min(1),
-        build_plans: z.string().min(1),
-        build_runs: z.string().min(1),
-        runs: z.string().min(1),
-        action_proposals: z.string().min(1),
-        executor: z.string().min(1),
-        open_path: z.string().min(1),
-        /**
-         * 0.15 — connected agents primitive. Optional during the 0.14 →
-         * 0.15 rollout so older clients don't fail discovery validation.
-         */
-        agents: z.string().min(1).optional(),
-        /**
-         * Optional resource paths for scoped helper resources.
-         */
-        readiness: z.string().min(1).optional(),
-        verifiable_contexts: z.string().min(1).optional(),
-        source_files: z.string().min(1).optional(),
-        preparation_setups: z.string().min(1).optional(),
-        preparation_changes: z.string().min(1).optional(),
-        build_plan_changes: z.string().min(1).optional(),
-        readiness_check_drafts: z.string().min(1).optional(),
-        build_plan_draft_runs: z.string().min(1).optional(),
-        build_plan_improvement_runs: z.string().min(1).optional(),
-        verify_runs: z.string().min(1).optional(),
-        reset: z.string().min(1).optional(),
-        status: z.string().min(1).optional(),
-    }).strict(),
-}).strict();
-export const OpenPathRequestSchema = z.object({
-    path: z.string().min(1),
-}).strict();
-export const OpenPathResponseSchema = z.object({
-    opened: z.boolean(),
-    path: z.string().min(1),
-}).strict();
-export const PreparationListResponseSchema = z.object({
-    preparations: z.array(PreparationWireShapeSchema),
-}).strict();
-export const BuildPlanListResponseSchema = z.object({
-    build_plans: z.array(BuildPlanResourceSchema),
-}).strict();
-export const BuildRunListResponseSchema = z.object({
-    build_runs: z.array(BuildRunResourceSchema),
-}).strict();
-export const LocalJobRunListResponseSchema = z.object({
-    jobs: z.array(LocalJobRunResourceSchema),
-}).strict();
-export const VerifyRunListResponseSchema = z.object({
-    verify_runs: z.array(VerifyRunResourceSchema),
-}).strict();
-export const RunObservabilityListResponseSchema = z.object({
-    runs: z.array(RunObservabilityResourceSchema),
-}).strict();
-export const ActionProposalListResponseSchema = z.object({
-    action_proposals: z.array(ActionProposalResourceSchema),
-}).strict();
-export const VerifiableContextListResponseSchema = z.object({
-    verifiable_contexts: z.array(VerifiableContextResourceSchema),
-}).strict();
-export const ReadinessListResponseSchema = z.object({
-    readiness: z.array(ReadinessResourceSchema),
-}).strict();
-export const SourceFileListResponseSchema = z.object({
-    source_files: z.array(SourceFileResourceSchema),
-}).strict();