@interf/compiler 0.22.2 → 0.33.0

package/dist/packages/runtime/schemas/build-plans.js

@@ -0,0 +1,107 @@
+import { z } from "zod";
+import { BuildPlanAuthoringBriefInputSchema, BuildPlanAuthoringBriefSchema, } from "../../build-plans/authoring/brief.js";
+import { ArtifactSchema, ContextCheckDeclarationSchema, ArtifactIdSchema, ProjectIdSchema, BuildPlanIdSchema, } from "../../contracts/lib/schema.js";
+export { BuildPlanAuthoringArtifactRequirementSchema, BuildPlanAuthoringBriefInputSchema, BuildPlanAuthoringBriefSchema, BuildPlanContextCheckDraftSchema, RequestedArtifactSchema, SourceContextSchema, } from "../../build-plans/authoring/brief.js";
+/** 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 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(),
+    brief: BuildPlanAuthoringBriefSchema.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_projects: z.array(ProjectIdSchema).default([]),
+    context_checks: z.array(ContextCheckDeclarationSchema).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 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_projects: z.array(ProjectIdSchema).default([]),
+    build_plan_path: z.string().min(1),
+    changed: z.boolean(),
+    message: z.string().min(1),
+}).strict();
+export const BuildPlanAuthoringCreateRequestSchema = BuildPlanAuthoringBriefInputSchema.extend({
+    project: ProjectIdSchema.nullable().optional(),
+    /**
+     * Runtime-only Source locator.
+     *
+     * Project-scoped service routes fill this from the saved Project binding.
+     * Clients should not send it; keeping it optional here lets queued action
+     * proposals and internal handlers share one request shape without making the
+     * public API duplicate Project state.
+     */
+    source_folder_path: z.string().min(1).optional(),
+    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).optional(),
+}).strict();
+export const BuildPlanAuthoringRuntimeRequestSchema = BuildPlanAuthoringCreateRequestSchema.extend({
+    source_folder_path: z.string().min(1),
+}).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 BuildPlanListResponseSchema = z.object({
+    build_plans: z.array(BuildPlanResourceSchema),
+}).strict();

package/dist/packages/runtime/schemas/files.d.ts

@@ -0,0 +1,567 @@
+import { z } from "zod";
+import { BuildEvidenceResourceSchema, type BuildEvidenceResource } from "../../contracts/lib/schema.js";
+/**
+ * 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 declare const ArtifactLocatorSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        "local-path": "local-path";
+        "remote-url": "remote-url";
+        "api-served": "api-served";
+    }>;
+    value: z.ZodString;
+}, z.core.$strict>;
+export declare const ContextGraphResourceSchema: z.ZodObject<{
+    kind: z.ZodOptional<z.ZodLiteral<"interf-context-graph">>;
+    version: z.ZodOptional<z.ZodLiteral<1>>;
+    graph_id: z.ZodOptional<z.ZodString>;
+    project_id: z.ZodOptional<z.ZodString>;
+    build_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodOptional<z.ZodString>;
+    is_latest: z.ZodOptional<z.ZodBoolean>;
+    project: z.ZodString;
+    path: z.ZodString;
+    exists: z.ZodBoolean;
+    readiness: z.ZodObject<{
+        kind: z.ZodLiteral<"interf-readiness-state">;
+        version: z.ZodLiteral<1>;
+        generated_at: z.ZodString;
+        project: z.ZodString;
+        status: z.ZodEnum<{
+            failed: "failed";
+            ready: "ready";
+            "not-configured": "not-configured";
+            "not-built": "not-built";
+            building: "building";
+            built: "built";
+            checking: "checking";
+            "not-ready": "not-ready";
+            stale: "stale";
+        }>;
+        ready: z.ZodBoolean;
+        summary: z.ZodString;
+        context_graph_path: z.ZodNullable<z.ZodString>;
+        latest_build_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        latest_benchmark_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        build: z.ZodNullable<z.ZodObject<{
+            gate: z.ZodEnum<{
+                "context-graph": "context-graph";
+                "project-config": "project-config";
+                "build-run": "build-run";
+                "artifact-diagnostics": "artifact-diagnostics";
+                "context-checks": "context-checks";
+                benchmarks: "benchmarks";
+                "benchmarks-current": "benchmarks-current";
+            }>;
+            ok: z.ZodBoolean;
+            status: z.ZodOptional<z.ZodEnum<{
+                failed: "failed";
+                ready: "ready";
+                "not-configured": "not-configured";
+                "not-built": "not-built";
+                building: "building";
+                built: "built";
+                checking: "checking";
+                "not-ready": "not-ready";
+                stale: "stale";
+            }>>;
+            summary: z.ZodString;
+            detail: z.ZodOptional<z.ZodString>;
+            run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            artifact_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>;
+        check_results: z.ZodObject<{
+            configured: z.ZodNumber;
+            fingerprint: z.ZodNullable<z.ZodString>;
+            source_files: z.ZodNullable<z.ZodObject<{
+                passed: z.ZodNumber;
+                total: z.ZodNumber;
+                pass_rate: z.ZodNullable<z.ZodNumber>;
+                checks_fingerprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                stale: z.ZodDefault<z.ZodBoolean>;
+                run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                run_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>>;
+            context_graph: z.ZodNullable<z.ZodObject<{
+                passed: z.ZodNumber;
+                total: z.ZodNumber;
+                pass_rate: z.ZodNullable<z.ZodNumber>;
+                checks_fingerprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                stale: z.ZodDefault<z.ZodBoolean>;
+                run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                run_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            gate: z.ZodEnum<{
+                "context-graph": "context-graph";
+                "project-config": "project-config";
+                "build-run": "build-run";
+                "artifact-diagnostics": "artifact-diagnostics";
+                "context-checks": "context-checks";
+                benchmarks: "benchmarks";
+                "benchmarks-current": "benchmarks-current";
+            }>;
+            ok: z.ZodBoolean;
+            status: z.ZodOptional<z.ZodEnum<{
+                failed: "failed";
+                ready: "ready";
+                "not-configured": "not-configured";
+                "not-built": "not-built";
+                building: "building";
+                built: "built";
+                checking: "checking";
+                "not-ready": "not-ready";
+                stale: "stale";
+            }>>;
+            summary: z.ZodString;
+            detail: z.ZodOptional<z.ZodString>;
+            run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            artifact_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+    build_plan: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    latest_build_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    latest_benchmark_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        role: z.ZodEnum<{
+            runtime: "runtime";
+            output: "output";
+            source: "source";
+            evidence: "evidence";
+            benchmark: "benchmark";
+        }>;
+        stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        label: z.ZodOptional<z.ZodString>;
+        sha256: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    build_evidence: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodLiteral<"interf-build-evidence">;
+        version: z.ZodLiteral<1>;
+        generated_at: z.ZodString;
+        project_id: z.ZodString;
+        build_run_id: z.ZodNullable<z.ZodString>;
+        ready: z.ZodBoolean;
+        summary: z.ZodString;
+        rows: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            assertion: z.ZodString;
+            metric: z.ZodObject<{
+                observed: z.ZodNumber;
+                total: z.ZodOptional<z.ZodNumber>;
+                unit: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+            evidence: z.ZodObject<{
+                kind: z.ZodEnum<{
+                    output: "output";
+                    "source-inventory": "source-inventory";
+                    "stage-record": "stage-record";
+                    validator: "validator";
+                    trace: "trace";
+                    "stage-evidence": "stage-evidence";
+                }>;
+                label: z.ZodString;
+                ref: z.ZodOptional<z.ZodString>;
+                path: z.ZodOptional<z.ZodString>;
+                run_id: z.ZodOptional<z.ZodString>;
+                stage_id: z.ZodOptional<z.ZodString>;
+                artifact_id: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+            issue_state: z.ZodOptional<z.ZodEnum<{
+                pass: "pass";
+                fail: "fail";
+                missing: "missing";
+                review: "review";
+            }>>;
+            issue: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const ContextGraphListResponseSchema: z.ZodObject<{
+    graphs: z.ZodArray<z.ZodObject<{
+        kind: z.ZodOptional<z.ZodLiteral<"interf-context-graph">>;
+        version: z.ZodOptional<z.ZodLiteral<1>>;
+        graph_id: z.ZodOptional<z.ZodString>;
+        project_id: z.ZodOptional<z.ZodString>;
+        build_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        created_at: z.ZodOptional<z.ZodString>;
+        is_latest: z.ZodOptional<z.ZodBoolean>;
+        project: z.ZodString;
+        path: z.ZodString;
+        exists: z.ZodBoolean;
+        readiness: z.ZodObject<{
+            kind: z.ZodLiteral<"interf-readiness-state">;
+            version: z.ZodLiteral<1>;
+            generated_at: z.ZodString;
+            project: z.ZodString;
+            status: z.ZodEnum<{
+                failed: "failed";
+                ready: "ready";
+                "not-configured": "not-configured";
+                "not-built": "not-built";
+                building: "building";
+                built: "built";
+                checking: "checking";
+                "not-ready": "not-ready";
+                stale: "stale";
+            }>;
+            ready: z.ZodBoolean;
+            summary: z.ZodString;
+            context_graph_path: z.ZodNullable<z.ZodString>;
+            latest_build_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            latest_benchmark_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            build: z.ZodNullable<z.ZodObject<{
+                gate: z.ZodEnum<{
+                    "context-graph": "context-graph";
+                    "project-config": "project-config";
+                    "build-run": "build-run";
+                    "artifact-diagnostics": "artifact-diagnostics";
+                    "context-checks": "context-checks";
+                    benchmarks: "benchmarks";
+                    "benchmarks-current": "benchmarks-current";
+                }>;
+                ok: z.ZodBoolean;
+                status: z.ZodOptional<z.ZodEnum<{
+                    failed: "failed";
+                    ready: "ready";
+                    "not-configured": "not-configured";
+                    "not-built": "not-built";
+                    building: "building";
+                    built: "built";
+                    checking: "checking";
+                    "not-ready": "not-ready";
+                    stale: "stale";
+                }>>;
+                summary: z.ZodString;
+                detail: z.ZodOptional<z.ZodString>;
+                run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                artifact_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>>;
+            check_results: z.ZodObject<{
+                configured: z.ZodNumber;
+                fingerprint: z.ZodNullable<z.ZodString>;
+                source_files: z.ZodNullable<z.ZodObject<{
+                    passed: z.ZodNumber;
+                    total: z.ZodNumber;
+                    pass_rate: z.ZodNullable<z.ZodNumber>;
+                    checks_fingerprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    stale: z.ZodDefault<z.ZodBoolean>;
+                    run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    run_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strict>>;
+                context_graph: z.ZodNullable<z.ZodObject<{
+                    passed: z.ZodNumber;
+                    total: z.ZodNumber;
+                    pass_rate: z.ZodNullable<z.ZodNumber>;
+                    checks_fingerprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    stale: z.ZodDefault<z.ZodBoolean>;
+                    run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    run_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>;
+            checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                gate: z.ZodEnum<{
+                    "context-graph": "context-graph";
+                    "project-config": "project-config";
+                    "build-run": "build-run";
+                    "artifact-diagnostics": "artifact-diagnostics";
+                    "context-checks": "context-checks";
+                    benchmarks: "benchmarks";
+                    "benchmarks-current": "benchmarks-current";
+                }>;
+                ok: z.ZodBoolean;
+                status: z.ZodOptional<z.ZodEnum<{
+                    failed: "failed";
+                    ready: "ready";
+                    "not-configured": "not-configured";
+                    "not-built": "not-built";
+                    building: "building";
+                    built: "built";
+                    checking: "checking";
+                    "not-ready": "not-ready";
+                    stale: "stale";
+                }>>;
+                summary: z.ZodString;
+                detail: z.ZodOptional<z.ZodString>;
+                run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                artifact_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>;
+        build_plan: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        latest_build_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        latest_benchmark_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            role: z.ZodEnum<{
+                runtime: "runtime";
+                output: "output";
+                source: "source";
+                evidence: "evidence";
+                benchmark: "benchmark";
+            }>;
+            stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            label: z.ZodOptional<z.ZodString>;
+            sha256: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        build_evidence: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodLiteral<"interf-build-evidence">;
+            version: z.ZodLiteral<1>;
+            generated_at: z.ZodString;
+            project_id: z.ZodString;
+            build_run_id: z.ZodNullable<z.ZodString>;
+            ready: z.ZodBoolean;
+            summary: z.ZodString;
+            rows: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                assertion: z.ZodString;
+                metric: z.ZodObject<{
+                    observed: z.ZodNumber;
+                    total: z.ZodOptional<z.ZodNumber>;
+                    unit: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
+                evidence: z.ZodObject<{
+                    kind: z.ZodEnum<{
+                        output: "output";
+                        "source-inventory": "source-inventory";
+                        "stage-record": "stage-record";
+                        validator: "validator";
+                        trace: "trace";
+                        "stage-evidence": "stage-evidence";
+                    }>;
+                    label: z.ZodString;
+                    ref: z.ZodOptional<z.ZodString>;
+                    path: z.ZodOptional<z.ZodString>;
+                    run_id: z.ZodOptional<z.ZodString>;
+                    stage_id: z.ZodOptional<z.ZodString>;
+                    artifact_id: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
+                issue_state: z.ZodOptional<z.ZodEnum<{
+                    pass: "pass";
+                    fail: "fail";
+                    missing: "missing";
+                    review: "review";
+                }>>;
+                issue: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const ReadinessResourceSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"interf-readiness-state">;
+    version: z.ZodLiteral<1>;
+    generated_at: z.ZodString;
+    project: z.ZodString;
+    status: z.ZodEnum<{
+        failed: "failed";
+        ready: "ready";
+        "not-configured": "not-configured";
+        "not-built": "not-built";
+        building: "building";
+        built: "built";
+        checking: "checking";
+        "not-ready": "not-ready";
+        stale: "stale";
+    }>;
+    ready: z.ZodBoolean;
+    summary: z.ZodString;
+    context_graph_path: z.ZodNullable<z.ZodString>;
+    latest_build_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    latest_benchmark_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    build: z.ZodNullable<z.ZodObject<{
+        gate: z.ZodEnum<{
+            "context-graph": "context-graph";
+            "project-config": "project-config";
+            "build-run": "build-run";
+            "artifact-diagnostics": "artifact-diagnostics";
+            "context-checks": "context-checks";
+            benchmarks: "benchmarks";
+            "benchmarks-current": "benchmarks-current";
+        }>;
+        ok: z.ZodBoolean;
+        status: z.ZodOptional<z.ZodEnum<{
+            failed: "failed";
+            ready: "ready";
+            "not-configured": "not-configured";
+            "not-built": "not-built";
+            building: "building";
+            built: "built";
+            checking: "checking";
+            "not-ready": "not-ready";
+            stale: "stale";
+        }>>;
+        summary: z.ZodString;
+        detail: z.ZodOptional<z.ZodString>;
+        run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        artifact_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>;
+    check_results: z.ZodObject<{
+        configured: z.ZodNumber;
+        fingerprint: z.ZodNullable<z.ZodString>;
+        source_files: z.ZodNullable<z.ZodObject<{
+            passed: z.ZodNumber;
+            total: z.ZodNumber;
+            pass_rate: z.ZodNullable<z.ZodNumber>;
+            checks_fingerprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            stale: z.ZodDefault<z.ZodBoolean>;
+            run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            run_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>;
+        context_graph: z.ZodNullable<z.ZodObject<{
+            passed: z.ZodNumber;
+            total: z.ZodNumber;
+            pass_rate: z.ZodNullable<z.ZodNumber>;
+            checks_fingerprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            stale: z.ZodDefault<z.ZodBoolean>;
+            run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            run_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        gate: z.ZodEnum<{
+            "context-graph": "context-graph";
+            "project-config": "project-config";
+            "build-run": "build-run";
+            "artifact-diagnostics": "artifact-diagnostics";
+            "context-checks": "context-checks";
+            benchmarks: "benchmarks";
+            "benchmarks-current": "benchmarks-current";
+        }>;
+        ok: z.ZodBoolean;
+        status: z.ZodOptional<z.ZodEnum<{
+            failed: "failed";
+            ready: "ready";
+            "not-configured": "not-configured";
+            "not-built": "not-built";
+            building: "building";
+            built: "built";
+            checking: "checking";
+            "not-ready": "not-ready";
+            stale: "stale";
+        }>>;
+        summary: z.ZodString;
+        detail: z.ZodOptional<z.ZodString>;
+        run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        artifact_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export declare const SourceFileResourceSchema: z.ZodObject<{
+    project: z.ZodString;
+    source_manifest_id: z.ZodOptional<z.ZodString>;
+    source_file_id: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
+    locator: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        image: "image";
+        pdf: "pdf";
+        document: "document";
+        spreadsheet: "spreadsheet";
+        presentation: "presentation";
+        text: "text";
+        other: "other";
+    }>>;
+    absolute_path: z.ZodString;
+    size_bytes: z.ZodNumber;
+    modified_at: z.ZodNullable<z.ZodString>;
+    source_folder_path: z.ZodString;
+}, z.core.$strict>;
+export declare const SourceFileListResponseSchema: z.ZodObject<{
+    source_files: z.ZodArray<z.ZodObject<{
+        project: z.ZodString;
+        source_manifest_id: z.ZodOptional<z.ZodString>;
+        source_file_id: z.ZodOptional<z.ZodString>;
+        path: z.ZodString;
+        locator: z.ZodOptional<z.ZodString>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            image: "image";
+            pdf: "pdf";
+            document: "document";
+            spreadsheet: "spreadsheet";
+            presentation: "presentation";
+            text: "text";
+            other: "other";
+        }>>;
+        absolute_path: z.ZodString;
+        size_bytes: z.ZodNumber;
+        modified_at: z.ZodNullable<z.ZodString>;
+        source_folder_path: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const SourceManifestResourceSchema: z.ZodObject<{
+    source_manifest: z.ZodObject<{
+        kind: z.ZodLiteral<"interf-source-manifest">;
+        version: z.ZodLiteral<1>;
+        manifest_id: z.ZodString;
+        generated_at: z.ZodString;
+        run_id: z.ZodNullable<z.ZodString>;
+        project: z.ZodString;
+        source: z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                "local-folder": "local-folder";
+            }>;
+            locator: z.ZodString;
+        }, z.core.$strict>;
+        scanner: z.ZodObject<{
+            executor: z.ZodString;
+            agent_label: z.ZodString;
+            attempt: z.ZodNumber;
+        }, z.core.$strict>;
+        source_total: z.ZodNumber;
+        files: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            locator: z.ZodString;
+            path: z.ZodString;
+            kind: z.ZodDefault<z.ZodEnum<{
+                image: "image";
+                pdf: "pdf";
+                document: "document";
+                spreadsheet: "spreadsheet";
+                presentation: "presentation";
+                text: "text";
+                other: "other";
+            }>>;
+            size_bytes: z.ZodOptional<z.ZodNumber>;
+            content_hash: z.ZodOptional<z.ZodString>;
+            page_count: z.ZodOptional<z.ZodNumber>;
+            inspectable_units: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    page: "page";
+                    slide: "slide";
+                    sheet: "sheet";
+                    table: "table";
+                    image: "image";
+                    section: "section";
+                }>;
+                index: z.ZodOptional<z.ZodNumber>;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            confidence: z.ZodDefault<z.ZodEnum<{
+                high: "high";
+                medium: "medium";
+                low: "low";
+            }>>;
+            evidence: z.ZodArray<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    "agent-observation": "agent-observation";
+                    "connector-metadata": "connector-metadata";
+                    "user-provided": "user-provided";
+                }>;
+                summary: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        warnings: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ArtifactLocator = z.infer<typeof ArtifactLocatorSchema>;
+export type ContextGraphResource = z.infer<typeof ContextGraphResourceSchema>;
+export type ContextGraphListResponse = z.infer<typeof ContextGraphListResponseSchema>;
+export { BuildEvidenceResourceSchema };
+export type { BuildEvidenceResource };
+export type ReadinessResource = z.infer<typeof ReadinessResourceSchema>;
+export type SourceFileResource = z.infer<typeof SourceFileResourceSchema>;
+export type SourceFileListResponse = z.infer<typeof SourceFileListResponseSchema>;
+export type SourceManifestResource = z.infer<typeof SourceManifestResourceSchema>;