export declare const QA_XLSX_MAX_ROWS = 2000; export declare const QA_XLSX_MAX_COLS = 200; export declare const QA_TEXT_MAX_BYTES: number; export type StagedSheet = { name: string; headers: string[]; rows: Array>; rowCount: number; truncated: boolean; }; export type ReadStagedResult = { ok: boolean; kind?: 'xlsx' | 'text'; sheets?: StagedSheet[]; text?: string; truncated?: boolean; error?: string; [key: string]: unknown; }; /** Split "Sheet1!B3" / "'My Sheet'!C2" / "B3" into sheet + column + row. */ export declare function parseCellAddress(addr: string): { sheet: string | null; col: number; row: number; } | null; export declare function colToLetters(col: number): string; /** * Read a staged file: spreadsheets come back as sheets + header-keyed rows, * text formats come back as text. Caps keep the MCP response small. */ export declare function readStagedFile(opts: { runId: string; filePath: string; sheet?: string; maxRows?: number; }): Promise; export type FillExcelResult = { ok: boolean; path?: string; fileName?: string; bytes?: number; error?: string; [key: string]: unknown; }; /** * Edit a COPY of the staged template: `cells` writes exact addresses * ("Sheet1!B3" or "B3" for the first sheet), `rows` appends header-keyed * objects after the last used row (matched against the header row, so the * agent must have read the template first). Styles, formulas and validation * survive — only the addressed cells change. */ export declare function fillStagedSpreadsheet(opts: { runId: string; templatePath: string; fileName?: string; cells?: Record; rows?: Array>; sheet?: string; }): Promise;