@interf/compiler 0.21.0 → 0.22.0

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

@@ -1,7 +1,7 @@
 import { z } from "zod";
-import { ArtifactRefSchema, CompileRunSchema, CompileRunStatusSchema, InterfRunEventSchema, ProofRecordSchema, RunObservabilitySchema, } from "../execution/lib/schema.js";
+import { ArtifactRefSchema, BuildRunStatusSchema, InterfRunEventSchema, ProofRecordSchema, RunObservabilitySchema, StageRunSchema, } from "../execution/lib/schema.js";
 import { RequestedArtifactSchema, SourcePreparationConfigSchema, SourceProfileSchema, SourceReadinessCheckSchema, } from "../../project/lib/schema.js";
-import { ArtifactSchema, ArtifactIdSchema, ArtifactPathShapeSchema, ArtifactStatusSchema, CheckSchema, LocatorSchema, PreparationNameSchema, ReadinessSchema, SourceCompiledMaxAttemptsSchema, SourceCompiledMaxLoopsSchema, MethodIdSchema, TestTargetTypeSchema, } from "../../contracts/lib/schema.js";
+import { ArtifactSchema, ArtifactIdSchema, ArtifactPathShapeSchema, ArtifactStatusSchema, CheckSchema, LocatorSchema, PreparationNameSchema, ReadinessSchema, SourceBuildMaxAttemptsSchema, SourceBuildMaxLoopsSchema, BuildPlanIdSchema, TestTargetTypeSchema, } from "../../contracts/lib/schema.js";
 import { ReadinessCheckRunSchema, } from "../verify/lib/schema.js";
 const JsonObjectSchema = z.record(z.string(), z.unknown());
 // ───────────────────────────────────────────────────────────────────────────
@@ -51,21 +51,21 @@ export const PreparationCreateRequestSchema = z.object({
     id: PreparationNameSchema,
     source: SourceBindingSchema,
     /**
-     * Selected Build Plan / Method package id. Optional — a Preparation
+     * Selected Build Plan id. Optional — a Preparation
      * can be created with requested Artifacts first, then have a Build Plan
-     * selected or drafted later before the first compile.
+     * selected or drafted later before the first build.
      */
-    method_id: MethodIdSchema.nullable().optional(),
+    build_plan_id: BuildPlanIdSchema.nullable().optional(),
     about: z.string().min(1).optional(),
     requested_artifacts: z.array(RequestedArtifactSchema).default([]),
     source_profile: SourceProfileSchema.optional(),
     checks: z.array(SourceReadinessCheckSchema).default([]),
-    max_attempts: SourceCompiledMaxAttemptsSchema.optional(),
-    max_loops: SourceCompiledMaxLoopsSchema.optional(),
+    max_attempts: SourceBuildMaxAttemptsSchema.optional(),
+    max_loops: SourceBuildMaxLoopsSchema.optional(),
 }).strict();
 /** Body of `PATCH /v1/preparations/<id>` — update mutable preparation fields. */
 export const PreparationUpdateRequestSchema = z.object({
-    method_id: MethodIdSchema.nullable().optional(),
+    build_plan_id: BuildPlanIdSchema.nullable().optional(),
     about: z.string().nullable().optional(),
     /**
      * Replace the full readiness-check list. Use the empty array to clear
@@ -76,13 +76,14 @@ export const PreparationUpdateRequestSchema = z.object({
     requested_artifacts: z.array(RequestedArtifactSchema).optional(),
     source_profile: SourceProfileSchema.nullable().optional(),
 }).strict();
-/** Body of `POST /v1/methods` — install a Method package by path. */
-export const MethodInstallRequestSchema = z.object({
+/** 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 MethodInstallResultSchema = z.object({
-    method_id: MethodIdSchema,
+export const BuildPlanSaveResultSchema = z.object({
+    build_plan_id: BuildPlanIdSchema,
     installed: z.boolean(),
     path: z.string().min(1),
 }).strict();
@@ -93,10 +94,10 @@ export const PreparationDeleteResponseSchema = z.object({
 export const PreparationWireShapeSchema = z.object({
     id: PreparationNameSchema,
     source: SourceBindingSchema,
-    method_id: MethodIdSchema.nullable(),
+    build_plan_id: BuildPlanIdSchema.nullable(),
     about: z.string().min(1).nullable(),
     config_path: z.string().min(1),
-    portable_context: ArtifactLocatorSchema,
+    verifiable_context: ArtifactLocatorSchema,
     checks: z.array(SourceReadinessCheckSchema).default([]),
     requested_artifacts: z.array(RequestedArtifactSchema).default([]),
     source_profile: SourceProfileSchema.nullable().optional(),
@@ -128,12 +129,12 @@ export const LocalServiceConfigSchema = z.object({
     host: LocalServiceHostSchema.default("127.0.0.1"),
     port: LocalServicePortSchema.default(4873),
 }).strict();
-export const ServiceRegistryWorkspaceSchema = z.object({
-    control_path: z.string().min(1),
-    registered_at: z.string().min(1),
-    last_activity: z.string().min(1),
-}).strict();
-export const ServiceRegistryEntrySchema = z.object({
+export const ServiceRegistryEntrySchema = z.preprocess((value) => {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return value;
+    const { old_state_roots: _oldStateRoots, ...entry } = value;
+    return entry;
+}, z.object({
     pid: z.number().int().positive(),
     host: LocalServiceHostSchema,
     port: LocalServicePortSchema,
@@ -146,8 +147,7 @@ export const ServiceRegistryEntrySchema = z.object({
      * fresh entries always have one.
      */
     auth_token: LocalServiceAuthTokenSchema.optional(),
-    workspaces: z.array(ServiceRegistryWorkspaceSchema).default([]),
-}).strict();
+}).strict());
 export const ServiceRegistrySchema = z.object({
     services: z.array(ServiceRegistryEntrySchema).default([]),
 }).strict();
@@ -163,7 +163,6 @@ export const LocalServiceHealthSchema = z.object({
     started_at: z.string().min(1).optional(),
     package_version: z.string().min(1).optional(),
     instance_started_at: z.string().min(1).optional(),
-    registered_workspaces: z.array(ServiceRegistryWorkspaceSchema).default([]),
     active_runs: z.number().int().min(0).default(0),
     idle_for_seconds: z.number().int().min(0).default(0),
 }).strict();
@@ -173,29 +172,16 @@ export const LocalServiceErrorSchema = z.object({
         code: z.string().min(1).optional(),
     }).strict(),
 }).strict();
-export const LocalServicePointerSchema = z.object({
-    service_url: z.string().min(1),
-    host: LocalServiceHostSchema,
-    port: LocalServicePortSchema,
-    pid: z.number().int().positive(),
-    control_path: z.string().min(1),
-    started_at: z.string().min(1),
-    /**
-     * Per-workspace copy of the bearer token. Optional so legacy pointer
-     * files keep parsing during upgrades; new pointers always include it.
-     */
-    auth_token: LocalServiceAuthTokenSchema.optional(),
-}).strict();
-export const PortableContextMappingSchema = z.object({
+export const VerifiableContextMappingSchema = z.object({
     preparation: PreparationNameSchema,
     path: z.string().min(1).nullable(),
     exists: z.boolean(),
-    method_id: MethodIdSchema.nullable(),
-    latest_compile_run_id: z.string().min(1).nullable(),
+    build_plan_id: BuildPlanIdSchema.nullable(),
+    latest_build_run_id: z.string().min(1).nullable(),
     latest_test_run_id: z.string().min(1).nullable(),
 }).strict();
 export const PreparationRunLinkageSchema = z.object({
-    latest_compile_run_id: z.string().min(1).nullable(),
+    latest_build_run_id: z.string().min(1).nullable(),
     latest_test_run_id: z.string().min(1).nullable(),
 }).strict();
 export const PreparationResourceSchema = z.object({
@@ -203,25 +189,25 @@ export const PreparationResourceSchema = z.object({
     name: PreparationNameSchema,
     preparation: SourcePreparationConfigSchema,
     source_path: z.string().min(1),
-    method_id: MethodIdSchema.nullable(),
+    build_plan_id: BuildPlanIdSchema.nullable(),
     checks: z.array(SourceReadinessCheckSchema).default([]),
     requested_artifacts: z.array(RequestedArtifactSchema).default([]),
     source_profile: SourceProfileSchema.nullable().optional(),
-    portable_context: PortableContextMappingSchema,
-    portable_context_path: z.string().min(1).nullable(),
+    verifiable_context: VerifiableContextMappingSchema,
+    verifiable_context_path: z.string().min(1).nullable(),
     readiness: ReadinessSchema,
     runs: PreparationRunLinkageSchema,
-    latest_compile_run_id: z.string().min(1).nullable().optional(),
+    latest_build_run_id: z.string().min(1).nullable().optional(),
     latest_test_run_id: z.string().min(1).nullable().optional(),
-    // 0.17 — per-Artifact status from the latest compile run, mirrored
+    // Per-Artifact status from the latest Build run, mirrored
     // here so the UI/CLI can render artifact rows without a separate
-    // GET /v1/preparations/<id>/runs fetch. Empty when the Method
-    // no compile run has produced artifacts yet.
+    // GET /v1/preparations/<id>/runs fetch. Empty when no Build run has
+    // produced artifacts yet.
     artifacts: z.array(ArtifactStatusSchema).default([]),
 }).strict();
-export const MethodResourceSchema = z.object({
-    id: MethodIdSchema,
-    method_id: MethodIdSchema,
+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(),
@@ -247,40 +233,59 @@ export const MethodResourceSchema = z.object({
         contract_type: z.string().min(1),
         skill_dir: z.string().min(1),
         /**
-         * 0.15 — role hint Methods declare per stage. Defaults to
+         * Role hint Build Plans declare per stage. Defaults to
          * `general` at the runtime layer; the wire shape mirrors that
-         * default so older /v1/methods clients always see a string.
+         * 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 CompileRunCreateRequestSchema = z.object({
+export const BuildRunCreateRequestSchema = z.object({
     preparation: PreparationNameSchema,
-    method: MethodIdSchema.optional(),
-    max_attempts: SourceCompiledMaxAttemptsSchema.optional(),
-    max_loops: SourceCompiledMaxLoopsSchema.optional(),
+    build_plan: BuildPlanIdSchema.optional(),
+    max_attempts: SourceBuildMaxAttemptsSchema.optional(),
+    max_loops: SourceBuildMaxLoopsSchema.optional(),
     preserve_stage_shells: z.enum(["on-failure", "always"]).optional(),
 }).strict();
-export const CompileRunSummarySchema = z.object({
+export const BuildRunSummarySchema = z.object({
     run_id: z.string().min(1),
-    status: CompileRunStatusSchema,
+    status: BuildRunStatusSchema,
     preparation: PreparationNameSchema,
-    method: MethodIdSchema,
-    portable_context_path: z.string().min(1),
+    build_plan: BuildPlanIdSchema,
+    verifiable_context_path: z.string().min(1),
     started_at: z.string().nullable().optional(),
     finished_at: z.string().nullable().optional(),
     latest_event: InterfRunEventSchema.nullable().optional(),
     latest_proof: ProofRecordSchema.nullable().optional(),
 }).strict();
-export const CompileRunResourceSchema = z.object({
-    run: CompileRunSchema,
+export const BuildRunSchema = z.object({
+    kind: z.literal("interf-build-run"),
+    version: z.literal(1),
+    run_id: z.string().min(1),
+    status: BuildRunStatusSchema,
+    preparation: PreparationNameSchema,
+    build_plan: BuildPlanIdSchema,
+    backend: z.string().min(1),
+    source_path: z.string().min(1),
+    verifiable_context_path: z.string().min(1),
+    created_at: z.string().min(1),
+    started_at: z.string().nullable().optional(),
+    finished_at: z.string().nullable().optional(),
+    stages: z.array(StageRunSchema).default([]),
+    events: z.array(InterfRunEventSchema).default([]),
+    latest_proof: ProofRecordSchema.nullable().optional(),
+    readiness: ReadinessSchema.nullable().optional(),
+    artifacts: z.array(ArtifactStatusSchema).default([]),
+}).strict();
+export const BuildRunResourceSchema = z.object({
+    run: BuildRunSchema,
 }).strict();
 export const LocalJobTypeSchema = z.enum([
     "readiness-check-draft",
-    "method-authoring",
-    "method-improvement",
+    "build-plan-draft",
+    "build-plan-improvement",
 ]);
 export const RunStatusSchema = z.enum([
     "queued",
@@ -338,7 +343,7 @@ export const LocalJobRunCreateRequestSchema = z.object({
     job_type: LocalJobTypeSchema,
     title: z.string().min(1),
     preparation: PreparationNameSchema.nullable().optional(),
-    method: MethodIdSchema.nullable().optional(),
+    build_plan: BuildPlanIdSchema.nullable().optional(),
     source_path: z.string().min(1).nullable().optional(),
     output_path: z.string().min(1).nullable().optional(),
     agent: LocalJobAgentSchema.nullable().optional(),
@@ -350,47 +355,47 @@ export const LocalJobRunCreateRequestSchema = z.object({
 }).strict();
 export const PreparationSetupCreateRequestSchema = z.object({
     preparation: SourcePreparationConfigSchema,
-    prepare_after_setup: z.boolean().default(false),
-    setup_mode: z.enum(["create", "select-method"]).default("create"),
+    build_after_setup: z.boolean().default(false),
+    setup_mode: z.enum(["create", "select-build-plan"]).default("create"),
 }).strict();
 export const PreparationSetupResultSchema = z.object({
     kind: z.literal("interf-preparation-setup-result"),
     version: z.literal(1),
-    operation: z.enum(["create", "select-method"]),
+    operation: z.enum(["create", "select-build-plan"]),
     preparation: PreparationNameSchema,
-    method: MethodIdSchema.nullable(),
+    build_plan: BuildPlanIdSchema.nullable(),
     source_folder_path: z.string().min(1),
     config_path: z.string().min(1),
-    portable_context_path: z.string().min(1),
+    verifiable_context_path: z.string().min(1),
     changed: z.boolean(),
     message: z.string().min(1),
     submitted_run_id: z.string().min(1).nullable().optional(),
-    submitted_run_type: z.literal("compile-run").nullable().optional(),
+    submitted_run_type: z.literal("build-run").nullable().optional(),
 }).strict();
-export const MethodChangeCreateRequestSchema = z.discriminatedUnion("operation", [
+export const BuildPlanChangeCreateRequestSchema = z.discriminatedUnion("operation", [
     z.object({
-        action_type: z.literal("method-change").optional(),
+        action_type: z.literal("build-plan-change").optional(),
         operation: z.literal("duplicate"),
-        method: MethodIdSchema,
-        new_method_id: MethodIdSchema,
+        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("method-change").optional(),
+        action_type: z.literal("build-plan-change").optional(),
         operation: z.literal("remove"),
-        method: MethodIdSchema,
-        confirmation: MethodIdSchema,
+        build_plan: BuildPlanIdSchema,
+        confirmation: BuildPlanIdSchema,
     }).strict(),
 ]);
-export const MethodChangeResultSchema = z.object({
-    kind: z.literal("interf-method-change-result"),
+export const BuildPlanChangeResultSchema = z.object({
+    kind: z.literal("interf-build-plan-change-result"),
     version: z.literal(1),
     operation: z.enum(["duplicate", "remove"]),
-    method: MethodIdSchema,
-    new_method_id: MethodIdSchema.nullable().optional(),
+    build_plan: BuildPlanIdSchema,
+    new_build_plan_id: BuildPlanIdSchema.nullable().optional(),
     updated_preparations: z.array(PreparationNameSchema).default([]),
-    method_path: z.string().min(1),
+    build_plan_path: z.string().min(1),
     changed: z.boolean(),
     message: z.string().min(1),
 }).strict();
@@ -408,21 +413,21 @@ export const PreparationChangeResultSchema = z.object({
     operation: z.literal("remove"),
     preparation: PreparationNameSchema,
     config_path: z.string().min(1),
-    portable_context_path: z.string().min(1),
-    portable_context_retained: z.boolean(),
+    verifiable_context_path: z.string().min(1),
+    verifiable_context_retained: z.boolean(),
     changed: z.boolean(),
     message: z.string().min(1),
 }).strict();
 export const ResetRequestSchema = z.object({
     preparation: PreparationNameSchema,
-    scope: z.enum(["compile", "all"]),
+    scope: z.enum(["build", "all"]),
 }).strict();
 export const ResetResultSchema = z.object({
     kind: z.literal("interf-reset-result"),
     version: z.literal(1),
     preparation: PreparationNameSchema,
-    scope: z.enum(["compile", "all"]),
-    portable_context_path: z.string().min(1),
+    scope: z.enum(["build", "all"]),
+    verifiable_context_path: z.string().min(1),
     changed: z.boolean(),
     message: z.string().min(1),
 }).strict();
@@ -435,32 +440,32 @@ export const ReadinessCheckDraftCreateRequestSchema = z.object({
 export const ReadinessCheckDraftResultSchema = z.object({
     checks: z.array(SourceReadinessCheckSchema).default([]),
 }).strict();
-export const MethodAuthoringArtifactRequirementSchema = z.object({
+export const BuildPlanAuthoringArtifactRequirementSchema = z.object({
     id: ArtifactIdSchema,
     description: z.string().min(1).optional(),
     shape: ArtifactPathShapeSchema,
     checks: z.array(CheckSchema).default([]),
     stage_hint: z.string().min(1).optional(),
 }).strict();
-export const MethodAuthoringCreateRequestSchema = z.object({
+export const BuildPlanAuthoringCreateRequestSchema = z.object({
     preparation: PreparationNameSchema.nullable().optional(),
     source_folder_path: z.string().min(1),
-    base_method_id: MethodIdSchema.optional(),
-    reference_method_id: MethodIdSchema.optional(),
-    method_id: MethodIdSchema,
+    base_build_plan_id: BuildPlanIdSchema.optional(),
+    reference_build_plan_id: BuildPlanIdSchema.optional(),
+    build_plan_id: BuildPlanIdSchema,
     label: z.string().min(1),
     hint: z.string().min(1),
     task_prompt: z.string().min(1),
     checks: z.array(SourceReadinessCheckSchema).default([]),
     requested_artifacts: z.array(RequestedArtifactSchema).default([]),
     source_profile: SourceProfileSchema.nullable().optional(),
-    artifact_requirements: z.array(MethodAuthoringArtifactRequirementSchema).default([]),
+    artifact_requirements: z.array(BuildPlanAuthoringArtifactRequirementSchema).default([]),
 }).strict();
-export const MethodAuthoringResultSchema = z.object({
+export const BuildPlanAuthoringResultSchema = z.object({
     status: z.enum(["updated", "no-change", "invalid", "executor-failed"]),
     changed: z.boolean(),
     summary: z.string().min(1),
-    method_path: z.string().min(1),
+    build_plan_path: z.string().min(1),
     shell_path: z.string().min(1),
     validation: z.unknown().nullable().optional(),
 }).strict();
@@ -480,7 +485,7 @@ export const LocalJobRunResourceSchema = z.object({
     status: LocalJobStatusSchema,
     title: z.string().min(1),
     preparation: PreparationNameSchema.nullable().optional(),
-    method: MethodIdSchema.nullable().optional(),
+    build_plan: BuildPlanIdSchema.nullable().optional(),
     source_path: z.string().min(1).nullable().optional(),
     output_path: z.string().min(1).nullable().optional(),
     agent: LocalJobAgentSchema.nullable().optional(),
@@ -494,26 +499,18 @@ export const LocalJobRunResourceSchema = z.object({
 }).strict();
 export const VerifyRunStatusSchema = RunStatusSchema;
 /**
- * 0.17 — verify runs choose their judge target. `compiled` (default)
- * judges against the latest portable-context output; `source-files`
- * judges against the raw source folder for a baseline that reveals
- * how much value the Method actually adds. The 0.15 cleanup made
- * verify compiled-only on the wire because the source-files branch
- * had been retired in 0.13.1; 0.17 restores it because the readiness-check UI and
- * `verify/README.md` have always claimed the option exists, and the
- * sandbox + spec builders for source-files have remained in tree
- * since 0.13.
+ * Verify runs choose their judge target.
  */
 export const VerifyRunCreateRequestSchema = z.object({
     preparation: PreparationNameSchema,
-    target: TestTargetTypeSchema.default("compiled"),
+    target: TestTargetTypeSchema.default("verifiable-context"),
 }).strict();
 export const VerifyRunResourceSchema = z.object({
     run_id: z.string().min(1),
     status: VerifyRunStatusSchema,
     preparation: PreparationNameSchema,
     source_path: z.string().min(1),
-    portable_context_path: z.string().min(1).nullable(),
+    verifiable_context_path: z.string().min(1).nullable(),
     started_at: z.string().nullable().optional(),
     finished_at: z.string().nullable().optional(),
     readiness_run: ReadinessCheckRunSchema.nullable(),
@@ -537,9 +534,9 @@ export const LocalExecutorSelectRequestSchema = z.object({
 export const ActionProposalTypeSchema = z.enum([
     "clarification",
     "readiness-check-draft",
-    "method-authoring",
-    "method-improvement",
-    "compile",
+    "build-plan-draft",
+    "build-plan-improvement",
+    "build",
     "test",
 ]);
 export const ActionProposalPlanActionTypeSchema = z.enum([
@@ -547,10 +544,10 @@ export const ActionProposalPlanActionTypeSchema = z.enum([
     "preparation-setup",
     "preparation-change",
     "readiness-check-draft",
-    "method-authoring",
-    "method-change",
-    "method-improvement",
-    "compile",
+    "build-plan-draft",
+    "build-plan-change",
+    "build-plan-improvement",
+    "build",
     "test",
 ]);
 export const ActionProposalStatusSchema = z.enum([
@@ -578,7 +575,7 @@ export const ActionProposalCreateRequestSchema = z.object({
 export const ActionProposalPlanSchema = z.object({
     action_type: ActionProposalPlanActionTypeSchema,
     preparation: PreparationNameSchema.optional(),
-    method: MethodIdSchema.optional(),
+    build_plan: BuildPlanIdSchema.optional(),
     values: JsonObjectSchema.optional(),
     title: z.string().min(1).optional(),
     summary: z.string().min(1).optional(),
@@ -605,14 +602,14 @@ const ActionProposalResourceBaseSchema = z.object({
     command_preview: z.string().min(1).optional(),
     message: z.string().min(1),
     preparation: PreparationNameSchema.nullable().optional(),
-    method: MethodIdSchema.nullable().optional(),
+    build_plan: BuildPlanIdSchema.nullable().optional(),
     client_origin: ActionClientOriginSchema.default("unknown"),
     created_at: z.string().min(1),
     updated_at: z.string().min(1),
     proposed_by_executor: LocalJobAgentSchema.nullable().optional(),
     approval: ActionProposalApprovalSchema.nullable().optional(),
     submitted_run_id: z.string().min(1).nullable().optional(),
-    submitted_run_type: z.enum(["compile-run", "verify-run", "job-run"]).nullable().optional(),
+    submitted_run_type: z.enum(["build-run", "verify-run", "job-run"]).nullable().optional(),
     error: z.string().min(1).nullable().optional(),
 }).strict();
 export const ActionProposalResourceSchema = z.discriminatedUnion("action_type", [
@@ -621,8 +618,8 @@ export const ActionProposalResourceSchema = z.discriminatedUnion("action_type",
         request: JsonObjectSchema,
     }).strict(),
     ActionProposalResourceBaseSchema.extend({
-        action_type: z.literal("compile"),
-        request: CompileRunCreateRequestSchema,
+        action_type: z.literal("build"),
+        request: BuildRunCreateRequestSchema,
     }).strict(),
     ActionProposalResourceBaseSchema.extend({
         action_type: z.literal("test"),
@@ -633,21 +630,21 @@ export const ActionProposalResourceSchema = z.discriminatedUnion("action_type",
         request: ReadinessCheckDraftCreateRequestSchema,
     }).strict(),
     ActionProposalResourceBaseSchema.extend({
-        action_type: z.literal("method-authoring"),
-        request: MethodAuthoringCreateRequestSchema,
+        action_type: z.literal("build-plan-draft"),
+        request: BuildPlanAuthoringCreateRequestSchema,
     }).strict(),
     ActionProposalResourceBaseSchema.extend({
-        action_type: z.literal("method-improvement"),
-        request: MethodAuthoringCreateRequestSchema,
+        action_type: z.literal("build-plan-improvement"),
+        request: BuildPlanAuthoringCreateRequestSchema,
     }).strict(),
 ]);
-export const PortableContextResourceSchema = z.object({
+export const VerifiableContextResourceSchema = z.object({
     preparation: PreparationNameSchema,
     path: z.string().min(1),
     exists: z.boolean(),
     readiness: ReadinessSchema,
-    method: MethodIdSchema.nullable().optional(),
-    latest_compile_run_id: z.string().min(1).nullable().optional(),
+    build_plan: BuildPlanIdSchema.nullable().optional(),
+    latest_build_run_id: z.string().min(1).nullable().optional(),
     latest_test_run_id: z.string().min(1).nullable().optional(),
     artifacts: z.array(ArtifactRefSchema).default([]),
 }).strict();
@@ -660,19 +657,14 @@ export const SourceFileResourceSchema = z.object({
     modified_at: z.string().min(1).nullable(),
     source_folder_path: z.string().min(1),
 }).strict();
-export const WorkspaceFileResourceSchema = z.object({
-    path: z.string().min(1),
-    absolute_path: z.string().min(1),
-    size_bytes: z.number().int().min(0),
-    modified_at: z.string().min(1).nullable(),
-}).strict();
 export const LocalServiceDiscoverySchema = z.object({
     kind: z.literal("interf-local-service-discovery"),
     version: z.literal(1),
     resources: z.object({
         instance: z.string().min(1),
         preparations: z.string().min(1),
-        methods: z.string().min(1),
+        build_plans: z.string().min(1),
+        build_runs: z.string().min(1),
         runs: z.string().min(1),
         action_proposals: z.string().min(1),
         executor: z.string().min(1),
@@ -683,24 +675,19 @@ export const LocalServiceDiscoverySchema = z.object({
          */
         agents: z.string().min(1).optional(),
         /**
-         * Older discovery fields. Resource access is now preparation-scoped,
-         * but accepting these keys keeps stale clients from failing parse.
+         * Optional resource paths for scoped helper resources.
          */
         readiness: z.string().min(1).optional(),
-        portable_contexts: z.string().min(1).optional(),
+        verifiable_contexts: z.string().min(1).optional(),
         source_files: z.string().min(1).optional(),
-        workspace_files: z.string().min(1).optional(),
         preparation_setups: z.string().min(1).optional(),
         preparation_changes: z.string().min(1).optional(),
-        method_changes: z.string().min(1).optional(),
-        workspace_bootstraps: z.string().min(1).optional(),
+        build_plan_changes: z.string().min(1).optional(),
         readiness_check_drafts: z.string().min(1).optional(),
-        method_authoring_runs: z.string().min(1).optional(),
-        method_improvement_runs: z.string().min(1).optional(),
-        compile_runs: z.string().min(1).optional(),
+        build_plan_draft_runs: z.string().min(1).optional(),
+        build_plan_improvement_runs: z.string().min(1).optional(),
         verify_runs: z.string().min(1).optional(),
         reset: z.string().min(1).optional(),
-        workspaces: z.string().min(1).optional(),
         status: z.string().min(1).optional(),
     }).strict(),
 }).strict();
@@ -714,11 +701,11 @@ export const OpenPathResponseSchema = z.object({
 export const PreparationListResponseSchema = z.object({
     preparations: z.array(PreparationWireShapeSchema),
 }).strict();
-export const MethodListResponseSchema = z.object({
-    methods: z.array(MethodResourceSchema),
+export const BuildPlanListResponseSchema = z.object({
+    build_plans: z.array(BuildPlanResourceSchema),
 }).strict();
-export const CompileRunListResponseSchema = z.object({
-    compile_runs: z.array(CompileRunResourceSchema),
+export const BuildRunListResponseSchema = z.object({
+    build_runs: z.array(BuildRunResourceSchema),
 }).strict();
 export const LocalJobRunListResponseSchema = z.object({
     jobs: z.array(LocalJobRunResourceSchema),
@@ -732,8 +719,8 @@ export const RunObservabilityListResponseSchema = z.object({
 export const ActionProposalListResponseSchema = z.object({
     action_proposals: z.array(ActionProposalResourceSchema),
 }).strict();
-export const PortableContextListResponseSchema = z.object({
-    portable_contexts: z.array(PortableContextResourceSchema),
+export const VerifiableContextListResponseSchema = z.object({
+    verifiable_contexts: z.array(VerifiableContextResourceSchema),
 }).strict();
 export const ReadinessListResponseSchema = z.object({
     readiness: z.array(ReadinessResourceSchema),
@@ -741,6 +728,3 @@ export const ReadinessListResponseSchema = z.object({
 export const SourceFileListResponseSchema = z.object({
     source_files: z.array(SourceFileResourceSchema),
 }).strict();
-export const WorkspaceFileListResponseSchema = z.object({
-    workspace_files: z.array(WorkspaceFileResourceSchema),
-}).strict();

package/dist/packages/engine/native-run-handlers.d.ts

@@ -1,25 +1,25 @@
-import { type ResolveStageExecutor } from "./compile/method-runs.js";
-import type { MethodExecutionProfile, MethodExecutor } from "./agents/lib/executors.js";
+import { type ResolveStageExecutor } from "./build/build-plan-runs.js";
+import type { AgentExecutionProfile, AgentExecutor } from "./agents/lib/executors.js";
 import type { SourcePreparationConfig } from "../project/lib/schema.js";
-import type { StageShellRetentionMode } from "./compile/method-runs.js";
+import type { StageShellRetentionMode } from "./build/build-plan-runs.js";
 import { type RunEventSink } from "./execution/events.js";
 import type { LocalServiceRunHandlers } from "./runtime.js";
 export interface NativeLocalServiceRunHandlerOptions {
-    executor?: MethodExecutor;
-    testExecutor?: MethodExecutor;
+    executor?: AgentExecutor;
+    testExecutor?: AgentExecutor;
 }
-export declare function runConfiguredCompiledCompile(options: {
-    executor: MethodExecutor;
-    testExecutor?: MethodExecutor | null;
+export declare function runConfiguredBuild(options: {
+    executor: AgentExecutor;
+    testExecutor?: AgentExecutor | null;
     resolveStageExecutor?: ResolveStageExecutor;
-    compiledPath: string;
+    verifiableContextPath: string;
     sourcePath: string;
-    compiledConfig: SourcePreparationConfig | null;
-    executionProfile?: MethodExecutionProfile;
+    verifiableContextConfig: SourcePreparationConfig | null;
+    executionProfile?: AgentExecutionProfile;
     maxAttemptsOverride: number | null;
     maxLoopsOverride: number | null;
     preserveStageShells?: StageShellRetentionMode;
     runId?: string;
     events?: RunEventSink;
 }): Promise<boolean>;
-export declare function createNativeLocalServiceRunHandlers(options?: NativeLocalServiceRunHandlerOptions): Pick<LocalServiceRunHandlers, "planActionProposal" | "createCompileRun" | "createVerifyRun" | "createReadinessCheckDraft" | "createMethodAuthoringRun">;
+export declare function createNativeLocalServiceRunHandlers(options?: NativeLocalServiceRunHandlerOptions): Pick<LocalServiceRunHandlers, "planActionProposal" | "createBuildRun" | "createVerifyRun" | "createReadinessCheckDraft" | "createBuildPlanAuthoringRun">;