/**
 * Deep-link intent to open the host's global workspace settings panel from
 * anywhere in the agent-gui tree (e.g. the conversation rail's "Usage &
 * Settings" popover). The host (apps/desktop) watches this singleton store and
 * opens its settings panel, navigating to `section` when provided.
 *
 * Workspace settings keeps this legacy request channel; Agent Env uses an
 * injected host command and a desktop-owned service instead
 * settings service; it only publishes the intent as a plain string section.
 */
interface WorkspaceSettingsPanelRequest {
    /**
     * Which settings section to navigate to, e.g. "agent". Kept as a plain string
     * so agent-gui does not depend on the host's section id union; the host
     * validates/casts it.
     */
    section: string | null;
    /**
     * Optional sub-pane within the section, e.g. "agents" to open the Agents tab
     * of the agent section. Plain string; the host validates/casts it.
     */
    pane: string | null;
    /**
     * Optional provider/agent id to focus once the pane is open, e.g. deep-linking
     * from an agent's "more" action to its row in the Agents tab. Plain string.
     */
    provider: string | null;
    /**
     * Bumped on every openWorkspaceSettingsPanel() call so the host reacts even
     * when the panel is already open or the section is unchanged.
     */
    requestSequence: number;
}
interface OpenWorkspaceSettingsPanelInput {
    section?: string | null;
    pane?: string | null;
    provider?: string | null;
}
/**
 * Request that the host open the global workspace settings panel. Safe to call
 * from anywhere in the agent-gui tree; the host renders the actual panel and
 * reacts to this singleton store.
 */
declare function openWorkspaceSettingsPanel(input?: OpenWorkspaceSettingsPanelInput): void;
/** Imperative read, mainly for tests. Components should use the hook. */
declare function getWorkspaceSettingsPanelStore(): WorkspaceSettingsPanelRequest;
/** Reactive snapshot of the panel request for the host renderer. */
declare function useWorkspaceSettingsPanelRequest(): WorkspaceSettingsPanelRequest;

export { type OpenWorkspaceSettingsPanelInput, type WorkspaceSettingsPanelRequest, getWorkspaceSettingsPanelStore, openWorkspaceSettingsPanel, useWorkspaceSettingsPanelRequest };