@interf/compiler 0.22.2 → 0.50.0

package/dist/packages/engine/action-definitions.d.ts

@@ -1,407 +0,0 @@
-import { z } from "zod";
-import { type RequestedArtifact, type SourceProfile } from "../project/lib/schema.js";
-import { artifactRequirementsFromRequestedArtifacts } from "./requested-artifacts.js";
-export declare const ActionValueIdPattern: RegExp;
-export declare const ActionValueIdSchema: z.ZodString;
-export declare const OptionalActionValueIdSchema: z.ZodString;
-export declare const SourceReadinessCheckActionValueSchema: z.ZodObject<{
-    question: z.ZodString;
-    answer: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-export declare const RequestedArtifactActionValueSchema: z.ZodPreprocess<z.ZodObject<{
-    id: z.ZodOptional<z.ZodString>;
-    title: z.ZodString;
-    purpose: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
-    checks: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-        label: z.ZodString;
-    }, z.core.$loose>]>>>;
-    output: z.ZodOptional<z.ZodObject<{
-        path: z.ZodOptional<z.ZodString>;
-        shape: z.ZodOptional<z.ZodObject<{
-            kind: z.ZodLiteral<"path">;
-            path: z.ZodString;
-            artifact_kind: z.ZodEnum<{
-                file: "file";
-                directory: "directory";
-            }>;
-        }, z.core.$strict>>;
-        checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            kind: z.ZodEnum<{
-                file_exists: "file_exists";
-                min_file_count: "min_file_count";
-                min_file_count_matches_source: "min_file_count_matches_source";
-                frontmatter_valid: "frontmatter_valid";
-                frontmatter_required_keys: "frontmatter_required_keys";
-                wikilinks_valid: "wikilinks_valid";
-                must_not_contain: "must_not_contain";
-                must_contain: "must_contain";
-                qa_match: "qa_match";
-            }>;
-            description: z.ZodOptional<z.ZodString>;
-            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-            required: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strict>>>;
-        stage_hint: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>;
-}, z.core.$strict>>;
-export declare const SourceProfileActionValueSchema: z.ZodObject<{
-    summary: z.ZodOptional<z.ZodString>;
-    items: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        name: z.ZodOptional<z.ZodString>;
-        path: z.ZodOptional<z.ZodString>;
-        kind: z.ZodOptional<z.ZodString>;
-        page_count: z.ZodOptional<z.ZodNumber>;
-        note: z.ZodOptional<z.ZodString>;
-    }, z.core.$loose>>>;
-    observations: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    limitations: z.ZodDefault<z.ZodArray<z.ZodString>>;
-}, z.core.$loose>;
-export declare const PreparationSetupActionValuesSchema: z.ZodObject<{
-    name: z.ZodString;
-    path: z.ZodString;
-    about: z.ZodString;
-    build_plan: z.ZodOptional<z.ZodString>;
-    checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        question: z.ZodString;
-        answer: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>>>;
-    requested_artifacts: z.ZodOptional<z.ZodArray<z.ZodPreprocess<z.ZodObject<{
-        id: z.ZodOptional<z.ZodString>;
-        title: z.ZodString;
-        purpose: z.ZodOptional<z.ZodString>;
-        description: z.ZodOptional<z.ZodString>;
-        checks: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-            label: z.ZodString;
-        }, z.core.$loose>]>>>;
-        output: z.ZodOptional<z.ZodObject<{
-            path: z.ZodOptional<z.ZodString>;
-            shape: z.ZodOptional<z.ZodObject<{
-                kind: z.ZodLiteral<"path">;
-                path: z.ZodString;
-                artifact_kind: z.ZodEnum<{
-                    file: "file";
-                    directory: "directory";
-                }>;
-            }, z.core.$strict>>;
-            checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                id: z.ZodString;
-                kind: z.ZodEnum<{
-                    file_exists: "file_exists";
-                    min_file_count: "min_file_count";
-                    min_file_count_matches_source: "min_file_count_matches_source";
-                    frontmatter_valid: "frontmatter_valid";
-                    frontmatter_required_keys: "frontmatter_required_keys";
-                    wikilinks_valid: "wikilinks_valid";
-                    must_not_contain: "must_not_contain";
-                    must_contain: "must_contain";
-                    qa_match: "qa_match";
-                }>;
-                description: z.ZodOptional<z.ZodString>;
-                params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-                required: z.ZodDefault<z.ZodBoolean>;
-            }, z.core.$strict>>>;
-            stage_hint: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>>;
-    }, z.core.$strict>>>>;
-    source_profile: z.ZodOptional<z.ZodObject<{
-        summary: z.ZodOptional<z.ZodString>;
-        items: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            name: z.ZodOptional<z.ZodString>;
-            path: z.ZodOptional<z.ZodString>;
-            kind: z.ZodOptional<z.ZodString>;
-            page_count: z.ZodOptional<z.ZodNumber>;
-            note: z.ZodOptional<z.ZodString>;
-        }, z.core.$loose>>>;
-        observations: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        limitations: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$loose>>;
-    max_attempts: z.ZodOptional<z.ZodNumber>;
-    max_loops: z.ZodOptional<z.ZodNumber>;
-    readiness_notes: z.ZodOptional<z.ZodString>;
-    build_after_setup: z.ZodOptional<z.ZodBoolean>;
-    setup_mode: z.ZodOptional<z.ZodEnum<{
-        create: "create";
-        "select-build-plan": "select-build-plan";
-    }>>;
-}, z.core.$strict>;
-export declare const BuildPlanAuthoringActionValuesSchema: z.ZodObject<{
-    build_plan_id: z.ZodOptional<z.ZodString>;
-    base_build_plan_id: z.ZodOptional<z.ZodString>;
-    reference_build_plan_id: z.ZodOptional<z.ZodString>;
-    label: z.ZodOptional<z.ZodString>;
-    hint: z.ZodOptional<z.ZodString>;
-    task_prompt: z.ZodString;
-    requested_artifacts_description: z.ZodOptional<z.ZodString>;
-    requested_artifacts: z.ZodOptional<z.ZodArray<z.ZodPreprocess<z.ZodObject<{
-        id: z.ZodOptional<z.ZodString>;
-        title: z.ZodString;
-        purpose: z.ZodOptional<z.ZodString>;
-        description: z.ZodOptional<z.ZodString>;
-        checks: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-            label: z.ZodString;
-        }, z.core.$loose>]>>>;
-        output: z.ZodOptional<z.ZodObject<{
-            path: z.ZodOptional<z.ZodString>;
-            shape: z.ZodOptional<z.ZodObject<{
-                kind: z.ZodLiteral<"path">;
-                path: z.ZodString;
-                artifact_kind: z.ZodEnum<{
-                    file: "file";
-                    directory: "directory";
-                }>;
-            }, z.core.$strict>>;
-            checks: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                id: z.ZodString;
-                kind: z.ZodEnum<{
-                    file_exists: "file_exists";
-                    min_file_count: "min_file_count";
-                    min_file_count_matches_source: "min_file_count_matches_source";
-                    frontmatter_valid: "frontmatter_valid";
-                    frontmatter_required_keys: "frontmatter_required_keys";
-                    wikilinks_valid: "wikilinks_valid";
-                    must_not_contain: "must_not_contain";
-                    must_contain: "must_contain";
-                    qa_match: "qa_match";
-                }>;
-                description: z.ZodOptional<z.ZodString>;
-                params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-                required: z.ZodDefault<z.ZodBoolean>;
-            }, z.core.$strict>>>;
-            stage_hint: z.ZodOptional<z.ZodString>;
-        }, z.core.$strict>>;
-    }, z.core.$strict>>>>;
-    source_profile: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        summary: z.ZodOptional<z.ZodString>;
-        items: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            name: z.ZodOptional<z.ZodString>;
-            path: z.ZodOptional<z.ZodString>;
-            kind: z.ZodOptional<z.ZodString>;
-            page_count: z.ZodOptional<z.ZodNumber>;
-            note: z.ZodOptional<z.ZodString>;
-        }, z.core.$loose>>>;
-        observations: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        limitations: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$loose>>>;
-    readiness_notes: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-export type PreparationSetupActionValues = z.infer<typeof PreparationSetupActionValuesSchema>;
-export type BuildPlanAuthoringActionValues = z.infer<typeof BuildPlanAuthoringActionValuesSchema>;
-export type SourceReadinessCheckActionValue = z.infer<typeof SourceReadinessCheckActionValueSchema>;
-export declare const INTERF_SERVICE_ACTIONS: {
-    readonly createPreparation: {
-        readonly id: "create-preparation";
-        readonly serviceAction: "preparation-setup";
-        readonly title: "Create Preparation";
-        readonly description: "Save a Source, requested Artifacts, Build Plan, and run history under one Preparation.";
-    };
-    readonly buildRun: {
-        readonly id: "build-run";
-        readonly serviceAction: "build";
-        readonly title: "Build Artifacts";
-        readonly description: "Run the saved Build Plan against this Source and write verifiable context.";
-    };
-    readonly selectBuildPlan: {
-        readonly id: "select-build-plan";
-        readonly serviceAction: "preparation-setup";
-        readonly title: "Select Build Plan";
-        readonly description: "Choose the Build Plan that will build this Preparation's requested Artifacts.";
-    };
-    readonly createBuildPlan: {
-        readonly id: "build-plan-draft";
-        readonly serviceAction: "build-plan-draft";
-        readonly title: "Draft Build Plan";
-        readonly description: "Draft a Build Plan for the Artifacts this Preparation should build.";
-    };
-    readonly buildPlanChange: {
-        readonly id: "build-plan-change";
-        readonly serviceAction: "build-plan-change";
-        readonly title: "Build Plan Change";
-        readonly description: "Modify, duplicate, or remove an existing Build Plan.";
-    };
-    readonly preparationChange: {
-        readonly id: "preparation-change";
-        readonly serviceAction: "preparation-change";
-        readonly title: "Preparation Change";
-        readonly description: "Modify, duplicate, or remove an existing Preparation.";
-    };
-    readonly confirmAction: {
-        readonly id: "confirm-action";
-        readonly serviceAction: "action-proposal";
-        readonly title: "Send Request";
-        readonly description: "Confirm the typed Interf service request before it runs.";
-    };
-    readonly checkReadiness: {
-        readonly id: "check-readiness";
-        readonly serviceAction: "test";
-        readonly title: "Check Readiness";
-        readonly description: "Run saved readiness checks against this Preparation.";
-    };
-    readonly draftReadinessChecks: {
-        readonly id: "draft-readiness-checks";
-        readonly serviceAction: "readiness-check-draft";
-        readonly title: "Draft Readiness Checks";
-        readonly description: "Ask the configured local executor to draft saved readiness checks.";
-    };
-    readonly improvePreparation: {
-        readonly id: "improve-preparation";
-        readonly serviceAction: "build-plan-improvement";
-        readonly title: "Improve Build Plan";
-        readonly description: "Use readiness evidence to refine the Build Plan this Preparation uses.";
-    };
-};
-export type InterfServiceActionKey = keyof typeof INTERF_SERVICE_ACTIONS;
-export type InterfServiceActionId = typeof INTERF_SERVICE_ACTIONS[InterfServiceActionKey]["id"];
-export declare function buildPlanAuthoringTaskPrompt(values: BuildPlanAuthoringActionValues): string;
-export type ActionInputValues = Record<string, string>;
-export type ActionValues = Record<string, unknown>;
-export type ActionInputDraft = {
-    confirmed?: boolean;
-    preparation: string;
-    message: string;
-    values?: ActionValues;
-};
-export type ActionFieldOption = {
-    label: string;
-    value: string;
-};
-export type ActionFieldDefinition = {
-    advanced?: boolean;
-    context: string;
-    help: string;
-    label: string;
-    name: string;
-    options?: ActionFieldOption[];
-    placeholder?: string;
-    readOnly?: boolean;
-    rows?: number;
-    type: "text" | "textarea" | "select";
-};
-export type ActionInputDefinition = {
-    buildDraft: (values: ActionInputValues) => ActionInputDraft;
-    description: string;
-    fields: ActionFieldDefinition[];
-    id: string;
-    initialValues: ActionInputValues;
-    normalizeValues?: (values: ActionInputValues) => ActionInputValues;
-    schema: z.ZodType<ActionInputValues>;
-    submitLabel: string;
-    title: string;
-    validateRequest?: (values: ActionInputValues) => Record<string, string>;
-    valuesPreview: (values: ActionInputValues) => ActionValues;
-};
-export type BuildPlanActionChoice = {
-    id: string;
-    label?: string | null;
-};
-export type CreatePreparationActionContext = {
-    existingNames: string[];
-    buildPlans: BuildPlanActionChoice[];
-    prepDataDir: string;
-    suggestedName: string;
-};
-export type BuildRunActionContext = {
-    about: string;
-    buildPlanId: string;
-    name: string;
-    sourceFolderPath: string;
-};
-export type SelectBuildPlanActionContext = {
-    about: string;
-    checks?: SourceReadinessCheckActionValue[];
-    currentBuildPlanId?: string | null;
-    maxAttempts?: number;
-    maxLoops?: number;
-    buildPlans: BuildPlanActionChoice[];
-    name: string;
-    requestedArtifacts?: RequestedArtifact[];
-    sourceProfile?: SourceProfile | null;
-    sourceFolderPath: string;
-};
-export type CreateBuildPlanActionContext = {
-    defaultPreparation: string;
-    existingBuildPlanIds: string[];
-    suggestedBuildPlanId: string;
-};
-export type BuildPlanChangeAction = "modify" | "duplicate" | "remove";
-export type PreparationChangeAction = "modify" | "duplicate" | "remove";
-export type ReadinessAction = "check" | "draft-checks" | "improve";
-export type BuildPlanChangeActionContext = {
-    action: BuildPlanChangeAction;
-    existingBuildPlanIds: string[];
-    hint?: string | null;
-    label?: string | null;
-    buildPlanId: string;
-    preparation: string;
-};
-export type PreparationChangeActionContext = {
-    about?: string | null;
-    action: PreparationChangeAction;
-    existingNames: string[];
-    buildPlanId?: string | null;
-    preparation: string;
-    sourceFolderPath: string;
-};
-export declare function packageSchemaFieldErrors(result: z.ZodSafeParseResult<unknown>, pathMap: Record<string, string>): Record<string, string>;
-export declare function slugForActionId(value: string): string;
-export declare function uniqueActionId(seed: string, usedIds: Set<string>): string;
-export declare function titleFromActionId(value: string): string;
-export declare function maybeActionValue(value: string): string | undefined;
-export declare function buildPlanChoiceOptions(buildPlans: BuildPlanActionChoice[]): ActionFieldOption[];
-export declare function buildPlanTaskPromptFromInput(values: ActionInputValues): string;
-export declare function preparationSetupRequestFromActionValues(input: unknown): {
-    preparation: {
-        about: string;
-        checks: SourceReadinessCheckActionValue[];
-        max_attempts?: number;
-        max_loops?: number;
-        build_plan?: string;
-        name: string;
-        path: string;
-        requested_artifacts?: RequestedArtifact[];
-        source_profile?: SourceProfile;
-    };
-    build_after_setup: boolean;
-    setup_mode: "create" | "select-build-plan";
-};
-export declare function buildPlanAuthoringRequestFromActionValues(input: unknown, context: {
-    checks?: SourceReadinessCheckActionValue[];
-    preparation?: string | null;
-    requestedArtifacts?: RequestedArtifact[];
-    sourceProfile?: SourceProfile | null;
-    sourceFolderPath: string;
-}): {
-    artifact_requirements: ReturnType<typeof artifactRequirementsFromRequestedArtifacts>;
-    base_build_plan_id?: string;
-    checks: SourceReadinessCheckActionValue[];
-    hint: string;
-    label: string;
-    build_plan_id: string;
-    preparation?: string;
-    reference_build_plan_id?: string;
-    requested_artifacts: RequestedArtifact[];
-    source_profile?: SourceProfile | null;
-    source_folder_path: string;
-    task_prompt: string;
-};
-export declare function buildPlanImprovementActionValues(options: {
-    checks?: SourceReadinessCheckActionValue[];
-    hint?: string;
-    label?: string;
-    buildPlanId: string;
-    preparationName: string;
-}): BuildPlanAuthoringActionValues;
-export declare function buildCreatePreparationActionDefinition(context: CreatePreparationActionContext): ActionInputDefinition;
-export declare function buildBuildRunActionDefinition(context: BuildRunActionContext): ActionInputDefinition;
-export declare function buildBuildRunActionDraft(context: BuildRunActionContext): ActionInputDraft;
-export declare function buildSelectBuildPlanActionDefinition(context: SelectBuildPlanActionContext): ActionInputDefinition;
-export declare function buildCreateBuildPlanActionDefinition(context: CreateBuildPlanActionContext): ActionInputDefinition;
-export declare function buildBuildPlanChangeActionDefinition(context: BuildPlanChangeActionContext): ActionInputDefinition;
-export declare function buildPreparationChangeActionDefinition(context: PreparationChangeActionContext): ActionInputDefinition;
-export declare function buildConfirmActionDefinition(draft: ActionInputDraft): ActionInputDefinition;
-export declare function buildReadinessActionDraft(options: {
-    action: ReadinessAction;
-    buildPlanId?: string;
-    preparation: string;
-}): ActionInputDraft;