export type BuiltinAgentsMode = "all" | "none" | "selected";
export interface BuiltinAgentsConfig {
    mode: BuiltinAgentsMode;
    /** Built-ins this workspace offers. Anything else is unknown to it. */
    include: string[];
    /** Hosted URL overrides, applied only when a built-in is offered. */
    urls?: Record<string, string>;
}
export declare const BUILTIN_AGENTS_ENV_KEY = "AGENT_NATIVE_BUILTIN_AGENTS_JSON";
export declare function frameworkDefaultBuiltinAgentsConfig(): BuiltinAgentsConfig;
export declare function parseBuiltinAgentsConfig(raw: unknown): {
    config: BuiltinAgentsConfig;
    warnings: string[];
};
/** Serialized `agent-native.builtinAgents` for child app processes, if configured. */
export declare function workspaceBuiltinAgentsJson(workspaceRoot: string): string | undefined;
/**
 * The app builder's `agent-native.builtinAgents` config, read from
 * AGENT_NATIVE_BUILTIN_AGENTS_JSON or the workspace root (or standalone app)
 * package.json. Absent config means `mode: "all"`.
 */
export declare function readBuiltinAgentsConfig(): BuiltinAgentsConfig;
export declare function resetBuiltinAgentsConfigForTests(): void;