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

package/README.md

@@ -175,7 +175,6 @@ const agent = createMapAgent(map, {
 | `getStandardMapStyles` | List available standard map style presets |
 | `setMapStandardStyle` | Switch map style (light, dark, satellite, driving, etc.) |
 | `setLanguage` | Change the language for map labels and API responses |
-| `toggleTilesBaseMapLayerGroups` | Show/hide named layer groups (buildings3D, roadLabels, water, etc.) |
 | `toggleTilesPOIs` | Show/hide built-in map POI icons with optional category filtering |
 
 ### MapLibre direct access
@@ -262,9 +261,6 @@ const agent = createMapAgent<MyState>(map, {
     // Max tool-loop iterations (default: 10)
     maxSteps: 15,
 
-    // Opt into experimental features (subject to change without notice)
-    featureFlags: { experimentalSearch: true },
-
     // Provider-specific options forwarded to the AI SDK on every step
     providerOptions: {
         openai: { reasoningEffort: 'low', reasoningSummary: 'auto' },
@@ -514,7 +510,7 @@ const agent = createMapAgent(map, {
         setLanguage: false,
         setLayoutProperties: false,
         setPaintProperties: false,
-        toggleTilesBaseMapLayerGroups: false,
+        toggleTilesPOIs: false,
     },
 });
 ```

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { BaseMapModule, CustomGeoJSONLayerSpec, CustomGeoJSONModule, GeometriesModule, GeometryTheme, HillshadeModule, POIsModule, PlaceConnectionDisplay, PlacesModule, PlanningWaypoint, RoutingModule, StylingModule, TomTomMap, TrafficAreaAnalyticsConfig, TrafficAreaAnalyticsModule, TrafficFlowModule, TrafficIncidentOverlayModule, TrafficIncidentsModule } from "@tomtom-org/maps-sdk/map";
+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 { 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";
@@ -698,22 +698,20 @@ type BYODEntry = BaseEntry<FeatureCollection$1> & {
 //#endregion
 //#region src/state/base-map/state.d.ts
 /**
- * State for base map display: style, language, viewport, layers, and hillshade.
+ * State for base map display: style, language, viewport and layers.
  *
  * Provides direct access to the TomTomMap and MapLibre instances alongside
- * lazy-initialized BaseMapModule and HillshadeModule.
+ * lazy-initialized BaseMapModule and StylingModule.
  *
  * @group Agent Toolkit
  */
 declare class BaseMapState implements StateSlice {
   readonly ttMap: TomTomMap;
   private _baseMapModule?;
-  private _hillshadeModule?;
   private _stylingModule?;
   constructor(ttMap: TomTomMap);
   get mapLibreMap(): Map$1;
   getBaseMapModule(): Promise<BaseMapModule>;
-  getHillshadeModule(): Promise<HillshadeModule>;
   getStylingModule(): Promise<StylingModule>;
   reset(): void;
 }
@@ -2866,12 +2864,16 @@ export declare const packSandboxArgs: (sandbox: SandboxInputs, libs: {
  * sandboxed code. `Places` is a FeatureCollection of Point Features; only the
  * `properties` shape (the TomTom-specific bit) is documented here.
  *
+ * @remarks
+ * Takes {@link FeatureFlags} so a future flag can vary the doc; no flag
+ * currently does, so every caller gets the same text.
+ *
  * @ignore
  */
-export declare const buildPlacesSchemaDoc: (flags: FeatureFlags) => string;
+export declare const buildPlacesSchemaDoc: (_flags: FeatureFlags) => string;
 /**
- * Default-flag (`experimentalSearch: false`) Places schema doc — preserved as a
- * named constant so non-flag-aware tools keep working.
+ * Places schema doc — preserved as a named constant so non-flag-aware tools
+ * keep working.
  *
  * @ignore
  */
@@ -3912,7 +3914,6 @@ export declare const DEFAULT_TOOLS: {
   getStandardMapStyles: ToolDefinition;
   setMapStandardStyle: ToolDefinition;
   setLanguage: ToolDefinition;
-  toggleTilesBaseMapLayerGroups: ToolDefinition;
   toggleTilesPOIs: ToolDefinition;
   describeMapStyling: ToolDefinition;
   setMapStyling: ToolDefinition;
@@ -4115,7 +4116,7 @@ export type ToolState = {
   mapPOIs: MapPOIsState;
   /** Route calculation, waypoint management, and planning parameter state. */
   routing: RoutingState;
-  /** Base map display: style, language, viewport, layers, and hillshade. */
+  /** Base map display: style, language, viewport and layers. */
   baseMap: BaseMapState;
   /** Traffic tile overlays: flow tiles + incident overlay tiles. */
   trafficTiles: TrafficTilesState;
@@ -4327,21 +4328,14 @@ export type Classifier = (context: ClassifierContext) => Promise<ClassificationR
  */
 export type FeatureFlags = {
   /**
-   * Route `discoverPlaces` through the experimental exploration search
-   * backend (and expose its richer input surface — `municipalities`,
-   * multiple `boundingBoxes`, `placeTypes`, `areaId`, `areaTags`). When
-   * `false`/unset, `discoverPlaces` uses the stable default search
-   * service and a reduced input schema that matches what the default
-   * service supports.
-   *
-   * **Internal experiment.** Not part of the public agent-toolkit
-   * contract; subject to removal at any time.
+   * No feature flags are currently defined.
    *
-   * @internal
-   * @experimental
-   * @default false
+   * @remarks
+   * The bag is kept because the tool builders (`ToolEntryBuilder`,
+   * `buildDiscoverPlacesSchema`, …) thread it through as their extension
+   * point for schema and description variation. A future flag is added here.
    */
-  experimentalSearch?: boolean;
+  readonly [flag: string]: never;
 };
 /**
  * Build-time options passed to a {@link ToolEntryBuilder}. Lets each tool