@grid-is/agent-tools 0.2.3 → 0.3.1

package/dist/index.d.ts

@@ -1,7 +1,7 @@
+import { C as runFormula, D as whatIf, E as viewRange, S as readCalculatedValues, T as symbols, _ as isToolError, a as dependents, b as manageSheets, c as editCells, d as generateWorkbookContext, f as getComment, g as inspect, h as goalSeek, i as captureRange, l as fillCells, m as getStyles, n as ToolContext, o as describeStructure, p as getComments, s as editCellStyles, t as SpreadsheetTool, u as findCells, v as listErrors, x as precedents, y as manageRowsAndColumns } from "./index-DtYMYL_H.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { Cell, CellValue, FormulaError, Model, WorkbookDescription } from "@grid-is/apiary";
 import { z } from "zod";
-//#region src/tools.d.ts
+//#region src/session.d.ts
 interface ToolResult {
   text: string;
   isError: boolean;
@@ -18,1550 +18,6 @@ interface GridTool {
 }
 declare function createGridTools(cwd?: string): GridTool[];
 //#endregion
-//#region node_modules/@jsfkit/types/dist/index.d.ts
-/**
- * A whole number without a fractional value.
- *
- * @group Workbooks
- */
-type integer = number;
-/**
- * A numeric value measured in pixels.
- *
- * @min 0
- * @group Workbooks
- */
-type PixelValue = number;
-/**
- * Automatic colour choice. The application decides on what exact colour to use. Typically this
- * means black for text, white for background.
- *
- * @group Colors
- */
-type AutoColor = {
-  type: 'auto';
-};
-/**
- * Represents a single transformation that can be applied to a colour.
- *
- * Most transforms have a `type` that specifies the kind of transformation, and a `value` that
- * provides the necessary parameter for that transformation. The exact meaning and valid range of
- * `value` depends on the `type` of transform. The exception are a handful of whole-colour
- * transformations that affect the entire colour; they have `type` but no `value.`
- *
- * The supported transform types include:
- *
- * - Tint and shade: blend the colour towards white (tint) or black (shade) by a specified
- *   percentage.
- * - Alpha: adjust the opacity of the colour using various methods (absolute value, multiplicative,
- *   or additive).
- * - Hue, saturation, and luminance: rotate a colour attribute of the colour by a specified amount
- *   (absolute, multiplicative, or additive).
- * - Per-channel RGB adjustments: modify individual red, green, or blue channels (absolute,
- *   multiplicative, or additive).
- * - Whole-colour operations: apply transformations that affect the entire colour (complement,
- *   invert, grayscale, gamma adjustments).
- *
- * @group Colors
- */
-type ColorTransform = {
-  /**
-   * Produces a lighter version of the input colour. A 10% tint is 10% of the input colour
-   * combined with 90% white. */
-  type: 'tint';
-  /**
-   * Percentage (clamped to 0-100).
-   * @min 0
-   * @max 100
-   */
-  value: number;
-} | {
-  /**
-   * Produces a darker version of the input colour. A 10% shade is 10% of the input colour
-   * combined with 90% black.
-   */
-  type: 'shade';
-  /**
-   * Percentage (clamped to 0-100).
-   * @min 0
-   * @max 100
-   */
-  value: number;
-} | {
-  /** Alters the input colour to have the specified opacity, but with its colour unchanged. */
-  type: 'alpha';
-  /**
-   * Percentage (clamped to 0-100).
-   * @min 0
-   * @max 100
-   */
-  value: number;
-} | {
-  /**
-   * Produces a more or less opaque version of the input colour. An alpha modulate never increases
-   * the alpha beyond 100%. A 200% alpha modulate makes an input colour twice as opaque as before.
-   * A 50% alpha modulate makes an input colour half as opaque as before.
-   */
-  type: 'alphaMod';
-  /**
-   * Positive percentage.
-   * @min 0
-   */
-  value: number;
-} | {
-  /**
-   * Produces a more or less opaque version of the input colour.
-   *
-   * Increases or decreases the input alpha percentage by the specified percentage offset. A 10%
-   * alpha offset increases a 50% opacity to 60%. A -10% alpha offset decreases a 50% opacity to
-   * 40%. The transformed alpha values are limited to a range of 0 to 100%. A 10% alpha offset
-   * increase to a 100% opaque object still results in 100% opacity.
-   */
-  type: 'alphaOff';
-  /**
-   * Percentage (clamped to -100 to 100).
-   * @min -100
-   * @max 100
-   */
-  value: number;
-} | {
-  /**
-   * Alters the input colour so it has the specified hue, but with its saturation and luminance
-   * unchanged.
-   */
-  type: 'hue';
-  /**
-   * Degrees (clamped to 0-360).
-   * @min 0
-   * @max 360
-   */
-  value: number;
-} | {
-  /**
-   * Modulates the input colour's hue by the given percentage. A 50% hue modulate decreases the
-   * angular hue value by half. A 200% hue modulate doubles the angular hue value.
-   */
-  type: 'hueMod';
-  /**
-   * Positive percentage.
-   * @min 0
-   */
-  value: number;
-} | {
-  /**
-   * Produces the input colour with its hue shifted, but with its saturation and luminance
-   * unchanged.
-   */
-  type: 'hueOff';
-  /** Degrees. */
-  value: number;
-} | {
-  /**
-   * Alters the input colour so it has the specified saturation, but with its hue and luminance
-   * unchanged.
-   */
-  type: 'sat';
-  /** Unbounded percentage. */
-  value: number;
-} | {
-  /**
-   * Modulates the input colour's saturation by the given percentage.
-   *
-   * A 50% saturation modulate reduces the saturation by half. A 200% saturation modulate doubles
-   * the saturation.
-   */
-  type: 'satMod';
-  /** Unbounded percentage. */
-  value: number;
-} | {
-  /**
-   * Produces the input colour with its saturation shifted, but with its hue and luminance
-   * unchanged. A 10% offset to 20% saturation yields 30% saturation.
-   */
-  type: 'satOff';
-  /** Unbounded percentage. */
-  value: number;
-} | {
-  /**
-   * Alters the input colour so it has the specified luminance, but with its hue and saturation
-   * unchanged.
-   */
-  type: 'lum';
-  /** Unbounded percentage. */
-  value: number;
-} | {
-  /**
-   * Alters the input colour's luminance modulated by the given percentage.
-   *
-   * A 50% luminance modulate reduces the luminance by half. A 200% luminance modulate doubles the
-   * luminance.
-   */
-  type: 'lumMod';
-  /** Unbounded percentage. */
-  value: number;
-} | {
-  /**
-   * Produces the input colour with its luminance shifted, but with its hue and saturation
-   * unchanged.
-   */
-  type: 'lumOff';
-  /** Unbounded percentage. */
-  value: number;
-} | {
-  /**
-   * Produces the input colour with the specified red component. The green and blue colour
-   * components unchanged.
-   */
-  type: 'red';
-  /** Unbounded percentage. */
-  value: number;
-} | {
-  /**
-   * Alters the input colour so its red component is modulated by the given percentage. A 50% red
-   * modulate reduces the red component by half. A 200% red modulate doubles the red component.
-   */
-  type: 'redMod';
-  /** Unbounded percentage. */
-  value: number;
-} | {
-  /**
-   * Alters the input colour so its red component is shifted. Its green and blue colour components
-   * unchanged.
-   */
-  type: 'redOff';
-  /** Unbounded percentage. */
-  value: number;
-} | {
-  /**
-   * Provides the input colour with the specified green component. Its red and blue colour
-   * components unchanged.
-   */
-  type: 'green';
-  /** Unbounded percentage. */
-  value: number;
-} | {
-  /**
-   * Modulates the input colour's green component by the given percentage.
-   *
-   * A 50% green modulate reduces the green component by half. A 200% green modulate doubles the
-   * green component.
-   */
-  type: 'greenMod';
-  /** Unbounded percentage. */
-  value: number;
-} | {
-  /**
-   * Alters the input colour so its green component is shifted. Its red and blue colour components
-   * unchanged.
-   */
-  type: 'greenOff';
-  /** Unbounded percentage. */
-  value: number;
-} | {
-  /**
-   * Provides the input colour with the specified blue component. Its red and green colour
-   * components unchanged.
-   */
-  type: 'blue';
-  /** Unbounded percentage. */
-  value: number;
-} | {
-  /**
-   * Modulates the input colour's blue component by the given percentage.
-   *
-   * A 50% blue modulate reduces the blue component by half. A 200% blue modulate doubles the blue
-   * component.
-   */
-  type: 'blueMod';
-  /** Unbounded percentage. */
-  value: number;
-} | {
-  /**
-   * Alters the input colour so its blue component is shifted, but with its red and green colour
-   * components unchanged.
-   */
-  type: 'blueOff';
-  /** Unbounded percentage. */
-  value: number;
-} | {
-  /**
-   * Specifies that the colour rendered should be the complement of the input colour with the
-   * complement being defined as such.
-   */
-  type: 'comp';
-} | {
-  /**
-   * Specifies the inverse of the input colour. For example, the inverse of red (1, 0, 0) is cyan
-   * (0, 1, 1 ).
-   */
-  type: 'inv';
-} | {
-  /**
-   * Specifies a grey scale of the input colour, taking into relative intensities of the red,
-   * green, and blue primaries.
-   */
-  type: 'gray';
-} | {
-  /**
-   * Specifies that the output colour rendered by the generating application should be the sRGB
-   * gamma shift of the input colour.
-   */
-  type: 'gamma';
-} | {
-  /**
-   * Specifies that the output colour rendered by the generating application should be the inverse
-   * sRGB gamma shift of the input colour.
-   */
-  type: 'invGamma';
-};
-/**
- * Hue / saturation / lightness.
- *
- * Hue, saturation and lightness follow CSS Color Level 4 conventions, but using the range (0-100)
- * rather than (0-1).
- *
- * @group Colors
- */
-type HslColor = {
-  type: 'hsl';
-  /**
-   * Degrees (0-360). Must be positive.
-   * @min 0
-   * @max 360
-   */
-  hue: number;
-  /** Percentage. */
-  saturation: number;
-  /** Percentage. */
-  lightness: number;
-};
-/**
- * A legacy colour indexing scheme, still occasionally required for backwards compatibility.
- *
- * An enumerated set of RGB colours values that correspond to a zero-based index.
- *
- * The table below lists the mapping from indexed colour value to RGB value. Note that indexes 8-15
- * are copies of indexes 0-7. All colours are fully opaque.
- *
- * | Index |    RGB hex colour |
- * |------:|------------------:|
- * |     0 |           #000000 |
- * |     1 |           #FFFFFF |
- * |     2 |           #FF0000 |
- * |     3 |           #00FF00 |
- * |     4 |           #0000FF |
- * |     5 |           #FFFF00 |
- * |     6 |           #FF00FF |
- * |     7 |           #00FFFF |
- * |     8 |           #000000 |
- * |     9 |           #FFFFFF |
- * |    10 |           #FF0000 |
- * |    11 |           #00FF00 |
- * |    12 |           #0000FF |
- * |    13 |           #FFFF00 |
- * |    14 |           #FF00FF |
- * |    15 |           #00FFFF |
- * |    16 |           #800000 |
- * |    17 |           #008000 |
- * |    18 |           #000080 |
- * |    19 |           #808000 |
- * |    20 |           #800080 |
- * |    21 |           #008080 |
- * |    22 |           #C0C0C0 |
- * |    23 |           #808080 |
- * |    24 |           #9999FF |
- * |    25 |           #993366 |
- * |    26 |           #FFFFCC |
- * |    27 |           #CCFFFF |
- * |    28 |           #660066 |
- * |    29 |           #FF8080 |
- * |    30 |           #0066CC |
- * |    31 |           #CCCCFF |
- * |    32 |           #000080 |
- * |    33 |           #FF00FF |
- * |    34 |           #FFFF00 |
- * |    35 |           #00FFFF |
- * |    36 |           #800080 |
- * |    37 |           #800000 |
- * |    38 |           #008080 |
- * |    39 |           #0000FF |
- * |    40 |           #00CCFF |
- * |    41 |           #CCFFFF |
- * |    42 |           #CCFFCC |
- * |    43 |           #FFFF99 |
- * |    44 |           #99CCFF |
- * |    45 |           #FF99CC |
- * |    46 |           #CC99FF |
- * |    47 |           #FFCC99 |
- * |    48 |           #3366FF |
- * |    49 |           #33CCCC |
- * |    50 |           #99CC00 |
- * |    51 |           #FFCC00 |
- * |    52 |           #FF9900 |
- * |    53 |           #FF6600 |
- * |    54 |           #666699 |
- * |    55 |           #969696 |
- * |    56 |           #003366 |
- * |    57 |           #339966 |
- * |    58 |           #003300 |
- * |    59 |           #333300 |
- * |    60 |           #993300 |
- * |    61 |           #993366 |
- * |    62 |           #333399 |
- * |    63 |           #333333 |
- * |    64 | System foreground |
- * |    65 | System background |
- *
- * @group Colors
- */
-type IndexedColor = {
-  type: 'indexed';
-  value: number;
-};
-/**
- * A named colour from a predefined collection of colours.
- *
- * The preset colours are analogous to the extended colour keywords from CSS Colors Level 3,
- * but using camel casing and abbreviated forms (e.g. `dkMagenta` vs `darkmagenta`).
- *
- * @group Colors
- */
-type PresetColor = {
-  type: 'preset';
-  /** Preset name, e.g. "aliceBlue", "coral". */
-  value: 'aliceBlue' | 'antiqueWhite' | 'aqua' | 'aquamarine' | 'azure' | 'beige' | 'bisque' | 'black' | 'blanchedAlmond' | 'blue' | 'blueViolet' | 'brown' | 'burlyWood' | 'cadetBlue' | 'chartreuse' | 'chocolate' | 'coral' | 'cornflowerBlue' | 'cornsilk' | 'crimson' | 'cyan' | 'dkBlue' | 'dkCyan' | 'dkGoldenrod' | 'dkGray' | 'dkGreen' | 'dkKhaki' | 'dkMagenta' | 'dkOliveGreen' | 'dkOrange' | 'dkOrchid' | 'dkRed' | 'dkSalmon' | 'dkSeaGreen' | 'dkSlateBlue' | 'dkSlateGray' | 'dkTurquoise' | 'dkViolet' | 'deepPink' | 'deepSkyBlue' | 'dimGray' | 'dodgerBlue' | 'firebrick' | 'floralWhite' | 'forestGreen' | 'fuchsia' | 'gainsboro' | 'ghostWhite' | 'gold' | 'goldenrod' | 'gray' | 'green' | 'greenYellow' | 'honeydew' | 'hotPink' | 'indianRed' | 'indigo' | 'ivory' | 'khaki' | 'lavender' | 'lavenderBlush' | 'lawnGreen' | 'lemonChiffon' | 'ltBlue' | 'ltCoral' | 'ltCyan' | 'ltGoldenrodYellow' | 'ltGray' | 'ltGreen' | 'ltPink' | 'ltSalmon' | 'ltSeaGreen' | 'ltSkyBlue' | 'ltSlateGray' | 'ltSteelBlue' | 'ltYellow' | 'lime' | 'limeGreen' | 'linen' | 'magenta' | 'maroon' | 'medAquamarine' | 'medBlue' | 'medOrchid' | 'medPurple' | 'medSeaGreen' | 'medSlateBlue' | 'medSpringGreen' | 'medTurquoise' | 'medVioletRed' | 'midnightBlue' | 'mintCream' | 'mistyRose' | 'moccasin' | 'navajoWhite' | 'navy' | 'oldLace' | 'olive' | 'oliveDrab' | 'orange' | 'orangeRed' | 'orchid' | 'paleGoldenrod' | 'paleGreen' | 'paleTurquoise' | 'paleVioletRed' | 'papayaWhip' | 'peachPuff' | 'peru' | 'pink' | 'plum' | 'powderBlue' | 'purple' | 'red' | 'rosyBrown' | 'royalBlue' | 'saddleBrown' | 'salmon' | 'sandyBrown' | 'seaGreen' | 'seaShell' | 'sienna' | 'silver' | 'skyBlue' | 'slateBlue' | 'slateGray' | 'snow' | 'springGreen' | 'steelBlue' | 'tan' | 'teal' | 'thistle' | 'tomato' | 'turquoise' | 'violet' | 'wheat' | 'white' | 'whiteSmoke' | 'yellow' | 'yellowGreen';
-};
-/**
- * A colour in Microsoft's scRGB colour space.
- *
- * Equivalent to CSS `srgb-linear` colour space.
- *
- * @group Colors
- */
-type ScRgbColor = {
-  type: 'scrgb';
-  /** Red value as a percentage. Can be outside the range 0-100. */
-  red: number;
-  /** Green value as a percentage. Can be outside the range 0-100. */
-  green: number;
-  /** Blue value as a percentage. Can be outside the range 0-100. */
-  blue: number;
-};
-/**
- * Standard sRGB colour space.
- *
- * @group Colors
- */
-type SrgbColor = {
-  type: 'srgb';
-  /**
-   * CSS-style hex, e.g. `FF0000`. Always six digits, always uppercase. No alpha channel.
-   * @pattern ^[A-F0-9]{6}$
-   */
-  value: string;
-};
-/**
- * OS-defined system colour (e.g. window text, highlight).
- *
- * The value must be one of the pre-defined values. The colour matching each of these values should
- * match the closest analogous colour in the OS in use.
- *
- * @group Colors
- */
-type SystemColor = {
-  type: 'system';
-  /** System colour name. */
-  value: 'scrollBar' | 'background' | 'activeCaption' | 'inactiveCaption' | 'menu' | 'window' | 'windowFrame' | 'menuText' | 'windowText' | 'captionText' | 'activeBorder' | 'inactiveBorder' | 'appWorkspace' | 'highlight' | 'highlightText' | 'btnFace' | 'btnShadow' | 'grayText' | 'btnText' | 'inactiveCaptionText' | 'btnHighlight' | '3dDkShadow' | '3dLight' | 'infoText' | 'infoBk' | 'hotLight' | 'gradientActiveCaption' | 'gradientInactiveCaption' | 'menuHighlight' | 'menuBar';
-};
-/** Reference to a theme colour. */
-/**
- * Reference to a theme colour.
- *
- * A theme colour is defined in the workbook's theme. Theme colours are used to ensure a consistent
- * palette across a workbook.
- *
- * @group Colors
- */
-type SchemeColor = {
-  type: 'theme';
-  /**
-   * Theme colour name.
-   *
-   * Must be one of a limited set of values. The actual colour that matches the name is defined
-   * elsewhere in the theme.
-   */
-  value: 'bg1' | 'tx1' | 'bg2' | 'tx2' | 'accent1' | 'accent2' | 'accent3' | 'accent4' | 'accent5' | 'accent6' | 'hlink' | 'folHlink' | 'phClr' | 'dk1' | 'lt1' | 'dk2' | 'lt2';
-};
-/**
- * A colour, which can be used is various parts of a workbook. The base colour can be transformed
- * using a list of colour transformations.
- *
- * The base colour must be defined using one of the following colour models:
- *
- * - {@link SrgbColor}: Standard sRGB colour space, defined by a CSS-style hex string (e.g.
- *   `FF0000`).
- * - {@link ScRgbColor}: A colour in Microsoft's scRGB colour space, defined by red, green, and blue
- *   values as percentages.
- * - {@link HslColor}: A colour in HSL colour space, defined by hue, saturation, and lightness
- *   values.
- * - {@link SystemColor}: An OS-defined system colour (e.g. window text, highlight), defined using
- *   one of an enumerated set of values.
- * - {@link SchemeColor}: A reference to a theme colour.
- * - {@link PresetColor}: A preset colour, similar to CSS's defined colours.
- * - {@link AutoColor}: Colour choice left to the application.
- * - {@link IndexedColor}: A legacy colour indexing scheme.
- *
- * @group Colors
- */
-type Color = (SrgbColor | ScRgbColor | HslColor | SystemColor | SchemeColor | PresetColor | AutoColor | IndexedColor) & {
-  /**
-   * Optional list of colour transformations to apply to the base colour.
-   *
-   * The transformations must be applied in order, and each transformation must be applied to the
-   * result of the previous one. There can be multiple transformations of the same type.
-   *
-   * The transformations are defined by {@link ColorTransform}, which includes operations such as
-   * tinting, shading, and saturation adjustments.
-   */
-  transforms?: ColorTransform[];
-};
-/**
- * The style to use when drawing a cell border. If the worksheet's zoom factor is changed the width
- * of the border is expected to stay the same.
- *
- * @group Workbooks
- */
-type BorderStyle =
-/** No border is drawn.*/
-'none' |
-/** Equivalent to SVG `stroke-dasharray="4 1 2 1"`, at a 1px width.*/
-'dashDot' |
-/** Equivalent to SVG `stroke-dasharray="4 1 2 1 2 1"`, at a 1px width.*/
-'dashDotDot' |
-/** Equivalent to SVG `stroke-dasharray=""3 1`, at a 1px width.*/
-'dashed' |
-/** Equivalent to SVG `stroke-dasharray="1"`, at a 1px width.*/
-'dotted' |
-/** Draw two 1px wide continuous parallel lines with a 1px gap between them.*/
-'double' |
-/** Draw a 1px wide pixel continuous hairline.*/
-'hair' |
-/** Draw a 2px wide pixel continuous line.*/
-'medium' |
-/** Equivalent to SVG `stroke-dasharray="4 1 2 1"`, at a 2px width.*/
-'mediumDashDot' |
-/** Equivalent to SVG `stroke-dasharray="4 1 2 1 2 1"`, at a 2px width.*/
-'mediumDashDotDot' |
-/** Equivalent to SVG `stroke-dasharray=""3 1`, at a 2px width.*/
-'mediumDashed' |
-/**
- * Draw two 1px parallel dashed lines where the lower/left line 1px "behind" the other, creating
- * a slant.
- */
-'slantDashDot' |
-/** Draw a 3px wide pixel continuous line.*/
-'thick' |
-/** Draw a 1px wide pixel continuous line.*/
-'thin';
-/**
- * Specifies the horizontal alignment of content (text) within a container (cell).
- *
- * @group Workbooks
- */
-type HAlign =
-/**
- * The horizontal alignment is general-aligned. Text data is left-aligned. Numbers, dates, and
- * times are right- aligned. Boolean types are centered.
- */
-'general' |
-/** Aligns content at the left edge of the cell (even in RTL mode). */
-'left' |
-/** The horizontal alignment is centered, meaning the text is centered across the cell. */
-'center' |
-/** Aligns content at the right edge of the cell (even in RTL mode). */
-'right' |
-/**
- * Indicates that the value of the cell should be filled across the entire width of the cell. If
- * blank cells to the right also have the fill alignment, they are also filled with the value,
- * using a convention similar to `centerContinuous`.
- */
-'fill' |
-/**
- * For each line of text, aligns each line of the wrapped text in a cell to the right and left
- * (except the last line).
- */
-'justify' |
-/** The horizontal alignment is centered across multiple cells. */
-'centerContinuous' |
-/**
- * Indicates that each 'word' in each line of text inside the cell is evenly distributed across
- * the width of the cell, with flush right and left margins.
- */
-'distributed';
-/**
- * The style of fill pattern used for a cell background. If the worksheets zoom factor is changed
- * the pixel scale of the pattern is still expected to stay the same.
- *
- * @group Workbooks
- */
-type PatternStyle = 'none' | 'solid' | 'mediumGray' | 'darkGray' | 'lightGray' | 'darkHorizontal' | 'darkVertical' | 'darkDown' | 'darkUp' | 'darkGrid' | 'darkTrellis' | 'lightHorizontal' | 'lightVertical' | 'lightDown' | 'lightUp' | 'lightGrid' | 'lightTrellis' | 'gray125' | 'gray0625';
-/**
- * Which type of underline to use when rendering text.
- *
- * @group Workbooks
- */
-type Underline = 'none' | 'single' | 'singleAccounting' | 'double' | 'doubleAccounting';
-/**
- * Vertical alignment of a cell content.
- *
- * @group Workbooks
- */
-type VAlign = 'bottom' | 'top' | 'center' | 'justify' | 'distributed';
-/**
- * Style rules that specify the visual presentation of a cell.
- *
- * @group Workbooks
- */
-type Style = {
-  /**
-   * The name of the font family used to render text, e.g. `"Arial"`.
-   *
-   * @default "Calibri"
-   */
-  fontFamily?: string;
-  /**
-   * Identifies the font scheme, if any, to which this style's font belongs.
-   *
-   * When set, the {@link Style.fontFamily} property is ignored and the font is instead resolved by
-   * the workbook theme. `"major"` maps to the theme's heading font and `"minor"` to the body font.
-   * The actual typeface is determined by the theme's {@link ThemeFontCollection} at render time.
-   *
-   * When the theme changes, an application is expected to update the fonts associated with a scheme
-   * automatically.
-   *
-   * It is an error to set this when a workbook has no theme.
-   *
-   * @see {@link Workbook.theme}
-   * @see {@link Theme.fontScheme}
-   * @see {@link ThemeFontScheme}
-   * @see {@link ThemeFontCollection}
-   */
-  fontScheme?: 'major' | 'minor';
-  /**
-   * The font size in pixels.
-   *
-   * @default 11
-   */
-  fontSize?: PixelValue;
-  /**
-   * The color used to render text.
-   *
-   * @default "#000"
-   */
-  color?: Color;
-  /**
-   * Indicates whether the text is bold.
-   *
-   * @default false
-   */
-  bold?: boolean;
-  /**
-   * Indicates whether the text is italic.
-   *
-   * @default false
-   */
-  italic?: boolean;
-  /**
-   * Text underline decoration type.
-   *
-   * @default "none"
-   */
-  underline?: Underline;
-  /**
-   * The cell's background color.
-   *
-   * @default "#FFFFFF"
-   */
-  fillColor?: Color;
-  /**
-   * The color of a cell's background fill.
-   *
-   * @default "#000000"
-   */
-  patternColor?: Color;
-  /**
-   * The style of a cell's background fill.
-   *
-   * @default "none"
-   */
-  patternStyle?: PatternStyle;
-  /**
-   * Top border style.
-   *
-   * @default "none"
-   */
-  borderTopStyle?: BorderStyle;
-  /**
-   * Top border color.
-   */
-  borderTopColor?: Color;
-  /**
-   * Left border style.
-   *
-   * @default "none"
-   */
-  borderLeftStyle?: BorderStyle;
-  /**
-   * Left border color.
-   */
-  borderLeftColor?: Color;
-  /**
-   * Bottom border style.
-   *
-   * @default "none"
-   */
-  borderBottomStyle?: BorderStyle;
-  /**
-   * Bottom border color.
-   */
-  borderBottomColor?: Color;
-  /**
-   * Right border style.
-   *
-   * @default "none"
-   */
-  borderRightStyle?: BorderStyle;
-  /**
-   * Right border color.
-   */
-  borderRightColor?: Color;
-  /**
-   * Horizontal alignment of the cells [text] content.
-   *
-   * @default "general"
-   */
-  horizontalAlignment?: HAlign;
-  /**
-   * Vertical alignment of the cells [text] content.
-   *
-   * @default "bottom"
-   */
-  verticalAlignment?: VAlign;
-  /**
-   * Indicates whether text should be wrapped when it exceeds the cell's width.
-   *
-   * @default false
-   */
-  wrapText?: boolean;
-  /**
-   * Indicates whether the font-size should be automatically reduced in order to make the contents
-   * of the cell visible.
-   */
-  shrinkToFit?: boolean;
-  /**
-   * The degrees to which the cell text should be rotated. Values range from 0 to 180, and 255 to
-   * indicate vertical text. The origin of the rotation is the first letter of the text.
-   *
-   * @min 0
-   * @max 255
-   * @defaultValue 0
-   */
-  textRotation?: integer;
-  /**
-   * Formatting directions for rendering the cell's value to text.
-   */
-  numberFormat?: string;
-  /**
-   * Name of the named style this style inherits from (e.g. "Percent", "Heading 1").
-   * Refers to a key in {@link Workbook.namedStyles}.
-   * When absent, the style inherits from the default style (typically "Normal").
-   */
-  extendsStyle?: string;
-  /**
-   * Whether the a cell should appear as a pivot-table button header (typically shown with a
-   * dropdown-arrow filter UI, e.g. on "Row Labels" / "Column Labels").
-   *
-   * Should be set only on cell styles used in a pivot table's layout.
-   */
-  pivotButton?: boolean;
-};
-//#endregion
-//#region node_modules/@grid-is/grid-prompt-tools/dist/index.d.ts
-//#endregion
-//#region src/load_mismatches.d.ts
-/**
- * The flavour of cell value carried in load-mismatch entries.
- *
- * Sheet cells in Apiary always materialise to plain CellValue (number,
- * string, boolean, FormulaError, or null) — never Matrix/Reference/Lambda.
- * Both cached and computed sides of a mismatch are therefore CellValue.
- */
-type CellValue$1 = CellValue;
-interface MismatchEntry {
-  readonly sheetName: string;
-  readonly a1: string;
-  readonly cachedValue: CellValue$1;
-  readonly calculatedValue: CellValue$1;
-  readonly source: "formula" | "spill";
-}
-declare class LoadMismatches {
-  private readonly _entries;
-  constructor(entries?: Map<string, MismatchEntry>);
-  get count(): number;
-  /** Lookup by sheet-qualified A1; returns the entry or undefined. */
-  get(sheetName: string, a1: string): MismatchEntry | undefined;
-  [Symbol.iterator](): IterableIterator<MismatchEntry>;
-}
-//#endregion
-//#region src/tools/types.d.ts
-type ToolError = {
-  error: string;
-};
-/**
- * Per-call context passed to tool implementations. Carries the model under
- * test plus any per-call data the tool may want (load-time mismatches today,
- * potentially more later).
- */
-interface ToolContext {
-  readonly model: Model;
-  readonly mismatches?: LoadMismatches;
-}
-declare function isToolError(value: unknown): value is ToolError;
-declare class SpreadsheetTool<TParams extends z.ZodType = z.ZodType, TResult = unknown> {
-  readonly name: string;
-  readonly description: string;
-  readonly parameters: TParams;
-  private _run;
-  constructor(options: {
-    name: string;
-    description: string;
-    parameters: TParams;
-    run: (ctx: ToolContext, input: z.infer<TParams>) => TResult;
-  });
-  execute(ctx: ToolContext, input: z.infer<TParams>): TResult | ToolError;
-}
-//#endregion
-//#region src/tools/describe_structure.d.ts
-type SheetStructure = {
-  name: string;
-  cellCount: number;
-  formulaCount: number;
-  errorCount?: number;
-  errorSample?: Array<{
-    key: string;
-    count: number;
-    cells: string[];
-  }>;
-  labels: string[];
-  totalLabels?: number;
-};
-type DescribeStructureResult = {
-  sheets: SheetStructure[];
-  totalErrors?: number;
-  summary: string;
-};
-declare const describeStructure: SpreadsheetTool<z.ZodObject<{
-  sheets: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  labelOffset: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>, DescribeStructureResult | ToolError>;
-//#endregion
-//#region src/tools/utils/read_cells.d.ts
-/**
- * Cell information with optional A1 reference.
- * When returned as a dict, ref is omitted (it's the key).
- * When returned as a single cell, ref is included.
- */
-type CellInfo = {
-  /** Cell value */ v?: string | number | boolean; /** Formula string as stored by Apiary */
-  f?: string; /** Cell type: 'z'=blank, 'b'=boolean, 'n'=number, 's'=string, 'e'=error */
-  t?: "z" | "b" | "n" | "s" | "e"; /** A1 address of the cell (e.g., "A1", "B10"). Omitted when returned in a dict. */
-  ref?: string; /** Number format string (omitted if default/general) */
-  num_format?: string; /** Index into workbook.styles array (omitted if cell has no style) */
-  style_index?: number; /** Formatted display value (only present when num_format is set) */
-  formatted?: string; /** Full style object (bold, italic, numberFormat, etc.) */
-  style?: Style | null; /** Hyperlink URL */
-  href?: string | null; /** For anchor cells: the full merged range (e.g., "A1:B2") */
-  mergedRange?: string; /** For non-anchor cells in a merge: the anchor cell to write to instead */
-  mergedInto?: string; /** Full FormulaError metadata. Present only when t === "e". */
-  error?: {
-    /** Error name, e.g. "#DIV/0!", "#NAME?", "#REF!". Same value as the stringified v. */ name: string; /** Integer error code from Apiary's FormulaError. */
-    code: number; /** Optional detail message, e.g. "function name not found". Present only if FormulaError.detail is set. */
-    detail?: string; /** Sheet-qualified reference of the cell where the error originated. Present only if FormulaError.origin is set. Compare to the inspected cell's own ref to tell whether the error originated here or propagated from elsewhere. */
-    origin?: string;
-  };
-  /**
-   * Load-time mismatch warning. Present when the JSF cache disagrees with
-   * Apiary's recalculated value for this cell. `cachedValue` is what the
-   * source workbook (e.g. Excel) wrote into the JSF; `calculatedValue` is
-   * what Apiary computed. See `LoadMismatches` for details.
-   */
-  mismatch?: {
-    note: string;
-    cachedValue: string | number | boolean | null | FormulaError;
-    calculatedValue: string | number | boolean | null | FormulaError;
-  };
-};
-/** Multi-cell read result: dict of cells with optional metadata */
-type MultiCellResult = Record<string, CellInfo> & {
-  _note?: string;
-};
-//#endregion
-//#region src/tools/utils/slice_range.d.ts
-interface TruncatedPage {
-  data: MultiCellResult;
-  truncated: true;
-  totalCells: number;
-  returnedCells: number;
-  offset: number;
-  nextOffset: number;
-  reference: string;
-}
-type PaginatedReadResult = CellInfo | MultiCellResult | TruncatedPage;
-//#endregion
-//#region src/tools/read_calculated_values.d.ts
-type ExpressionResult = CellInfo | MultiCellResult | TruncatedPage | {
-  error: string;
-};
-type ReadCalculatedValuesResult = Record<string, ExpressionResult>;
-declare const readCalculatedValues: SpreadsheetTool<z.ZodObject<{
-  read: z.ZodArray<z.ZodString>;
-  apply: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    cell: z.ZodString;
-    value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
-  }, z.core.$strip>>>;
-  cursors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-}, z.core.$strip>, ToolError | ReadCalculatedValuesResult>;
-//#endregion
-//#region src/tools/run_formula.d.ts
-type RunFormulaResult = Record<string, unknown> & {
-  _note?: string;
-};
-declare const runFormula: SpreadsheetTool<z.ZodObject<{
-  apply: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    cell: z.ZodString;
-    value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
-  }, z.core.$strip>>>;
-  formula: z.ZodOptional<z.ZodString>;
-  formulas: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sheet: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>, ToolError | RunFormulaResult>;
-//#endregion
-//#region src/tools/edit_cells.d.ts
-interface TypeChangeWarning {
-  level: "high" | "low";
-  note: string;
-}
-type EditCellsResult = {
-  success: true;
-  cellsModified: number;
-  changedCells: string[];
-  merged?: string[];
-  unmerged?: string[];
-  errors?: Record<string, string>;
-  mergeErrors?: Record<string, string>;
-  cell_errors?: Record<string, string[]>;
-  warnings?: Record<string, TypeChangeWarning>;
-};
-declare const editCells: SpreadsheetTool<z.ZodObject<{
-  apply: z.ZodArray<z.ZodObject<{
-    target: z.ZodString;
-    value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
-    styleIndex: z.ZodOptional<z.ZodNumber>;
-  }, z.core.$strip>>;
-  styles: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    bold: z.ZodOptional<z.ZodBoolean>;
-    borderBottomColor: z.ZodOptional<z.ZodString>;
-    borderBottomStyle: z.ZodOptional<z.ZodEnum<{
-      none: "none";
-      dashDot: "dashDot";
-      dashDotDot: "dashDotDot";
-      dashed: "dashed";
-      dotted: "dotted";
-      double: "double";
-      hair: "hair";
-      medium: "medium";
-      mediumDashDot: "mediumDashDot";
-      mediumDashDotDot: "mediumDashDotDot";
-      mediumDashed: "mediumDashed";
-      slantDashDot: "slantDashDot";
-      thick: "thick";
-      thin: "thin";
-    }>>;
-    borderLeftColor: z.ZodOptional<z.ZodString>;
-    borderLeftStyle: z.ZodOptional<z.ZodEnum<{
-      none: "none";
-      dashDot: "dashDot";
-      dashDotDot: "dashDotDot";
-      dashed: "dashed";
-      dotted: "dotted";
-      double: "double";
-      hair: "hair";
-      medium: "medium";
-      mediumDashDot: "mediumDashDot";
-      mediumDashDotDot: "mediumDashDotDot";
-      mediumDashed: "mediumDashed";
-      slantDashDot: "slantDashDot";
-      thick: "thick";
-      thin: "thin";
-    }>>;
-    borderRightColor: z.ZodOptional<z.ZodString>;
-    borderRightStyle: z.ZodOptional<z.ZodEnum<{
-      none: "none";
-      dashDot: "dashDot";
-      dashDotDot: "dashDotDot";
-      dashed: "dashed";
-      dotted: "dotted";
-      double: "double";
-      hair: "hair";
-      medium: "medium";
-      mediumDashDot: "mediumDashDot";
-      mediumDashDotDot: "mediumDashDotDot";
-      mediumDashed: "mediumDashed";
-      slantDashDot: "slantDashDot";
-      thick: "thick";
-      thin: "thin";
-    }>>;
-    borderTopColor: z.ZodOptional<z.ZodString>;
-    borderTopStyle: z.ZodOptional<z.ZodEnum<{
-      none: "none";
-      dashDot: "dashDot";
-      dashDotDot: "dashDotDot";
-      dashed: "dashed";
-      dotted: "dotted";
-      double: "double";
-      hair: "hair";
-      medium: "medium";
-      mediumDashDot: "mediumDashDot";
-      mediumDashDotDot: "mediumDashDotDot";
-      mediumDashed: "mediumDashed";
-      slantDashDot: "slantDashDot";
-      thick: "thick";
-      thin: "thin";
-    }>>;
-    fillColor: z.ZodOptional<z.ZodString>;
-    fontColor: z.ZodOptional<z.ZodString>;
-    fontName: z.ZodOptional<z.ZodString>;
-    fontSize: z.ZodOptional<z.ZodNumber>;
-    horizontalAlignment: z.ZodOptional<z.ZodEnum<{
-      fill: "fill";
-      general: "general";
-      left: "left";
-      center: "center";
-      right: "right";
-      justify: "justify";
-      centerContinuous: "centerContinuous";
-      distributed: "distributed";
-    }>>;
-    italic: z.ZodOptional<z.ZodBoolean>;
-    numberFormat: z.ZodOptional<z.ZodString>;
-    numberFormatFromFormula: z.ZodOptional<z.ZodString>;
-    shrinkToFit: z.ZodOptional<z.ZodBoolean>;
-    underline: z.ZodOptional<z.ZodEnum<{
-      none: "none";
-      double: "double";
-      single: "single";
-      singleAccounting: "singleAccounting";
-      doubleAccounting: "doubleAccounting";
-    }>>;
-    verticalAlignment: z.ZodOptional<z.ZodEnum<{
-      center: "center";
-      justify: "justify";
-      distributed: "distributed";
-      bottom: "bottom";
-      top: "top";
-    }>>;
-    wrapText: z.ZodOptional<z.ZodBoolean>;
-  }, z.core.$strip>>>;
-  note: z.ZodOptional<z.ZodString>;
-  merge: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  unmerge: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>, ToolError | EditCellsResult>;
-//#endregion
-//#region src/tools/fill_cells.d.ts
-type FillCellsResult = {
-  success: true;
-  filledRange: string;
-  changedCells: string[];
-  cell_errors?: Record<string, string[]>;
-};
-declare const fillCells: SpreadsheetTool<z.ZodObject<{
-  sheet: z.ZodString;
-  selection: z.ZodString;
-  extend_to: z.ZodString;
-  note: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>, ToolError | FillCellsResult>;
-//#endregion
-//#region src/tools/manage_sheets.d.ts
-type ManageSheetsResult = {
-  success: true;
-  sheets: string[];
-};
-declare const manageSheets: SpreadsheetTool<z.ZodObject<{
-  add: z.ZodOptional<z.ZodObject<{
-    name: z.ZodString;
-  }, z.core.$strip>>;
-  remove: z.ZodOptional<z.ZodObject<{
-    sheet: z.ZodString;
-  }, z.core.$strip>>;
-  rename: z.ZodOptional<z.ZodObject<{
-    sheet: z.ZodString;
-    name: z.ZodString;
-  }, z.core.$strip>>;
-  setVisibility: z.ZodOptional<z.ZodObject<{
-    sheet: z.ZodString;
-    hidden: z.ZodEnum<{
-      visible: "visible";
-      hidden: "hidden";
-      veryHidden: "veryHidden";
-    }>;
-  }, z.core.$strip>>;
-  note: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>, ToolError | ManageSheetsResult>;
-//#endregion
-//#region src/tools/manage_rows_and_columns.d.ts
-type ManageRowsAndColumnsResult = {
-  success: true;
-  changedCells: string[];
-};
-declare const manageRowsAndColumns: SpreadsheetTool<z.ZodObject<{
-  sheet: z.ZodString;
-  columns: z.ZodOptional<z.ZodObject<{
-    insert: z.ZodOptional<z.ZodObject<{
-      column: z.ZodString;
-      count: z.ZodNumber;
-    }, z.core.$strip>>;
-    delete: z.ZodOptional<z.ZodObject<{
-      column: z.ZodString;
-      count: z.ZodNumber;
-    }, z.core.$strip>>;
-    autoSize: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  }, z.core.$strip>>;
-  rows: z.ZodOptional<z.ZodObject<{
-    insert: z.ZodOptional<z.ZodObject<{
-      row: z.ZodNumber;
-      count: z.ZodNumber;
-    }, z.core.$strip>>;
-    delete: z.ZodOptional<z.ZodObject<{
-      row: z.ZodNumber;
-      count: z.ZodNumber;
-    }, z.core.$strip>>;
-    autoSize: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
-  }, z.core.$strip>>;
-  note: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>, ToolError | ManageRowsAndColumnsResult>;
-//#endregion
-//#region src/tools/edit_cell_styles.d.ts
-type EditCellStylesResult = {
-  success: true;
-  rangesStyled: number;
-};
-declare const editCellStyles: SpreadsheetTool<z.ZodObject<{
-  sheet: z.ZodString;
-  apply: z.ZodArray<z.ZodObject<{
-    target: z.ZodString;
-    styles: z.ZodObject<{
-      bold: z.ZodOptional<z.ZodBoolean>;
-      borderBottomColor: z.ZodOptional<z.ZodString>;
-      borderBottomStyle: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        dashDot: "dashDot";
-        dashDotDot: "dashDotDot";
-        dashed: "dashed";
-        dotted: "dotted";
-        double: "double";
-        hair: "hair";
-        medium: "medium";
-        mediumDashDot: "mediumDashDot";
-        mediumDashDotDot: "mediumDashDotDot";
-        mediumDashed: "mediumDashed";
-        slantDashDot: "slantDashDot";
-        thick: "thick";
-        thin: "thin";
-      }>>;
-      borderLeftColor: z.ZodOptional<z.ZodString>;
-      borderLeftStyle: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        dashDot: "dashDot";
-        dashDotDot: "dashDotDot";
-        dashed: "dashed";
-        dotted: "dotted";
-        double: "double";
-        hair: "hair";
-        medium: "medium";
-        mediumDashDot: "mediumDashDot";
-        mediumDashDotDot: "mediumDashDotDot";
-        mediumDashed: "mediumDashed";
-        slantDashDot: "slantDashDot";
-        thick: "thick";
-        thin: "thin";
-      }>>;
-      borderRightColor: z.ZodOptional<z.ZodString>;
-      borderRightStyle: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        dashDot: "dashDot";
-        dashDotDot: "dashDotDot";
-        dashed: "dashed";
-        dotted: "dotted";
-        double: "double";
-        hair: "hair";
-        medium: "medium";
-        mediumDashDot: "mediumDashDot";
-        mediumDashDotDot: "mediumDashDotDot";
-        mediumDashed: "mediumDashed";
-        slantDashDot: "slantDashDot";
-        thick: "thick";
-        thin: "thin";
-      }>>;
-      borderTopColor: z.ZodOptional<z.ZodString>;
-      borderTopStyle: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        dashDot: "dashDot";
-        dashDotDot: "dashDotDot";
-        dashed: "dashed";
-        dotted: "dotted";
-        double: "double";
-        hair: "hair";
-        medium: "medium";
-        mediumDashDot: "mediumDashDot";
-        mediumDashDotDot: "mediumDashDotDot";
-        mediumDashed: "mediumDashed";
-        slantDashDot: "slantDashDot";
-        thick: "thick";
-        thin: "thin";
-      }>>;
-      fillColor: z.ZodOptional<z.ZodString>;
-      fontColor: z.ZodOptional<z.ZodString>;
-      fontName: z.ZodOptional<z.ZodString>;
-      fontSize: z.ZodOptional<z.ZodNumber>;
-      horizontalAlignment: z.ZodOptional<z.ZodEnum<{
-        fill: "fill";
-        general: "general";
-        left: "left";
-        center: "center";
-        right: "right";
-        justify: "justify";
-        centerContinuous: "centerContinuous";
-        distributed: "distributed";
-      }>>;
-      italic: z.ZodOptional<z.ZodBoolean>;
-      numberFormat: z.ZodOptional<z.ZodString>;
-      numberFormatFromFormula: z.ZodOptional<z.ZodString>;
-      shrinkToFit: z.ZodOptional<z.ZodBoolean>;
-      underline: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        double: "double";
-        single: "single";
-        singleAccounting: "singleAccounting";
-        doubleAccounting: "doubleAccounting";
-      }>>;
-      verticalAlignment: z.ZodOptional<z.ZodEnum<{
-        center: "center";
-        justify: "justify";
-        distributed: "distributed";
-        bottom: "bottom";
-        top: "top";
-      }>>;
-      wrapText: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>;
-  }, z.core.$strip>>;
-  note: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>, ToolError | EditCellStylesResult>;
-//#endregion
-//#region src/tools/get_styles.d.ts
-type GetStylesResult = Record<number, unknown> | unknown[];
-declare const getStyles: SpreadsheetTool<z.ZodObject<{
-  indices: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
-}, z.core.$strip>, ToolError | GetStylesResult>;
-//#endregion
-//#region src/tools/goal_seek.d.ts
-type GoalSeekResult = {
-  success: true;
-  goalSeek: {
-    targetCell: string;
-    targetValue: number;
-    controlCell: string;
-    solution: unknown;
-  };
-};
-declare const goalSeek: SpreadsheetTool<z.ZodObject<{
-  write: z.ZodArray<z.ZodObject<{
-    cell: z.ZodString;
-    value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
-  }, z.core.$strip>>;
-  goalSeek: z.ZodObject<{
-    targetCell: z.ZodString;
-    targetValue: z.ZodNumber;
-    controlCell: z.ZodString;
-  }, z.core.$strip>;
-  persist: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>, ToolError | GoalSeekResult>;
-//#endregion
-//#region src/tools/intelligence/symbols.d.ts
-type SymbolsResult = {
-  sheets: {
-    name: string;
-    size: [number, number];
-  }[];
-  namedRanges: {
-    name: string;
-    formula: string | null;
-    scope: string;
-  }[];
-  tables: {
-    name: string;
-    sheet: string;
-    ref: string;
-    headers: number;
-    totals: number;
-  }[];
-  stats: {
-    cells: number;
-    graphNodes: number;
-    graphEdges: number;
-  };
-};
-declare const symbols: SpreadsheetTool<z.ZodObject<{}, z.core.$strip>, ToolError | SymbolsResult>;
-//#endregion
-//#region src/tools/intelligence/what_if.d.ts
-type WhatIfResult = {
-  applied: Record<string, string | number | boolean | null>;
-  affected: Record<string, {
-    before: string | number | boolean | null;
-    after: string | number | boolean | null;
-    formula: string | null;
-  }>;
-  truncated?: boolean;
-  totalAffected?: number;
-};
-declare const whatIf: SpreadsheetTool<z.ZodObject<{
-  changes: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
-}, z.core.$strip>, ToolError | WhatIfResult>;
-//#endregion
-//#region src/tools/intelligence/chunked_graph_node.d.ts
-type ChunkNode = WorkbookDescription["calculated"][number];
-/**
- * A node in a chunked dependency-graph traversal tree. Chunks represent groups
- * of cells with structurally identical formulas, collapsed into labeled nodes.
- *
- * Nodes are keyed by their chunk reference in the parent's `precedents` /
- * `dependents` dict (e.g. "Sheet1!C2:C10"), so there is no separate `ref`
- * field — its key is its address.
- */
-type ChunkedGraphNode = {
-  type: ChunkNode["type"];
-  labels: string[];
-  formula: string | null;
-  rootHeight?: number;
-  leafDepth?: number;
-  precedents?: Record<string, ChunkedGraphNode>;
-  dependents?: Record<string, ChunkedGraphNode>;
-  alreadyVisited?: true;
-  truncated?: {
-    reason: "maxDepth" | "maxNodes";
-    totalChildren?: number;
-  };
-};
-/** Top-level result: a single-entry dict keyed by the root chunk's ref. */
-type ChunkedGraphWalkResult = Record<string, ChunkedGraphNode>;
-//#endregion
-//#region src/tools/intelligence/graph_node.d.ts
-/**
- * A node in a dependency-graph traversal tree. The same shape is used for
- * both the precedents tool (walks outgoing edges, populates `precedents`)
- * and the dependents tool (walks incoming edges, populates `dependents`).
- *
- * Nodes are keyed by their cell/range/name reference in the parent's
- * `precedents` / `dependents` dict, so there is no `ref` field on the node
- * itself — its key is its address.
- */
-type GraphNode = {
-  kind: "cell" | "range" | "name";
-  formula: string | null;
-  value?: string | number | boolean | null;
-  errorValue?: string;
-  precedents?: Record<string, GraphNode>;
-  dependents?: Record<string, GraphNode>;
-  alreadyVisited?: true;
-  truncated?: {
-    reason: "maxDepth" | "maxNodes";
-    totalChildren?: number;
-  };
-};
-/** Top-level result: a single-entry dict keyed by the root node's ref. */
-type GraphWalkResult = Record<string, GraphNode>;
-//#endregion
-//#region src/tools/intelligence/make_graph_tool.d.ts
-type GraphToolResult = GraphWalkResult | ChunkedGraphWalkResult | ToolError;
-//#endregion
-//#region src/tools/list_errors.d.ts
-type ListErrorsResult = {
-  formulaErrors: {
-    groups: Array<{
-      key: string;
-      count: number;
-      cells: string[];
-      omittedCells?: number;
-    }>;
-    totalCells: number;
-    perSheet: Record<string, number>;
-  };
-  modelErrors: {
-    entries: Array<{
-      type: string;
-      level: "ERROR" | "WARNING" | "NOTICE";
-      message: string;
-      references: string[];
-    }>;
-    total: number;
-  };
-  truncated?: {
-    groupsWithOmittedCells: number;
-    hint: string;
-  };
-};
-declare const listErrors: SpreadsheetTool<z.ZodObject<{
-  sheet: z.ZodOptional<z.ZodString>;
-  range: z.ZodOptional<z.ZodString>;
-  max: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>, ToolError | ListErrorsResult>;
-//#endregion
-//#region src/tools/find_cells.d.ts
-type FindCellsMatch = {
-  /** Sheet-qualified A1 reference of the matching cell. */ ref: string; /** Cell value (stringified; omitted if blank). */
-  value?: string; /** Formula text (omitted for value cells). */
-  formula?: string; /** Human-readable fill color string (omitted if no fill). */
-  fillColor?: string;
-};
-type FindCellsResult = {
-  matches: FindCellsMatch[];
-  totalMatches: number;
-  truncated?: {
-    maxMatches: number;
-    hint: string;
-  };
-};
-declare const findCells: SpreadsheetTool<z.ZodObject<{
-  sheet: z.ZodOptional<z.ZodString>;
-  range: z.ZodOptional<z.ZodString>;
-  matchMode: z.ZodOptional<z.ZodEnum<{
-    AND: "AND";
-    OR: "OR";
-  }>>;
-  hasFormula: z.ZodOptional<z.ZodBoolean>;
-  fillColor: z.ZodOptional<z.ZodString>;
-  formulaContains: z.ZodOptional<z.ZodString>;
-  valueContains: z.ZodOptional<z.ZodString>;
-  valueWithin: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
-}, z.core.$strip>, ToolError | FindCellsResult>;
-//#endregion
-//#region src/tools/capture_range.d.ts
-declare const captureRange: SpreadsheetTool<z.ZodObject<{
-  reference: z.ZodString;
-  headers: z.ZodDefault<z.ZodBoolean>;
-  scale: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>, Promise<ToolError | Uint8Array<ArrayBufferLike>>>;
-//#endregion
-//#region src/tools/comments/helpers.d.ts
-type CommentEntry = {
-  /** Sheet-qualified A1 address, e.g. `'LBO Model'!E46`. */ address: string; /** `thread` = modern threaded comment; `note` = legacy single-author note. */
-  kind: "thread" | "note";
-  author: string; /** ISO datetime if known (threaded comments only). */
-  datetime?: string; /** Number of replies on a thread; omitted for notes and unreplied threads. */
-  replyCount?: number;
-  resolved?: boolean; /** First `PREVIEW_CHARS` chars of the root text, whitespace-collapsed. */
-  preview: string;
-  truncated?: boolean;
-};
-type ThreadEntry = {
-  author: string;
-  datetime?: string;
-  text: string;
-  isReply: boolean;
-};
-//#endregion
-//#region src/tools/comments/get_comment.d.ts
-type GetCommentResult = {
-  address: string;
-  kind: "thread";
-  resolved?: boolean;
-  entries: ThreadEntry[];
-} | {
-  address: string;
-  kind: "note";
-  author: string;
-  text: string;
-} | {
-  address: string;
-  kind: "none";
-};
-declare const getComment: SpreadsheetTool<z.ZodObject<{
-  address: z.ZodString;
-}, z.core.$strip>, ToolError | GetCommentResult>;
-//#endregion
-//#region src/tools/comments/get_comments.d.ts
-type GetCommentsResult = {
-  comments: CommentEntry[];
-  total: number;
-  offset: number;
-  hasMore: boolean;
-  nextOffset?: number;
-};
-declare const getComments: SpreadsheetTool<z.ZodObject<{
-  sheet: z.ZodOptional<z.ZodString>;
-  offset: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>, ToolError | GetCommentsResult>;
-//#endregion
-//#region src/tools/intelligence/dependents.d.ts
-declare const dependents: SpreadsheetTool<import("zod").ZodObject<{
-  reference: import("zod").ZodString;
-  mode: import("zod").ZodDefault<import("zod").ZodEnum<{
-    cells: "cells";
-    grouped: "grouped";
-  }>>;
-  maxDepth: import("zod").ZodOptional<import("zod").ZodNumber>;
-  maxNodes: import("zod").ZodOptional<import("zod").ZodNumber>;
-}, import("zod/v4/core").$strip>, GraphToolResult>;
-//#endregion
-//#region src/tools/intelligence/inspect.d.ts
-declare const inspect: SpreadsheetTool<z.ZodObject<{
-  reference: z.ZodString;
-  offset: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>, ToolError | PaginatedReadResult>;
-//#endregion
-//#region src/tools/intelligence/precedents.d.ts
-declare const precedents: SpreadsheetTool<import("zod").ZodObject<{
-  reference: import("zod").ZodString;
-  mode: import("zod").ZodDefault<import("zod").ZodEnum<{
-    cells: "cells";
-    grouped: "grouped";
-  }>>;
-  maxDepth: import("zod").ZodOptional<import("zod").ZodNumber>;
-  maxNodes: import("zod").ZodOptional<import("zod").ZodNumber>;
-}, import("zod/v4/core").$strip>, GraphToolResult>;
-//#endregion
-//#region src/tools/view_range.d.ts
-declare const viewRange: SpreadsheetTool<z.ZodObject<{
-  reference: z.ZodString;
-  show: z.ZodOptional<z.ZodEnum<{
-    value: "value";
-    formula: "formula";
-    fill: "fill";
-    fontColor: "fontColor";
-    numberFormat: "numberFormat";
-    rawValue: "rawValue";
-  }>>;
-}, z.core.$strip>, string>;
-//#endregion
-//#region src/tools/workbook_context.d.ts
-/**
- * Generate a pre-analyzed workbook summary suitable for injection into
- * an LLM system prompt. Combines the information from `symbols` and
- * `describeStructure` into a concise, structured format.
- *
- * Returns `null` only if the underlying tools fail.
- */
-declare function generateWorkbookContext(model: Model): string | null;
-//#endregion
 //#region src/index.d.ts
 declare function toMcpServer(tools?: GridTool[], info?: {
   name?: string;