import type { SettingsJsonValue } from "@mono-agent/agent-contracts";
import type { MonoAgentConfigJson } from "@mono-agent/config";
export declare const MONO_AGENT_CONFIG_SCHEMA_URL = "https://raw.githubusercontent.com/robertsreberski/mono-agent/main/packages/agent-app/schema/mono-agent.config.schema.json";
export interface ConfigReferenceField {
    readonly jsonPath: string;
    readonly env: string;
    readonly type: ConfigReferenceType;
    readonly defaultLabel: string;
    readonly defaultValue?: SettingsJsonValue;
    readonly example: SettingsJsonValue;
    readonly description: string;
    readonly secret?: boolean;
}
export type ConfigReferenceType = "string" | "number" | "integer" | "boolean" | "string[]" | "object" | "array";
interface JsonSchema {
    readonly [key: string]: unknown;
}
export declare function monoAgentConfigWithSchema(config: MonoAgentConfigJson): MonoAgentConfigJson;
export declare function allConfigReferenceFields(): readonly ConfigReferenceField[];
export declare function buildMonoAgentConfigSchema(): JsonSchema;
export declare function buildGeneratedConfigReferenceMarkdown(): string;
/** Return raw JSON paths that the generated schema would reject as unknown. */
export declare function findUnknownAppConfigPaths(json: object): readonly string[];
/** Fail before config values are flattened so misspelled settings cannot be ignored. */
export declare function assertKnownAppConfigKeys(json: object): void;
export declare function schemaForField(field: ConfigReferenceField): JsonSchema;
export {};
//# sourceMappingURL=config-reference.d.ts.map