@tomtom-org/maps-sdk-plugin-agent-toolkit 0.11.0 → 0.13.0

package/README.md

@@ -120,7 +120,7 @@ The plugin ships a `DEFAULT_TOOLS` registry covering search, routing, traffic, r
 | `getTrafficAreaAnalytics` | Fetch historical traffic analytics (speed, congestion, travel time) for an area |
 | `toggleTilesTrafficFlow` | Toggle the real-time traffic-flow tile overlay |
 | `toggleTilesTrafficIncidents` | Toggle the real-time traffic-incidents tile overlay |
-| `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 |
+| `setMapStyling` | Set or reset how the map looks — label/icon/road sizes, exit numbers and road arrows, POI and hillshade looks, congestion colours, map colours, map presets, or a whole theme from a few colours or an image |
 
 ### Trackers
 

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.291
+Version: 6.0.300
 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.

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.291
+Version: 6.0.300
 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.

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { BaseMapModule, CustomGeoJSONLayerSpec, CustomGeoJSONModule, GeometriesModule, GeometryFillStyle, POIsModule, PlaceConnectionDisplay, PlacesModule, PlanningWaypoint, ReachableRangesModule, RoutingModule, StylingModule, TomTomMap, TrafficAreaAnalyticsModule, TrafficAreaAnalyticsModuleConfig, TrafficFlowModule, TrafficIncidentDetailsModule, TrafficIncidentsModule } from "@tomtom-org/maps-sdk/map";
+import { BaseMapModule, CustomGeoJSONLayerSpec, CustomGeoJSONModule, GeometriesModule, GeometryFillStyle, POIsModule, PlaceConnectionDisplay, PlacesModule, PlanningWaypoint, ReachableRangesModule, RoutingModule, StylingFoundationsModule, TerrainModule, TomTomMap, TrafficAreaAnalyticsModule, TrafficAreaAnalyticsModuleConfig, TrafficFlowModule, TrafficIncidentDetailsModule, TrafficIncidentsModule } from "@tomtom-org/maps-sdk/map";
 import { BBox, CommonPlaceProps, GeographyType, Place, Places, PolygonFeature, PolygonFeatures, ReachableRangeBudget, Route, Routes, TrafficAreaAnalytics, TrafficIncident, WaypointLike } from "@tomtom-org/maps-sdk/core";
 import { ChartConfiguration } from "chart.js";
 import { Map as Map$1 } from "maplibre-gl";
@@ -701,18 +701,21 @@ type BYODEntry = BaseEntry<FeatureCollection$1> & {
  * State for base map display: style, language, viewport and layers.
  *
  * Provides direct access to the TomTomMap and MapLibre instances alongside
- * lazy-initialized BaseMapModule and StylingModule.
+ * lazy-initialized BaseMapModule, StylingFoundationsModule and TerrainModule.
  *
  * @group Agent Toolkit
  */
 declare class BaseMapState implements StateSlice {
   readonly ttMap: TomTomMap;
   private _baseMapModule?;
-  private _stylingModule?;
+  private _stylingFoundationsModule?;
+  private _terrainModule?;
   constructor(ttMap: TomTomMap);
   get mapLibreMap(): Map$1;
   getBaseMapModule(): Promise<BaseMapModule>;
-  getStylingModule(): Promise<StylingModule>;
+  getStylingFoundationsModule(): Promise<StylingFoundationsModule>;
+  getTerrainModule(): Promise<TerrainModule>;
+  get terrainModule(): TerrainModule | undefined;
   reset(): void;
 }
 //#endregion
@@ -3959,6 +3962,7 @@ export declare const DEFAULT_TOOLS: {
   setMapStandardStyle: ToolDefinition;
   setLanguage: ToolDefinition;
   toggleTilesPOIs: ToolDefinition;
+  toggleTilesBaseMapLayerGroups: ToolDefinition;
   setMapStyling: ToolDefinition;
   toggleTilesTrafficFlow: ToolDefinition;
   toggleTilesTrafficIncidents: ToolDefinition;
@@ -4144,7 +4148,7 @@ export type EntryDataKind = 'places' | 'routes' | 'incidents' | 'customGeometrie
  * function createMyTool(state: ToolState) {
  *   return tool({
  *     execute: async () => {
- *       const pins = await state.places.getPinPlacesModule();
+ *       const places = await state.places.getEntryPlacesModule('places-0', 'pin');
  *       state.routing.currentRoutes;  // most recent routes
  *       state.baseMap.mapLibreMap;    // MapLibre instance
  *     }
@@ -4210,7 +4214,7 @@ export type ToolState = {
  * @group Agent Toolkit
  */
 export type CodeExecutionConfig = {
-  /** Wall-clock budget per isolated (browser) run, in ms. Default: 5000. */
+  /** Wall-clock budget per isolated (browser) run, in ms. Default: 10000. */
   timeoutMs?: number;
   /**
    * Optional override of the worker's library source. By default the SDK loads its own
@@ -4512,7 +4516,8 @@ export type MapAgentOptions<CS extends ToolState = ToolState> = {
   includeDefaultTools?: boolean;
   /**
    * Tool overrides merged with default tools.
-   * - `ToolEntry` values add a new tool or replace a default.
+   * - {@link ToolDefinition} values (a `ToolEntry`, a builder, or a `DEFAULT_TOOLS` value) add a new
+   *   tool or replace a default.
    * - `false` values exclude a default tool.
    *
    * When omitted, all default tools are used as-is.
@@ -4532,7 +4537,7 @@ export type MapAgentOptions<CS extends ToolState = ToolState> = {
    * });
    * ```
    */
-  tools?: { [K in ToolNameHint]?: ToolEntry<CS> | false | undefined; };
+  tools?: { [K in ToolNameHint]?: ToolDefinition<CS> | false | undefined; };
   /**
    * Custom state slices merged alongside built-in state.
    * Only custom slices need to be provided — built-in slices are created automatically.
@@ -4543,9 +4548,9 @@ export type MapAgentOptions<CS extends ToolState = ToolState> = {
    * Per-kind data-entry configuration. Each {@link DataEntryKind} accepts
    * `{ enabled?, entryMode? }`. Setting `enabled: false` removes the kind from the
    * agent's tool surface entirely — it disappears from `analyseData` / `processData`
-   * scope and input fields, and the slice-specific recall / display / fetch tools
-   * are dropped from the registry. `entryMode` is applied to the underlying slice
-   * right after the agent state is built — before any tool runs.
+   * scope and input fields, and its slice-specific display / fetch tools
+   * ({@link TOOLS_BY_DATA_ENTRY_KIND}) are dropped from the registry; `recallState` stays.
+   * `entryMode` is applied to the underlying slice right after the agent state is built — before any tool runs.
    *
    * Keys are LLM-facing kind names (`routes`, `incidents`) — not slice names
    * (`routing`, `trafficIncidents`). The slice mapping is internal.
@@ -4557,8 +4562,8 @@ export type MapAgentOptions<CS extends ToolState = ToolState> = {
    *     dataEntries: {
    *         routes: { entryMode: 'single' },
    *         incidents: { entryMode: 'single' },
-   *         byod: { enabled: false }, // disables recallState, addByodSource, setByodLayers, updateByodDisplay + byod scope on analyse/process
-   *         ranges: { enabled: false }, // disables findReachableAreas + recallState
+   *         byod: { enabled: false }, // drops addByodSource, setByodLayers, updateByodDisplay + byod scope on analyse/process
+   *         ranges: { enabled: false }, // drops findReachableAreas
    *     },
    * });
    * ```
@@ -4746,7 +4751,7 @@ export declare const createMapAgent: <CS extends ToolState = ToolState>(map: Tom
  *
  * @group Agent Toolkit
  */
-export declare const resolveTools: <S extends ToolState>(defaults: Record<string, ToolDefinition<S>>, overrides?: { [K in ToolNameHint]?: ToolEntry<S> | false | undefined; }) => Record<string, ToolDefinition<S>>;
+export declare const resolveTools: <S extends ToolState>(defaults: Record<string, ToolDefinition<S>>, overrides?: MapAgentOptions<S>["tools"]) => Record<string, ToolDefinition<S>>;
 //#endregion
 //#region src/tools/utilities/clarify-user-intent.d.ts
 /** A single clarification question shown to the user. Exported so a host can type its form state. */