@tomtom-org/maps-sdk-plugin-agent-toolkit 0.7.0 → 0.9.0

package/README.md

@@ -79,7 +79,7 @@ function ChatPanel() {
 }
 ```
 
-See [`examples/map-chat-agent-react`](../../examples/map-chat-agent-react) for a full working example.
+See [`examples/map-traffic-agent-react`](../../examples/map-traffic-agent-react) for a full working example.
 
 ## Tools reference
 
@@ -105,7 +105,7 @@ The plugin ships a `DEFAULT_TOOLS` registry covering search, routing, traffic, r
 | `removeWaypointsFromRoute` | Remove one or more waypoints by index from the current route |
 | `replaceWaypointInRoute` | Overwrite a single waypoint of the current route in place — origin, destination, or by index |
 | `getCurrentWaypoints` | Get the staged waypoint slots (origin, stops, destination) |
-| `findReachableAreas` | Calculate isochrone/isodistance polygons from one or more origins |
+| `findReachableAreas` | Calculate isochrone/isodistance polygons from one or more origins (private preview: the API key needs Calculate Reachable Range access) |
 
 ### Traffic
 
@@ -119,8 +119,7 @@ The plugin ships a `DEFAULT_TOOLS` registry covering search, routing, traffic, r
 | `queryTrafficAnalytics` | Query cached analytics data or check what is currently displayed |
 | `toggleTilesTrafficFlow` | Toggle the real-time traffic-flow tile overlay |
 | `toggleTilesTrafficIncidents` | Toggle the real-time traffic-incidents tile overlay |
-| `describeMapStyling` | List the semantic base-map styling knobs (sizes, toggles, POI and traffic colours) with ranges and current values |
-| `setMapStyling` | Set or reset base-map styling knobs — label/icon/road sizes, exit numbers, shields, 3D buildings, congestion colours… |
+| `setMapStyling` | Set or reset base-map styling knobs — label/icon/road sizes, exit numbers, shields, 3D buildings, congestion colours, map colours, presets, or a whole theme from a few colours or an image |
 | `getShownTileIncidents` | List real-time incidents visible in the current viewport |
 
 ### Bring-your-own-data (BYOD)
@@ -556,4 +555,4 @@ For the complete, always-current list of exports — factories, tool-registry he
     - [Bring your own data](https://docs.tomtom.com/maps-sdk-js/guides/plugins/agent-toolkit/byod) — ingest customer GeoJSON layers
 - [AI SDK v6 documentation](https://ai-sdk.dev/)
 - [TomTom Maps SDK documentation](https://docs.tomtom.com/maps-sdk-js)
-- [Example application](../../examples/map-chat-agent-react) — full chat interface implementation
+- [Example application](../../examples/map-traffic-agent-react) — full chat interface implementation

package/THIRD_PARTY.txt

@@ -49,7 +49,7 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ---
 
 Name: ai
-Version: 6.0.266
+Version: 6.0.291
 License: Apache-2.0
 Bundled: false (peer dependency)
 Description: AI SDK by Vercel - build apps like ChatGPT, Claude, Gemini, and more with a single interface for any model using the Vercel AI Gateway or go direct to OpenAI, Anthropic, Google, or any other model provider.
@@ -334,7 +334,7 @@ limitations under the License.
 ---
 
 Name: maplibre-gl
-Version: 6.9.0
+Version: 6.11.2
 License: BSD-3-Clause
 Bundled: false (peer dependency)
 Description: BSD licensed community fork of mapbox-gl, a WebGL interactive maps library
@@ -464,7 +464,7 @@ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 ---
 
 Name: zod
-Version: 4.4.3
+Version: 4.6.5
 License: MIT
 Bundled: false (peer dependency)
 Description: TypeScript-first schema declaration and validation library with static type inference

package/dist/THIRD_PARTY.txt

@@ -39,7 +39,7 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ---
 
 Name: ai
-Version: 6.0.266
+Version: 6.0.291
 License: Apache-2.0
 Bundled: false (peer dependency)
 Description: AI SDK by Vercel - build apps like ChatGPT, Claude, Gemini, and more with a single interface for any model using the Vercel AI Gateway or go direct to OpenAI, Anthropic, Google, or any other model provider.
@@ -324,7 +324,7 @@ limitations under the License.
 ---
 
 Name: maplibre-gl
-Version: 6.9.0
+Version: 6.11.2
 License: BSD-3-Clause
 Bundled: false (peer dependency)
 Description: BSD licensed community fork of mapbox-gl, a WebGL interactive maps library
@@ -454,7 +454,7 @@ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 ---
 
 Name: zod
-Version: 4.4.3
+Version: 4.6.5
 License: MIT
 Bundled: false (peer dependency)
 Description: TypeScript-first schema declaration and validation library with static type inference

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { BaseMapModule, CustomGeoJSONLayerSpec, CustomGeoJSONModule, GeometriesModule, GeometryTheme, POIsModule, PlaceConnectionDisplay, PlacesModule, PlanningWaypoint, RoutingModule, StylingModule, TomTomMap, TrafficAreaAnalyticsConfig, TrafficAreaAnalyticsModule, TrafficFlowModule, TrafficIncidentOverlayModule, TrafficIncidentsModule } from "@tomtom-org/maps-sdk/map";
+import { BaseMapModule, CustomGeoJSONLayerSpec, CustomGeoJSONModule, GeometriesModule, GeometryFillStyle, POIsModule, PlaceConnectionDisplay, PlacesModule, PlanningWaypoint, RoutingModule, StylingModule, TomTomMap, TrafficAreaAnalyticsModule, TrafficAreaAnalyticsModuleConfig, TrafficFlowModule, TrafficIncidentOverlayModule, TrafficIncidentsModule } from "@tomtom-org/maps-sdk/map";
 import { BBox, CommonPlaceProps, GeographyType, POICategory, Place, Places, PolygonFeature, PolygonFeatures, Route, Routes, TrafficAreaAnalytics, TrafficIncident, WaypointLike } from "@tomtom-org/maps-sdk/core";
 import { ChartConfiguration } from "chart.js";
 import { Map as Map$1 } from "maplibre-gl";
@@ -734,9 +734,6 @@ export declare const AGENT_TOOLKIT_USER_AGENT: string;
  * `tomtom-user-agent` override (see `generateTomTomHeaders`, `core/src/util/headers.ts`) — reuses
  * an existing, already-allow-listed header rather than adding a new one.
  *
- * Not applicable to `searchOne`/`geocodeOne` (and the `searchOneFn`/`geocodeOneFn` dispatch in
- * `locate-places.ts`) — those take a bare query string with no params object to tag.
- *
  * @ignore
  */
 export declare const withAgentToolkitHeaders: <P extends object>(params: P) => P;
@@ -1214,9 +1211,9 @@ declare class PlacesState implements StateSlice {
   getEntryPlacesModule(entryId: string, markerType: PlacesMarkerType): Promise<PlacesModule>;
   /**
    * Lazy-init and return the entry's place-geometries module (for POI footprints, municipality
-   * outlines). Re-applies themed config when the theme changes. Throws on unknown entry id.
+   * outlines). Re-applies the config when the fill style changes. Throws on unknown entry id.
    */
-  getEntryGeometriesModule(entryId: string, theme?: GeometryTheme): Promise<GeometriesModule>;
+  getEntryGeometriesModule(entryId: string, fillStyle?: GeometryFillStyle): Promise<GeometriesModule>;
   private _requireEntry;
   get entries(): readonly PlacesEntry[];
   /**
@@ -1262,7 +1259,7 @@ declare class PlacesState implements StateSlice {
    * `entryId` defaults to the latest entry that owns geometries — handy when callers only ever
    * render the most-recently produced footprints. Pass an explicit id to target an older one.
    */
-  showPlaceGeometries(features: PolygonFeature<CommonPlaceProps>[], theme?: GeometryTheme, mode?: 'add' | 'replace', entryId?: string): Promise<void>;
+  showPlaceGeometries(features: PolygonFeature<CommonPlaceProps>[], fillStyle?: GeometryFillStyle, mode?: 'add' | 'replace', entryId?: string): Promise<void>;
   private _latestGeometriesEntryId;
   private _buildGeometryIndex;
   /** IDs of all entries currently shown on the map. */
@@ -1389,8 +1386,8 @@ type RangesEntry = BaseEntry<ReachableRange[]> & {
     geometries?: GeometriesModule;
     places?: PlacesModule;
   };
-  /** Theme that the geometries module is currently configured with. */
-  _shownTheme?: 'filled' | 'outline' | 'inverted';
+  /** Fill style that the geometries module is currently configured with. */
+  _shownFillStyle?: GeometryFillStyle;
   /** True while any of this entry's modules are rendering on the map. */
   _shown?: boolean;
 };
@@ -1448,9 +1445,9 @@ declare class RangeState implements ShownEntriesSlice {
   setEntryMode(mode: EntryMode): Promise<void>;
   /**
    * Lazy-init the entry's GeometriesModule (for the isochrone/isodistance polygons),
-   * applying the requested theme. Throws on unknown id.
+   * applying the requested fill style. Throws on unknown id.
    */
-  getEntryGeometriesModule(entryId: string, theme?: GeometryTheme): Promise<GeometriesModule>;
+  getEntryGeometriesModule(entryId: string, fillStyle?: GeometryFillStyle): Promise<GeometriesModule>;
   /**
    * Lazy-init the entry's origin-pin PlacesModule. Each entry maintains its own pin module
    * so multiple ranges entries can be on the map simultaneously without the pins of one
@@ -1991,7 +1988,7 @@ type TrafficAreaAnalyticsEntry = BaseEntry<TrafficAreaAnalytics> & {
    */
   _module?: TrafficAreaAnalyticsModule;
   /** Latest viz config reflected from the module (mode / metric / scaleMode / …). */
-  _config?: TrafficAreaAnalyticsConfig;
+  _config?: TrafficAreaAnalyticsModuleConfig;
   /** Unsubscribe from this entry's module config-change wiring. Cleared on hide / remove. */
   _configChangeUnsub?: () => void;
   /** True while `_module` is rendering on the map. */
@@ -2020,7 +2017,7 @@ type TrafficAreaAnalyticsStateEvents = {
   /** Per-entry viz config changed (mode / metric / scaleMode / …). */
   'config-change': {
     entryId: string;
-    config: TrafficAreaAnalyticsConfig | undefined;
+    config: TrafficAreaAnalyticsModuleConfig | undefined;
   };
   /** Display policy switched between `single` and `multiple`. */
   'mode-change': EntryMode;
@@ -2977,6 +2974,16 @@ export declare const showModeSchema: z.ZodOptional<z.ZodEnum<{
   add: "add";
   replace: "replace";
 }>>;
+/**
+ * How rendered polygons are filled — the SDK's `GeometryFillStyle`.
+ *
+ * @ignore
+ */
+export declare const geometryFillStyleSchema: z.ZodEnum<{
+  filled: "filled";
+  outline: "outline";
+  inverted: "inverted";
+}>;
 /**
  * Shared schema for the geometry-rendering option on tools that produce a places entry
  * (discoverPlaces, locatePlace, ...). When provided, the tool batch-fetches boundary
@@ -2990,7 +2997,7 @@ export declare const showPlaceGeometriesSchema: z.ZodOptional<z.ZodObject<{
     add: "add";
     replace: "replace";
   }>>;
-  theme: z.ZodOptional<z.ZodEnum<{
+  fillStyle: z.ZodOptional<z.ZodEnum<{
     filled: "filled";
     outline: "outline";
     inverted: "inverted";
@@ -3005,7 +3012,7 @@ export declare const showPlaceGeometriesSchema: z.ZodOptional<z.ZodObject<{
  * @ignore
  */
 export declare const geometryDisplayConfigSchema: z.ZodObject<{
-  theme: z.ZodOptional<z.ZodEnum<{
+  fillStyle: z.ZodOptional<z.ZodEnum<{
     filled: "filled";
     outline: "outline";
     inverted: "inverted";
@@ -3359,12 +3366,12 @@ type CustomGeometriesEntry = BaseEntry<PolygonFeature[]> & {
   provenance: GeometryProvenance;
   /**
    * Per-entry GeometriesModule. Each entry owns its own module so display state
-   * (theme, current features) lives on the entry instead of a shared slice-level
+   * (fill style, current features) lives on the entry instead of a shared slice-level
    * module. Lazy-initialised via CustomGeometriesState helpers.
    */
   _module?: GeometriesModule;
-  /** Theme that the geometries module is currently configured with. */
-  _shownTheme?: 'filled' | 'outline' | 'inverted';
+  /** Fill style that the geometries module is currently configured with. */
+  _shownFillStyle?: GeometryFillStyle;
   /** True while this entry's `_module` is rendering on the map. */
   _shown?: boolean;
 };
@@ -3425,8 +3432,8 @@ declare class CustomGeometriesState implements ShownEntriesSlice, StateSlice {
    * Returns the assigned id. Under `single` mode the new entry replaces every older one.
    */
   addEntry(features: PolygonFeature<CommonPlaceProps>[], provenance: CustomGeometriesEntry['provenance'], label: string, explicitId?: string): Promise<string>;
-  /** Lazy-init the entry's GeometriesModule, applying / re-applying the requested theme. */
-  getEntryGeometriesModule(entryId: string, theme?: GeometryTheme): Promise<GeometriesModule>;
+  /** Lazy-init the entry's GeometriesModule, applying / re-applying the requested fill style. */
+  getEntryGeometriesModule(entryId: string, fillStyle?: GeometryFillStyle): Promise<GeometriesModule>;
   /**
    * Render this entry's polygons. `mode` is scoped to this entry's own layer:
    * - `'replace'` (default) — show exactly `entry.data`, clearing whatever the
@@ -3438,7 +3445,7 @@ declare class CustomGeometriesState implements ShownEntriesSlice, StateSlice {
    * shown entries are hidden first; otherwise the caller uses `hideEntry` / the
    * tools' `hidePreviousEntries` option.
    */
-  showEntry(entryId: string, theme?: GeometryTheme, mode?: 'add' | 'replace'): Promise<void>;
+  showEntry(entryId: string, fillStyle?: GeometryFillStyle, mode?: 'add' | 'replace'): Promise<void>;
   private _hideOthersUnderSingleMode;
   hideEntry(entryId: string): Promise<void>;
   /** Drop a single entry from history (clears its module first). No-op when unknown. */
@@ -3915,7 +3922,6 @@ export declare const DEFAULT_TOOLS: {
   setMapStandardStyle: ToolDefinition;
   setLanguage: ToolDefinition;
   toggleTilesPOIs: ToolDefinition;
-  describeMapStyling: ToolDefinition;
   setMapStyling: ToolDefinition;
   toggleTilesTrafficFlow: ToolDefinition;
   toggleTilesTrafficIncidents: ToolDefinition;