/**
 * Workbook scope — controls which open Excel workbooks the agent can see.
 *
 * Scope modes: "unset" (default, resolves to all), "all", "none", or
 * "selected" (an explicit subset of workbook names). The scope is
 * resolved against the list of currently-open workbooks so stale
 * selections fall back to "all" rather than silently hiding everything.
 */
export declare const SCOPE_UNSET: "unset";
export declare const SCOPE_ALL: "all";
export declare const SCOPE_NONE: "none";
export declare const SCOPE_SELECTED: "selected";
export type ActiveScopeMode = typeof SCOPE_ALL | typeof SCOPE_NONE | typeof SCOPE_SELECTED;
export type WorkbookScope = {
    mode: typeof SCOPE_UNSET;
} | {
    mode: typeof SCOPE_ALL;
} | {
    mode: typeof SCOPE_NONE;
} | {
    mode: typeof SCOPE_SELECTED;
    workbooks: string[];
};
export interface WorkbookConnectionState {
    connected: boolean;
    workbooks: string[];
}
export interface WorkbookScopeStateRef {
    current: WorkbookScope;
    prefetchedState?: WorkbookConnectionState;
    /** Workbook names seen when scope was last determined. */
    knownWorkbooks?: string[];
}
export interface WorkbookScopeDetails {
    scopeMode: ActiveScopeMode;
    workbooks: string[];
}
/** Resolve a WorkbookScope against the currently-open workbooks, collapsing "unset" to "all" and dropping stale selections. */
export declare function resolveWorkbookScope(scope: WorkbookScope, openWorkbooks: string[]): Exclude<WorkbookScope, {
    mode: typeof SCOPE_UNSET;
}>;
/** Return the workbook names visible under the given scope. */
export declare function getScopedWorkbookNames(scope: WorkbookScope, openWorkbooks: string[]): string[];
/** Resolve scope and return both the active mode and the matching workbook names. */
export declare function getWorkbookScopeDetails(scope: WorkbookScope, openWorkbooks: string[]): WorkbookScopeDetails;
/** Format a human-readable annotation for display in the UI footer. */
export declare function formatWorkbookScopeAnnotation(details: WorkbookScopeDetails): string | null;
//# sourceMappingURL=workbook-scope.d.ts.map