import { type MonoAgentConfigJson, type RouteSafetyMode } from "@mono-agent/config";
import { type CapabilityModule, type GeneratedFile, type ModuleInputValues, type ModuleValidateExpectation } from "../modules/index.js";
/**
 * The complete set of choices the wizard (or a preset) makes. This is the single
 * input to {@link composeWizardPlan}: everything the composer needs to emit a full
 * `mono-agent.config.json`, `.env.example`, and follow-up files is derived from it.
 */
export interface WizardFallback {
    readonly model: string;
    readonly effort?: string;
}
export interface WizardAnswers {
    /** Public display identity. Omitted only by legacy/programmatic callers. */
    readonly name?: string;
    /** Concise role statement used to generate the initial Identity. */
    readonly purpose?: string;
    readonly model: string;
    /** Optional primary-route effort; omitted means provider default. */
    readonly effort?: string;
    /** Canonical ordered fallback routes; omitted effort means provider default. */
    readonly fallbacks: readonly WizardFallback[];
    /**
     * Deprecated compatibility input. {@link defaultAnswers} converts these to
     * canonical routes, inheriting the legacy global effort when it is present.
     */
    readonly fallbackModels?: readonly string[];
    readonly routeSafety: RouteSafetyMode;
    /** Channel module ids, e.g. `["channel:webhook","channel:telegram"]`. */
    readonly channels: readonly string[];
    /** Memory module id, or `undefined` for no memory section. */
    readonly memory?: string;
    readonly sandbox: boolean;
    readonly observability: boolean;
    /** Final tool selection written into `tools.allowedTools`. */
    readonly allowedTools: readonly string[];
    /** Per module id → non-secret input overrides. Secret inputs are stripped by the composer. */
    readonly moduleInputs: Readonly<Record<string, ModuleInputValues>>;
}
/** Folder-derived context the base skeleton needs (not from wizard inputs). */
export interface ComposeContext {
    readonly dirBasename: string;
    readonly skillsRootExists: boolean;
}
/**
 * One secret the composed agent still needs. The CLI prints the checklist as
 * `- <label>: <description>` and points the operator at `<envVar>` in `.env`.
 */
export interface SecretChecklistItem {
    readonly moduleId: string;
    readonly label: string;
    readonly envVar: string;
    readonly description: string;
    readonly required: boolean;
}
/**
 * The single artifact of config generation: the JSON to write (with `$schema`),
 * the optional `.env.example`, follow-up files, the secret checklist, the selected
 * modules, the validate expectations, and any authoring warnings.
 */
export interface WizardPlan {
    readonly configJson: MonoAgentConfigJson;
    /** Joined module `envExampleLines` plus a trailing newline; `undefined` when none. */
    readonly envExample?: string;
    readonly files: readonly GeneratedFile[];
    readonly secrets: readonly SecretChecklistItem[];
    readonly selectedModules: readonly CapabilityModule[];
    readonly validateExpectations: readonly ModuleValidateExpectation[];
    readonly warnings: readonly string[];
}
/**
 * Every runtime/LLM reference that generic provider setup must account for.
 * Managed-memory embeddings deliberately stay out of this Pi-model-shaped
 * list: the guided wizard and readiness gate use the configured service root
 * and embedding-native discovery/probe contract instead.
 */
export declare function referencedSetupModelRefs(plan: WizardPlan): readonly string[];
/**
 * The recommended `allowedTools` for these answers: the read-only safe defaults
 * plus every selected module's `recommendedTools`, deduped and ordered by the
 * canonical BUILTIN∪ADAPTER position. Deterministic — no Set-iteration reliance.
 */
export declare function recommendedToolSelection(answers: WizardAnswers): readonly string[];
/**
 * The tools this agent auto-provisions regardless of `tools.allowedTools` — the
 * "always on" set the wizard surfaces so the operator understands they are NOT gated
 * by the allow-list choice. Today that is `MemoryRecall` when the memory tier enables
 * recall (lite/journal/bujo/supermemory). `ReadSkill` (skills configured) and MCP-server
 * tools are also always-on when present, but the basic wizard authors neither, so they
 * never appear here.
 */
export declare function alwaysOnTools(answers: WizardAnswers): readonly string[];
/**
 * The wizard's starting answers with `overrides` shallow-merged on top. Unless an
 * explicit `allowedTools` override is supplied, `allowedTools` defaults to allow-all
 * (`["*"]`) — the single choke point that flips the silent scaffold, every preset, and
 * every non-interactive `--flag` path to allow-all. An explicit override is preserved
 * verbatim: `["*"]`, a specific list, or `[]` (the chat-only case).
 */
export declare function defaultAnswers(overrides?: Partial<WizardAnswers>): WizardAnswers;
/** Canonicalize old answer objects at the single composition boundary. */
export declare function effectiveFallbacks(answers: WizardAnswers): readonly WizardFallback[];
/** Folder basenames become readable public identities without affecting paths. */
export declare function humanizeAgentName(dirBasename: string): string;
/** Overrides for one module: the shared model plus its non-secret input values. */
export declare function moduleOverrides(module: CapabilityModule, answers: WizardAnswers): Record<string, string | undefined>;
/**
 * The single config-generation path: turn wizard answers into a complete
 * `WizardPlan`. Fragments are composed onto the adapter-neutral base skeleton;
 * secret inputs are stripped before any fragment runs, so a secret value can never
 * reach the JSON. The composed default config is byte-equal to today's `init.ts`
 * scaffold except `tools.allowedTools` (filled from the wizard's tools selection).
 */
export declare function composeWizardPlan(answers: WizardAnswers, ctx: ComposeContext): WizardPlan;
//# sourceMappingURL=answers.d.ts.map