import { z } from 'zod';
export type EntityKind = 'agent' | 'template' | 'shell';
/** `path` anchors the issue at a field (`transitions[2].from`) so the editor can point at it. */
export interface Issue {
    path: string;
    message: string;
}
export interface ValidationResult {
    errors: Issue[];
    warnings: Issue[];
}
/** Raw (unexpanded, un-file-ref-resolved) config as it sits on disk: name → parsed JSON. */
export interface RawRegistry {
    agents: Record<string, unknown>;
    templates: Record<string, unknown>;
    shells: Record<string, unknown>;
}
/** Optional filesystem probes. Omitted in unit tests, injected by the API handler. */
export interface RefResolver {
    promptsDir: string;
    pluginBaseDir: string;
    join: (...parts: string[]) => string;
    exists: (absPath: string) => boolean;
    isAbsolute: (p: string) => boolean;
}
/** `__active__` is the runtime-resolved default agent (prompt-builder.ts:20), not a config entity. */
export declare const ACTIVE_AGENT = "__active__";
export declare const stageSchema: z.ZodObject<{
    promptTemplate: z.ZodString;
    continuesSession: z.ZodOptional<z.ZodBoolean>;
    description: z.ZodOptional<z.ZodString>;
}, z.core.$strip>;
export declare const conditionSchema: z.ZodObject<{
    type: z.ZodEnum<{
        always: "always";
        convergence: "convergence";
        output_contains: "output_contains";
        output_not_contains: "output_not_contains";
    }>;
    marker: z.ZodOptional<z.ZodString>;
    pattern: z.ZodOptional<z.ZodString>;
    maxIterations: z.ZodOptional<z.ZodNumber>;
}, z.core.$strip>;
export declare const transitionSchema: z.ZodObject<{
    from: z.ZodString;
    to: z.ZodString;
    condition: z.ZodObject<{
        type: z.ZodEnum<{
            always: "always";
            convergence: "convergence";
            output_contains: "output_contains";
            output_not_contains: "output_not_contains";
        }>;
        marker: z.ZodOptional<z.ZodString>;
        pattern: z.ZodOptional<z.ZodString>;
        maxIterations: z.ZodOptional<z.ZodNumber>;
    }, z.core.$strip>;
}, z.core.$strip>;
export declare const hookConfigSchema: z.ZodObject<{
    command: z.ZodString;
    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
    timeout: z.ZodOptional<z.ZodNumber>;
}, z.core.$strip>;
export declare const hooksSchema: z.ZodObject<{
    onStart: z.ZodOptional<z.ZodObject<{
        command: z.ZodString;
        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
        timeout: z.ZodOptional<z.ZodNumber>;
    }, z.core.$strip>>;
    onTransition: z.ZodOptional<z.ZodObject<{
        command: z.ZodString;
        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
        timeout: z.ZodOptional<z.ZodNumber>;
    }, z.core.$strip>>;
    onEnd: z.ZodOptional<z.ZodObject<{
        command: z.ZodString;
        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
        timeout: z.ZodOptional<z.ZodNumber>;
    }, z.core.$strip>>;
}, z.core.$strip>;
export declare const agentSchema: z.ZodObject<{
    name: z.ZodString;
    description: z.ZodOptional<z.ZodString>;
    profile: z.ZodString;
    persistSession: z.ZodBoolean;
    directive: z.ZodOptional<z.ZodString>;
    systemPrompt: z.ZodOptional<z.ZodString>;
    promptTemplate: z.ZodOptional<z.ZodString>;
    claudeAgent: z.ZodOptional<z.ZodString>;
    outputStyle: z.ZodOptional<z.ZodString>;
    tools: z.ZodOptional<z.ZodString>;
    pluginDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
    mcpComposition: z.ZodOptional<z.ZodEnum<{
        direct: "direct";
        "thread-control": "thread-control";
        none: "none";
        "benchmark-thread-run": "benchmark-thread-run";
    }>>;
    stages: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
        promptTemplate: z.ZodString;
        continuesSession: z.ZodOptional<z.ZodBoolean>;
        description: z.ZodOptional<z.ZodString>;
    }, z.core.$strip>>>;
    entryStage: z.ZodOptional<z.ZodString>;
}, z.core.$strip>;
export declare const agentRefOverrideSchema: z.ZodObject<{
    ref: z.ZodString;
    promptTemplate: z.ZodOptional<z.ZodString>;
    directive: z.ZodOptional<z.ZodString>;
    systemPrompt: z.ZodOptional<z.ZodString>;
    persistSession: z.ZodOptional<z.ZodBoolean>;
    claudeAgent: z.ZodOptional<z.ZodString>;
    outputStyle: z.ZodOptional<z.ZodString>;
    tools: z.ZodOptional<z.ZodString>;
    pluginDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strip>;
export declare const agentRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
    ref: z.ZodString;
    promptTemplate: z.ZodOptional<z.ZodString>;
    directive: z.ZodOptional<z.ZodString>;
    systemPrompt: z.ZodOptional<z.ZodString>;
    persistSession: z.ZodOptional<z.ZodBoolean>;
    claudeAgent: z.ZodOptional<z.ZodString>;
    outputStyle: z.ZodOptional<z.ZodString>;
    tools: z.ZodOptional<z.ZodString>;
    pluginDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
}, z.core.$strip>]>;
export declare const templateSchema: z.ZodObject<{
    name: z.ZodOptional<z.ZodString>;
    description: z.ZodString;
    agents: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
        ref: z.ZodString;
        promptTemplate: z.ZodOptional<z.ZodString>;
        directive: z.ZodOptional<z.ZodString>;
        systemPrompt: z.ZodOptional<z.ZodString>;
        persistSession: z.ZodOptional<z.ZodBoolean>;
        claudeAgent: z.ZodOptional<z.ZodString>;
        outputStyle: z.ZodOptional<z.ZodString>;
        tools: z.ZodOptional<z.ZodString>;
        pluginDirs: z.ZodOptional<z.ZodArray<z.ZodString>>;
    }, z.core.$strip>]>>;
    transitions: z.ZodArray<z.ZodObject<{
        from: z.ZodString;
        to: z.ZodString;
        condition: z.ZodObject<{
            type: z.ZodEnum<{
                always: "always";
                convergence: "convergence";
                output_contains: "output_contains";
                output_not_contains: "output_not_contains";
            }>;
            marker: z.ZodOptional<z.ZodString>;
            pattern: z.ZodOptional<z.ZodString>;
            maxIterations: z.ZodOptional<z.ZodNumber>;
        }, z.core.$strip>;
    }, z.core.$strip>>;
    entryAgent: z.ZodString;
    entryStage: z.ZodOptional<z.ZodString>;
    maxTotalSteps: z.ZodNumber;
    maxTotalCostUsd: z.ZodOptional<z.ZodNumber>;
    disableHooks: z.ZodOptional<z.ZodBoolean>;
    hooks: z.ZodOptional<z.ZodObject<{
        onStart: z.ZodOptional<z.ZodObject<{
            command: z.ZodString;
            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
            timeout: z.ZodOptional<z.ZodNumber>;
        }, z.core.$strip>>;
        onTransition: z.ZodOptional<z.ZodObject<{
            command: z.ZodString;
            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
            timeout: z.ZodOptional<z.ZodNumber>;
        }, z.core.$strip>>;
        onEnd: z.ZodOptional<z.ZodObject<{
            command: z.ZodString;
            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
            timeout: z.ZodOptional<z.ZodNumber>;
        }, z.core.$strip>>;
    }, z.core.$strip>>;
}, z.core.$strip>;
export declare const shellBindingSchema: z.ZodObject<{
    shell: z.ZodString;
    description: z.ZodOptional<z.ZodString>;
    maxTotalSteps: z.ZodOptional<z.ZodNumber>;
}, z.core.$strip>;
export declare const shellSchema: z.ZodObject<{
    params: z.ZodArray<z.ZodString>;
    agents: z.ZodArray<z.ZodString>;
    transitions: z.ZodArray<z.ZodObject<{
        from: z.ZodString;
        to: z.ZodString;
        condition: z.ZodObject<{
            type: z.ZodEnum<{
                always: "always";
                convergence: "convergence";
                output_contains: "output_contains";
                output_not_contains: "output_not_contains";
            }>;
            marker: z.ZodOptional<z.ZodString>;
            pattern: z.ZodOptional<z.ZodString>;
            maxIterations: z.ZodOptional<z.ZodNumber>;
        }, z.core.$strip>;
    }, z.core.$strip>>;
    entryAgent: z.ZodString;
    entryStage: z.ZodOptional<z.ZodString>;
    maxTotalSteps: z.ZodNumber;
    maxTotalCostUsd: z.ZodOptional<z.ZodNumber>;
    hooks: z.ZodOptional<z.ZodObject<{
        onStart: z.ZodOptional<z.ZodObject<{
            command: z.ZodString;
            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
            timeout: z.ZodOptional<z.ZodNumber>;
        }, z.core.$strip>>;
        onTransition: z.ZodOptional<z.ZodObject<{
            command: z.ZodString;
            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
            timeout: z.ZodOptional<z.ZodNumber>;
        }, z.core.$strip>>;
        onEnd: z.ZodOptional<z.ZodObject<{
            command: z.ZodString;
            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
            timeout: z.ZodOptional<z.ZodNumber>;
        }, z.core.$strip>>;
    }, z.core.$strip>>;
}, z.core.$strip>;
/** Names of the templates whose definition mentions this agent or shell. */
export declare function dependentTemplates(kind: EntityKind, name: string, registry: RawRegistry): string[];
/**
 * Validate one entity against the registry it will live in. The caller is expected to pass a
 * registry with the candidate already swapped in, so cross-entity references resolve against the
 * post-save world rather than the current one.
 */
export declare function validateEntity(kind: EntityKind, name: string, body: unknown, registry: RawRegistry, refs?: RefResolver): ValidationResult;
/** Validate every entity in a registry. Key format: `<kind>:<name>`. */
export declare function validateRegistry(registry: RawRegistry, refs?: RefResolver): Map<string, ValidationResult>;
/** The only I/O in this module: read `<dir>/{agents,templates,shells}/*.json` as raw bodies.
 *  An unparseable file lands as `null`, which every validator reports as a root-level error. */
export declare function rawRegistryFromDir(dir: string, io: {
    readdirSync: (p: string) => string[];
    readFileSync: (p: string, enc: 'utf8') => string;
    existsSync: (p: string) => boolean;
    join: (...parts: string[]) => string;
}): RawRegistry;
/** Copy of a registry with one entity replaced — what a save would produce. */
export declare function withCandidate(registry: RawRegistry, kind: EntityKind, name: string, body: unknown): RawRegistry;