@sqlrooms/deck 0.29.0-rc.10

package/dist/MapSettingsControls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapSettingsControls.js","sourceRoot":"","sources":["../src/MapSettingsControls.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  getTableDisplayName,\n  getTableIdentity,\n  isColumnCategorical,\n  isColumnNumeric,\n  isColumnQuantitative,\n  type DataTable,\n  type TableColumn,\n} from '@sqlrooms/duckdb';\nimport {\n  Button,\n  cn,\n  Combobox,\n  CopyButton,\n  ScrollArea,\n  Tooltip,\n  TooltipContent,\n  TooltipTrigger,\n} from '@sqlrooms/ui';\nimport {CodeIcon, TableIcon} from 'lucide-react';\nimport {\n  createContext,\n  useContext,\n  type FC,\n  type PropsWithChildren,\n} from 'react';\n\nexport const DeckMapSettingsField: FC<\n  PropsWithChildren<{label: string; required?: boolean}>\n> = ({label, required, children}) => (\n  <div className=\"flex flex-col gap-1\">\n    <label className=\"text-xs font-medium\">\n      {label}\n      {required && <span className=\"text-destructive ml-1\">*</span>}\n    </label>\n    <div className=\"grid items-end gap-2\">{children}</div>\n  </div>\n);\n\nexport type DeckMapColumnKind =\n  | 'all'\n  | 'numeric'\n  | 'quantitative'\n  | 'categorical';\n\nexport function filterDeckMapColumns(\n  columns: TableColumn[],\n  kind: DeckMapColumnKind,\n) {\n  if (kind === 'all') return columns;\n  return columns.filter((column) => {\n    if (!column.type) return false;\n    if (kind === 'numeric') return isColumnNumeric(column.type);\n    if (kind === 'quantitative') return isColumnQuantitative(column.type);\n    return isColumnCategorical(column.type);\n  });\n}\n\nconst DeckMapColumnsContext = createContext<TableColumn[]>([]);\n\nexport const DeckMapColumnsProvider: FC<\n  PropsWithChildren<{columns: TableColumn[]}>\n> = ({columns, children}) => (\n  <DeckMapColumnsContext.Provider value={columns}>\n    {children}\n  </DeckMapColumnsContext.Provider>\n);\n\nexport type DeckMapColumnSelectorProps = {\n  columns?: TableColumn[];\n  kind?: DeckMapColumnKind;\n  value?: string;\n  onChange: (value: string) => void;\n  placeholder?: string;\n  disabled?: boolean;\n};\n\nconst DeckMapColumnSelectorRoot: FC<DeckMapColumnSelectorProps> = ({\n  columns,\n  kind = 'all',\n  value,\n  onChange,\n  placeholder = 'Select column…',\n  disabled,\n}) => {\n  const contextColumns = useContext(DeckMapColumnsContext);\n  const options = filterDeckMapColumns(columns ?? contextColumns, kind);\n  const selectedColumn = options.find((column) => column.name === value);\n  const isMissing = Boolean(value && !selectedColumn);\n  return (\n    <Combobox value={value ?? ''} onChange={onChange} disabled={disabled}>\n      <Combobox.Trigger\n        className={cn(\n          'w-full',\n          isMissing && 'border-destructive/60 bg-destructive/5',\n        )}\n      >\n        {selectedColumn ? (\n          <span className=\"flex min-w-0 items-baseline gap-1\">\n            <span className=\"truncate\">{selectedColumn.name}</span>\n            <span className=\"text-muted-foreground truncate text-[8px]\">\n              {selectedColumn.type}\n            </span>\n          </span>\n        ) : value ? (\n          <span className=\"text-destructive truncate\">{value} (missing)</span>\n        ) : (\n          <span className=\"text-muted-foreground truncate\">{placeholder}</span>\n        )}\n      </Combobox.Trigger>\n      <Combobox.Content\n        searchable\n        searchPlaceholder=\"Search columns...\"\n        emptyMessage=\"No matching column.\"\n      >\n        {options.map((column) => (\n          <Combobox.Item key={column.name} value={column.name}>\n            <span className=\"truncate\">{column.name}</span>\n            <span className=\"text-muted-foreground ml-auto text-[8px]\">\n              {column.type}\n            </span>\n          </Combobox.Item>\n        ))}\n      </Combobox.Content>\n    </Combobox>\n  );\n};\n\nexport const DeckMapColumnSelector = Object.assign(DeckMapColumnSelectorRoot, {\n  Numeric: (props: Omit<DeckMapColumnSelectorProps, 'kind'>) => (\n    <DeckMapColumnSelectorRoot {...props} kind=\"numeric\" />\n  ),\n  Quantitative: (props: Omit<DeckMapColumnSelectorProps, 'kind'>) => (\n    <DeckMapColumnSelectorRoot {...props} kind=\"quantitative\" />\n  ),\n  Categorical: (props: Omit<DeckMapColumnSelectorProps, 'kind'>) => (\n    <DeckMapColumnSelectorRoot {...props} kind=\"categorical\" />\n  ),\n});\n\nexport const DeckMapTableSelector: FC<{\n  tables: DataTable[];\n  value?: DataTable;\n  onChange: (table: DataTable) => void;\n  disabled?: boolean;\n}> = ({tables, value, onChange, disabled}) => {\n  const identity = value ? getTableIdentity(value.table) : '';\n  return (\n    <Combobox\n      value={identity}\n      onChange={(nextIdentity) => {\n        const table = tables.find(\n          (candidate) => getTableIdentity(candidate.table) === nextIdentity,\n        );\n        if (table) onChange(table);\n      }}\n      disabled={disabled}\n    >\n      <Combobox.Trigger className=\"w-full font-mono\">\n        <span className=\"flex min-w-0 items-center gap-2\">\n          <TableIcon className=\"text-muted-foreground h-3.5 w-3.5 shrink-0\" />\n          <span className=\"truncate\">\n            {value ? getTableDisplayName(value.table) : 'Select table...'}\n          </span>\n        </span>\n      </Combobox.Trigger>\n      <Combobox.Content\n        searchable\n        searchPlaceholder=\"Search tables...\"\n        emptyMessage=\"No tables found.\"\n      >\n        {tables.map((table) => {\n          const tableIdentity = getTableIdentity(table.table);\n          return (\n            <Combobox.Item\n              key={tableIdentity}\n              value={tableIdentity}\n              keywords={[\n                getTableDisplayName(table.table),\n                table.table.schema ?? '',\n                table.table.database ?? '',\n              ]}\n            >\n              <span className=\"truncate font-mono\">\n                {getTableDisplayName(table.table)}\n              </span>\n              {table.isView ? (\n                <span className=\"text-muted-foreground ml-auto text-[10px]\">\n                  view\n                </span>\n              ) : null}\n            </Combobox.Item>\n          );\n        })}\n      </Combobox.Content>\n    </Combobox>\n  );\n};\n\nexport const DeckMapCodeViewToggleButton: FC<{\n  selected: boolean;\n  onClick: () => void;\n  label?: string;\n}> = ({selected, onClick, label: labelProp}) => {\n  const label = labelProp ?? (selected ? 'Show settings' : 'View code');\n  return (\n    <Tooltip>\n      <TooltipTrigger asChild>\n        <Button\n          type=\"button\"\n          variant={selected ? 'secondary' : 'ghost'}\n          size=\"icon\"\n          className=\"h-6 w-6\"\n          onClick={onClick}\n          aria-label={label}\n          aria-pressed={selected}\n        >\n          <CodeIcon className=\"h-3.5 w-3.5\" />\n        </Button>\n      </TooltipTrigger>\n      <TooltipContent>{label}</TooltipContent>\n    </Tooltip>\n  );\n};\n\nexport const DeckMapCodeViewerPanel: FC<{\n  value: string;\n  copyTooltipLabel?: string;\n}> = ({value, copyTooltipLabel = 'Copy map config'}) => (\n  <ScrollArea className=\"min-h-0 flex-1\">\n    <div className=\"h-full p-2\">\n      <div className=\"border-input relative h-full overflow-hidden rounded-md border\">\n        <pre className=\"h-full overflow-auto p-3 pr-12 font-mono text-xs whitespace-pre-wrap\">\n          {value}\n        </pre>\n        <div className=\"bg-background absolute top-2 right-2 rounded-md border\">\n          <CopyButton\n            text={value}\n            size=\"xs\"\n            tooltipLabel={copyTooltipLabel}\n            disabled={!value.trim()}\n          />\n        </div>\n      </div>\n    </div>\n  </ScrollArea>\n);\n"]}

package/dist/ai.d.ts

@@ -0,0 +1,261 @@
+import { type Tool } from 'ai';
+import { z } from 'zod';
+import { DashboardAiAdapter, type CreateDashboardAgentToolOptions, type CreateDashboardAiToolsOptions, DatabaseAiAdapter, MosaicDashboardStoreState } from '@sqlrooms/mosaic';
+import { getFirstDatasetSourceTableName, hasSqlOnlyDatasetSource } from './datasetSourceUtils';
+export { getFirstDatasetSourceTableName, hasSqlOnlyDatasetSource };
+export declare const DECK_MAP_AI_INSTRUCTIONS = "\nDeck map tools:\n- create_deck_map_config validates and returns a reusable native Deck JSON map config without requiring a dashboard artifact.\n- create_dashboard_map creates or updates an interactive map panel inside a dashboard from a native Deck JSON map config.\n- Use map tools when the user asks for a map, geospatial/spatial visualization, locations, longitude/latitude data, or geometry columns.\n- CONFIG MODE: Every map config must include a configMode field (\"basic\" or \"custom\") that determines how the map was authored and whether the UI settings panel is available.\n  - \"basic\" (default): Use for straightforward requests \u2014 single layer, standard color scale, simple geometry binding. Stick ONLY to properties that the UI configurator supports: layer @@type, visibility, color scale (@@function colorScale), point radius (numeric getRadius with radiusUnits), line width (numeric getWidth with widthUnits), geometry/H3/arc column bindings, extrusion with a single elevation column. Do NOT use string accessors (@@= expressions), custom extensions, multiple layers, or advanced deck.gl props in basic mode. The user can fine-tune these maps through the settings panel.\n  - \"custom\": Use when the request demands creative, complex, or advanced visualization \u2014 multiple layers, data-driven accessors (@@= expressions), custom color arrays, advanced deck.gl props (opacity, transitions, material, highlightColor, etc.), layer extensions, or any props not representable in the UI configurator. The UI settings panel will be disabled for custom configs; users edit via the JSON editor instead.\n  - Decision rule: If the map can be fully expressed with a single layer + basic color scale + simple numeric radius/width, use \"basic\". Otherwise use \"custom\".\n- Author maps with config.spec.layers using Deck JSON layer classes in @@type, such as GeoArrowScatterplotLayer, GeoArrowHeatmapLayer, GeoArrowPolygonLayer, GeoArrowPathLayer, GeoArrowTripsLayer, GeoArrowArcLayer, or GeoArrowH3HexagonLayer.\n- LAYER SELECTION: Choose the layer type based on the geometry type in the data.\n  IMPORTANT: Only create a layer if the table contains data suitable for that layer type, or if you can transform the data into the required format with transformSql or a standalone sqlQuery. Do NOT create a layer if the data is clearly incompatible (e.g. do not create a path layer from point-only data without aggregation, do not create a polygon layer from point coordinates, do not create an arc layer without origin-destination pairs).\n  - Point data (lon/lat coordinates, point geometry): GeoArrowScatterplotLayer (Point layer), GeoArrowHeatmapLayer, GeoArrowColumnLayer. Requires rows with individual point positions \u2014 either separate longitude/latitude numeric columns, or a point geometry column. Each row represents one point on the map.\n  - Polygon data (building footprints, boundaries, areas, parcels, zones): GeoArrowPolygonLayer or GeoArrowSolidPolygonLayer. Requires a geometry column containing polygon or multipolygon WKB/GeoArrow data. Typically loaded from GeoJSON/Shapefile/GeoParquet or produced by spatial queries. Do NOT use for point data.\n  - Line data (roads, routes, paths, rivers): GeoArrowPathLayer. CRITICAL: GeoArrowPathLayer requires LineString geometry, NOT individual point rows. If the table has one row per waypoint (indicated by columns like path_id/route_id + order/sequence + lat/lon), you MUST aggregate them with transformSql: \"SELECT path_id, label, ST_AsWKB(ST_MakeLine(LIST(ST_Point(lon, lat) ORDER BY waypoint_order))) AS geom FROM __sqlrooms_source GROUP BY path_id, label\". Set geometryColumn to \"geom\" and geometryEncodingHint to \"wkb\". If the table already has a geometry/geom column with linestring data, use it directly with tableName. NEVER pass raw waypoint rows to GeoArrowPathLayer \u2014 it will fail.\n  - Animated trip data (routes with timestamps): GeoArrowTripsLayer. Same geometry requirements as GeoArrowPathLayer (LineString), plus a timestamps column. The transformSql MUST aggregate both the geometry and timestamps: \"SELECT path_id, label, ST_AsWKB(ST_MakeLine(LIST(ST_Point(lon, lat) ORDER BY waypoint_order))) AS geom, LIST(timestamp ORDER BY waypoint_order) AS timestamps FROM __sqlrooms_source GROUP BY path_id, label\". Set geometryColumn to \"geom\", geometryEncodingHint to \"wkb\", and _sqlroomsBinding.timestampColumn to \"timestamps\". The timestamps column must be a list of numbers (seconds) matching the order of waypoints in the linestring. Also set currentTime on the layer to control animation position. Do NOT use unless the data has or can produce both paths and ordered timestamps.\n- CRITICAL geometryColumn rule: The geometryColumn field (in datasets[id].geometryColumn, _sqlroomsBinding.geometryColumn, and fitToData.geometryColumn) MUST match the exact column alias that produces the WKB geometry in the final query output \u2014 typically the \"AS geom\" alias in ST_AsWKB(...) AS geom. It must NEVER be set to a GROUP BY key, an ID column, or any other non-geometry column. For example, if the transformSql is \"SELECT path_id, ST_AsWKB(ST_MakeLine(...)) AS geom ... GROUP BY path_id\", geometryColumn must be \"geom\" (the geometry output), NOT \"path_id\" (the grouping key). Setting geometryColumn to a non-geometry column will cause the layer to fail silently.\n  - Arc data (origin-destination pairs): GeoArrowArcLayer. Requires two sets of coordinates per row (source and target). The table must have source_lon/source_lat AND target_lon/target_lat columns (or equivalent). The dataset source MUST use transformSql that creates WKB geometry columns from lat/lon, for example: \"SELECT *, ST_AsWKB(ST_Point(source_lon, source_lat)) AS source_geom, ST_AsWKB(ST_Point(target_lon, target_lat)) AS target_geom FROM __sqlrooms_source\". Set sourceGeometryColumn to \"source_geom\" and targetGeometryColumn to \"target_geom\". Set geometryEncodingHint to \"wkb\". To render straight lines instead of arcs, set \"getHeight\": 0 on the layer. Do NOT use for data with only one set of coordinates per row. When the source data has H3 indices instead of lat/lon, convert H3 to coordinates using h3_cell_to_lng(h3_index) and h3_cell_to_lat(h3_index) (the H3 extension is pre-loaded at startup), for example: \"SELECT *, ST_AsWKB(ST_Point(h3_cell_to_lng(source_h3), h3_cell_to_lat(source_h3))) AS source_geom, ST_AsWKB(ST_Point(h3_cell_to_lng(target_h3), h3_cell_to_lat(target_h3))) AS target_geom FROM __sqlrooms_source\". Do NOT use h3_latlng() \u2014 it does not exist.\n  - H3 hexagon data (h3 index column): GeoArrowH3HexagonLayer. Requires a column containing H3 string indices. Bind to dataset with _sqlroomsBinding.dataset. Set \"getHexagon\": \"@@=h3_column_name\" where h3_column_name is the column containing H3 string indices. Always include \"fitToData\": {\"dataset\": \"datasetId\"} so the map can zoom to the data extent. Do NOT use unless the table has an H3 index column. DuckDB H3 extension functions: h3_cell_to_lat(index), h3_cell_to_lng(index), h3_cell_to_latlng(index). Do NOT use h3_latlng(), h3_to_lat(), or other non-existent function names.\n- CRITICAL: The transformSql and sqlQuery fields must contain ONLY a single SELECT statement. NEVER put INSTALL, LOAD, CREATE, or other DDL/meta-commands in dataset SQL \u2014 they will fail because dataset SQL is wrapped in a subquery at runtime. Extensions like h3 and spatial are pre-loaded at startup.\n  - GeoJSON files typically contain polygon or multipolygon features (boundaries, buildings, parcels); use GeoArrowPolygonLayer for these. If a GeoJSON file contains point features, use GeoArrowScatterplotLayer (Point layer) instead.\n- RADIUS AND WIDTH: For GeoArrowScatterplotLayer (Point layer) use getRadius with radiusUnits: \"pixels\" (typically 2\u20136 pixels); large radii cause overdraw and rendering lag, especially with many points. For GeoArrowColumnLayer use the \"radius\" property (NOT getRadius) \u2014 it sets column radius in meters; typical values are 20\u2013200 for city-scale data or smaller for dense datasets. Do NOT use getRadius or radiusUnits on column layers. For GeoArrowArcLayer, GeoArrowPathLayer, and GeoArrowTripsLayer use getWidth with widthUnits: \"pixels\" (typically 1\u20133 pixels).\n- HEATMAP: For GeoArrowHeatmapLayer, do NOT set colorRange manually. The UI provides a scheme selector that generates the correct color array. If you set colorRange to hand-picked RGB arrays, it will be out of sync with the scheme selector shown in the UI. Just omit colorRange entirely and let the default apply \u2014 users can change the scheme through the map settings panel.\n- ARC vs LINE: GeoArrowArcLayer renders curved 3D arcs by default. If the user asks for \"lines\" or \"straight connections\" between origin-destination pairs (not arcs), set \"getHeight\": 0 on the layer to render flat straight lines. Use arcs for flight routes or connections where the curve adds clarity; use flat lines for direct relationships, edges, or when the user explicitly requests lines.\n- ELEVATION: For extruded layers, getElevation with @@function \"scale\" passes the raw field value as meters. Use elevationScale on the layer to multiply values to a useful visual height. For example, if the field is \"floors\" (1-10), set elevationScale to 3 (meters per floor). Do NOT use negative values for elevation. Avoid using diverging scales for elevation. IMPORTANT: Keep elevation moderate \u2014 if extruded polygons or H3 hexagons are too tall, users can't see the tops when zoomed in. Prefer elevationScale values that produce heights of a few hundred meters at most for city-scale data. A good rule of thumb: the maximum elevation (field max \u00D7 elevationScale) should not exceed ~500m for typical zoom levels.\n- Bind layers to datasets with _sqlroomsBinding.dataset and put tableName, tableName+transformSql, or sqlQuery sources in config.datasets.\n- Use source.tableName for direct table-backed datasets. Use source.tableName plus source.transformSql when the map needs generated geometry or aggregation but should still follow the dashboard selected table. transformSql must read from __sqlrooms_source, not from the authored table name.\n- Use source.sqlQuery only for a standalone literal query that should remain pinned to the authored SQL. Dashboard selected table replacement applies only to structured tableName sources, not literal sqlQuery sources.\n- IMPORTANT: Always pass tableName in the create_dashboard_map tool params (the top-level tableName field). Use the table currently selected in the dashboard (dashboard.selectedTable from list_dashboard_panels). At runtime, the dashboard's selected table overrides structured source.tableName values \u2014 this param seeds or changes that selection.\n- IMPORTANT: If you are creating a structured table-backed map layer for a table that is NOT the currently selected dashboard table, you MUST switch the dashboard's selected table to that dataset BEFORE or WHEN calling create_dashboard_map (pass the correct tableName). Structured table-backed map panels resolve data from the dashboard's active table \u2014 if you don't switch it, the layer will query the wrong table and fail.\n- IMPORTANT: When referencing tables in tableName or sqlQuery, use ONLY the bare table name (e.g. \"my_table\") or schema-qualified name (e.g. \"main.my_table\"). NEVER include the database/catalog prefix (e.g. do NOT use \"sqlrooms-cli.main.my_table\") \u2014 the catalog does not exist in the query execution context.\n- IMPORTANT: For point data with longitude/latitude columns that should follow dashboard table switching, use source.tableName plus source.transformSql to create a geometry column, for example: \"SELECT *, ST_AsWKB(ST_Point(\\\"Longitude\\\", \\\"Latitude\\\")) AS \\\"__sqlrooms_geom\\\" FROM __sqlrooms_source WHERE \\\"Longitude\\\" IS NOT NULL AND \\\"Latitude\\\" IS NOT NULL\". Set geometryColumn to the same name used in the AS clause (e.g. \"__sqlrooms_geom\") and geometryEncodingHint to \"wkb\".\n- IMPORTANT: When providing fitToData, it MUST be a flat object (NOT nested by dataset ID). Include either longitudeColumn+latitudeColumn (for point data with separate coordinate columns) OR geometryColumn (for data with a WKB geometry column like GeoJSON). For H3 hexagon layers, just specify the dataset: \"fitToData\": {\"dataset\": \"datasetId\"} \u2014 the H3 column is auto-detected from the layer binding. For GeoJSON/spatial files with a \"geom\" column, use: \"fitToData\": {\"dataset\": \"datasetId\", \"geometryColumn\": \"geom\"}. For point data use: \"fitToData\": {\"dataset\": \"datasetId\", \"longitudeColumn\": \"lon\", \"latitudeColumn\": \"lat\"}. NEVER nest fitToData as {\"datasetId\": {...}} \u2014 always use a flat object with \"dataset\" as a string field.\n- IMPORTANT: For GeoJSON or spatial files that already have a native geometry column (e.g. \"geometry\", \"geom\"), use the table directly with source.tableName (no sqlQuery needed), set the dataset's geometryColumn to \"geom\", set geometryEncodingHint to \"wkb\", and use fitToData with geometryColumn: {\"dataset\": \"datasetId\", \"geometryColumn\": \"geom\"}.\n- IMPORTANT: When a GeoJSON file (.geojson) is loaded as a table, DuckDB uses ST_Read to produce a table with a WKB \"geom\" column and all feature properties as columns. Use source.tableName, set geometryColumn to \"geom\" and geometryEncodingHint to \"wkb\". Use \"fitToData\": {\"dataset\": \"datasetId\", \"geometryColumn\": \"geom\"} to zoom to the data extent.\n- For data-driven color, use native Deck JSON accessors with {\"@@function\":\"colorScale\", \"field\":\"...\", \"type\":\"sequential\"|\"diverging\"|\"quantize\"|\"quantile\"|\"categorical\", \"scheme\":\"...\", \"domain\":\"auto\"} on color properties such as getFillColor, getLineColor, getColor, getSourceColor, or getTargetColor. Valid schemes: for \"categorical\" type use one of Accent, Dark2, Paired, Pastel1, Pastel2, Set1, Set2, Set3, Tableau10, Observable10, Category10. For \"sequential\" use Viridis, Inferno, Magma, Plasma, Turbo, Blues, Greens, Oranges, Reds, Purples, etc. For \"diverging\" use RdBu, Spectral, RdYlGn, BrBG, PiYG, etc. IMPORTANT: The colorScale \"field\" must reference a column that exists in the FINAL query output (after any GROUP BY aggregation). Do not reference columns that are lost during aggregation.\n- IMPORTANT: Enabling a color scale means adding a {\"@@function\":\"colorScale\", ...} accessor to a compatible layer color property. The top-level showLegends field only controls whether already-defined color scale legends are visible; showLegends by itself does NOT create or enable data-driven color.\n- Map panels default to a 100000-row runtime data limit; use config.dataPolicy.maxRows only when the map genuinely needs a panel-specific limit.\n- Create maps with a SINGLE layer unless the user explicitly asks for multiple layers. If you think multiple layers would better serve the user's request, ask the user for confirmation before adding them.\n- IMPORTANT: Browsers limit the number of active WebGL contexts (typically 8\u201316 per page). Each map panel uses one context. Do NOT create more than 4\u20135 map panels in a single dashboard \u2014 exceeding the limit causes older maps to lose their rendering context and show errors. If the user asks for many datasets, prefer combining compatible layers into fewer maps rather than creating one map per dataset.\n- After calling create_dashboard_map, call list_dashboard_panels before your final response and check the map panel issue. If it has a render-error, repair the map config in place instead of saying the map is complete.\n- BASEMAPS: Omit mapStyle unless the user explicitly requests a custom basemap. Maps inherit the host application's theme-aware basemap when available, with a token-free fallback. Do NOT use Mapbox styles (mapbox://styles/...) because a Mapbox access token may not be available. For an explicitly requested custom basemap, use a token-free MapLibre-compatible style URL.\n";
+/**
+ * Returns AI instructions for dashboards with Deck.gl map support.
+ * Provides guidance on when and how to use map visualizations.
+ *
+ * @returns Instructions string for AI agents
+ */
+export declare function getDashboardWithDeckMapAiInstructions(): string;
+/**
+ * Creates dashboard AI tools with built-in Deck.gl map support.
+ * Extends standard dashboard tools with map visualization capabilities.
+ *
+ * @param options - Dashboard AI tools configuration options
+ * @returns Record mapping tool names to tool instances, including map tools
+ */
+export declare function createDashboardWithDeckMapAiTools(options: CreateDashboardAiToolsOptions): Record<string, Tool>;
+/**
+ * Creates a dashboard agent tool with built-in Deck.gl map support.
+ * Extends the standard dashboard agent with map creation capabilities.
+ *
+ * @template TState - Store state type extending MosaicDashboardStoreState
+ * @param options - Dashboard agent configuration options
+ * @returns Dashboard agent tool with map support
+ */
+export declare function createDashboardAgentToolWithDeckMaps<TState extends MosaicDashboardStoreState>(options: CreateDashboardAgentToolOptions<TState>): Tool;
+export declare const DeckMapDashboardConfigParameter: z.ZodObject<{
+    spec: z.ZodObject<{
+        initialViewState: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        viewState: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        controller: z.ZodOptional<z.ZodUnknown>;
+        layers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            '@@type': z.ZodOptional<z.ZodString>;
+            id: z.ZodOptional<z.ZodString>;
+            _sqlroomsBinding: z.ZodOptional<z.ZodObject<{
+                dataset: z.ZodOptional<z.ZodString>;
+                geometryColumn: z.ZodOptional<z.ZodString>;
+                geometryEncodingHint: z.ZodOptional<z.ZodEnum<{
+                    geoarrow: "geoarrow";
+                    wkb: "wkb";
+                    wkt: "wkt";
+                }>>;
+                sourceGeometryColumn: z.ZodOptional<z.ZodString>;
+                targetGeometryColumn: z.ZodOptional<z.ZodString>;
+                timestampColumn: z.ZodOptional<z.ZodString>;
+                hexagonColumn: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>;
+    datasets: z.ZodRecord<z.ZodString, z.ZodObject<{
+        source: z.ZodOptional<z.ZodObject<{
+            tableName: z.ZodOptional<z.ZodString>;
+            transformSql: z.ZodOptional<z.ZodString>;
+            sqlQuery: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        geometryColumn: z.ZodOptional<z.ZodString>;
+        geometryEncodingHint: z.ZodOptional<z.ZodEnum<{
+            geoarrow: "geoarrow";
+            wkb: "wkb";
+            wkt: "wkt";
+        }>>;
+    }, z.core.$loose>>;
+    configMode: z.ZodOptional<z.ZodEnum<{
+        custom: "custom";
+        basic: "basic";
+    }>>;
+    mapStyle: z.ZodOptional<z.ZodString>;
+    mapProps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    showLegends: z.ZodOptional<z.ZodBoolean>;
+    interaction: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    fitToData: z.ZodOptional<z.ZodObject<{
+        dataset: z.ZodString;
+        longitudeColumn: z.ZodOptional<z.ZodString>;
+        latitudeColumn: z.ZodOptional<z.ZodString>;
+        geometryColumn: z.ZodOptional<z.ZodString>;
+        h3Column: z.ZodOptional<z.ZodString>;
+        padding: z.ZodOptional<z.ZodNumber>;
+        maxZoom: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    dataPolicy: z.ZodOptional<z.ZodObject<{
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        maxRows: z.ZodOptional<z.ZodNumber>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    settingsOpen: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>;
+export type DeckMapDashboardConfigToolConfig = z.infer<typeof DeckMapDashboardConfigParameter>;
+export declare const DeckMapConfigToolParameters: z.ZodObject<{
+    title: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    config: z.ZodObject<{
+        spec: z.ZodObject<{
+            initialViewState: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            viewState: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            controller: z.ZodOptional<z.ZodUnknown>;
+            layers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                '@@type': z.ZodOptional<z.ZodString>;
+                id: z.ZodOptional<z.ZodString>;
+                _sqlroomsBinding: z.ZodOptional<z.ZodObject<{
+                    dataset: z.ZodOptional<z.ZodString>;
+                    geometryColumn: z.ZodOptional<z.ZodString>;
+                    geometryEncodingHint: z.ZodOptional<z.ZodEnum<{
+                        geoarrow: "geoarrow";
+                        wkb: "wkb";
+                        wkt: "wkt";
+                    }>>;
+                    sourceGeometryColumn: z.ZodOptional<z.ZodString>;
+                    targetGeometryColumn: z.ZodOptional<z.ZodString>;
+                    timestampColumn: z.ZodOptional<z.ZodString>;
+                    hexagonColumn: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>;
+        datasets: z.ZodRecord<z.ZodString, z.ZodObject<{
+            source: z.ZodOptional<z.ZodObject<{
+                tableName: z.ZodOptional<z.ZodString>;
+                transformSql: z.ZodOptional<z.ZodString>;
+                sqlQuery: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            geometryColumn: z.ZodOptional<z.ZodString>;
+            geometryEncodingHint: z.ZodOptional<z.ZodEnum<{
+                geoarrow: "geoarrow";
+                wkb: "wkb";
+                wkt: "wkt";
+            }>>;
+        }, z.core.$loose>>;
+        configMode: z.ZodOptional<z.ZodEnum<{
+            custom: "custom";
+            basic: "basic";
+        }>>;
+        mapStyle: z.ZodOptional<z.ZodString>;
+        mapProps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        showLegends: z.ZodOptional<z.ZodBoolean>;
+        interaction: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        fitToData: z.ZodOptional<z.ZodObject<{
+            dataset: z.ZodString;
+            longitudeColumn: z.ZodOptional<z.ZodString>;
+            latitudeColumn: z.ZodOptional<z.ZodString>;
+            geometryColumn: z.ZodOptional<z.ZodString>;
+            h3Column: z.ZodOptional<z.ZodString>;
+            padding: z.ZodOptional<z.ZodNumber>;
+            maxZoom: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        dataPolicy: z.ZodOptional<z.ZodObject<{
+            disabled: z.ZodOptional<z.ZodBoolean>;
+            maxRows: z.ZodOptional<z.ZodNumber>;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        settingsOpen: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>;
+    reasoning: z.ZodString;
+}, z.core.$strip>;
+export type DeckMapConfigToolParams = z.infer<typeof DeckMapConfigToolParameters>;
+export declare const DeckMapDashboardToolParameters: z.ZodObject<{
+    title: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    config: z.ZodObject<{
+        spec: z.ZodObject<{
+            initialViewState: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            viewState: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            controller: z.ZodOptional<z.ZodUnknown>;
+            layers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                '@@type': z.ZodOptional<z.ZodString>;
+                id: z.ZodOptional<z.ZodString>;
+                _sqlroomsBinding: z.ZodOptional<z.ZodObject<{
+                    dataset: z.ZodOptional<z.ZodString>;
+                    geometryColumn: z.ZodOptional<z.ZodString>;
+                    geometryEncodingHint: z.ZodOptional<z.ZodEnum<{
+                        geoarrow: "geoarrow";
+                        wkb: "wkb";
+                        wkt: "wkt";
+                    }>>;
+                    sourceGeometryColumn: z.ZodOptional<z.ZodString>;
+                    targetGeometryColumn: z.ZodOptional<z.ZodString>;
+                    timestampColumn: z.ZodOptional<z.ZodString>;
+                    hexagonColumn: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>;
+        datasets: z.ZodRecord<z.ZodString, z.ZodObject<{
+            source: z.ZodOptional<z.ZodObject<{
+                tableName: z.ZodOptional<z.ZodString>;
+                transformSql: z.ZodOptional<z.ZodString>;
+                sqlQuery: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            geometryColumn: z.ZodOptional<z.ZodString>;
+            geometryEncodingHint: z.ZodOptional<z.ZodEnum<{
+                geoarrow: "geoarrow";
+                wkb: "wkb";
+                wkt: "wkt";
+            }>>;
+        }, z.core.$loose>>;
+        configMode: z.ZodOptional<z.ZodEnum<{
+            custom: "custom";
+            basic: "basic";
+        }>>;
+        mapStyle: z.ZodOptional<z.ZodString>;
+        mapProps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        showLegends: z.ZodOptional<z.ZodBoolean>;
+        interaction: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        fitToData: z.ZodOptional<z.ZodObject<{
+            dataset: z.ZodString;
+            longitudeColumn: z.ZodOptional<z.ZodString>;
+            latitudeColumn: z.ZodOptional<z.ZodString>;
+            geometryColumn: z.ZodOptional<z.ZodString>;
+            h3Column: z.ZodOptional<z.ZodString>;
+            padding: z.ZodOptional<z.ZodNumber>;
+            maxZoom: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        dataPolicy: z.ZodOptional<z.ZodObject<{
+            disabled: z.ZodOptional<z.ZodBoolean>;
+            maxRows: z.ZodOptional<z.ZodNumber>;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        settingsOpen: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>;
+    tableName: z.ZodOptional<z.ZodString>;
+    panelId: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodString;
+}, z.core.$strip>;
+export type DeckMapDashboardToolParams = z.infer<typeof DeckMapDashboardToolParameters>;
+/**
+ * Creates a dashboard-compatible Deck map panel from the native map config
+ * used by AI tools and embeddable map surfaces.
+ */
+export declare function createDeckMapPanelFromNativeConfig(params: Pick<DeckMapConfigToolParams, 'title' | 'config'>): {
+    id: string;
+    type: string;
+    title: string;
+    config: Record<string, unknown>;
+};
+export declare function createDeckMapConfigTool(): Tool;
+/**
+ * Creates AI tools for Deck.gl map configuration.
+ * Returns tools for creating and configuring Deck.gl map panels.
+ *
+ * @returns Record mapping tool names to map configuration tools
+ */
+export declare function createDeckMapAiTools(): Record<string, Tool>;
+/**
+ * Parameters for creating a Deck.gl map dashboard tool.
+ * Provides adapters for dashboard and database operations.
+ */
+export type CreateDeckMapDashboardToolParams = {
+    /** Dashboard adapter for adding and updating map panels */
+    dashboardAdapter: DashboardAiAdapter;
+    /** Database adapter for table validation */
+    databaseAdapter: DatabaseAiAdapter;
+};
+/**
+ * Creates a tool for adding Deck.gl map panels to dashboards.
+ * Supports creating new map panels or updating existing ones with native Deck JSON configs.
+ *
+ * @param params - Parameters containing dashboard and database adapters
+ * @returns Tool instance for creating/updating Deck.gl map panels
+ */
+export declare function createDeckMapDashboardTool({ dashboardAdapter, databaseAdapter, }: CreateDeckMapDashboardToolParams): Tool;
+export declare function createDeckMapDashboardAiTools(params: CreateDeckMapDashboardToolParams): Record<string, Tool>;
+//# sourceMappingURL=ai.d.ts.map

package/dist/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,IAAI,EAAC,MAAM,IAAI,CAAC;AACnC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,EACL,kBAAkB,EAIlB,KAAK,+BAA+B,EACpC,KAAK,6BAA6B,EAGlC,iBAAiB,EAGjB,yBAAyB,EAC1B,MAAM,kBAAkB,CAAC;AAO1B,OAAO,EACL,8BAA8B,EAC9B,uBAAuB,EACxB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAC,8BAA8B,EAAE,uBAAuB,EAAC,CAAC;AAEjE,eAAO,MAAM,wBAAwB,4vfA0CpC,CAAC;AAWF;;;;;GAKG;AACH,wBAAgB,qCAAqC,WAEpD;AAED;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,6BAA6B,GACrC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAKtB;AAED;;;;;;;GAOG;AACH,wBAAgB,oCAAoC,CAClD,MAAM,SAAS,yBAAyB,EACxC,OAAO,EAAE,+BAA+B,CAAC,MAAM,CAAC,GAAG,IAAI,CAWxD;AA2CD,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsD1C,CAAC;AAEH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CACpD,OAAO,+BAA+B,CACvC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQtC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,2BAA2B,CACnC,CAAC;AAEF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBvC,CAAC;AAEL,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,8BAA8B,CACtC,CAAC;AAiGF;;;GAGG;AACH,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,IAAI,CAAC,uBAAuB,EAAE,OAAO,GAAG,QAAQ,CAAC;;;;;EAM1D;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAgC9C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAI3D;AAED;;;GAGG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C,2DAA2D;IAC3D,gBAAgB,EAAE,kBAAkB,CAAC;IACrC,4CAA4C;IAC5C,eAAe,EAAE,iBAAiB,CAAC;CACpC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,gBAAgB,EAChB,eAAe,GAChB,EAAE,gCAAgC,GAAG,IAAI,CAqEzC;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,gCAAgC,GACvC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAItB"}