export type AdapterMode = boolean | "auto";
export type FooterStatus = "full" | "compact" | "off";
export type CombinerSettings = {
    /** Tool name registered with Pi. Default "mcp" (parity with pi-mcp-adapter);
     *  rename (e.g. "combiner") to coexist while both are installed. */
    toolName: string;
    /** "lazy" (default): connect on first mcp() call. "eager": connect at session_start. */
    lazy: "lazy" | "eager";
    /** Client-half gate. `true`: we are the MCP tool. `false`: legacy mode — the
     *  process + instructions halves only, pi-mcp-adapter (if installed) owns MCP.
     *  `"auto"` (default): OFF when pi-mcp-adapter is detected installed, ON otherwise —
     *  so existing adapter users upgrade with zero behaviour change, while fresh
     *  installs get the one-package experience. Env PI_MCP_COMBINER_ADAPTER wins. */
    adapter: AdapterMode;
    /** Expose combiner resources as read_* tools. */
    exposeResources: boolean;
    /** Register combiner prompts as slash commands (adapter naming:
     *  mcp__<server>__<name>; prefixed with our toolName when renamed). */
    prompts: boolean;
    /** Footer status line: "full" = "N servers enabled (M ready) · T tools", "compact" = "MCP M/N",
     *  "off" = none. Same values as pi-mcp-adapter's mcpFooterStatus. */
    mcpFooterStatus: FooterStatus;
    /** The ctx.ui.setStatus key the footer publishes under. Default "mcp" — the
     *  slot pi-mcp-adapter wrote and footers (oh-my-posh's PI_STATUS aggregate)
     *  already surface; rename only if something else claims it. */
    mcpFooterKey: string;
    /** Register the trusted batching tool (<toolName>Script). Default true. */
    scriptMode: boolean;
    /** Auto-open interactive widget URLs (Stage 2 holds + resource reads).
     *  Default true. */
    uiAutoOpen: boolean;
    /** Explicit combiner base URL (e.g. "http://127.0.0.1:9741/mcp"). Env wins. */
    url?: string;
    /** Notify (vs stderr-only) for connection lifecycle messages. */
    notify: boolean;
};
export declare const DEFAULT_SETTINGS: CombinerSettings;
/** Pi's agent dir: `$PI_CODING_AGENT_DIR` when set, else the first existing of the
 *  known defaults (~/.config/pi/agent on newer layouts, ~/.pi/agent on older). */
export declare function agentDir(): string;
/** The settings file path this extension reads. */
export declare function settingsPath(): string;
/** Load + validate the settings file; missing file or bad shape → defaults.
 *  Unknown keys are ignored (forward compat). */
export declare function loadSettings(path?: string): CombinerSettings;
//# sourceMappingURL=settings.d.ts.map