@interf/compiler 0.22.2 → 0.33.0

package/dist/packages/runtime/service/operations.d.ts

@@ -0,0 +1,1490 @@
+import { z, type ZodType } from "zod";
+export type ServiceOperationVisibility = "public" | "app" | "admin" | "internal";
+export type HttpMethod = "GET" | "POST" | "PATCH" | "DELETE";
+export interface ServiceOperationParameter {
+    name: string;
+    in: "path" | "query" | "header";
+    required: boolean;
+    description: string;
+    schema: ZodType;
+}
+export interface ServiceOperation {
+    id: string;
+    method: HttpMethod;
+    path: string;
+    tags: string[];
+    summary: string;
+    description: string;
+    visibility: ServiceOperationVisibility;
+    workflow_step?: number;
+    request_schema?: ZodType;
+    response_schema?: ZodType;
+    response_content_type?: "application/json" | "text/plain" | "application/octet-stream";
+    success_status: number;
+    parameters?: ServiceOperationParameter[];
+}
+declare const EmptyObjectSchema: z.ZodObject<{}, z.core.$strict>;
+export declare const SERVICE_OPERATIONS: readonly [{
+    readonly id: "getHealth";
+    readonly method: "GET";
+    readonly path: "/health";
+    readonly tags: ["Instance"];
+    readonly summary: "Check local service health";
+    readonly description: "Small tokenless liveness probe for local clients.";
+    readonly visibility: "public";
+    readonly response_schema: z.ZodObject<{
+        kind: z.ZodLiteral<"interf-local-service-health">;
+        version: z.ZodLiteral<1>;
+        status: z.ZodLiteral<"ok">;
+        host: z.ZodString;
+        port: z.ZodNumber;
+        service_url: z.ZodString;
+        control_path: z.ZodOptional<z.ZodString>;
+        source_folder_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        started_at: z.ZodOptional<z.ZodString>;
+        package_version: z.ZodOptional<z.ZodString>;
+        instance_started_at: z.ZodOptional<z.ZodString>;
+        active_runs: z.ZodDefault<z.ZodNumber>;
+        idle_for_seconds: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>;
+    readonly success_status: 200;
+}, {
+    readonly id: "getInstance";
+    readonly method: "GET";
+    readonly path: "/v1/instance";
+    readonly tags: ["Instance"];
+    readonly summary: "Get instance metadata";
+    readonly description: "Return local service metadata without Project or Source contents.";
+    readonly visibility: "public";
+    readonly response_schema: z.ZodObject<{
+        kind: z.ZodLiteral<"interf-instance">;
+        version: z.ZodLiteral<1>;
+        url: z.ZodString;
+        host: z.ZodString;
+        port: z.ZodNumber;
+        pid: z.ZodOptional<z.ZodNumber>;
+        started_at: z.ZodString;
+        uptime_seconds: z.ZodOptional<z.ZodNumber>;
+        package_version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        project_count: z.ZodNumber;
+        active_run_count: z.ZodNumber;
+        idle_for_seconds: z.ZodNumber;
+        auth_required: z.ZodBoolean;
+        owner_kind: z.ZodOptional<z.ZodEnum<{
+            "desktop-app": "desktop-app";
+            headless: "headless";
+        }>>;
+        owner_pid: z.ZodOptional<z.ZodNumber>;
+        agent_count: z.ZodOptional<z.ZodNumber>;
+        default_agent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        connection_kind: z.ZodOptional<z.ZodEnum<{
+            local: "local";
+            remote: "remote";
+        }>>;
+    }, z.core.$strict>;
+    readonly success_status: 200;
+}, {
+    readonly id: "getOpenApi";
+    readonly method: "GET";
+    readonly path: "/v1/openapi.json";
+    readonly tags: ["Instance"];
+    readonly summary: "Get OpenAPI contract";
+    readonly description: "Return the generated OpenAPI document for the local service API.";
+    readonly visibility: "public";
+    readonly response_schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    readonly success_status: 200;
+}, {
+    readonly id: "createProject";
+    readonly method: "POST";
+    readonly path: "/v1/projects";
+    readonly tags: ["Projects"];
+    readonly summary: "Create Project";
+    readonly description: "Create a Project bound to one Source. Project ids may be generated by clients.";
+    readonly visibility: "app";
+    readonly workflow_step: 1;
+    readonly request_schema: z.ZodObject<{
+        id: z.ZodString;
+        source: z.ZodObject<{
+            kind: z.ZodLiteral<"local-folder">;
+            locator: z.ZodString;
+        }, z.core.$strict>;
+        build_plan_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+    readonly response_schema: z.ZodObject<{
+        id: z.ZodString;
+        project_id: z.ZodOptional<z.ZodString>;
+        source: z.ZodObject<{
+            kind: z.ZodLiteral<"local-folder">;
+            locator: z.ZodString;
+        }, z.core.$strict>;
+        build_plan_id: z.ZodNullable<z.ZodString>;
+        config_path: z.ZodString;
+        context_graph: z.ZodObject<{
+            kind: z.ZodEnum<{
+                "local-path": "local-path";
+                "remote-url": "remote-url";
+                "api-served": "api-served";
+            }>;
+            value: z.ZodString;
+        }, z.core.$strict>;
+        context_graph_path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly success_status: 201;
+}, {
+    readonly id: "getProject";
+    readonly method: "GET";
+    readonly path: "/v1/projects/{project_id}";
+    readonly tags: ["Projects"];
+    readonly summary: "Get Project";
+    readonly description: "Read one Project to confirm its Source binding, selected Build Plan, readiness, and latest Context Graph.";
+    readonly visibility: "app";
+    readonly parameters: [ServiceOperationParameter];
+    readonly response_schema: z.ZodObject<{
+        id: z.ZodString;
+        project_id: z.ZodOptional<z.ZodString>;
+        source: z.ZodObject<{
+            kind: z.ZodLiteral<"local-folder">;
+            locator: z.ZodString;
+        }, z.core.$strict>;
+        build_plan_id: z.ZodNullable<z.ZodString>;
+        config_path: z.ZodString;
+        context_graph: z.ZodObject<{
+            kind: z.ZodEnum<{
+                "local-path": "local-path";
+                "remote-url": "remote-url";
+                "api-served": "api-served";
+            }>;
+            value: z.ZodString;
+        }, z.core.$strict>;
+        context_graph_path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly success_status: 200;
+}, {
+    readonly id: "prepareBuildPlan";
+    readonly method: "POST";
+    readonly path: "/v1/projects/{project_id}/build-plan-drafts";
+    readonly tags: ["Build Plans"];
+    readonly summary: "Prepare Build Plan";
+    readonly description: "Draft a Build Plan from the approved intent, Context Checks, and requested Artifacts. This does not run a Build.";
+    readonly visibility: "app";
+    readonly workflow_step: 2;
+    readonly parameters: [ServiceOperationParameter];
+    readonly request_schema: z.ZodObject<{
+        checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            evidence: z.ZodOptional<z.ZodString>;
+            evidence_expectation: z.ZodOptional<z.ZodString>;
+            backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        label: z.ZodString;
+        context_checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            evidence: z.ZodOptional<z.ZodString>;
+            evidence_expectation: z.ZodOptional<z.ZodString>;
+            backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        intent: z.ZodString;
+        requested_artifacts: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            title: z.ZodString;
+            purpose: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            checks: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                label: z.ZodString;
+            }, z.core.$strict>]>>>;
+            output: z.ZodOptional<z.ZodObject<{
+                path: z.ZodOptional<z.ZodString>;
+                shape: z.ZodOptional<z.ZodObject<{
+                    kind: z.ZodLiteral<"path">;
+                    path: z.ZodString;
+                    artifact_kind: z.ZodEnum<{
+                        file: "file";
+                        directory: "directory";
+                    }>;
+                }, z.core.$strict>>;
+                checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    kind: z.ZodEnum<{
+                        file_exists: "file_exists";
+                        source_manifest_valid: "source_manifest_valid";
+                        min_file_count: "min_file_count";
+                        min_file_count_matches_source: "min_file_count_matches_source";
+                        source_summary_folders: "source_summary_folders";
+                        source_page_coverage: "source_page_coverage";
+                        frontmatter_valid: "frontmatter_valid";
+                        frontmatter_required_keys: "frontmatter_required_keys";
+                        frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
+                        source_refs_required: "source_refs_required";
+                        wikilinks_valid: "wikilinks_valid";
+                        must_not_contain: "must_not_contain";
+                        must_contain: "must_contain";
+                        qa_match: "qa_match";
+                    }>;
+                    description: z.ZodOptional<z.ZodString>;
+                    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    required: z.ZodDefault<z.ZodBoolean>;
+                }, z.core.$strict>>>;
+                stage_hint: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>>>;
+        user_prep_instructions: z.ZodOptional<z.ZodString>;
+        source_context: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            summary: z.ZodOptional<z.ZodString>;
+            items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                path: z.ZodOptional<z.ZodString>;
+                kind: z.ZodOptional<z.ZodString>;
+                page_count: z.ZodOptional<z.ZodNumber>;
+                note: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            observations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            limitations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>>;
+        artifact_requirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            shape: z.ZodObject<{
+                kind: z.ZodLiteral<"path">;
+                path: z.ZodString;
+                artifact_kind: z.ZodEnum<{
+                    file: "file";
+                    directory: "directory";
+                }>;
+            }, z.core.$strict>;
+            checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                kind: z.ZodEnum<{
+                    file_exists: "file_exists";
+                    source_manifest_valid: "source_manifest_valid";
+                    min_file_count: "min_file_count";
+                    min_file_count_matches_source: "min_file_count_matches_source";
+                    source_summary_folders: "source_summary_folders";
+                    source_page_coverage: "source_page_coverage";
+                    frontmatter_valid: "frontmatter_valid";
+                    frontmatter_required_keys: "frontmatter_required_keys";
+                    frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
+                    source_refs_required: "source_refs_required";
+                    wikilinks_valid: "wikilinks_valid";
+                    must_not_contain: "must_not_contain";
+                    must_contain: "must_contain";
+                    qa_match: "qa_match";
+                }>;
+                description: z.ZodOptional<z.ZodString>;
+                params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                required: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strict>>>;
+            stage_hint: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        build_plan_id: z.ZodString;
+        hint: z.ZodOptional<z.ZodString>;
+        base_build_plan_id: z.ZodOptional<z.ZodString>;
+        reference_build_plan_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly response_schema: z.ZodObject<{
+        kind: z.ZodLiteral<"interf-local-job-run">;
+        version: z.ZodLiteral<1>;
+        run_id: z.ZodString;
+        job_type: z.ZodEnum<{
+            "benchmark-question-draft": "benchmark-question-draft";
+            "build-plan-draft": "build-plan-draft";
+            "build-plan-improvement": "build-plan-improvement";
+        }>;
+        status: z.ZodEnum<{
+            running: "running";
+            failed: "failed";
+            cancelled: "cancelled";
+            queued: "queued";
+            succeeded: "succeeded";
+        }>;
+        title: z.ZodString;
+        project: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        build_plan: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        source_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        output_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        agent: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            name: z.ZodString;
+            display_name: z.ZodString;
+            command: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>>;
+        created_at: z.ZodString;
+        started_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        finished_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            status: z.ZodEnum<{
+                running: "running";
+                failed: "failed";
+                cancelled: "cancelled";
+                queued: "queued";
+                succeeded: "succeeded";
+            }>;
+            started_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            finished_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            input: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            output: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        }, z.core.$strict>>>;
+        events: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            event_id: z.ZodString;
+            run_id: z.ZodString;
+            timestamp: z.ZodString;
+            type: z.ZodEnum<{
+                "artifact.written": "artifact.written";
+                "log.appended": "log.appended";
+                "job.started": "job.started";
+                "step.started": "step.started";
+                "step.completed": "step.completed";
+                "step.failed": "step.failed";
+                "job.completed": "job.completed";
+                "job.failed": "job.failed";
+            }>;
+            step_id: z.ZodOptional<z.ZodString>;
+            message: z.ZodOptional<z.ZodString>;
+            artifact: z.ZodOptional<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>>;
+            input: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            output: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        }, z.core.$strict>>>;
+        result: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+    readonly success_status: 202;
+}, {
+    readonly id: "runBuild";
+    readonly method: "POST";
+    readonly path: "/v1/projects/{project_id}/build-runs";
+    readonly tags: ["Build Runs"];
+    readonly summary: "Run Build";
+    readonly description: "Run the selected Build Plan and create an isolated Context Graph folder. Use only after Build Plan approval or explicit autonomy.";
+    readonly visibility: "app";
+    readonly workflow_step: 3;
+    readonly parameters: [ServiceOperationParameter];
+    readonly request_schema: z.ZodDefault<z.ZodObject<{
+        max_attempts: z.ZodOptional<z.ZodNumber>;
+        max_loops: z.ZodOptional<z.ZodNumber>;
+        preserve_stage_shells: z.ZodOptional<z.ZodEnum<{
+            "on-failure": "on-failure";
+            always: "always";
+        }>>;
+    }, z.core.$strict>>;
+    readonly response_schema: z.ZodObject<{
+        run: z.ZodObject<{
+            kind: z.ZodLiteral<"interf-build-run">;
+            version: z.ZodLiteral<1>;
+            run_id: z.ZodString;
+            status: z.ZodEnum<{
+                running: "running";
+                failed: "failed";
+                cancelled: "cancelled";
+                queued: "queued";
+                succeeded: "succeeded";
+            }>;
+            project: z.ZodString;
+            build_plan: z.ZodString;
+            backend: z.ZodEnum<{
+                native: "native";
+            }>;
+            source_path: z.ZodString;
+            context_graph_path: z.ZodString;
+            created_at: z.ZodString;
+            started_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            finished_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            stages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                run_id: z.ZodString;
+                stage_id: z.ZodString;
+                stage_label: z.ZodOptional<z.ZodString>;
+                stage_index: z.ZodOptional<z.ZodNumber>;
+                stage_total: z.ZodOptional<z.ZodNumber>;
+                status: z.ZodEnum<{
+                    running: "running";
+                    failed: "failed";
+                    queued: "queued";
+                    succeeded: "succeeded";
+                }>;
+                started_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                finished_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                contract: z.ZodOptional<z.ZodObject<{
+                    stage_label: z.ZodOptional<z.ZodString>;
+                    stage_index: z.ZodOptional<z.ZodNumber>;
+                    stage_total: z.ZodOptional<z.ZodNumber>;
+                    reads: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                    writes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>>;
+                executor: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    kind: z.ZodEnum<{
+                        "local-agent": "local-agent";
+                        "connected-provider": "connected-provider";
+                        managed: "managed";
+                    }>;
+                    name: z.ZodString;
+                    display_name: z.ZodString;
+                    command: z.ZodNullable<z.ZodString>;
+                    model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    effort: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    profile: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    timeout_ms: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                }, z.core.$strip>>>;
+                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>>>;
+                logs: z.ZodOptional<z.ZodObject<{
+                    prompt_path: z.ZodOptional<z.ZodString>;
+                    event_stream_path: z.ZodOptional<z.ZodString>;
+                    status_path: z.ZodOptional<z.ZodString>;
+                    contract_path: z.ZodOptional<z.ZodString>;
+                    evidence_path: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
+                latest_evidence: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    id: z.ZodString;
+                    run_id: z.ZodString;
+                    stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    generated_at: z.ZodString;
+                    summary: z.ZodString;
+                    files_processed: z.ZodOptional<z.ZodNumber>;
+                    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>>>;
+                    checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        label: z.ZodString;
+                        ok: z.ZodBoolean;
+                        detail: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>>;
+                }, z.core.$strict>>>;
+                failure: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>>>;
+            events: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                event_id: z.ZodString;
+                run_id: z.ZodString;
+                timestamp: z.ZodString;
+                type: z.ZodLiteral<"run.started">;
+                project: z.ZodString;
+                build_plan: z.ZodOptional<z.ZodString>;
+                context_graph_path: z.ZodOptional<z.ZodString>;
+                backend: z.ZodEnum<{
+                    native: "native";
+                }>;
+            }, z.core.$strict>, z.ZodObject<{
+                event_id: z.ZodString;
+                run_id: z.ZodString;
+                timestamp: z.ZodString;
+                type: z.ZodLiteral<"stage.started">;
+                stage_id: z.ZodString;
+                stage_index: z.ZodOptional<z.ZodNumber>;
+                stage_total: z.ZodOptional<z.ZodNumber>;
+                logs: z.ZodOptional<z.ZodObject<{
+                    prompt_path: z.ZodOptional<z.ZodString>;
+                    event_stream_path: z.ZodOptional<z.ZodString>;
+                    status_path: z.ZodOptional<z.ZodString>;
+                    contract_path: z.ZodOptional<z.ZodString>;
+                    evidence_path: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                event_id: z.ZodString;
+                run_id: z.ZodString;
+                timestamp: z.ZodString;
+                type: z.ZodLiteral<"file.processed">;
+                stage_id: z.ZodString;
+                path: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                event_id: z.ZodString;
+                run_id: z.ZodString;
+                timestamp: z.ZodString;
+                type: z.ZodLiteral<"artifact.written">;
+                stage_id: z.ZodString;
+                artifact: 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>;
+            }, z.core.$strict>, z.ZodObject<{
+                event_id: z.ZodString;
+                run_id: z.ZodString;
+                timestamp: z.ZodString;
+                type: z.ZodLiteral<"evidence.updated">;
+                stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                evidence: z.ZodObject<{
+                    id: z.ZodString;
+                    run_id: z.ZodString;
+                    stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    generated_at: z.ZodString;
+                    summary: z.ZodString;
+                    files_processed: z.ZodOptional<z.ZodNumber>;
+                    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>>>;
+                    checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                        id: z.ZodString;
+                        label: z.ZodString;
+                        ok: z.ZodBoolean;
+                        detail: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>>;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                event_id: z.ZodString;
+                run_id: z.ZodString;
+                timestamp: z.ZodString;
+                type: z.ZodLiteral<"log.appended">;
+                stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                stream: z.ZodEnum<{
+                    status: "status";
+                    trace: "trace";
+                    system: "system";
+                }>;
+                message: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                event_id: z.ZodString;
+                run_id: z.ZodString;
+                timestamp: z.ZodString;
+                type: z.ZodLiteral<"stage.passed">;
+                stage_id: z.ZodString;
+                summary: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                event_id: z.ZodString;
+                run_id: z.ZodString;
+                timestamp: z.ZodString;
+                type: z.ZodLiteral<"stage.failed">;
+                stage_id: z.ZodString;
+                error: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                event_id: z.ZodString;
+                run_id: z.ZodString;
+                timestamp: z.ZodString;
+                type: z.ZodLiteral<"run.completed">;
+                summary: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                event_id: z.ZodString;
+                run_id: z.ZodString;
+                timestamp: z.ZodString;
+                type: z.ZodLiteral<"run.failed">;
+                error: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                event_id: z.ZodString;
+                run_id: z.ZodString;
+                timestamp: z.ZodString;
+                type: z.ZodLiteral<"run.cancelled">;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                event_id: z.ZodString;
+                run_id: z.ZodString;
+                timestamp: z.ZodString;
+                type: z.ZodLiteral<"checks.evaluated">;
+                passed: z.ZodNumber;
+                total: z.ZodNumber;
+                target: z.ZodOptional<z.ZodEnum<{
+                    "source-files": "source-files";
+                    "context-graph": "context-graph";
+                }>>;
+                checks_fingerprint: z.ZodOptional<z.ZodString>;
+                stale: z.ZodOptional<z.ZodBoolean>;
+                test_run_id: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                event_id: z.ZodString;
+                run_id: z.ZodString;
+                timestamp: z.ZodString;
+                type: z.ZodLiteral<"readiness.updated">;
+                project: z.ZodString;
+                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>;
+            }, z.core.$strict>], "type">>>;
+            latest_evidence: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                id: z.ZodString;
+                run_id: z.ZodString;
+                stage_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                generated_at: z.ZodString;
+                summary: z.ZodString;
+                files_processed: z.ZodOptional<z.ZodNumber>;
+                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>>>;
+                checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    label: z.ZodString;
+                    ok: z.ZodBoolean;
+                    detail: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>>;
+            readiness: z.ZodOptional<z.ZodNullable<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>>>;
+            context_checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                backed_by_artifact_ids: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                required: z.ZodDefault<z.ZodBoolean>;
+                evidence_expectation: z.ZodOptional<z.ZodString>;
+                status: z.ZodOptional<z.ZodEnum<{
+                    passed: "passed";
+                    pending: "pending";
+                    running: "running";
+                    failed: "failed";
+                    skipped: "skipped";
+                }>>;
+                evidence: z.ZodOptional<z.ZodString>;
+                issue: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                artifact_id: z.ZodString;
+                status: z.ZodEnum<{
+                    failed: "failed";
+                    skipped: "skipped";
+                    ready: "ready";
+                    not_ready: "not_ready";
+                }>;
+                built_by_stages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                check_results: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    check_id: z.ZodString;
+                    kind: z.ZodEnum<{
+                        file_exists: "file_exists";
+                        source_manifest_valid: "source_manifest_valid";
+                        min_file_count: "min_file_count";
+                        min_file_count_matches_source: "min_file_count_matches_source";
+                        source_summary_folders: "source_summary_folders";
+                        source_page_coverage: "source_page_coverage";
+                        frontmatter_valid: "frontmatter_valid";
+                        frontmatter_required_keys: "frontmatter_required_keys";
+                        frontmatter_nonempty_keys: "frontmatter_nonempty_keys";
+                        source_refs_required: "source_refs_required";
+                        wikilinks_valid: "wikilinks_valid";
+                        must_not_contain: "must_not_contain";
+                        must_contain: "must_contain";
+                        qa_match: "qa_match";
+                    }>;
+                    passed: z.ZodBoolean;
+                    required: z.ZodBoolean;
+                    summary: z.ZodString;
+                    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    evaluated_at: z.ZodString;
+                }, z.core.$strict>>>;
+                summary: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    readonly success_status: 201;
+}, {
+    readonly id: "getRunStatus";
+    readonly method: "GET";
+    readonly path: "/v1/runs/{run_id}/status";
+    readonly tags: ["Runs"];
+    readonly summary: "Get Run status";
+    readonly description: "Read compact Run observability for polling. Detailed logs and artifacts are separate resources.";
+    readonly visibility: "app";
+    readonly parameters: [ServiceOperationParameter];
+    readonly response_schema: z.ZodObject<{
+        kind: z.ZodLiteral<"interf-run-status">;
+        version: z.ZodLiteral<1>;
+        run_id: z.ZodString;
+        run_type: z.ZodEnum<{
+            build: "build";
+            verify: "verify";
+            "benchmark-question-draft": "benchmark-question-draft";
+            "build-plan-draft": "build-plan-draft";
+            "build-plan-improvement": "build-plan-improvement";
+            job: "job";
+        }>;
+        title: z.ZodString;
+        status: z.ZodEnum<{
+            running: "running";
+            failed: "failed";
+            cancelled: "cancelled";
+            queued: "queued";
+            succeeded: "succeeded";
+        }>;
+        project: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        build_plan: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        created_at: z.ZodString;
+        started_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        finished_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        metrics: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+            detail: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        artifact_count: z.ZodNumber;
+        check_count: z.ZodNumber;
+        context_check_count: z.ZodNumber;
+        readiness: z.ZodOptional<z.ZodNullable<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>>>;
+        latest_event: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        latest_log: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        detail_hint: z.ZodString;
+    }, z.core.$strict>;
+    readonly success_status: 200;
+}, {
+    readonly id: "getRunArtifacts";
+    readonly method: "GET";
+    readonly path: "/v1/runs/{run_id}/artifacts";
+    readonly tags: ["Runs"];
+    readonly summary: "Get Run artifacts";
+    readonly description: "Read the bounded artifact manifest for a finished Build run. Use only when the compact status says the Run is terminal.";
+    readonly visibility: "app";
+    readonly parameters: [ServiceOperationParameter];
+    readonly response_schema: z.ZodObject<{
+        artifacts: 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>>;
+    }, z.core.$strict>;
+    readonly success_status: 200;
+}, {
+    readonly id: "readRunFile";
+    readonly method: "GET";
+    readonly path: "/v1/runs/{run_id}/files";
+    readonly tags: ["Runs"];
+    readonly summary: "Read Run file";
+    readonly description: "Read a prompt log, status log, event stream, stage contract, or evidence file from the exact Build run output. Use this instead of latest Context Graph file reads when debugging historical runs.";
+    readonly visibility: "app";
+    readonly parameters: [ServiceOperationParameter, ServiceOperationParameter];
+    readonly response_schema: z.ZodString;
+    readonly response_content_type: "text/plain";
+    readonly success_status: 200;
+}, {
+    readonly id: "getLatestContextGraph";
+    readonly method: "GET";
+    readonly path: "/v1/projects/{project_id}/context-graph";
+    readonly tags: ["Context Graphs"];
+    readonly summary: "Get latest Context Graph";
+    readonly description: "Return the latest successful Context Graph locator and readiness state for a Project. This is a compact locator/status read; read artifacts/ handoff files before answering.";
+    readonly visibility: "app";
+    readonly parameters: [ServiceOperationParameter];
+    readonly response_schema: 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>;
+    readonly success_status: 200;
+}, {
+    readonly id: "listSourceFiles";
+    readonly method: "GET";
+    readonly path: "/v1/projects/{project_id}/source-files";
+    readonly tags: ["Source"];
+    readonly summary: "List Source Manifest projection";
+    readonly description: "Return the latest Source Manifest projected as source file rows for compatibility clients. Use source-manifest as the canonical run authority.";
+    readonly visibility: "app";
+    readonly parameters: [ServiceOperationParameter];
+    readonly response_schema: 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>;
+    readonly success_status: 200;
+}, {
+    readonly id: "getSourceManifest";
+    readonly method: "GET";
+    readonly path: "/v1/projects/{project_id}/source-manifest";
+    readonly tags: ["Source"];
+    readonly summary: "Get Source Manifest";
+    readonly description: "Return the evidence-backed Source Manifest recorded for the latest Context Graph.";
+    readonly visibility: "app";
+    readonly parameters: [ServiceOperationParameter];
+    readonly response_schema: 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>;
+    readonly success_status: 200;
+}, {
+    readonly id: "readContextGraphFile";
+    readonly method: "GET";
+    readonly path: "/v1/projects/{project_id}/context-graph/file";
+    readonly tags: ["Context Graphs"];
+    readonly summary: "Read Context Graph file";
+    readonly description: "Read one file from the latest Context Graph by relative path. Start with artifacts/ task handoffs; use summaries/ for coverage proof and knowledge/ for drilldown.";
+    readonly visibility: "app";
+    readonly parameters: [ServiceOperationParameter, ServiceOperationParameter];
+    readonly response_schema: z.ZodString;
+    readonly response_content_type: "text/plain";
+    readonly success_status: 200;
+}, {
+    readonly id: "getContextGraphTraces";
+    readonly method: "GET";
+    readonly path: "/v1/projects/{project_id}/context-graph/traces";
+    readonly tags: ["Context Graphs"];
+    readonly summary: "Get Context Graph traces";
+    readonly description: "Read source-backed trace rollups for exact values and provenance checks.";
+    readonly visibility: "app";
+    readonly parameters: [ServiceOperationParameter];
+    readonly response_schema: z.ZodObject<{
+        kind: z.ZodLiteral<"interf-context-graph-traces">;
+        version: z.ZodLiteral<1>;
+        generated_at: z.ZodString;
+        graph_id: z.ZodString;
+        project_id: z.ZodString;
+        files_processed: z.ZodNumber;
+        files_total: z.ZodNumber;
+        checks_passed: z.ZodNumber;
+        checks_total: z.ZodNumber;
+        ready: z.ZodBoolean;
+        pages_read: z.ZodOptional<z.ZodNumber>;
+        charts_extracted: z.ZodOptional<z.ZodNumber>;
+        entities_found: z.ZodOptional<z.ZodNumber>;
+        items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            label: z.ZodString;
+            count: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodOptional<z.ZodNumber>;
+            passed: z.ZodOptional<z.ZodBoolean>;
+            detail: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+    readonly success_status: 200;
+}, {
+    readonly id: "getBuildEvidence";
+    readonly method: "GET";
+    readonly path: "/v1/projects/{project_id}/context-graph/evidence";
+    readonly tags: ["Context Graphs"];
+    readonly summary: "Get Build evidence";
+    readonly description: "Read checks, Artifact diagnostics, and readiness evidence for the latest Context Graph.";
+    readonly visibility: "app";
+    readonly parameters: [ServiceOperationParameter];
+    readonly response_schema: 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>;
+    readonly success_status: 200;
+}];
+export type ServiceOperationId = typeof SERVICE_OPERATIONS[number]["id"];
+export declare const APP_PROFILE_OPERATION_IDS: ("createProject" | "getProject" | "prepareBuildPlan" | "runBuild" | "getRunStatus" | "getRunArtifacts" | "readRunFile" | "getLatestContextGraph" | "listSourceFiles" | "getSourceManifest" | "readContextGraphFile" | "getContextGraphTraces" | "getBuildEvidence")[];
+export declare function serviceOperationById(id: string): ServiceOperation | undefined;
+export { EmptyObjectSchema };