@interf/compiler 0.22.2 → 0.50.0

package/dist/packages/engine/action-definitions.js

@@ -1,1158 +0,0 @@
-import { z } from "zod";
-import { RequestedArtifactSchema, SourceProfileSchema, } from "../project/lib/schema.js";
-import { artifactRequirementsFromRequestedArtifacts, formatRequestedArtifactsForPrompt, } from "./requested-artifacts.js";
-export const ActionValueIdPattern = /^[a-z0-9][a-z0-9-]{0,79}$/;
-export const ActionValueIdSchema = z.string().trim().regex(ActionValueIdPattern, "Use lowercase letters, numbers, and dashes.");
-export const OptionalActionValueIdSchema = z.string().trim().refine((value) => value === "" || ActionValueIdPattern.test(value), "Use lowercase letters, numbers, and dashes.");
-export const SourceReadinessCheckActionValueSchema = z.object({
-    question: z.string().trim().min(1),
-    answer: z.string().trim().optional(),
-}).strict();
-export const RequestedArtifactActionValueSchema = RequestedArtifactSchema;
-export const SourceProfileActionValueSchema = SourceProfileSchema;
-export const PreparationSetupActionValuesSchema = z.object({
-    name: ActionValueIdSchema,
-    path: z.string().trim().min(1, "Source Folder is required."),
-    about: z.string().trim().min(1, "Agent work is required."),
-    build_plan: OptionalActionValueIdSchema.optional(),
-    checks: z.array(SourceReadinessCheckActionValueSchema).optional(),
-    requested_artifacts: z.array(RequestedArtifactActionValueSchema).optional(),
-    source_profile: SourceProfileActionValueSchema.optional(),
-    max_attempts: z.number().int().min(1).max(5).optional(),
-    max_loops: z.number().int().min(1).max(3).optional(),
-    readiness_notes: z.string().trim().optional(),
-    build_after_setup: z.boolean().optional(),
-    setup_mode: z.enum(["create", "select-build-plan"]).optional(),
-}).strict();
-export const BuildPlanAuthoringActionValuesSchema = z.object({
-    build_plan_id: ActionValueIdSchema.optional(),
-    base_build_plan_id: ActionValueIdSchema.optional(),
-    reference_build_plan_id: ActionValueIdSchema.optional(),
-    label: z.string().trim().optional(),
-    hint: z.string().trim().optional(),
-    task_prompt: z.string().trim().min(1, "Agent work is required."),
-    requested_artifacts_description: z.string().trim().optional(),
-    requested_artifacts: z.array(RequestedArtifactActionValueSchema).optional(),
-    source_profile: SourceProfileActionValueSchema.nullable().optional(),
-    readiness_notes: z.string().trim().optional(),
-}).strict();
-export const INTERF_SERVICE_ACTIONS = {
-    createPreparation: {
-        id: "create-preparation",
-        serviceAction: "preparation-setup",
-        title: "Create Preparation",
-        description: "Save a Source, requested Artifacts, Build Plan, and run history under one Preparation.",
-    },
-    buildRun: {
-        id: "build-run",
-        serviceAction: "build",
-        title: "Build Artifacts",
-        description: "Run the saved Build Plan against this Source and write verifiable context.",
-    },
-    selectBuildPlan: {
-        id: "select-build-plan",
-        serviceAction: "preparation-setup",
-        title: "Select Build Plan",
-        description: "Choose the Build Plan that will build this Preparation's requested Artifacts.",
-    },
-    createBuildPlan: {
-        id: "build-plan-draft",
-        serviceAction: "build-plan-draft",
-        title: "Draft Build Plan",
-        description: "Draft a Build Plan for the Artifacts this Preparation should build.",
-    },
-    buildPlanChange: {
-        id: "build-plan-change",
-        serviceAction: "build-plan-change",
-        title: "Build Plan Change",
-        description: "Modify, duplicate, or remove an existing Build Plan.",
-    },
-    preparationChange: {
-        id: "preparation-change",
-        serviceAction: "preparation-change",
-        title: "Preparation Change",
-        description: "Modify, duplicate, or remove an existing Preparation.",
-    },
-    confirmAction: {
-        id: "confirm-action",
-        serviceAction: "action-proposal",
-        title: "Send Request",
-        description: "Confirm the typed Interf service request before it runs.",
-    },
-    checkReadiness: {
-        id: "check-readiness",
-        serviceAction: "test",
-        title: "Check Readiness",
-        description: "Run saved readiness checks against this Preparation.",
-    },
-    draftReadinessChecks: {
-        id: "draft-readiness-checks",
-        serviceAction: "readiness-check-draft",
-        title: "Draft Readiness Checks",
-        description: "Ask the configured local executor to draft saved readiness checks.",
-    },
-    improvePreparation: {
-        id: "improve-preparation",
-        serviceAction: "build-plan-improvement",
-        title: "Improve Build Plan",
-        description: "Use readiness evidence to refine the Build Plan this Preparation uses.",
-    },
-};
-function optionalLine(label, value) {
-    const trimmed = value?.trim();
-    return trimmed ? `${label}: ${trimmed}` : null;
-}
-export function buildPlanAuthoringTaskPrompt(values) {
-    const requestedArtifacts = values.requested_artifacts?.length
-        ? formatRequestedArtifactsForPrompt(values.requested_artifacts)
-        : null;
-    return [
-        `Agent work: ${values.task_prompt}`,
-        requestedArtifacts ? `Requested Artifacts:\n${requestedArtifacts}` : null,
-        optionalLine("Requested Artifacts", values.requested_artifacts_description),
-        optionalLine("Readiness checks", values.readiness_notes),
-    ].filter((line) => Boolean(line)).join("\n");
-}
-const requiredActionText = (field) => z.string().trim().min(1, `${field} is required.`);
-const optionalActionText = z.string().trim();
-const actionIdField = (field) => requiredActionText(field).regex(ActionValueIdPattern, `${field} must use lowercase letters, numbers, and dashes.`);
-const optionalActionIdField = (field) => optionalActionText.refine((value) => value === "" || ActionValueIdPattern.test(value), `${field} must use lowercase letters, numbers, and dashes.`);
-export function packageSchemaFieldErrors(result, pathMap) {
-    if (result.success)
-        return {};
-    const errors = {};
-    for (const issue of result.error.issues) {
-        const path = issue.path.join(".");
-        const key = pathMap[path] ?? pathMap[issue.path.at(-1)?.toString() ?? ""] ?? "";
-        if (key && !errors[key])
-            errors[key] = issue.message;
-    }
-    return errors;
-}
-export function slugForActionId(value) {
-    const slug = value
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-+|-+$/g, "")
-        .slice(0, 72)
-        .replace(/-+$/g, "");
-    return slug || "preparation";
-}
-export function uniqueActionId(seed, usedIds) {
-    const base = slugForActionId(seed);
-    if (!usedIds.has(base))
-        return base;
-    for (let index = 2; index < 100; index += 1) {
-        const candidate = `${base}-${index}`;
-        if (!usedIds.has(candidate))
-            return candidate;
-    }
-    return `${base}-${Date.now().toString(36)}`;
-}
-export function titleFromActionId(value) {
-    return value
-        .split("-")
-        .filter(Boolean)
-        .map((part) => `${part.charAt(0).toUpperCase()}${part.slice(1)}`)
-        .join(" ");
-}
-export function maybeActionValue(value) {
-    const trimmed = value.trim();
-    return trimmed.length > 0 ? trimmed : undefined;
-}
-function inputValue(values, key) {
-    return values[key] ?? "";
-}
-export function buildPlanChoiceOptions(buildPlans) {
-    const seen = new Set();
-    const options = [];
-    for (const buildPlan of [{ id: "interf-default", label: "interf-default" }, ...buildPlans]) {
-        if (seen.has(buildPlan.id))
-            continue;
-        seen.add(buildPlan.id);
-        options.push({ label: buildPlan.label ?? buildPlan.id, value: buildPlan.id });
-    }
-    return options;
-}
-export function buildPlanTaskPromptFromInput(values) {
-    const parsed = BuildPlanAuthoringActionValuesSchema.safeParse(values);
-    if (parsed.success)
-        return buildPlanAuthoringTaskPrompt(parsed.data);
-    const taskPrompt = inputValue(values, "task_prompt");
-    const requestedArtifactsDescription = inputValue(values, "requested_artifacts_description");
-    const readinessNotes = inputValue(values, "readiness_notes");
-    return [
-        `Agent work: ${taskPrompt}`,
-        maybeActionValue(requestedArtifactsDescription) ? `Requested Artifacts: ${requestedArtifactsDescription}` : null,
-        maybeActionValue(readinessNotes) ? `Readiness checks: ${readinessNotes}` : null,
-    ].filter((line) => Boolean(line)).join("\n");
-}
-function createPreparationSchema(existingNames) {
-    return z.object({
-        name: actionIdField("Preparation name"),
-        path: requiredActionText("Source Folder"),
-        about: requiredActionText("Agent work"),
-        build_plan: optionalActionIdField("Build Plan"),
-        readiness_notes: optionalActionText,
-    }).strict().superRefine((values, ctx) => {
-        if (existingNames.has(values.name)) {
-            ctx.addIssue({
-                code: z.ZodIssueCode.custom,
-                path: ["name"],
-                message: "A Preparation with this name already exists.",
-            });
-        }
-    });
-}
-function prepareRunSchema() {
-    return z.object({
-        preparation: actionIdField("Preparation"),
-        build_plan: optionalActionIdField("Build Plan"),
-        about: optionalActionText,
-        source_folder_path: optionalActionText,
-    }).strict();
-}
-function selectBuildPlanSchema() {
-    return z.object({
-        name: actionIdField("Preparation"),
-        path: requiredActionText("Source Folder"),
-        about: requiredActionText("Agent work"),
-        current_build_plan: optionalActionIdField("Current Build Plan"),
-        build_plan: actionIdField("Build Plan"),
-    }).strict();
-}
-function buildPlanAuthoringSchema(existingBuildPlanIds) {
-    return z.object({
-        build_plan_id: optionalActionIdField("Build Plan id"),
-        label: optionalActionText,
-        hint: optionalActionText,
-        task_prompt: requiredActionText("Agent work"),
-        requested_artifacts_description: optionalActionText,
-        readiness_notes: optionalActionText,
-    }).strict().superRefine((values, ctx) => {
-        const explicitBuildPlanId = maybeActionValue(values.build_plan_id ?? "");
-        if (explicitBuildPlanId && existingBuildPlanIds.has(explicitBuildPlanId)) {
-            ctx.addIssue({
-                code: z.ZodIssueCode.custom,
-                path: ["build_plan_id"],
-                message: "A Build Plan with this id already exists.",
-            });
-        }
-    });
-}
-function buildPlanChangeSchema(action, buildPlanId, existingBuildPlanIds) {
-    const base = {
-        action: requiredActionText("Action"),
-        build_plan: actionIdField("Build Plan"),
-        preparation: optionalActionIdField("Preparation"),
-    };
-    if (action === "modify") {
-        return z.object({
-            ...base,
-            change_request: requiredActionText("Requested change"),
-            label: optionalActionText,
-            hint: optionalActionText,
-        }).strict();
-    }
-    if (action === "duplicate") {
-        return z.object({
-            ...base,
-            new_build_plan_id: actionIdField("New Build Plan id"),
-        }).strict().superRefine((values, ctx) => {
-            if (existingBuildPlanIds.has(values.new_build_plan_id)) {
-                ctx.addIssue({
-                    code: z.ZodIssueCode.custom,
-                    path: ["new_build_plan_id"],
-                    message: "A Build Plan with this id already exists.",
-                });
-            }
-        });
-    }
-    return z.object({
-        ...base,
-        confirmation: requiredActionText("Confirmation").refine((value) => value === buildPlanId, `Type ${buildPlanId} to confirm.`),
-    }).strict();
-}
-function preparationChangeSchema(action, preparation, existingNames) {
-    const base = {
-        action: requiredActionText("Action"),
-        preparation: actionIdField("Preparation"),
-    };
-    if (action === "modify") {
-        return z.object({
-            ...base,
-            name: actionIdField("Preparation id"),
-            path: requiredActionText("Source Folder"),
-            about: requiredActionText("Agent work"),
-            build_plan: optionalActionIdField("Build Plan"),
-        }).strict().superRefine((values, ctx) => {
-            if (values.name !== preparation && existingNames.has(values.name)) {
-                ctx.addIssue({
-                    code: z.ZodIssueCode.custom,
-                    path: ["name"],
-                    message: "A Preparation with this name already exists.",
-                });
-            }
-        });
-    }
-    if (action === "duplicate") {
-        return z.object({
-            ...base,
-            name: actionIdField("New Preparation id"),
-            path: requiredActionText("Source Folder"),
-            about: requiredActionText("Agent work"),
-            build_plan: optionalActionIdField("Build Plan"),
-        }).strict().superRefine((values, ctx) => {
-            if (existingNames.has(values.name)) {
-                ctx.addIssue({
-                    code: z.ZodIssueCode.custom,
-                    path: ["name"],
-                    message: "A Preparation with this name already exists.",
-                });
-            }
-        });
-    }
-    return z.object({
-        ...base,
-        confirmation: requiredActionText("Confirmation").refine((value) => value === preparation, `Type ${preparation} to confirm.`),
-    }).strict();
-}
-function conciseSummary(value, fallback) {
-    const normalized = value.replace(/\s+/g, " ").trim();
-    if (!normalized)
-        return fallback;
-    const sentence = normalized.match(/^.{24,180}?(?:[.!?](?:\s|$)|$)/)?.[0]?.trim() ?? normalized;
-    return sentence.length > 180 ? `${sentence.slice(0, 177).trim()}...` : sentence;
-}
-function normalizedBuildPlanActionValues(values, existingBuildPlanIds, defaultSeed) {
-    const explicitBuildPlanId = maybeActionValue(inputValue(values, "build_plan_id"));
-    const taskPrompt = inputValue(values, "task_prompt").trim();
-    const buildPlanId = explicitBuildPlanId ?? uniqueActionId(taskPrompt || defaultSeed || "custom-build-plan", existingBuildPlanIds);
-    const output = maybeActionValue(inputValue(values, "requested_artifacts_description"));
-    return {
-        ...values,
-        build_plan_id: buildPlanId,
-        label: maybeActionValue(inputValue(values, "label")) ?? titleFromActionId(buildPlanId),
-        hint: maybeActionValue(inputValue(values, "hint")) ?? conciseSummary(output ?? taskPrompt, "Reusable Build Plan for building Artifacts."),
-        task_prompt: taskPrompt,
-    };
-}
-function createPreparationActionValues(values) {
-    const buildPlan = inputValue(values, "build_plan");
-    const readinessNotes = inputValue(values, "readiness_notes");
-    return {
-        name: inputValue(values, "name"),
-        path: inputValue(values, "path"),
-        about: inputValue(values, "about"),
-        build_after_setup: false,
-        ...(maybeActionValue(buildPlan) ? { build_plan: buildPlan } : {}),
-        ...(maybeActionValue(readinessNotes) ? { readiness_notes: readinessNotes } : {}),
-    };
-}
-function selectBuildPlanActionValues(values) {
-    return {
-        name: inputValue(values, "name"),
-        path: inputValue(values, "path"),
-        about: inputValue(values, "about"),
-        build_plan: inputValue(values, "build_plan"),
-        build_after_setup: false,
-        setup_mode: "select-build-plan",
-    };
-}
-export function preparationSetupRequestFromActionValues(input) {
-    const values = PreparationSetupActionValuesSchema.parse(input);
-    const buildPlan = values.build_plan;
-    return {
-        build_after_setup: values.build_after_setup ?? false,
-        setup_mode: values.setup_mode === "select-build-plan" ? "select-build-plan" : "create",
-        preparation: {
-            name: values.name,
-            path: values.path,
-            about: values.about,
-            ...(buildPlan && buildPlan.length > 0 ? { build_plan: buildPlan } : {}),
-            checks: values.checks ?? [],
-            ...(values.requested_artifacts ? { requested_artifacts: values.requested_artifacts } : {}),
-            ...(values.source_profile ? { source_profile: values.source_profile } : {}),
-            ...(typeof values.max_attempts === "number" ? { max_attempts: values.max_attempts } : {}),
-            ...(typeof values.max_loops === "number" ? { max_loops: values.max_loops } : {}),
-        },
-    };
-}
-export function buildPlanAuthoringRequestFromActionValues(input, context) {
-    const values = BuildPlanAuthoringActionValuesSchema.parse(input);
-    const buildPlanId = values.build_plan_id ?? values.build_plan_id;
-    if (!buildPlanId) {
-        throw new Error("Build Plan id is required.");
-    }
-    const taskPrompt = buildPlanAuthoringTaskPrompt(values);
-    const requestedArtifacts = values.requested_artifacts ?? context.requestedArtifacts ?? [];
-    const sourceProfile = values.source_profile ?? context.sourceProfile ?? null;
-    return {
-        ...(context.preparation ? { preparation: context.preparation } : {}),
-        source_folder_path: context.sourceFolderPath,
-        ...(values.base_build_plan_id ?? values.base_build_plan_id ? { base_build_plan_id: values.base_build_plan_id ?? values.base_build_plan_id } : {}),
-        ...(values.reference_build_plan_id ?? values.reference_build_plan_id ? { reference_build_plan_id: values.reference_build_plan_id ?? values.reference_build_plan_id } : {}),
-        build_plan_id: buildPlanId,
-        label: values.label ?? titleFromActionId(buildPlanId),
-        hint: values.hint ?? conciseSummary(values.requested_artifacts_description ?? values.task_prompt, "Reusable Build Plan for building Artifacts."),
-        task_prompt: taskPrompt,
-        checks: context.checks ?? [],
-        requested_artifacts: requestedArtifacts,
-        source_profile: sourceProfile,
-        artifact_requirements: artifactRequirementsFromRequestedArtifacts(requestedArtifacts),
-    };
-}
-export function buildPlanImprovementActionValues(options) {
-    const readinessNotes = (options.checks ?? [])
-        .map((check) => check.question)
-        .filter((question) => question.trim().length > 0)
-        .join("\n");
-    return {
-        build_plan_id: options.buildPlanId,
-        reference_build_plan_id: options.buildPlanId,
-        ...(maybeActionValue(options.label ?? "") ? { label: options.label } : {}),
-        ...(maybeActionValue(options.hint ?? "") ? { hint: options.hint } : {}),
-        task_prompt: `Improve Build Plan ${options.buildPlanId} using the latest readiness evidence for Preparation ${options.preparationName}.`,
-        ...(maybeActionValue(readinessNotes) ? { readiness_notes: readinessNotes } : {}),
-    };
-}
-function buildPlanAuthoringActionValues(values) {
-    const buildPlanId = inputValue(values, "build_plan_id");
-    const label = inputValue(values, "label");
-    const hint = inputValue(values, "hint");
-    const requestedArtifactsDescription = inputValue(values, "requested_artifacts_description");
-    const readinessNotes = inputValue(values, "readiness_notes");
-    return {
-        ...(maybeActionValue(buildPlanId) ? { build_plan_id: buildPlanId } : {}),
-        ...(maybeActionValue(label) ? { label } : {}),
-        ...(maybeActionValue(hint) ? { hint } : {}),
-        task_prompt: inputValue(values, "task_prompt"),
-        ...(maybeActionValue(requestedArtifactsDescription) ? { requested_artifacts_description: requestedArtifactsDescription } : {}),
-        ...(maybeActionValue(readinessNotes) ? { readiness_notes: readinessNotes } : {}),
-    };
-}
-function buildPlanChangeActionValues(action, values) {
-    if (action === "modify") {
-        const buildPlanId = inputValue(values, "build_plan");
-        return {
-            build_plan_id: buildPlanId,
-            reference_build_plan_id: buildPlanId,
-            ...(maybeActionValue(inputValue(values, "label")) ? { label: inputValue(values, "label") } : {}),
-            ...(maybeActionValue(inputValue(values, "hint")) ? { hint: inputValue(values, "hint") } : {}),
-            task_prompt: [
-                `Modify Build Plan ${buildPlanId}.`,
-                inputValue(values, "change_request"),
-            ].filter(Boolean).join("\n"),
-        };
-    }
-    if (action === "duplicate") {
-        const newBuildPlanId = inputValue(values, "new_build_plan_id");
-        return {
-            action_type: "build-plan-change",
-            operation: "duplicate",
-            build_plan: inputValue(values, "build_plan"),
-            new_build_plan_id: newBuildPlanId,
-            label: titleFromActionId(newBuildPlanId),
-            hint: `Duplicate of ${inputValue(values, "build_plan")}`,
-        };
-    }
-    return {
-        action_type: "build-plan-change",
-        operation: "remove",
-        build_plan: inputValue(values, "build_plan"),
-        confirmation: inputValue(values, "confirmation"),
-    };
-}
-function duplicatePreparationActionValues(values) {
-    const buildPlan = inputValue(values, "build_plan");
-    return {
-        name: inputValue(values, "name"),
-        path: inputValue(values, "path"),
-        about: inputValue(values, "about"),
-        build_after_setup: false,
-        setup_mode: "create",
-        ...(maybeActionValue(buildPlan) ? { build_plan: buildPlan } : {}),
-    };
-}
-function preparationChangeActionValues(action, values) {
-    if (action === "modify" || action === "duplicate")
-        return duplicatePreparationActionValues(values);
-    return {
-        action_type: "preparation-change",
-        operation: "remove",
-        preparation: inputValue(values, "preparation"),
-        confirmation: inputValue(values, "confirmation"),
-    };
-}
-export function buildCreatePreparationActionDefinition(context) {
-    const existingNames = new Set(context.existingNames);
-    const name = uniqueActionId(context.suggestedName, existingNames);
-    return {
-        id: INTERF_SERVICE_ACTIONS.createPreparation.id,
-        title: INTERF_SERVICE_ACTIONS.createPreparation.title,
-        description: "Describe the Source and agent job. Interf saves a Preparation so a Build Plan can be drafted and reviewed before build.",
-        submitLabel: "Create",
-        initialValues: {
-            name,
-            path: context.prepDataDir,
-            about: "",
-            readiness_notes: "",
-        },
-        schema: createPreparationSchema(existingNames),
-        validateRequest: (values) => packageSchemaFieldErrors(PreparationSetupActionValuesSchema.safeParse(createPreparationActionValues(values)), {
-            name: "name",
-            path: "path",
-            about: "about",
-            build_plan: "build_plan",
-        }),
-        valuesPreview: createPreparationActionValues,
-        buildDraft: (values) => {
-            const actionValues = createPreparationActionValues(values);
-            const readinessNotes = inputValue(values, "readiness_notes");
-            return {
-                preparation: inputValue(values, "name"),
-                values: actionValues,
-                message: [
-                    `Create Preparation ${inputValue(values, "name")}.`,
-                    `Agent work: ${inputValue(values, "about")}`,
-                    maybeActionValue(readinessNotes) ? `Requested Artifacts and readiness: ${readinessNotes}` : null,
-                    `Source folder: ${inputValue(values, "path")}`,
-                    "Draft or select the Build Plan after this Preparation exists. Do not build yet.",
-                    "Use the attached typed action input as the source of truth.",
-                ].filter((line) => Boolean(line)).join("\n"),
-            };
-        },
-        fields: [
-            {
-                name: "path",
-                label: "Source folder",
-                type: "text",
-                help: "Absolute path to the folder Interf will read from. Files stay where they are; Interf reads them by reference.",
-                context: "Saved as the Preparation's source binding and sent as typed action input.",
-                placeholder: context.prepDataDir || "/Users/you/Documents/your-folder",
-            },
-            {
-                name: "about",
-                label: "Agent job",
-                type: "textarea",
-                rows: 4,
-                help: "The concrete work this Preparation should enable.",
-                context: "Saved as the Preparation intent and sent as typed action input.",
-                placeholder: "Example: Analyze every report chart, extract annual take-up by location, and produce a source data file plus markdown summary.",
-            },
-            {
-                name: "readiness_notes",
-                label: "Requested Artifacts",
-                type: "textarea",
-                rows: 3,
-                help: "Artifacts, coverage, and proof the agent needs before it can trust the Source.",
-                context: "Used as guidance when Interf drafts the Build Plan and readiness checks for review.",
-                placeholder: "Example: Extract every chart, produce a source data file, write a markdown summary, and show evidence for every location.",
-            },
-        ],
-    };
-}
-export function buildBuildRunActionDefinition(context) {
-    return {
-        id: INTERF_SERVICE_ACTIONS.buildRun.id,
-        title: INTERF_SERVICE_ACTIONS.buildRun.title,
-        description: "Build verifiable context for this Preparation. Interf will run the saved Build Plan against the Source and record a visible run.",
-        submitLabel: "Run",
-        initialValues: {
-            preparation: context.name,
-            build_plan: context.buildPlanId,
-            about: context.about,
-            source_folder_path: context.sourceFolderPath,
-        },
-        schema: prepareRunSchema(),
-        valuesPreview: (values) => ({
-            action_type: INTERF_SERVICE_ACTIONS.buildRun.serviceAction,
-            preparation: inputValue(values, "preparation"),
-            build_plan: inputValue(values, "build_plan"),
-            source_folder_path: inputValue(values, "source_folder_path"),
-            about: inputValue(values, "about"),
-        }),
-        buildDraft: (values) => ({
-            preparation: inputValue(values, "preparation"),
-            values: {
-                action_type: INTERF_SERVICE_ACTIONS.buildRun.serviceAction,
-                preparation: inputValue(values, "preparation"),
-                ...(maybeActionValue(inputValue(values, "build_plan")) ? { build_plan: inputValue(values, "build_plan") } : {}),
-            },
-            message: [
-                `Build Artifacts for Preparation ${inputValue(values, "preparation")}.`,
-                maybeActionValue(inputValue(values, "about")) ? `Agent work: ${inputValue(values, "about")}` : null,
-                `Build Plan: ${inputValue(values, "build_plan") || "(saved selection)"}.`,
-                "Build verifiable context from the saved Source and requested Artifacts.",
-                "Use the attached typed action input as the source of truth.",
-            ].filter((line) => Boolean(line)).join("\n"),
-        }),
-        fields: [
-            {
-                name: "preparation",
-                label: "Preparation",
-                type: "text",
-                readOnly: true,
-                help: "The saved Preparation that will be built.",
-                context: "Sent as the build target.",
-            },
-            {
-                name: "build_plan",
-                label: "Build Plan",
-                type: "text",
-                readOnly: true,
-                help: "The Build Plan Interf will run to build the requested Artifacts.",
-                context: "Sent as the Build Plan override.",
-            },
-            {
-                name: "about",
-                label: "Agent job",
-                type: "textarea",
-                readOnly: true,
-                advanced: true,
-                help: "The work this Preparation is meant to support.",
-                context: "Preserved as context for the Build run proposal.",
-                placeholder: "No saved job description.",
-            },
-            {
-                name: "source_folder_path",
-                label: "Source Folder",
-                type: "text",
-                readOnly: true,
-                advanced: true,
-                help: "The local folder Interf will read.",
-                context: "Resolved from the saved Preparation.",
-            },
-        ],
-    };
-}
-export function buildBuildRunActionDraft(context) {
-    const definition = buildBuildRunActionDefinition(context);
-    return definition.buildDraft(definition.initialValues);
-}
-export function buildSelectBuildPlanActionDefinition(context) {
-    const actionValues = (values) => ({
-        ...selectBuildPlanActionValues(values),
-        checks: context.checks ?? [],
-        requested_artifacts: context.requestedArtifacts ?? [],
-        ...(context.sourceProfile ? { source_profile: context.sourceProfile } : {}),
-        ...(typeof context.maxAttempts === "number" ? { max_attempts: context.maxAttempts } : {}),
-        ...(typeof context.maxLoops === "number" ? { max_loops: context.maxLoops } : {}),
-    });
-    return {
-        id: INTERF_SERVICE_ACTIONS.selectBuildPlan.id,
-        title: INTERF_SERVICE_ACTIONS.selectBuildPlan.title,
-        description: "Choose the Build Plan that builds this Preparation's requested Artifacts. This saves the selection without running a Build run.",
-        submitLabel: "Confirm",
-        initialValues: {
-            name: context.name,
-            path: context.sourceFolderPath,
-            about: context.about,
-            current_build_plan: context.currentBuildPlanId ?? "",
-            build_plan: context.currentBuildPlanId ?? "",
-        },
-        schema: selectBuildPlanSchema(),
-        validateRequest: (values) => packageSchemaFieldErrors(PreparationSetupActionValuesSchema.safeParse(actionValues(values)), {
-            name: "name",
-            path: "path",
-            about: "about",
-            build_plan: "build_plan",
-        }),
-        valuesPreview: actionValues,
-        buildDraft: (values) => ({
-            preparation: inputValue(values, "name"),
-            values: actionValues(values),
-            message: [
-                `Select Build Plan ${inputValue(values, "build_plan")} for Preparation ${inputValue(values, "name")}.`,
-                "Save the selected Build Plan. Do not build yet.",
-                "Use the attached typed action input as the source of truth.",
-            ].join("\n"),
-        }),
-        fields: [
-            {
-                name: "build_plan",
-                label: "Build Plan",
-                type: "select",
-                help: "The Build Plan future Build runs should use to build requested Artifacts.",
-                context: "Saved on the existing Preparation.",
-                options: buildPlanChoiceOptions(context.buildPlans),
-            },
-            {
-                name: "current_build_plan",
-                label: "Current Build Plan",
-                type: "text",
-                readOnly: true,
-                help: "The Build Plan currently saved for this Preparation.",
-                context: "Shown so the change is explicit before approval.",
-            },
-            {
-                name: "name",
-                label: "Preparation",
-                type: "text",
-                readOnly: true,
-                advanced: true,
-                help: "The Preparation whose Build Plan selection will be updated.",
-                context: "Sent with the setup action.",
-            },
-            {
-                name: "about",
-                label: "Agent job",
-                type: "textarea",
-                readOnly: true,
-                advanced: true,
-                help: "The saved job intent for this Preparation.",
-                context: "Preserved while updating the selected Build Plan.",
-            },
-            {
-                name: "path",
-                label: "Source Folder",
-                type: "text",
-                readOnly: true,
-                advanced: true,
-                help: "The saved Source Folder path.",
-                context: "Preserved while updating the selected Build Plan.",
-            },
-        ],
-    };
-}
-export function buildCreateBuildPlanActionDefinition(context) {
-    const existingBuildPlanIds = new Set(context.existingBuildPlanIds);
-    const defaultSeed = context.defaultPreparation ? `${context.defaultPreparation}-build-plan` : context.suggestedBuildPlanId;
-    const buildPlanId = uniqueActionId(defaultSeed, existingBuildPlanIds);
-    const label = titleFromActionId(buildPlanId);
-    return {
-        id: INTERF_SERVICE_ACTIONS.createBuildPlan.id,
-        title: INTERF_SERVICE_ACTIONS.createBuildPlan.title,
-        description: "Describe the Artifacts the agent needs. Interf drafts the Build Plan from this description; the Build run later proves source coverage.",
-        submitLabel: "Send Request",
-        initialValues: {
-            build_plan_id: "",
-            label: "",
-            hint: "",
-            task_prompt: "",
-            requested_artifacts_description: "",
-            readiness_notes: "",
-        },
-        normalizeValues: (values) => normalizedBuildPlanActionValues(values, existingBuildPlanIds, defaultSeed),
-        schema: buildPlanAuthoringSchema(existingBuildPlanIds),
-        validateRequest: (values) => packageSchemaFieldErrors(BuildPlanAuthoringActionValuesSchema.safeParse(buildPlanAuthoringActionValues(values)), {
-            build_plan_id: "build_plan_id",
-            label: "label",
-            hint: "hint",
-            task_prompt: "task_prompt",
-            requested_artifacts_description: "requested_artifacts_description",
-            readiness_notes: "readiness_notes",
-        }),
-        valuesPreview: (values) => ({
-            build_plan_id: inputValue(values, "build_plan_id"),
-            label: inputValue(values, "label"),
-            hint: inputValue(values, "hint"),
-            task_prompt: buildPlanTaskPromptFromInput(values),
-        }),
-        buildDraft: (values) => ({
-            preparation: context.defaultPreparation,
-            values: buildPlanAuthoringActionValues(values),
-            message: [
-                `Draft Build Plan ${inputValue(values, "build_plan_id")}${context.defaultPreparation ? ` for Preparation ${context.defaultPreparation}` : ""}.`,
-                `Label: ${inputValue(values, "label")}`,
-                `Summary: ${inputValue(values, "hint")}`,
-                buildPlanTaskPromptFromInput(values),
-                "Use the attached typed action input as the Build Plan authoring request.",
-            ].join("\n"),
-        }),
-        fields: [
-            {
-                name: "task_prompt",
-                label: "Agent work",
-                type: "textarea",
-                rows: 4,
-                help: "The agent task this Preparation should unlock.",
-                context: "Used as the main Build Plan authoring instruction.",
-                placeholder: "Example: Analyze every report chart, extract annual take-up by location, and produce a source data file plus markdown summary.",
-            },
-            {
-                name: "requested_artifacts_description",
-                label: "Requested Artifacts",
-                type: "textarea",
-                rows: 3,
-                help: "Files, sections, or evidence agents should receive in verifiable context.",
-                context: "Guides the requested Artifact shape and Build Plan stages before a Build run proves source coverage.",
-                placeholder: "Describe the files or sections agents should receive.",
-            },
-            {
-                name: "readiness_notes",
-                label: "Readiness guidance",
-                type: "textarea",
-                rows: 3,
-                help: "What these Artifacts should be able to prove.",
-                context: "Guides readiness checks. Artifact contract checks stay separate.",
-                placeholder: "Describe the evidence that should make these Artifacts ready.",
-            },
-            {
-                name: "build_plan_id",
-                label: "Build Plan id",
-                type: "text",
-                advanced: true,
-                help: "Optional. Leave blank and Interf generates a stable id from the job.",
-                context: "Saved as the Build Plan id and referenced by Preparations.",
-                placeholder: buildPlanId,
-            },
-            {
-                name: "label",
-                label: "Label",
-                type: "text",
-                advanced: true,
-                help: "Optional readable name people can choose later.",
-                context: "Shown in the UI and sent to the local agent while drafting the Build Plan.",
-                placeholder: label,
-            },
-            {
-                name: "hint",
-                label: "Summary",
-                type: "textarea",
-                advanced: true,
-                rows: 2,
-                help: "Optional short description. Interf derives one from the job if left blank.",
-                context: "Gives the local agent quick context before it drafts stages and outputs.",
-                placeholder: "Prepare charts, tables, and cited findings for analyst agents.",
-            },
-        ],
-    };
-}
-export function buildBuildPlanChangeActionDefinition(context) {
-    const existingBuildPlanIds = new Set(context.existingBuildPlanIds);
-    const actionLabel = titleFromActionId(context.action);
-    const newBuildPlanId = context.action === "duplicate"
-        ? uniqueActionId(`${context.buildPlanId}-copy`, existingBuildPlanIds)
-        : "";
-    const initialValues = {
-        action: `build-plan-${context.action}`,
-        build_plan: context.buildPlanId,
-        preparation: context.preparation,
-        ...(context.action === "modify" ? { change_request: "", label: context.label ?? "", hint: context.hint ?? "" } : {}),
-        ...(context.action === "duplicate" ? { new_build_plan_id: newBuildPlanId } : {}),
-        ...(context.action === "remove" ? { confirmation: "" } : {}),
-    };
-    const actionValues = (values) => buildPlanChangeActionValues(context.action, values);
-    const messageFor = (values) => {
-        if (context.action === "modify") {
-            return [
-                `Modify Build Plan ${inputValue(values, "build_plan")}.`,
-                `Requested change: ${inputValue(values, "change_request")}`,
-                "Use the attached typed Build Plan authoring input as the source of truth.",
-            ].join("\n");
-        }
-        if (context.action === "duplicate") {
-            return [
-                `Duplicate Build Plan ${inputValue(values, "build_plan")} as ${inputValue(values, "new_build_plan_id")}.`,
-                "Use the attached typed Build Plan change input as the source of truth.",
-            ].join("\n");
-        }
-        return [
-            `Remove Build Plan ${inputValue(values, "build_plan")}.`,
-            "The user typed the Build Plan id to confirm removal.",
-            "Use the attached typed Build Plan change input as the source of truth.",
-        ].join("\n");
-    };
-    const fields = [
-        {
-            name: "build_plan",
-            label: "Build Plan",
-            type: "text",
-            readOnly: true,
-            help: "The Build Plan this request targets.",
-            context: "Sent as the Build Plan change target.",
-        },
-        {
-            name: "change_request",
-            label: context.action === "duplicate" ? "Requested difference" : "Requested change",
-            type: "textarea",
-            rows: 4,
-            advanced: context.action === "remove",
-            help: context.action === "duplicate"
-                ? "What should be different in the duplicate Build Plan."
-                : "What should change in the existing Build Plan.",
-            context: "Sent as the human-authored Build Plan change request.",
-            placeholder: "Describe the concrete change Interf should make.",
-        },
-        {
-            name: "new_build_plan_id",
-            label: "New Build Plan id",
-            type: "text",
-            advanced: context.action !== "duplicate",
-            help: "Stable id for the duplicated Build Plan.",
-            context: "Used as the target Build Plan id for the duplicate request.",
-            placeholder: newBuildPlanId,
-        },
-        {
-            name: "confirmation",
-            label: "Confirm removal",
-            type: "text",
-            advanced: context.action !== "remove",
-            help: `Type ${context.buildPlanId} to confirm this removal request.`,
-            context: "Prevents accidental destructive Build Plan requests.",
-            placeholder: context.buildPlanId,
-        },
-        {
-            name: "label",
-            label: "Label",
-            type: "text",
-            advanced: true,
-            help: "Readable Build Plan name to keep while modifying this Build Plan.",
-            context: "Sent to the Build Plan authoring run.",
-            placeholder: context.label ?? context.buildPlanId,
-        },
-        {
-            name: "hint",
-            label: "Summary",
-            type: "textarea",
-            rows: 2,
-            advanced: true,
-            help: "Short Build Plan summary to keep while modifying this Build Plan.",
-            context: "Sent to the Build Plan authoring run.",
-            placeholder: context.hint ?? "Reusable Build Plan for compiling Artifacts.",
-        },
-        {
-            name: "preparation",
-            label: "Preparation",
-            type: "text",
-            readOnly: true,
-            advanced: true,
-            help: "A related Preparation used as context for this request.",
-            context: "Sent with the proposal request when available.",
-            placeholder: "No Preparation selected",
-        },
-    ];
-    return {
-        id: `${INTERF_SERVICE_ACTIONS.buildPlanChange.id}-${context.action}`,
-        title: `${actionLabel} Build Plan`,
-        description: context.action === "remove"
-            ? "Confirm the Build Plan removal request. Interf will reject removal while any saved Preparation still uses it."
-            : context.action === "duplicate"
-                ? "Duplicate this Build Plan through the local Interf service."
-                : "Describe the change and Interf will run a visible Build Plan draft job.",
-        submitLabel: context.action === "modify" ? "Send Request" : "Confirm",
-        initialValues,
-        schema: buildPlanChangeSchema(context.action, context.buildPlanId, existingBuildPlanIds),
-        valuesPreview: actionValues,
-        buildDraft: (values) => ({
-            preparation: inputValue(values, "preparation"),
-            values: actionValues(values),
-            message: messageFor(values),
-        }),
-        fields: fields.filter((field) => {
-            if (field.name === "change_request")
-                return context.action === "modify";
-            if (field.name === "new_build_plan_id")
-                return context.action === "duplicate";
-            if (field.name === "confirmation")
-                return context.action === "remove";
-            if (field.name === "label" || field.name === "hint")
-                return context.action === "modify";
-            return true;
-        }),
-    };
-}
-export function buildPreparationChangeActionDefinition(context) {
-    const existingNames = new Set(context.existingNames);
-    const actionLabel = titleFromActionId(context.action);
-    const duplicateName = context.action === "duplicate"
-        ? uniqueActionId(`${context.preparation}-copy`, existingNames)
-        : "";
-    const initialValues = {
-        action: `preparation-${context.action}`,
-        preparation: context.preparation,
-        ...(context.action === "modify" || context.action === "duplicate"
-            ? {
-                name: context.action === "duplicate" ? duplicateName : context.preparation,
-                path: context.sourceFolderPath,
-                about: context.about ?? "",
-                build_plan: context.buildPlanId ?? "",
-            }
-            : {}),
-        ...(context.action === "remove" ? { confirmation: "" } : {}),
-    };
-    const actionValues = (values) => preparationChangeActionValues(context.action, values);
-    const messageFor = (values) => {
-        if (context.action === "modify") {
-            return [
-                `Modify Preparation ${inputValue(values, "preparation")}.`,
-                `Agent work: ${inputValue(values, "about")}`,
-                maybeActionValue(inputValue(values, "build_plan")) ? `Build Plan: ${inputValue(values, "build_plan")}` : null,
-                `Source folder: ${inputValue(values, "path")}`,
-                "Use the attached typed Preparation setup input as the source of truth.",
-            ].filter((line) => Boolean(line)).join("\n");
-        }
-        if (context.action === "duplicate") {
-            return [
-                `Duplicate Preparation ${inputValue(values, "preparation")} as ${inputValue(values, "name")}.`,
-                `Agent work: ${inputValue(values, "about")}`,
-                maybeActionValue(inputValue(values, "build_plan")) ? `Build Plan: ${inputValue(values, "build_plan")}` : null,
-                `Source folder: ${inputValue(values, "path")}`,
-                "Use the attached typed Preparation setup input as the source of truth.",
-            ].filter((line) => Boolean(line)).join("\n");
-        }
-        return [
-            `Remove Preparation ${inputValue(values, "preparation")}.`,
-            "The user typed the Preparation id to confirm removal.",
-            "Use the attached typed Preparation change input as the source of truth.",
-        ].join("\n");
-    };
-    const fields = [
-        {
-            name: "preparation",
-            label: "Preparation",
-            type: "text",
-            readOnly: true,
-            help: "The saved Preparation this request targets.",
-            context: "Sent as the Preparation target.",
-        },
-        {
-            name: "name",
-            label: context.action === "duplicate" ? "New Preparation id" : "Preparation id",
-            type: "text",
-            readOnly: context.action === "modify",
-            help: context.action === "duplicate"
-                ? "Stable id for the duplicated Preparation."
-                : "Stable id for this Preparation.",
-            context: "Saved as the Preparation name.",
-            placeholder: duplicateName || context.preparation,
-        },
-        {
-            name: "about",
-            label: "Agent job",
-            type: "textarea",
-            rows: 4,
-            help: "The concrete work this Preparation should support.",
-            context: "Saved as the Preparation intent.",
-            placeholder: "Describe the agent job.",
-        },
-        {
-            name: "build_plan",
-            label: "Build Plan",
-            type: "text",
-            help: "The Build Plan future Build runs should use.",
-            context: "Saved on this Preparation.",
-            placeholder: "interf-default",
-        },
-        {
-            name: "path",
-            label: "Source Folder",
-            type: "text",
-            readOnly: true,
-            advanced: context.action === "modify",
-            help: "The Source Folder for this Preparation.",
-            context: "Saved on this Preparation.",
-        },
-        {
-            name: "confirmation",
-            label: "Confirm removal",
-            type: "text",
-            help: `Type ${context.preparation} to confirm this removal request.`,
-            context: "Prevents accidental destructive Preparation requests.",
-            placeholder: context.preparation,
-        },
-    ];
-    return {
-        id: `${INTERF_SERVICE_ACTIONS.preparationChange.id}-${context.action}`,
-        title: `${actionLabel} Preparation`,
-        description: context.action === "remove"
-            ? "Confirm the Preparation removal request before Interf removes it from the saved config."
-            : context.action === "duplicate"
-                ? "Describe the new Preparation created from this saved Source Folder."
-                : "Update the saved Preparation fields through the local Interf service.",
-        submitLabel: "Confirm",
-        initialValues,
-        schema: preparationChangeSchema(context.action, context.preparation, existingNames),
-        validateRequest: context.action === "modify" || context.action === "duplicate"
-            ? (values) => packageSchemaFieldErrors(PreparationSetupActionValuesSchema.safeParse(duplicatePreparationActionValues(values)), {
-                name: "name",
-                path: "path",
-                about: "about",
-                build_plan: "build_plan",
-            })
-            : undefined,
-        valuesPreview: actionValues,
-        buildDraft: (values) => ({
-            preparation: inputValue(values, "preparation"),
-            values: actionValues(values),
-            message: messageFor(values),
-        }),
-        fields: fields.filter((field) => {
-            if (field.name === "name" || field.name === "about" || field.name === "build_plan" || field.name === "path")
-                return context.action === "modify" || context.action === "duplicate";
-            if (field.name === "confirmation")
-                return context.action === "remove";
-            return true;
-        }),
-    };
-}
-export function buildConfirmActionDefinition(draft) {
-    return {
-        id: INTERF_SERVICE_ACTIONS.confirmAction.id,
-        title: INTERF_SERVICE_ACTIONS.confirmAction.title,
-        description: "This request will be sent to the local Interf service to create an approval proposal.",
-        submitLabel: "Send Request",
-        initialValues: {
-            preparation: draft.preparation,
-            message: draft.message,
-        },
-        schema: z.object({
-            preparation: optionalActionText,
-            message: requiredActionText("Action"),
-        }).strict(),
-        valuesPreview: () => draft.values ?? { message: draft.message },
-        buildDraft: () => ({ ...draft, confirmed: true }),
-        fields: [
-            {
-                name: "preparation",
-                label: "Preparation",
-                type: "text",
-                readOnly: true,
-                help: "The Preparation this action targets.",
-                context: "Sent with the proposal request.",
-                placeholder: "No Preparation selected",
-            },
-            {
-                name: "message",
-                label: "Request to Interf service",
-                type: "textarea",
-                readOnly: true,
-                rows: 5,
-                help: "Interf sends this request with typed values so the local service can propose the concrete action.",
-                context: "Sent to the local Interf service together with typed action values when available.",
-            },
-        ],
-    };
-}
-export function buildReadinessActionDraft(options) {
-    if (options.action === "check") {
-        return {
-            preparation: options.preparation,
-            message: `Check readiness for ${options.preparation}.`,
-            values: {
-                action_type: INTERF_SERVICE_ACTIONS.checkReadiness.serviceAction,
-                preparation: options.preparation,
-            },
-        };
-    }
-    if (options.action === "draft-checks") {
-        return {
-            preparation: options.preparation,
-            message: `Draft readiness checks for ${options.preparation}.`,
-            values: {
-                action_type: INTERF_SERVICE_ACTIONS.draftReadinessChecks.serviceAction,
-                preparation: options.preparation,
-            },
-        };
-    }
-    return {
-        preparation: options.preparation,
-        message: `Improve ${options.preparation} using the latest readiness evidence.`,
-        values: {
-            action_type: INTERF_SERVICE_ACTIONS.improvePreparation.serviceAction,
-            ...(options.buildPlanId ? { build_plan: options.buildPlanId } : {}),
-            preparation: options.preparation,
-        },
-    };
-}