@interf/compiler 0.22.2 → 0.50.0

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

@@ -1,25 +0,0 @@
-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 "./build/build-plan-runs.js";
-import { type RunEventSink } from "./execution/events.js";
-import type { LocalServiceRunHandlers } from "./runtime.js";
-export interface NativeLocalServiceRunHandlerOptions {
-    executor?: AgentExecutor;
-    testExecutor?: AgentExecutor;
-}
-export declare function runConfiguredBuild(options: {
-    executor: AgentExecutor;
-    testExecutor?: AgentExecutor | null;
-    resolveStageExecutor?: ResolveStageExecutor;
-    verifiableContextPath: string;
-    sourcePath: string;
-    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" | "createBuildRun" | "createVerifyRun" | "createReadinessCheckDraft" | "createBuildPlanAuthoringRun">;

package/dist/packages/engine/preparation-store.d.ts

@@ -1,105 +0,0 @@
-/**
- * 0.13 preparation store.
- *
- * Each preparation lives at `~/.interf/preparations/<id>/` and is registered
- * with the runtime so the build / test / readiness machinery can find its
- * preparation data dir.
- *
- *   ~/.interf/preparations/<id>/
- *     interf.json          ← preparation config, single preparation entry name=<id>
- *     <id>/                ← verifiable context (matches preparation name)
- *
- * NOTE: We keep the synthetic `interf.json` shape (with a `preparations[]`
- * array of length 1, name=id, path=id) so the existing build/test
- * machinery stays functional. The doc-shape `config.json` /
- * `verifiable-context/` from `instance-paths.ts` is aspirational; transitioning
- * the entire build pipeline to read those names is out of scope for the
- * 0.13 cutover.
- *
- * Public callers reach this through the preparation-keyed HTTP routes.
- */
-import type { RequestedArtifact, SourcePreparationConfig, SourceProfile, SourceReadinessCheck } from "../project/lib/schema.js";
-import type { LocalServiceRuntime } from "./runtime.js";
-export interface PreparationCreateInput {
-    id: string;
-    source: {
-        kind: "local-folder";
-        locator: string;
-    };
-    /** Build Plan binding. Null/undefined means "not bound yet" — bind later via update. */
-    build_plan_id?: string | null;
-    about?: string;
-    requested_artifacts?: RequestedArtifact[];
-    source_profile?: SourceProfile;
-    checks?: SourceReadinessCheck[];
-    max_attempts?: number;
-    max_loops?: number;
-}
-export interface PreparationUpdateInput {
-    build_plan_id?: string | null;
-    about?: string | null;
-    requested_artifacts?: RequestedArtifact[];
-    source_profile?: SourceProfile | null;
-    checks?: SourceReadinessCheck[];
-}
-export interface StoredPreparation {
-    id: string;
-    prepDataDir: string;
-    source: {
-        kind: "local-folder";
-        locator: string;
-    };
-    /** Null when no Build Plan has been bound to this preparation yet. */
-    buildPlanId: string | null;
-    about: string | null;
-    config: SourcePreparationConfig;
-    verifiableContextPath: string;
-    configPath: string;
-}
-/** List every preparation registered under `~/.interf/preparations/`. */
-export declare function listStoredPreparations(): StoredPreparation[];
-/** Read one preparation by id. Returns null when missing. */
-export declare function getStoredPreparation(prepId: string): StoredPreparation | null;
-/**
- * Create a preparation: scaffold its data dir, write the local
- * Preparation config, and register it with the runtime so subsequent
- * build / test / readiness calls find it.
- *
- * Throws on validation errors (bad id, bad Build Plan id, source missing).
- */
-export declare function createStoredPreparation(runtime: LocalServiceRuntime, input: PreparationCreateInput): StoredPreparation;
-/**
- * Delete a preparation: deregister its runtime context and remove
- * `~/.interf/preparations/<id>/` from disk. Returns true when something
- * was actually removed.
- */
-export declare function deleteStoredPreparation(runtime: LocalServiceRuntime, prepId: string): boolean;
-/**
- * Update mutable fields on an existing preparation (Build Plan binding,
- * about text). Returns the freshly-loaded record. Throws if the
- * preparation does not exist.
- */
-export declare function updateStoredPreparation(prepId: string, patch: PreparationUpdateInput): StoredPreparation;
-/**
- * Re-register every preparation directory with the runtime on startup so
- * preparations survive a `interf web` restart.
- */
-export declare function rehydratePreparations(runtime: LocalServiceRuntime): void;
-/** Build the wire shape for `GET /v1/preparations/<id>` given a stored preparation. */
-export declare function preparationWireShape(stored: StoredPreparation): {
-    id: string;
-    source: {
-        kind: string;
-        locator: string;
-    };
-    build_plan_id: string | null;
-    about: string | null;
-    config_path: string;
-    verifiable_context: {
-        kind: "local-path";
-        value: string;
-    };
-    checks: SourcePreparationConfig["checks"];
-    requested_artifacts: SourcePreparationConfig["requested_artifacts"];
-    source_profile: SourcePreparationConfig["source_profile"] | null;
-};

package/dist/packages/engine/preparation-store.js

@@ -1,213 +0,0 @@
-/**
- * 0.13 preparation store.
- *
- * Each preparation lives at `~/.interf/preparations/<id>/` and is registered
- * with the runtime so the build / test / readiness machinery can find its
- * preparation data dir.
- *
- *   ~/.interf/preparations/<id>/
- *     interf.json          ← preparation config, single preparation entry name=<id>
- *     <id>/                ← verifiable context (matches preparation name)
- *
- * NOTE: We keep the synthetic `interf.json` shape (with a `preparations[]`
- * array of length 1, name=id, path=id) so the existing build/test
- * machinery stays functional. The doc-shape `config.json` /
- * `verifiable-context/` from `instance-paths.ts` is aspirational; transitioning
- * the entire build pipeline to read those names is out of scope for the
- * 0.13 cutover.
- *
- * Public callers reach this through the preparation-keyed HTTP routes.
- */
-import { existsSync, mkdirSync, readdirSync, rmSync, statSync, } from "node:fs";
-import { join, resolve } from "node:path";
-import { PreparationNameSchema, BuildPlanIdSchema, } from "../contracts/lib/schema.js";
-import { preparationDataDir, preparationsRoot, } from "./instance-paths.js";
-import { saveSourceFolderConfig, loadSourceFolderConfig, } from "../project/source-config.js";
-function ensurePreparationsRoot() {
-    mkdirSync(preparationsRoot(), { recursive: true });
-}
-function loadStoredPreparation(prepId) {
-    const prepDataDir = preparationDataDir(prepId);
-    if (!existsSync(prepDataDir) || !statSync(prepDataDir).isDirectory())
-        return null;
-    const config = loadSourceFolderConfig(prepDataDir);
-    if (!config)
-        return null;
-    const preparation = config.preparations?.find((p) => p.name === prepId);
-    if (!preparation)
-        return null;
-    const sourceFolderPath = config.source_folder?.path;
-    if (!sourceFolderPath)
-        return null;
-    return {
-        id: prepId,
-        prepDataDir,
-        source: { kind: "local-folder", locator: sourceFolderPath },
-        buildPlanId: preparation.build_plan ?? null,
-        about: preparation.about ?? null,
-        config: preparation,
-        verifiableContextPath: join(prepDataDir, prepId),
-        configPath: join(prepDataDir, "interf.json"),
-    };
-}
-/** List every preparation registered under `~/.interf/preparations/`. */
-export function listStoredPreparations() {
-    const root = preparationsRoot();
-    if (!existsSync(root))
-        return [];
-    const entries = readdirSync(root, { withFileTypes: true });
-    const out = [];
-    for (const entry of entries) {
-        if (!entry.isDirectory())
-            continue;
-        const stored = loadStoredPreparation(entry.name);
-        if (stored)
-            out.push(stored);
-    }
-    return out.sort((a, b) => a.id.localeCompare(b.id));
-}
-/** Read one preparation by id. Returns null when missing. */
-export function getStoredPreparation(prepId) {
-    return loadStoredPreparation(prepId);
-}
-/**
- * Create a preparation: scaffold its data dir, write the local
- * Preparation config, and register it with the runtime so subsequent
- * build / test / readiness calls find it.
- *
- * Throws on validation errors (bad id, bad Build Plan id, source missing).
- */
-export function createStoredPreparation(runtime, input) {
-    PreparationNameSchema.parse(input.id);
-    if (input.build_plan_id != null) {
-        BuildPlanIdSchema.parse(input.build_plan_id);
-    }
-    const sourceLocator = resolve(input.source.locator);
-    if (!existsSync(sourceLocator)) {
-        throw new Error(`Source folder does not exist: ${sourceLocator}`);
-    }
-    if (!statSync(sourceLocator).isDirectory()) {
-        throw new Error(`Source folder is not a directory: ${sourceLocator}`);
-    }
-    ensurePreparationsRoot();
-    const prepDataDir = preparationDataDir(input.id);
-    if (existsSync(prepDataDir) && loadStoredPreparation(input.id)) {
-        throw new Error(`Preparation already exists: ${input.id}`);
-    }
-    mkdirSync(prepDataDir, { recursive: true });
-    const preparation = {
-        name: input.id,
-        path: input.id,
-        ...(input.build_plan_id ? { build_plan: input.build_plan_id } : {}),
-        checks: (input.checks ?? []).map((check) => ({
-            question: check.question,
-            ...(check.answer ? { answer: check.answer } : {}),
-            ...(check.strictness ? { strictness: check.strictness } : {}),
-            ...(check.expect ? { expect: check.expect } : {}),
-        })),
-        ...(input.requested_artifacts ? { requested_artifacts: input.requested_artifacts } : {}),
-        ...(input.source_profile ? { source_profile: input.source_profile } : {}),
-        ...(input.about ? { about: input.about } : {}),
-        ...(input.max_attempts ? { max_attempts: input.max_attempts } : {}),
-        ...(input.max_loops ? { max_loops: input.max_loops } : {}),
-    };
-    saveSourceFolderConfig(prepDataDir, {
-        source_folder: { path: sourceLocator },
-        preparations: [preparation],
-    });
-    // Hand the Preparation data dir to the runtime so the existing
-    // build/test/readiness paths see it.
-    runtime.registerPreparation(prepDataDir);
-    const stored = loadStoredPreparation(input.id);
-    if (!stored)
-        throw new Error(`Failed to load freshly-created preparation ${input.id}`);
-    return stored;
-}
-/**
- * Delete a preparation: deregister its runtime context and remove
- * `~/.interf/preparations/<id>/` from disk. Returns true when something
- * was actually removed.
- */
-export function deleteStoredPreparation(runtime, prepId) {
-    const prepDataDir = preparationDataDir(prepId);
-    if (!existsSync(prepDataDir))
-        return false;
-    runtime.deregisterPreparation(prepDataDir);
-    rmSync(prepDataDir, { recursive: true, force: true });
-    return true;
-}
-/**
- * Update mutable fields on an existing preparation (Build Plan binding,
- * about text). Returns the freshly-loaded record. Throws if the
- * preparation does not exist.
- */
-export function updateStoredPreparation(prepId, patch) {
-    const stored = loadStoredPreparation(prepId);
-    if (!stored)
-        throw new Error(`Preparation not found: ${prepId}`);
-    if (patch.build_plan_id !== undefined && patch.build_plan_id !== null) {
-        BuildPlanIdSchema.parse(patch.build_plan_id);
-    }
-    const nextPreparation = {
-        ...stored.config,
-        ...(patch.build_plan_id === null
-            ? { build_plan: undefined }
-            : patch.build_plan_id !== undefined
-                ? { build_plan: patch.build_plan_id }
-                : {}),
-        ...(patch.checks !== undefined
-            ? { checks: patch.checks.map((check) => ({
-                    question: check.question,
-                    ...(check.answer ? { answer: check.answer } : {}),
-                    ...(check.strictness ? { strictness: check.strictness } : {}),
-                    ...(check.expect ? { expect: check.expect } : {}),
-                })) }
-            : {}),
-        ...(patch.requested_artifacts !== undefined
-            ? { requested_artifacts: patch.requested_artifacts }
-            : {}),
-        ...(patch.source_profile === null
-            ? { source_profile: undefined }
-            : patch.source_profile !== undefined
-                ? { source_profile: patch.source_profile }
-                : {}),
-    };
-    const aboutPatch = patch.about === undefined ? stored.about : patch.about;
-    const preparationWithAbout = aboutPatch
-        ? { ...nextPreparation, about: aboutPatch }
-        : (() => {
-            const { about: _omitAbout, ...rest } = nextPreparation;
-            return rest;
-        })();
-    saveSourceFolderConfig(stored.prepDataDir, {
-        source_folder: { path: stored.source.locator },
-        preparations: [preparationWithAbout],
-    });
-    const next = loadStoredPreparation(prepId);
-    if (!next)
-        throw new Error(`Failed to reload updated preparation ${prepId}`);
-    return next;
-}
-/**
- * Re-register every preparation directory with the runtime on startup so
- * preparations survive a `interf web` restart.
- */
-export function rehydratePreparations(runtime) {
-    for (const stored of listStoredPreparations()) {
-        runtime.registerPreparation(stored.prepDataDir);
-    }
-}
-/** Build the wire shape for `GET /v1/preparations/<id>` given a stored preparation. */
-export function preparationWireShape(stored) {
-    return {
-        id: stored.id,
-        source: stored.source,
-        build_plan_id: stored.buildPlanId,
-        about: stored.about,
-        config_path: stored.configPath,
-        verifiable_context: { kind: "local-path", value: stored.verifiableContextPath },
-        checks: stored.config.checks ?? [],
-        requested_artifacts: stored.config.requested_artifacts ?? [],
-        source_profile: stored.config.source_profile ?? null,
-    };
-}

package/dist/packages/engine/readiness-check-draft.d.ts

@@ -1,20 +0,0 @@
-import type { AgentExecutor } from "./agents/lib/executors.js";
-import type { SourceReadinessCheck } from "../project/lib/schema.js";
-export declare function buildReadinessCheckDraftPrompt(options: {
-    preparationName: string;
-    sourceFolderPath: string;
-    about?: string;
-    outputPath: string;
-    targetCount: number;
-}): string;
-export declare function draftReadinessChecks(options: {
-    preparationName: string;
-    sourceFolderPath: string;
-    about?: string;
-    executor: AgentExecutor;
-    targetCount?: number;
-    onStatus?: (line: string) => void;
-}): Promise<{
-    checks: SourceReadinessCheck[] | null;
-    error?: string;
-}>;

package/dist/packages/engine/readiness-check-draft.js

@@ -1,111 +0,0 @@
-import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { z } from "zod";
-const DraftReadinessCheckSchema = z.object({
-    question: z.string().min(1),
-    answer: z.string().min(1),
-}).strict();
-const DraftReadinessChecksSchema = z.array(DraftReadinessCheckSchema).min(1).max(8);
-export function buildReadinessCheckDraftPrompt(options) {
-    const normalizedAbout = options.about?.trim();
-    const taskLines = normalizedAbout
-        ? [
-            `Primary agent work: ${normalizedAbout}`,
-            "Draft readiness checks that directly measure whether a local agent can recover the agent-work-critical facts from the source files.",
-            "Prefer checks that would make a human confident the Preparation is useful for that exact job.",
-        ]
-        : [
-            "No primary agent work was provided.",
-            "Prefer broad, representative readiness checks that reflect the facts a human would verify from this Source Folder.",
-        ];
-    return [
-        "You are drafting Interf readiness checks for a local Source Folder.",
-        "Read the files in this folder and draft a small set of checks that a human can verify from the source files.",
-        "Do not ask follow-up questions.",
-        "Keep the checks concrete, explicit, and useful for measuring whether an agent can reason correctly over the files in this Source Folder.",
-        "",
-        `Preparation id: ${options.preparationName}`,
-        `Source Folder: ${options.sourceFolderPath}`,
-        ...taskLines,
-        "",
-        `Write exactly one JSON array to ${JSON.stringify(options.outputPath)}.`,
-        `Draft ${options.targetCount} checks unless the Source Folder is too small; in that case write fewer.`,
-        "Each array item must be an object with exactly these keys:",
-        '- "question": a plain-English question answerable from this Source Folder',
-        '- "answer": the expected correct answer in plain English',
-        "",
-        "Quality bar:",
-        "- If a primary task was provided, make most checks directly relevant to that task.",
-        "- Prefer facts, comparisons, or small derived calculations with clear expected answers.",
-        "- Prefer values that are easy for a human to cross-check in the source files.",
-        "- Prefer explicit chart labels, table cells, headings, totals, and directly stated comparisons.",
-        "- Avoid unstable superlatives unless the source itself clearly states the ranking in one place.",
-        "- Avoid checks where the expected answer depends on scanning many pages for a hidden exception or a larger outlier.",
-        "- Avoid vague essay questions, open-ended opinions, or anything requiring outside knowledge.",
-        "- Avoid duplicate checks that cover the same fact in slightly different words.",
-        "",
-        "Output rules:",
-        "- JSON only in the output file.",
-        "- No markdown fences.",
-        "- Do not print the JSON to stdout.",
-        "- Stop after writing the file.",
-    ].join("\n");
-}
-export async function draftReadinessChecks(options) {
-    const tempDir = mkdtempSync(join(tmpdir(), "interf-draft-checks-"));
-    const outputPath = join(tempDir, "checks.json");
-    const promptPath = join(tempDir, "prompt.txt");
-    const prompt = buildReadinessCheckDraftPrompt({
-        preparationName: options.preparationName,
-        sourceFolderPath: options.sourceFolderPath,
-        about: options.about,
-        outputPath,
-        targetCount: options.targetCount ?? 4,
-    });
-    writeFileSync(promptPath, `${prompt}\n`);
-    try {
-        const code = await options.executor.execute(options.sourceFolderPath, prompt, {
-            completionCheck: () => existsSync(outputPath),
-            onStatus: options.onStatus,
-        });
-        if (!existsSync(outputPath)) {
-            return {
-                checks: null,
-                error: code === 0
-                    ? "The local agent finished without writing draft checks."
-                    : "The local agent did not produce draft checks.",
-            };
-        }
-        let parsed;
-        try {
-            parsed = JSON.parse(readFileSync(outputPath, "utf8"));
-        }
-        catch (error) {
-            return {
-                checks: null,
-                error: `Draft checks were not valid JSON: ${error instanceof Error ? error.message : String(error)}`,
-            };
-        }
-        const validated = DraftReadinessChecksSchema.safeParse(parsed);
-        if (!validated.success) {
-            const detail = validated.error.issues[0]?.message ?? "invalid draft checks";
-            return {
-                checks: null,
-                error: `Draft checks did not match the required shape: ${detail}`,
-            };
-        }
-        return {
-            checks: validated.data,
-        };
-    }
-    catch (error) {
-        return {
-            checks: null,
-            error: error instanceof Error ? error.message : String(error),
-        };
-    }
-    finally {
-        rmSync(tempDir, { recursive: true, force: true });
-    }
-}

package/dist/packages/engine/requested-artifacts.d.ts

@@ -1,5 +0,0 @@
-import type { RequestedArtifact } from "../project/lib/schema.js";
-import type { BuildPlanAuthoringArtifactRequirement } from "./lib/schema.js";
-export declare function requestedArtifactCheckLabel(check: RequestedArtifact["checks"][number]): string;
-export declare function formatRequestedArtifactsForPrompt(artifacts: RequestedArtifact[]): string;
-export declare function artifactRequirementsFromRequestedArtifacts(artifacts: RequestedArtifact[]): BuildPlanAuthoringArtifactRequirement[];

package/dist/packages/engine/routes.d.ts

@@ -1,85 +0,0 @@
-export declare const LOCAL_SERVICE_DEFAULT_HOST = "127.0.0.1";
-export declare const LOCAL_SERVICE_DEFAULT_PORT = 4873;
-export declare const LOCAL_SERVICE_ROUTES: {
-    readonly root: "/";
-    readonly api: "/v1";
-    readonly health: "/health";
-    readonly instance: "/v1/instance";
-    readonly preparations: "/v1/preparations";
-    readonly buildPlans: "/v1/build-plans";
-    readonly buildRuns: "/v1/build-runs";
-    readonly runs: "/v1/runs";
-    readonly actionProposals: "/v1/action-proposals";
-    /**
-     * 0.14 single-active-agent shortcut. Kept as a back-compat shim
-     * over the role-map's `general` row in 0.15+.
-     */
-    readonly executor: "/v1/executor";
-    /**
-     * 0.15 connected-agents primitive — registry, role-map, role list.
-     * `agents/{name}` and `agents/role-map` are sub-resources handled
-     * by string match in `server.ts`.
-     */
-    readonly agents: "/v1/agents";
-    readonly openPath: "/v1/open-path";
-};
-/** Preparation-scoped sub-resources (relative to /v1/preparations/<id>/). */
-export declare const PREPARATION_SUBRESOURCES: {
-    readonly buildRuns: "build-runs";
-    readonly verifyRuns: "verify-runs";
-    readonly buildPlanDraftRuns: "build-plan-draft-runs";
-    readonly buildPlanImprovementRuns: "build-plan-improvement-runs";
-    readonly readinessCheckDrafts: "readiness-check-drafts";
-    readonly changes: "changes";
-    readonly reset: "reset";
-    readonly runs: "runs";
-    readonly readiness: "readiness";
-    readonly sourceFiles: "source-files";
-    readonly verifiableContext: "verifiable-context";
-    /**
-     * 0.16 — read a verifiable-context file (read-only, path-guarded
-     * inside the prep's verifiable-context root). Used by the locator
-     * pattern's `api-served` kind:
-     *   GET /v1/preparations/<id>/files/<relpath>
-     */
-    readonly files: "files";
-    /**
-     * 0.17 — per-Artifact detail. Returns the latest status, contributing
-     * stages, and proof refs for a Build Plan-declared Artifact:
-     *   GET /v1/preparations/<id>/artifacts/<artifact-id>
-     */
-    readonly artifacts: "artifacts";
-};
-/** Build Plan activity sub-resources (relative to /v1/build-plans/<id>/). */
-export declare const BUILD_PLAN_SUBRESOURCES: {
-    readonly runs: "runs";
-    /**
-     * Read a Build Plan definition file (read-only, path-guarded inside
-     * the Build Plan root). Used by the locator pattern's `api-served` kind:
-     *   GET /v1/build-plans/<id>/files/<relpath>
-     */
-    readonly files: "files";
-};
-/** Run-scoped sub-resources (relative to /v1/runs/<run-id>/). */
-export declare const RUN_SUBRESOURCES: {
-    readonly events: "events";
-    readonly cancel: "cancel";
-    readonly proof: "proof";
-    readonly artifacts: "artifacts";
-};
-export declare function buildLocalServiceUrl(options?: {
-    host?: string;
-    port?: number;
-}): string;
-/** Path builder: /v1/preparations/<id>. */
-export declare function preparationResourcePath(prepId: string): string;
-/** Path builder: /v1/preparations/<id>/<subresource>. */
-export declare function preparationSubresourcePath(prepId: string, sub: keyof typeof PREPARATION_SUBRESOURCES): string;
-/** Path builder: /v1/runs/<run-id>. */
-export declare function runResourcePath(runId: string): string;
-/** Path builder: /v1/runs/<run-id>/<subresource>. */
-export declare function runSubresourcePath(runId: string, sub: keyof typeof RUN_SUBRESOURCES): string;
-/** Path builder: /v1/build-plans/<id>. */
-export declare function buildPlanResourcePath(buildPlanId: string): string;
-/** Path builder: /v1/build-plans/<id>/<subresource>. */
-export declare function buildPlanSubresourcePath(buildPlanId: string, sub: keyof typeof BUILD_PLAN_SUBRESOURCES): string;

package/dist/packages/engine/routes.js

@@ -1,99 +0,0 @@
-export const LOCAL_SERVICE_DEFAULT_HOST = "127.0.0.1";
-export const LOCAL_SERVICE_DEFAULT_PORT = 4873;
-export const LOCAL_SERVICE_ROUTES = {
-    root: "/",
-    api: "/v1",
-    health: "/health",
-    // 0.13 surface — preparation-keyed.
-    instance: "/v1/instance",
-    preparations: "/v1/preparations",
-    buildPlans: "/v1/build-plans",
-    buildRuns: "/v1/build-runs",
-    runs: "/v1/runs",
-    actionProposals: "/v1/action-proposals",
-    /**
-     * 0.14 single-active-agent shortcut. Kept as a back-compat shim
-     * over the role-map's `general` row in 0.15+.
-     */
-    executor: "/v1/executor",
-    /**
-     * 0.15 connected-agents primitive — registry, role-map, role list.
-     * `agents/{name}` and `agents/role-map` are sub-resources handled
-     * by string match in `server.ts`.
-     */
-    agents: "/v1/agents",
-    openPath: "/v1/open-path",
-};
-/** Preparation-scoped sub-resources (relative to /v1/preparations/<id>/). */
-export const PREPARATION_SUBRESOURCES = {
-    buildRuns: "build-runs",
-    verifyRuns: "verify-runs",
-    buildPlanDraftRuns: "build-plan-draft-runs",
-    buildPlanImprovementRuns: "build-plan-improvement-runs",
-    readinessCheckDrafts: "readiness-check-drafts",
-    changes: "changes",
-    reset: "reset",
-    runs: "runs",
-    readiness: "readiness",
-    sourceFiles: "source-files",
-    verifiableContext: "verifiable-context",
-    /**
-     * 0.16 — read a verifiable-context file (read-only, path-guarded
-     * inside the prep's verifiable-context root). Used by the locator
-     * pattern's `api-served` kind:
-     *   GET /v1/preparations/<id>/files/<relpath>
-     */
-    files: "files",
-    /**
-     * 0.17 — per-Artifact detail. Returns the latest status, contributing
-     * stages, and proof refs for a Build Plan-declared Artifact:
-     *   GET /v1/preparations/<id>/artifacts/<artifact-id>
-     */
-    artifacts: "artifacts",
-};
-/** Build Plan activity sub-resources (relative to /v1/build-plans/<id>/). */
-export const BUILD_PLAN_SUBRESOURCES = {
-    runs: "runs",
-    /**
-     * Read a Build Plan definition file (read-only, path-guarded inside
-     * the Build Plan root). Used by the locator pattern's `api-served` kind:
-     *   GET /v1/build-plans/<id>/files/<relpath>
-     */
-    files: "files",
-};
-/** Run-scoped sub-resources (relative to /v1/runs/<run-id>/). */
-export const RUN_SUBRESOURCES = {
-    events: "events",
-    cancel: "cancel",
-    proof: "proof",
-    artifacts: "artifacts",
-};
-export function buildLocalServiceUrl(options = {}) {
-    const host = options.host ?? LOCAL_SERVICE_DEFAULT_HOST;
-    const port = options.port ?? LOCAL_SERVICE_DEFAULT_PORT;
-    return `http://${host}:${port}`;
-}
-/** Path builder: /v1/preparations/<id>. */
-export function preparationResourcePath(prepId) {
-    return `${LOCAL_SERVICE_ROUTES.preparations}/${encodeURIComponent(prepId)}`;
-}
-/** Path builder: /v1/preparations/<id>/<subresource>. */
-export function preparationSubresourcePath(prepId, sub) {
-    return `${preparationResourcePath(prepId)}/${PREPARATION_SUBRESOURCES[sub]}`;
-}
-/** Path builder: /v1/runs/<run-id>. */
-export function runResourcePath(runId) {
-    return `${LOCAL_SERVICE_ROUTES.runs}/${encodeURIComponent(runId)}`;
-}
-/** Path builder: /v1/runs/<run-id>/<subresource>. */
-export function runSubresourcePath(runId, sub) {
-    return `${runResourcePath(runId)}/${RUN_SUBRESOURCES[sub]}`;
-}
-/** Path builder: /v1/build-plans/<id>. */
-export function buildPlanResourcePath(buildPlanId) {
-    return `${LOCAL_SERVICE_ROUTES.buildPlans}/${encodeURIComponent(buildPlanId)}`;
-}
-/** Path builder: /v1/build-plans/<id>/<subresource>. */
-export function buildPlanSubresourcePath(buildPlanId, sub) {
-    return `${buildPlanResourcePath(buildPlanId)}/${BUILD_PLAN_SUBRESOURCES[sub]}`;
-}