import { type AgentFileUpload } from './agent-uploads.js';
import { type FocusedRange, type RangeRestriction } from './user-turn-enrichments.js';
/** UI-only metadata attached to a user turn and exposed on runtime snapshots. */
export interface UserMessageUiMetadata {
    /** Browser submit timestamp for the user turn. */
    createdAt?: number;
    /** Host interaction mode used for the submit, e.g. action/ask/plan. */
    interactionMode?: string;
    /** Files uploaded with the user turn. */
    fileUploads?: readonly AgentFileUpload[];
    /** Current spreadsheet focus when no explicit range restrictions are present. */
    focusedRange?: FocusedRange;
    /** Explicit user-added ranges; takes precedence over focusedRange in the UI. */
    rangeRestrictions?: readonly RangeRestriction[];
}
export declare function isUserMessageUiMetadata(value: unknown): value is UserMessageUiMetadata;
//# sourceMappingURL=user-message-ui-metadata.d.ts.map