@tomtom-org/maps-sdk-plugin-agent-toolkit 0.5.4 → 0.6.1

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { BaseMapModule, CustomGeoJSONLayerSpec, CustomGeoJSONModule, GeometriesModule, GeometryTheme, HillshadeModule, POIsModule, PlaceConnectionDisplay, PlacesModule, PlanningWaypoint, RoutingModule, TomTomMap, TrafficAreaAnalyticsConfig, TrafficAreaAnalyticsModule, TrafficFlowModule, TrafficIncidentOverlayModule, TrafficIncidentsModule } from "@tomtom-org/maps-sdk/map";
+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 { 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";
 import { z } from "zod";
-import { ReachableRangeBudget, TrafficIncidentDetailsByBBoxParams } from "@tomtom-org/maps-sdk/services";
+import { GeoBias, ReachableRangeBudget, TrafficIncidentDetailsByBBoxParams } from "@tomtom-org/maps-sdk/services";
 import { LanguageModel, ModelMessage, PrepareStepFunction, ToolLoopAgent } from "ai";
 //#region src/engine/engine.d.ts
 /** What {@link JobEngine.register} needs to mint a {@link Job}. `run` and `onOrphaned` are owner closures. */
@@ -78,7 +78,7 @@ declare class JobHandle implements Job {
 }
 //#endregion
 //#region src/tools/shared/sandbox-code.d.ts
-type AnalysisOutputFormat = 'json' | 'chart';
+export type AnalysisOutputFormat = 'json' | 'chart';
 /**
  * Compact sandbox-code blurb shared by `process-places`, `process-geometries`,
  * `analyse-places`, `analyse-geometries`, and `analyse-routes`. Keeps the
@@ -89,11 +89,11 @@ type AnalysisOutputFormat = 'json' | 'chart';
  *
  * @ignore
  */
-declare const buildSandboxCodePrompt: (injected: readonly string[]) => string;
+export declare const buildSandboxCodePrompt: (injected: readonly string[]) => string;
 /** Chart.js chart types accepted by the analyse-* tools when `outputFormat: "chart"`. */
-declare const CHART_TYPES: Set<string>;
+export declare const CHART_TYPES: Set<string>;
 /** Lightweight structural check that a sandbox return value is a Chart.js config. */
-declare const isChartConfiguration: (value: unknown) => value is ChartConfiguration;
+export declare const isChartConfiguration: (value: unknown) => value is ChartConfiguration;
 /**
  * GeoJSON Feature with a Polygon or MultiPolygon geometry. Generic over
  * `properties` so callers that need a narrower property shape (e.g. place
@@ -101,11 +101,11 @@ declare const isChartConfiguration: (value: unknown) => value is ChartConfigurat
  *
  * @ignore
  */
-declare const isPolygonFeature: <P = unknown>(value: unknown) => value is PolygonFeature<P>;
+export declare const isPolygonFeature: <P = unknown>(value: unknown) => value is PolygonFeature<P>;
 /** @ignore */
-declare const isPolygonFeatureArray: <P = unknown>(value: unknown) => value is PolygonFeature<P>[];
+export declare const isPolygonFeatureArray: <P = unknown>(value: unknown) => value is PolygonFeature<P>[];
 /** Shared `describe()` text for the analyse-* `outputFormat` enum field. */
-declare const ANALYSE_OUTPUT_FORMAT_DESCRIPTION: string;
+export declare const ANALYSE_OUTPUT_FORMAT_DESCRIPTION: string;
 /**
  * Builds the shared "return value" blurb for the analyse-* tools' `code` field.
  * Encodes the JSON-only contract, the Chart.js config shape, and the
@@ -116,7 +116,7 @@ declare const ANALYSE_OUTPUT_FORMAT_DESCRIPTION: string;
  * @param chartLabelExample Optional inline code snippet illustrating a
  *   multi-line `string[]` label using the tool's domain. Omitted when empty.
  */
-declare const buildAnalyseReturnPrompt: (jsonExamples: string, chartLabelExample?: string) => string;
+export declare const buildAnalyseReturnPrompt: (jsonExamples: string, chartLabelExample?: string) => string;
 /**
  * Validates the value returned by analyse-* sandboxed code: rejects
  * `undefined`, JSON-normalizes via `toJsonSafe`, and — when
@@ -126,15 +126,15 @@ declare const buildAnalyseReturnPrompt: (jsonExamples: string, chartLabelExample
  *
  * @ignore
  */
-declare const validateAnalysisResult: (analysis: unknown, outputFormat: AnalysisOutputFormat) => {
+export declare const validateAnalysisResult: (analysis: unknown, outputFormat: AnalysisOutputFormat) => {
   value: unknown;
 } | {
   error: string;
 };
 /** @ignore */
-declare const sandboxedGlobalShadows: readonly ["fetch", "XMLHttpRequest", "WebSocket", "EventSource", "localStorage", "sessionStorage", "indexedDB", "document", "window", "globalThis", "self", "navigator", "importScripts", "process"];
+export declare const sandboxedGlobalShadows: readonly ["fetch", "XMLHttpRequest", "WebSocket", "EventSource", "localStorage", "sessionStorage", "indexedDB", "document", "window", "globalThis", "self", "navigator", "importScripts", "process"];
 /** @ignore */
-declare const WORKER_PROVIDED_PARAMS: readonly ["turf", "h3", "routeUtils", "log", "cluster"];
+export declare const WORKER_PROVIDED_PARAMS: readonly ["turf", "h3", "routeUtils", "log", "cluster"];
 /**
  * Pluggable strategy for executing sandbox code. The default
  * {@link mainThreadExecutor} compiles + runs in the host realm; an alternative
@@ -146,7 +146,7 @@ declare const WORKER_PROVIDED_PARAMS: readonly ["turf", "h3", "routeUtils", "log
  *
  * @group Agent Toolkit
  */
-type SandboxExecutor = {
+export type SandboxExecutor = {
   run<Result = unknown>(code: string, paramNames: readonly string[], args: readonly unknown[], verb: string): Promise<{
     value: Result;
   } | {
@@ -163,7 +163,7 @@ type SandboxExecutor = {
  *
  * @ignore
  */
-declare const mainThreadExecutor: SandboxExecutor;
+export declare const mainThreadExecutor: SandboxExecutor;
 /**
  * Compiles `code` as the body of an `async` function that takes the named
  * `paramNames`, sanitises injected redeclarations, runs it with `args`, and
@@ -187,13 +187,13 @@ declare const mainThreadExecutor: SandboxExecutor;
  *
  * @ignore
  */
-declare const runSandboxedFn: <Result = unknown>(code: string, paramNames: readonly string[], args: readonly unknown[], verb: string, executor: SandboxExecutor) => Promise<{
+export declare const runSandboxedFn: <Result = unknown>(code: string, paramNames: readonly string[], args: readonly unknown[], verb: string, executor: SandboxExecutor) => Promise<{
   value: Result;
 } | {
   error: string;
 }>;
 /** @ignore */
-declare const stripInjectedRedeclarations: (code: string, identifiers: readonly string[]) => string;
+export declare const stripInjectedRedeclarations: (code: string, identifiers: readonly string[]) => string;
 /**
  * Builds an LLM-facing error string for sandboxed code execution failures.
  * Appends a `Hint:` suffix when the error matches a common pattern so the
@@ -201,7 +201,7 @@ declare const stripInjectedRedeclarations: (code: string, identifiers: readonly
  * in the prefix (e.g. `"Analysis"`, `"Process"`).
  */
 /** @ignore */
-declare const formatSandboxExecutionError: (verb: string, error: unknown) => string;
+export declare const formatSandboxExecutionError: (verb: string, error: unknown) => string;
 //#endregion
 //#region src/state/events.d.ts
 /**
@@ -709,10 +709,12 @@ 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;
 }
 //#endregion
@@ -720,7 +722,7 @@ declare class BaseMapState implements StateSlice {
 /**
  * @module agent-toolkit-tools
  */
-declare const AGENT_TOOLKIT_ID = "AgentToolkit";
+export declare const AGENT_TOOLKIT_ID = "AgentToolkit";
 /**
  * The `tomtom-user-agent` value identifying agent-toolkit traffic. Shared by both paths that carry
  * it — {@link withAgentToolkitHeaders} on service calls, `createMapAgent` on the map — so the two
@@ -728,7 +730,7 @@ declare const AGENT_TOOLKIT_ID = "AgentToolkit";
  *
  * @ignore
  */
-declare const AGENT_TOOLKIT_USER_AGENT: string;
+export declare const AGENT_TOOLKIT_USER_AGENT: string;
 /**
  * Tags an SDK service call as coming from agent-toolkit, via the SDK's own supported per-call
  * `tomtom-user-agent` override (see `generateTomTomHeaders`, `core/src/util/headers.ts`) — reuses
@@ -739,7 +741,7 @@ declare const AGENT_TOOLKIT_USER_AGENT: string;
  *
  * @ignore
  */
-declare const withAgentToolkitHeaders: <P extends object>(params: P) => P;
+export declare const withAgentToolkitHeaders: <P extends object>(params: P) => P;
 //#endregion
 //#region src/tools/shared/entry-kinds.d.ts
 /**
@@ -749,14 +751,14 @@ declare const withAgentToolkitHeaders: <P extends object>(params: P) => P;
  *
  * @ignore
  */
-declare const ALL_ENTRY_DATA_KINDS: readonly ["places", "routes", "incidents", "customGeometries", "trafficAreaAnalytics", "byod"];
+export declare const ALL_ENTRY_DATA_KINDS: readonly ["places", "routes", "incidents", "customGeometries", "trafficAreaAnalytics", "byod"];
 /**
  * Per-kind scope envelope. The classifier emits one of these in `toolScopes.<toolName>`
  * to narrow which kinds the tool's per-turn input schema and code-doc mention.
  *
  * @ignore
  */
-type EntryKindScope = {
+export type EntryKindScope = {
   kinds: readonly EntryDataKind[];
 };
 /**
@@ -766,7 +768,7 @@ type EntryKindScope = {
  *
  * @ignore
  */
-declare const buildEntryKindScopeSchema: (enabled: readonly EntryDataKind[]) => z.ZodObject<{
+export declare const buildEntryKindScopeSchema: (enabled: readonly EntryDataKind[]) => z.ZodObject<{
   kinds: z.ZodArray<z.ZodEnum<{
     places: "places";
     routes: "routes";
@@ -796,7 +798,7 @@ type FieldBuildOptions = {
  *
  * @ignore
  */
-type EntryKindMeta = {
+export type EntryKindMeta = {
   fieldName: string;
   fieldLabel: string;
   buildField: (options: FieldBuildOptions) => z.ZodTypeAny;
@@ -810,7 +812,7 @@ type EntryKindMeta = {
  *
  * @ignore
  */
-declare const ENTRY_KIND_META: Record<EntryDataKind, EntryKindMeta>;
+export declare const ENTRY_KIND_META: Record<EntryDataKind, EntryKindMeta>;
 /**
  * Resolve the set of kinds active for a single per-turn build: the intersection of
  * the agent's enabled kinds and the classifier's per-turn scope. `scope === undefined`
@@ -818,7 +820,7 @@ declare const ENTRY_KIND_META: Record<EntryDataKind, EntryKindMeta>;
  *
  * @ignore
  */
-declare const resolveActiveKinds: (enabled: readonly EntryDataKind[], scope: EntryKindScope | undefined) => readonly EntryDataKind[];
+export declare const resolveActiveKinds: (enabled: readonly EntryDataKind[], scope: EntryKindScope | undefined) => readonly EntryDataKind[];
 /**
  * Predicate form of {@link resolveActiveKinds} for a single kind. Used when generating
  * tool-specific fields (e.g. analyseData's `monitor`) that should only appear when
@@ -826,21 +828,21 @@ declare const resolveActiveKinds: (enabled: readonly EntryDataKind[], scope: Ent
  *
  * @ignore
  */
-declare const isKindActive: (enabled: readonly EntryDataKind[], scope: EntryKindScope | undefined, kind: EntryDataKind) => boolean;
+export declare const isKindActive: (enabled: readonly EntryDataKind[], scope: EntryKindScope | undefined, kind: EntryDataKind) => boolean;
 /**
  * Slash-joined list of scoped `*EntryIDs` field labels — used in "At least one of `A` / `B`
  * must be set." messages and in per-field hints. Order follows {@link ALL_ENTRY_DATA_KINDS}.
  *
  * @ignore
  */
-declare const buildEntryFieldList: (active: readonly EntryDataKind[]) => string;
+export declare const buildEntryFieldList: (active: readonly EntryDataKind[]) => string;
 /**
  * Join the per-kind sandbox-doc fragments in canonical order for the supplied active set.
  * Returns the multi-line "Each input is …" block.
  *
  * @ignore
  */
-declare const buildEntryKindSandboxDocs: (active: readonly EntryDataKind[]) => string;
+export declare const buildEntryKindSandboxDocs: (active: readonly EntryDataKind[]) => string;
 /**
  * Join the per-kind deep schema-doc fragments in canonical order for the supplied active
  * set. Empty when no active kind has a schema doc (only places / routes / customGeometries
@@ -848,7 +850,7 @@ declare const buildEntryKindSandboxDocs: (active: readonly EntryDataKind[]) => s
  *
  * @ignore
  */
-declare const buildEntryKindSchemaDocs: (active: readonly EntryDataKind[]) => string;
+export declare const buildEntryKindSchemaDocs: (active: readonly EntryDataKind[]) => string;
 /**
  * Build the input-shape Record passed into `z.object({...})`. Both tools share this
  * shape — each kind in the active set contributes its `*EntryIDs` field via
@@ -857,7 +859,7 @@ declare const buildEntryKindSchemaDocs: (active: readonly EntryDataKind[]) => st
  *
  * @ignore
  */
-declare const buildEntryIdFields: (active: readonly EntryDataKind[], options: FieldBuildOptions) => Record<string, z.ZodTypeAny>;
+export declare const buildEntryIdFields: (active: readonly EntryDataKind[], options: FieldBuildOptions) => Record<string, z.ZodTypeAny>;
 /**
  * Set of LLM-input objects that contain any `*EntryIDs` field. Used by the shared
  * "at least one of …" refine so both tools agree on what counts as "input present".
@@ -868,37 +870,37 @@ declare const buildEntryIdFields: (active: readonly EntryDataKind[], options: Fi
  *
  * @ignore
  */
-declare const hasAnyEntryIds: (value: Record<string, unknown>) => boolean;
+export declare const hasAnyEntryIds: (value: Record<string, unknown>) => boolean;
 /**
  * Message used by the shared "at least one of …" refine. Lists the active kinds'
  * field labels and the slash-joined recall-tool hints for the same set.
  *
  * @ignore
  */
-declare const buildAtLeastOneEntryIdMessage: (active: readonly EntryDataKind[]) => string;
+export declare const buildAtLeastOneEntryIdMessage: (active: readonly EntryDataKind[]) => string;
 //#endregion
 //#region src/tools/shared/fit-on-map.d.ts
 /** @ignore */
-declare const fitOnMapInputSchema: z.ZodUnion<readonly [z.ZodArray<z.ZodNumber>, z.ZodObject<{
+export declare const fitOnMapInputSchema: z.ZodUnion<readonly [z.ZodArray<z.ZodNumber>, z.ZodObject<{
   bbox: z.ZodArray<z.ZodNumber>;
   padding: z.ZodOptional<z.ZodNumber>;
   animate: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>]>;
 /** @ignore */
-declare const fittedReportSchema: z.ZodObject<{
+export declare const fittedReportSchema: z.ZodObject<{
   bbox: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
   padding: z.ZodNumber;
 }, z.core.$strip>;
 /** @ignore */
-type FitOnMapInput = BBox | {
+export type FitOnMapInput = BBox | {
   bbox: BBox;
   padding?: number;
   animate?: boolean;
 };
 /** Doc blurb to inline in sandboxed-code descriptions. @ignore */
-declare const FIT_ON_MAP_DOC: string;
+export declare const FIT_ON_MAP_DOC: string;
 /** @ignore */
-declare const isFitOnMapInput: (value: unknown) => value is FitOnMapInput;
+export declare const isFitOnMapInput: (value: unknown) => value is FitOnMapInput;
 /**
  * Apply a sandbox-returned `fitOnMap` directive: move the camera to the bbox
  * with the requested padding/animation, and return a normalized record for
@@ -906,7 +908,7 @@ declare const isFitOnMapInput: (value: unknown) => value is FitOnMapInput;
  *
  * @ignore
  */
-declare const applyFitOnMap: (state: ToolState, fit: FitOnMapInput) => z.infer<typeof fittedReportSchema>;
+export declare const applyFitOnMap: (state: ToolState, fit: FitOnMapInput) => z.infer<typeof fittedReportSchema>;
 //#endregion
 //#region src/tools/shared/geocode-areas.d.ts
 /**
@@ -916,17 +918,17 @@ declare const applyFitOnMap: (state: ToolState, fit: FitOnMapInput) => z.infer<t
  * it. Excludes `Country` (too coarse) and `PostalCodeArea` (homonym noise — "A10" → a Kazakh
  * postcode).
  */
-declare const AREA_GEOGRAPHY_TYPES: GeographyType[];
+export declare const AREA_GEOGRAPHY_TYPES: GeographyType[];
 /**
  * Geocodes `query` restricted to administrative AREA geographies (not streets/POIs), biased toward
  * `bias` (the map centre). Because `geographyTypes` filters to areas, every result carries a
  * `boundingBox`. Callers choose among the candidates (e.g. the one nearest the current view) — a
  * centre bias is used rather than a hard viewport-bbox filter so out-of-view areas still resolve.
  */
-declare const geocodeAreas: (query: string, opts?: {
+export declare const geocodeAreas: (query: string, opts?: {
   bias?: Position;
   limit?: number;
-}) => Promise<Place[]>;
+}, execOptions?: ToolExecuteOptions) => Promise<Place[]>;
 //#endregion
 //#region src/tools/shared/geometries-id.d.ts
 /**
@@ -934,7 +936,7 @@ declare const geocodeAreas: (query: string, opts?: {
  *
  * @group Agent Toolkit
  */
-type GeometriesIdKind = 'place' | 'places' | 'ranges' | 'customGeometries';
+export type GeometriesIdKind = 'place' | 'places' | 'ranges' | 'customGeometries';
 /**
  * Tagged geometries id. The Zod schema is exposed so tools can plug it
  * straight into their input shape (`z.array(geometriesIdSchema).min(1)`)
@@ -942,7 +944,7 @@ type GeometriesIdKind = 'place' | 'places' | 'ranges' | 'customGeometries';
  *
  * @group Agent Toolkit
  */
-declare const geometriesIdSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+export declare const geometriesIdSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   kind: z.ZodLiteral<"place">;
   id: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
@@ -960,7 +962,7 @@ declare const geometriesIdSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
  *
  * @group Agent Toolkit
  */
-type GeometriesId = z.infer<typeof geometriesIdSchema>;
+export type GeometriesId = z.infer<typeof geometriesIdSchema>;
 /**
  * Shared `geometriesEntryIDs` input schema for tools that read polygons from
  * session state (`processData`, `analyseData`). One canonical
@@ -969,7 +971,7 @@ type GeometriesId = z.infer<typeof geometriesIdSchema>;
  *
  * @ignore
  */
-declare const geometriesEntryIDsSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+export declare const geometriesEntryIDsSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
   kind: z.ZodLiteral<"place">;
   id: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
@@ -988,19 +990,19 @@ declare const geometriesEntryIDsSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.Zo
  *
  * @ignore
  */
-declare const GEOMETRIES_PROPS_DOC: string;
+export declare const GEOMETRIES_PROPS_DOC: string;
 /**
  * Shared description for `skipped` arrays in tool outputs.
  *
  * @ignore
  */
-declare const GEOMETRIES_SKIPPED_DESC = "Source ids that could not contribute (unknown id, no geometry data source, fetch failure, or empty entry).";
+export declare const GEOMETRIES_SKIPPED_DESC = "Source ids that could not contribute (unknown id, no geometry data source, fetch failure, or empty entry).";
 /**
  * Shared description for `sourceIds` arrays in tool outputs.
  *
  * @ignore
  */
-declare const GEOMETRIES_SOURCE_IDS_DESC = "Tagged input ids that contributed at least one polygon to the run, in input order.";
+export declare const GEOMETRIES_SOURCE_IDS_DESC = "Tagged input ids that contributed at least one polygon to the run, in input order.";
 //#endregion
 //#region src/tools/shared/geometries-schema-doc.d.ts
 /**
@@ -1013,7 +1015,7 @@ declare const GEOMETRIES_SOURCE_IDS_DESC = "Tagged input ids that contributed at
  * spelled out here.
  */
 /** @ignore */
-declare const GEOMETRIES_SCHEMA_DOC: string;
+export declare const GEOMETRIES_SCHEMA_DOC: string;
 //#endregion
 //#region src/state/custom-geometries/analysis.d.ts
 /**
@@ -1094,7 +1096,7 @@ type StateDigest = {
  *
  * @group Agent Toolkit
  */
-declare const getStateDigest: (state: ToolState) => StateDigest;
+export declare const getStateDigest: (state: ToolState) => StateDigest;
 /**
  * Produce a compact, LLM-readable summary of the differences between two digests, or `null` when
  * nothing changed. The output is short enough to prepend to a user prompt without bloating the
@@ -1110,7 +1112,7 @@ declare const getStateDigest: (state: ToolState) => StateDigest;
  *
  * @group Agent Toolkit
  */
-declare const formatStateDigestDiff: (prev: StateDigest, next: StateDigest) => string | null;
+export declare const formatStateDigestDiff: (prev: StateDigest, next: StateDigest) => string | null;
 //#endregion
 //#region src/state/map-pois/state.d.ts
 /**
@@ -1141,45 +1143,15 @@ declare class MapPOIsState implements StateSlice {
  */
 type PlacesAnalysis = EntryAnalysis;
 //#endregion
-//#region src/state/places/entry.d.ts
+//#region src/state/places/state.d.ts
 /**
- * A single entry in the place search history.
- *
- * @group Agent Toolkit
- *
- * @ignore
+ * The marker looks an entry can be rendered with: individual pins, base-map POIs, or clustered
+ * pins. A type-checked subset of the SDK's {@link PlacesTheme} — `circle-icon` is not offered to
+ * the agent. Every tool enum for marker types derives from this array rather than repeating it.
  */
-type PlacesEntry = BaseEntry<Place[]> & {
-  /** Connections (lines between places) produced alongside this entry, rendered via PlacesModule.showConnections. */
-  connections?: PlaceConnectionDisplay[];
-  /**
-   * Boundary polygons attached to this entry. One feature per place that has a geometry data
-   * source (populated lazily via PlacesState.fetchPlaceGeometry), or a standalone result list
-   * produced by tools like `processData`. Each feature's `id` is the geometry-data-source id
-   * (`place.properties.dataSources.geometry.id`), matching the response shape of `geometryData`.
-   */
-  geometries?: PolygonFeature<CommonPlaceProps>[];
-  /** Lazy place-id → Place index, built on first ID lookup through PlacesState.findPlaceById. */
-  _byId?: Record<string, Place>;
-  /** Lazy place-id → boundary polygon index, built on first lookup through PlacesState.getGeometryForPlace. */
-  _geometryByPlaceId?: Record<string, PolygonFeature<CommonPlaceProps>>;
-  /**
-   * Per-entry display modules. An entry is rendered under at most one marker theme at a time,
-   * so a single PlacesModule covers all themes — `_showEntryAs` rethemes it via `applyTheme`.
-   * A dedicated GeometriesModule renders the entry's boundary polygons.
-   * Lazy-initialised via PlacesState helpers — undefined until first show.
-   */
-  _modules?: {
-    places?: PlacesModule;
-    geometries?: GeometriesModule;
-  };
-  /** The marker theme currently rendering this entry, or undefined when hidden. */
-  _shownAs?: 'pin' | 'base-map' | 'pin-clustered';
-};
-//#endregion
-//#region src/state/places/state.d.ts
-/** How an entry is rendered on the map: as individual pins, base-map POIs, or clustered pins. */
-type PlacesMarkerType = 'pin' | 'base-map' | 'pin-clustered';
+declare const placesMarkerTypes: readonly ["pin", "base-map", "pin-clustered"];
+/** How an entry is rendered on the map — one of {@link placesMarkerTypes}. */
+type PlacesMarkerType = (typeof placesMarkerTypes)[number];
 /**
  * Events fired by {@link PlacesState}. Subscribe via `state.places.events.on(type, handler)`.
  *
@@ -1270,14 +1242,14 @@ declare class PlacesState implements StateSlice {
    * the owning entry. Returns the cached feature if already fetched, or undefined if the place
    * is unknown or has no geometry data source.
    */
-  fetchPlaceGeometry(placeId: string): Promise<PolygonFeature<CommonPlaceProps> | undefined>;
+  fetchPlaceGeometry(placeId: string, options?: ToolExecuteOptions): Promise<PolygonFeature<CommonPlaceProps> | undefined>;
   /**
    * Batch-fetches boundary polygons for every place in an entry that has a geometry data source
    * but is not yet cached. Issues one Geometry Data request per chunk of {@link GEOMETRY_DATA_BATCH_SIZE}
    * place ids (the API caps each request) and stores the merged result on `entry.geometries`.
    * Returns the full geometries list for the entry, or an empty array if the entry is unknown.
    */
-  fetchGeometriesForEntry(entryId: string): Promise<PolygonFeature<CommonPlaceProps>[]>;
+  fetchGeometriesForEntry(entryId: string, options?: ToolExecuteOptions): Promise<PolygonFeature<CommonPlaceProps>[]>;
   /**
    * Render the given polygons via the entry's GeometriesModule. The `mode` flag is
    * scoped to **this entry's layer only** — it does not touch other entries (use
@@ -1344,6 +1316,42 @@ declare class PlacesState implements StateSlice {
   reset(): void;
 }
 //#endregion
+//#region src/state/places/entry.d.ts
+/**
+ * A single entry in the place search history.
+ *
+ * @group Agent Toolkit
+ *
+ * @ignore
+ */
+type PlacesEntry = BaseEntry<Place[]> & {
+  /** Connections (lines between places) produced alongside this entry, rendered via PlacesModule.showConnections. */
+  connections?: PlaceConnectionDisplay[];
+  /**
+   * Boundary polygons attached to this entry. One feature per place that has a geometry data
+   * source (populated lazily via PlacesState.fetchPlaceGeometry), or a standalone result list
+   * produced by tools like `processData`. Each feature's `id` is the geometry-data-source id
+   * (`place.properties.dataSources.geometry.id`), matching the response shape of `geometryData`.
+   */
+  geometries?: PolygonFeature<CommonPlaceProps>[];
+  /** Lazy place-id → Place index, built on first ID lookup through PlacesState.findPlaceById. */
+  _byId?: Record<string, Place>;
+  /** Lazy place-id → boundary polygon index, built on first lookup through PlacesState.getGeometryForPlace. */
+  _geometryByPlaceId?: Record<string, PolygonFeature<CommonPlaceProps>>;
+  /**
+   * Per-entry display modules. An entry is rendered under at most one marker theme at a time,
+   * so a single PlacesModule covers all themes — `_showEntryAs` rethemes it via `applyTheme`.
+   * A dedicated GeometriesModule renders the entry's boundary polygons.
+   * Lazy-initialised via PlacesState helpers — undefined until first show.
+   */
+  _modules?: {
+    places?: PlacesModule;
+    geometries?: GeometriesModule;
+  };
+  /** The marker theme currently rendering this entry, or undefined when hidden. */
+  _shownAs?: PlacesMarkerType;
+};
+//#endregion
 //#region src/state/range/entry.d.ts
 /**
  * A single reachable area, scoped to one origin and one set of budgets.
@@ -1815,7 +1823,7 @@ declare class RoutingState implements ShownEntriesSlice {
  *
  * @group Agent Toolkit
  */
-interface StateSlice {
+export interface StateSlice {
   reset(): void;
 }
 //#endregion
@@ -2561,29 +2569,24 @@ declare class TrafficTilesState implements StateSlice {
  *
  * @ignore
  */
-declare const hidePreviousShownEntries: (slice: ShownEntriesSlice, keepEntryIds: readonly string[], selector: "all" | readonly string[] | undefined) => Promise<void>;
+export declare const hidePreviousShownEntries: (slice: ShownEntriesSlice, keepEntryIds: readonly string[], selector: "all" | readonly string[] | undefined) => Promise<void>;
 //#endregion
 //#region src/tools/shared/locate-places.d.ts
-type LocateBias = {
-  position: Position;
-} | {
-  boundingBox: BBox;
-};
-type QueryAs = 'poi' | 'place';
+export type QueryAs = 'poi' | 'place';
 /**
  * Resolves a query string to up to `limit` Places. POI search when `queryAs === 'poi'`, geocoding
  * otherwise. Optional `bias` narrows the search to a region.
  */
-declare const locatePlaces: (query: string, queryAs: QueryAs, options: {
+export declare const locatePlaces: (query: string, queryAs: QueryAs, options: {
   limit: number;
-  bias?: LocateBias;
-}) => Promise<Place[]>;
+  bias?: GeoBias;
+}, execOptions?: ToolExecuteOptions) => Promise<Place[]>;
 /** Convenience wrapper around {@link locatePlaces} for the single-result case. */
-declare const locatePlace: (query: string, queryAs: QueryAs, bias?: LocateBias) => Promise<Place | null>;
+export declare const locatePlace: (query: string, queryAs: QueryAs, bias?: GeoBias, execOptions?: ToolExecuteOptions) => Promise<Place | null>;
 //#endregion
 //#region src/tools/shared/location-input.d.ts
 /** @ignore */
-type ResolvedLocation = {
+export type ResolvedLocation = {
   /** Resolved place: a Place (with address metadata) or a bare [lng, lat] tuple. */
   place: WaypointLike;
   position: Position;
@@ -2592,7 +2595,7 @@ type ResolvedLocation = {
   query?: string;
 };
 /** @ignore */
-declare const locationInputSchema: z.ZodUnion<readonly [z.ZodObject<{
+export declare const locationInputSchema: z.ZodUnion<readonly [z.ZodObject<{
   query: z.ZodString;
   queryAs: z.ZodEnum<{
     poi: "poi";
@@ -2604,11 +2607,18 @@ declare const locationInputSchema: z.ZodUnion<readonly [z.ZodObject<{
   placeIdOrEntryId: z.ZodString;
 }, z.core.$strip>]>;
 /** @ignore */
-type LocationInput = z.infer<typeof locationInputSchema>;
+export type LocationInput = z.infer<typeof locationInputSchema>;
+/**
+ * Names a location input in an error message, without resolving it — so the model reads back the
+ * same thing it sent.
+ *
+ * @ignore
+ */
+export declare const labelForLocationInput: (location: LocationInput) => string;
 //#endregion
 //#region src/tools/shared/state-inputs.d.ts
 /** @ignore */
-declare const skippedSourceSchema: z.ZodObject<{
+export declare const skippedSourceSchema: z.ZodObject<{
   source: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"place">;
     id: z.ZodString;
@@ -2625,16 +2635,16 @@ declare const skippedSourceSchema: z.ZodObject<{
   reason: z.ZodString;
 }, z.core.$strip>;
 /** @ignore */
-type SkippedSource = z.infer<typeof skippedSourceSchema>;
+export type SkippedSource = z.infer<typeof skippedSourceSchema>;
 /** @ignore */
-type AffectedEntry = {
+export type AffectedEntry = {
   /** Unqualified entry id within the owning slice. */
   id: string;
   /** Which slice the entry lives in (only kinds that carry analyses are tracked). */
   kind: 'places' | 'customGeometries';
 };
 /** @ignore */
-type CollectedGeometries = {
+export type CollectedGeometries = {
   geometries: PolygonFeature[];
   /** Place objects whose footprints contributed (used to seed processData provenance). */
   sourcePlaces: Place[];
@@ -2661,7 +2671,7 @@ type CollectedGeometries = {
  *
  * @ignore
  */
-declare const collectInputGeometries: (sources: readonly GeometriesId[], state: ToolState) => Promise<{
+export declare const collectInputGeometries: (sources: readonly GeometriesId[], state: ToolState) => Promise<{
   value: CollectedGeometries;
 } | {
   error: string;
@@ -2674,7 +2684,7 @@ declare const collectInputGeometries: (sources: readonly GeometriesId[], state:
  *
  * @ignore
  */
-declare const findPlacesByEntry: (placesEntryIDs: readonly string[] | undefined, state: ToolState) => {
+export declare const findPlacesByEntry: (placesEntryIDs: readonly string[] | undefined, state: ToolState) => {
   value: Record<string, Places> | undefined;
 } | {
   error: string;
@@ -2690,7 +2700,7 @@ type FeatureCollection<F> = {
  *
  * @ignore
  */
-type MultiInputIds = {
+export type MultiInputIds = {
   placesEntryIDs?: readonly string[];
   routesEntryIDs?: readonly string[];
   incidentsEntryIDs?: readonly string[];
@@ -2703,7 +2713,7 @@ type MultiInputIds = {
  *
  * @ignore
  */
-type ResolvedEntries = {
+export type ResolvedEntries = {
   places: PlacesEntry[];
   routes: RoutesEntry[];
   incidents: TrafficIncidentsEntry[];
@@ -2712,7 +2722,7 @@ type ResolvedEntries = {
 };
 /** Newest `timestamp` across every resolved source entry, or undefined when none carry one. The
  * canonical `sampledAt` for a recurring sandbox run over these inputs. */
-declare const latestTimestamp: (resolved: ResolvedEntries) => number | undefined;
+export declare const latestTimestamp: (resolved: ResolvedEntries) => number | undefined;
 /**
  * Sandbox-facing inputs. Each kind is exposed as a single `<kind>ByEntry` record keyed by the entry id
  * the caller passed in `<kind>EntryIDs`; the field is `undefined` when its kind wasn't requested. There
@@ -2721,7 +2731,7 @@ declare const latestTimestamp: (resolved: ResolvedEntries) => number | undefined
  *
  * @ignore
  */
-type SandboxInputs = {
+export type SandboxInputs = {
   /**
    * Per-entry places, keyed by entry id. Each value is a FeatureCollection of that one entry's places.
    */
@@ -2758,7 +2768,7 @@ type SandboxInputs = {
  *
  * @ignore
  */
-type GeometriesMeta = {
+export type GeometriesMeta = {
   affectedEntries: AffectedEntry[];
   sourceIds: GeometriesId[];
   skipped: SkippedSource[];
@@ -2769,7 +2779,7 @@ type GeometriesMeta = {
  *
  * @ignore
  */
-type PreparedInputs = {
+export type PreparedInputs = {
   resolved: ResolvedEntries;
   sandbox: SandboxInputs;
   geometries: GeometriesMeta;
@@ -2781,7 +2791,7 @@ type PreparedInputs = {
  *
  * @ignore
  */
-declare const prepareMultiInputs: (ids: MultiInputIds, state: ToolState) => Promise<{
+export declare const prepareMultiInputs: (ids: MultiInputIds, state: ToolState) => Promise<{
   value: PreparedInputs;
 } | {
   error: string;
@@ -2794,11 +2804,11 @@ declare const prepareMultiInputs: (ids: MultiInputIds, state: ToolState) => Prom
  *
  * @ignore
  */
-declare const BY_ENTRY_VIEWS_DOC: string;
+export declare const BY_ENTRY_VIEWS_DOC: string;
 /**
  * @ignore
  */
-declare const routeUtils: {
+export declare const routeUtils: {
   readonly calculateProgressAtRoutePoint: (route: Route, pathIndex: number) => import("@tomtom-org/maps-sdk/core").RouteProgressAtPoint | undefined;
   readonly getCoordinateAtRouteProgress: (route: Route, query: import("@tomtom-org/maps-sdk/core").RouteProgressQuery) => import("@tomtom-org/maps-sdk/core").RouteCoordinateAtProgress | undefined;
   readonly getProgressAtNearestRoutePoint: (route: Route, point: import("@tomtom-org/maps-sdk/core").HasLngLat) => import("@tomtom-org/maps-sdk/core").RouteCoordinateAtProgress | undefined;
@@ -2811,7 +2821,7 @@ declare const routeUtils: {
  *
  * @ignore
  */
-declare const MULTI_INPUT_SANDBOX_PARAMS: readonly ["placesByEntry", "routesByEntry", "incidentsByEntry", "geometriesByEntry", "trafficAreaAnalyticsByEntry", "byodByEntry", "h3", "turf", "routeUtils", "cluster"];
+export declare const MULTI_INPUT_SANDBOX_PARAMS: readonly ["placesByEntry", "routesByEntry", "incidentsByEntry", "geometriesByEntry", "trafficAreaAnalyticsByEntry", "byodByEntry", "h3", "turf", "routeUtils", "cluster"];
 /**
  * Common "tools available in the sandbox" prompt section, shared verbatim by
  * analyseData and processData so the injected-library docs live in ONE place and the
@@ -2825,7 +2835,7 @@ declare const MULTI_INPUT_SANDBOX_PARAMS: readonly ["placesByEntry", "routesByEn
  *
  * @ignore
  */
-declare const buildSandboxToolsDoc: (active: readonly EntryDataKind[], scoped: boolean) => string;
+export declare const buildSandboxToolsDoc: (active: readonly EntryDataKind[], scoped: boolean) => string;
 /**
  * Pack `prepared.sandbox` into the positional argument array expected by
  * `runSandboxedFn`, in the same order as {@link MULTI_INPUT_SANDBOX_PARAMS}.
@@ -2845,7 +2855,7 @@ declare const buildSandboxToolsDoc: (active: readonly EntryDataKind[], scoped: b
  *
  * @ignore
  */
-declare const packSandboxArgs: (sandbox: SandboxInputs, libs: {
+export declare const packSandboxArgs: (sandbox: SandboxInputs, libs: {
   h3: unknown;
   turf: unknown;
 }) => readonly unknown[];
@@ -2856,20 +2866,24 @@ 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
  */
-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
  */
-declare const PLACES_SCHEMA_DOC: string;
+export declare const PLACES_SCHEMA_DOC: string;
 //#endregion
 //#region src/tools/shared/resolve-poi-categories.d.ts
 /** Outcome of {@link resolvePoiCategories}. @ignore */
-type ResolvedPoiCategories = {
+export type ResolvedPoiCategories = {
   /** Final search filter — known codes plus codes resolved from natural-language synonyms. */
   resolved: POICategory[] | undefined;
   /** Inputs that matched neither an exact code nor any synonym. */
@@ -2884,10 +2898,10 @@ type ResolvedPoiCategories = {
  *
  * @ignore
  */
-declare const resolvePoiCategories: (poiCategories: string[] | undefined) => Promise<ResolvedPoiCategories>;
+export declare const resolvePoiCategories: (poiCategories: string[] | undefined, options?: ToolExecuteOptions) => Promise<ResolvedPoiCategories>;
 //#endregion
 //#region src/tools/shared/resolve-range.d.ts
-declare const getRangePolygons: (state: ToolState, rangeId: string) => {
+export declare const getRangePolygons: (state: ToolState, rangeId: string) => {
   polygons: (Polygon | MultiPolygon)[];
 } | {
   error: string;
@@ -2900,21 +2914,21 @@ declare const getRangePolygons: (state: ToolState, rangeId: string) => {
  *
  * @ignore
  */
-declare const positionSchema: z.ZodArray<z.ZodNumber>;
+export declare const positionSchema: z.ZodArray<z.ZodNumber>;
 /** @ignore */
-declare const geoJsonBBoxSchema: z.ZodArray<z.ZodNumber>;
+export declare const geoJsonBBoxSchema: z.ZodArray<z.ZodNumber>;
 /** @ignore */
-declare const polygonInputSchema: z.ZodObject<{
+export declare const polygonInputSchema: z.ZodObject<{
   type: z.ZodLiteral<"Polygon">;
   coordinates: z.ZodArray<z.ZodArray<z.ZodArray<z.ZodNumber>>>;
 }, z.core.$strip>;
 /** @ignore */
-declare const multiPolygonInputSchema: z.ZodObject<{
+export declare const multiPolygonInputSchema: z.ZodObject<{
   type: z.ZodLiteral<"MultiPolygon">;
   coordinates: z.ZodArray<z.ZodArray<z.ZodArray<z.ZodArray<z.ZodNumber>>>>;
 }, z.core.$strip>;
 /** @ignore */
-declare const geometryInputSchema: z.ZodUnion<readonly [z.ZodObject<{
+export declare const geometryInputSchema: z.ZodUnion<readonly [z.ZodObject<{
   type: z.ZodLiteral<"Polygon">;
   coordinates: z.ZodArray<z.ZodArray<z.ZodArray<z.ZodNumber>>>;
 }, z.core.$strip>, z.ZodObject<{
@@ -2929,7 +2943,7 @@ declare const geometryInputSchema: z.ZodUnion<readonly [z.ZodObject<{
  *
  * @ignore
  */
-declare const placesEntryIDsSchema: ({ verb, extra }: {
+export declare const placesEntryIDsSchema: ({ verb, extra }: {
   verb: string;
   extra?: string;
 }) => z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -2939,7 +2953,7 @@ declare const placesEntryIDsSchema: ({ verb, extra }: {
  *
  * @ignore
  */
-declare const routesEntryIDsSchema: ({ verb, extra }: {
+export declare const routesEntryIDsSchema: ({ verb, extra }: {
   verb: string;
   extra?: string;
 }) => z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -2951,7 +2965,7 @@ declare const routesEntryIDsSchema: ({ verb, extra }: {
  *
  * @ignore
  */
-declare const placesEntryIdHintSchema: z.ZodOptional<z.ZodString>;
+export declare const placesEntryIdHintSchema: z.ZodOptional<z.ZodString>;
 /**
  * Reusable `mode` field for show-on-map options that render polygons into an entry's
  * own `GeometriesModule`. Controls how the new polygons combine with what is **already
@@ -2961,7 +2975,7 @@ declare const placesEntryIdHintSchema: z.ZodOptional<z.ZodString>;
  *
  * @ignore
  */
-declare const showModeSchema: z.ZodOptional<z.ZodEnum<{
+export declare const showModeSchema: z.ZodOptional<z.ZodEnum<{
   add: "add";
   replace: "replace";
 }>>;
@@ -2972,7 +2986,7 @@ declare const showModeSchema: z.ZodOptional<z.ZodEnum<{
  *
  * @ignore
  */
-declare const showPlaceGeometriesSchema: z.ZodOptional<z.ZodObject<{
+export declare const showPlaceGeometriesSchema: z.ZodOptional<z.ZodObject<{
   show: z.ZodOptional<z.ZodBoolean>;
   mode: z.ZodOptional<z.ZodEnum<{
     add: "add";
@@ -2992,7 +3006,7 @@ declare const showPlaceGeometriesSchema: z.ZodOptional<z.ZodObject<{
  *
  * @ignore
  */
-declare const geometryDisplayConfigSchema: z.ZodObject<{
+export declare const geometryDisplayConfigSchema: z.ZodObject<{
   theme: z.ZodOptional<z.ZodEnum<{
     filled: "filled";
     outline: "outline";
@@ -3011,9 +3025,9 @@ declare const geometryDisplayConfigSchema: z.ZodObject<{
  *
  * @ignore
  */
-declare const markerTypeSchema: z.ZodEnum<{
-  "base-map": "base-map";
+export declare const markerTypeSchema: z.ZodEnum<{
   pin: "pin";
+  "base-map": "base-map";
   "pin-clustered": "pin-clustered";
   none: "none";
 }>;
@@ -3025,12 +3039,12 @@ declare const markerTypeSchema: z.ZodEnum<{
  *
  * @ignore
  */
-declare const hidePreviousEntriesSchema: (entryNoun: string) => z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>>;
+export declare const hidePreviousEntriesSchema: (entryNoun: string) => z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>>;
 /** @ignore */
-declare const showPlacesSchema: z.ZodObject<{
+export declare const showPlacesSchema: z.ZodObject<{
   markerType: z.ZodEnum<{
-    "base-map": "base-map";
     pin: "pin";
+    "base-map": "base-map";
     "pin-clustered": "pin-clustered";
     none: "none";
   }>;
@@ -3041,7 +3055,7 @@ declare const showPlacesSchema: z.ZodObject<{
   hidePreviousEntries: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>>;
 }, z.core.$strip>;
 /** @ignore */
-declare const shownSchema: z.ZodObject<{
+export declare const shownSchema: z.ZodObject<{
   markerType: z.ZodBoolean;
   zoomMode: z.ZodBoolean;
 }, z.core.$strip>;
@@ -3054,7 +3068,7 @@ declare const shownSchema: z.ZodObject<{
  *
  * @ignore
  */
-declare const showByodSchema: z.ZodObject<{
+export declare const showByodSchema: z.ZodObject<{
   zoomMode: z.ZodEnum<{
     none: "none";
     auto: "auto";
@@ -3062,7 +3076,7 @@ declare const showByodSchema: z.ZodObject<{
   hidePreviousEntries: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>>;
 }, z.core.$strip>;
 /** @ignore */
-declare const shownByodSchema: z.ZodObject<{
+export declare const shownByodSchema: z.ZodObject<{
   zoomMode: z.ZodBoolean;
 }, z.core.$strip>;
 /**
@@ -3070,7 +3084,7 @@ declare const shownByodSchema: z.ZodObject<{
  * `viewport` flag. Spread into each consumer's `z.object({...})`.
  * @ignore
  */
-declare const withinSharedFields: {
+export declare const withinSharedFields: {
   mode: z.ZodLiteral<"within">;
   viewport: z.ZodOptional<z.ZodLiteral<true>>;
 };
@@ -3080,7 +3094,7 @@ declare const withinSharedFields: {
  * postal codes, etc.). Optional everywhere; defaults to `'place'`.
  * @ignore
  */
-declare const queryAsSchema: z.ZodOptional<z.ZodEnum<{
+export declare const queryAsSchema: z.ZodOptional<z.ZodEnum<{
   poi: "poi";
   place: "place";
 }>>;
@@ -3088,7 +3102,7 @@ declare const queryAsSchema: z.ZodOptional<z.ZodEnum<{
  * locatePlace's `within` schema — exactly one of viewport / boundingBox / query / placeId.
  * @ignore
  */
-declare const withinWhereSchema: z.ZodObject<{
+export declare const withinWhereSchema: z.ZodObject<{
   boundingBox: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
   query: z.ZodOptional<z.ZodString>;
   queryAs: z.ZodOptional<z.ZodEnum<{
@@ -3100,7 +3114,7 @@ declare const withinWhereSchema: z.ZodObject<{
   viewport: z.ZodOptional<z.ZodLiteral<true>>;
 }, z.core.$strip>;
 /** @ignore */
-declare const nearbyWhereSchema: z.ZodObject<{
+export declare const nearbyWhereSchema: z.ZodObject<{
   mode: z.ZodLiteral<"nearby">;
   position: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
   viewport: z.ZodOptional<z.ZodLiteral<true>>;
@@ -3112,7 +3126,7 @@ declare const nearbyWhereSchema: z.ZodObject<{
   radiusMeters: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 /** @ignore */
-declare const globalWhereSchema: z.ZodObject<{
+export declare const globalWhereSchema: z.ZodObject<{
   mode: z.ZodLiteral<"global">;
 }, z.core.$strip>;
 /**
@@ -3120,7 +3134,7 @@ declare const globalWhereSchema: z.ZodObject<{
  * discoverPlaces builds its own union in discover-places.ts using the plural-form within schema.
  * @ignore
  */
-declare const whereSchema: z.ZodUnion<readonly [z.ZodObject<{
+export declare const whereSchema: z.ZodUnion<readonly [z.ZodObject<{
   boundingBox: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
   query: z.ZodOptional<z.ZodString>;
   queryAs: z.ZodOptional<z.ZodEnum<{
@@ -3148,7 +3162,7 @@ declare const whereSchema: z.ZodUnion<readonly [z.ZodObject<{
  * Spread into each tool's `z.object({...})` alongside any tool-specific fields.
  * @ignore
  */
-declare const sharedWithinFields: {
+export declare const sharedWithinFields: {
   queries: z.ZodOptional<z.ZodArray<z.ZodObject<{
     query: z.ZodString;
     queryAs: z.ZodOptional<z.ZodEnum<{
@@ -3178,7 +3192,7 @@ declare const sharedWithinFields: {
  * stored isochrones and is resolved caller-side.
  * @ignore
  */
-declare const areaWhereSchema: z.ZodObject<{
+export declare const areaWhereSchema: z.ZodObject<{
   viewport: z.ZodOptional<z.ZodBoolean>;
   boundingBox: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
   queries: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -3202,10 +3216,10 @@ declare const areaWhereSchema: z.ZodObject<{
   }, z.core.$strip>>;
 }, z.core.$strip>;
 /** The `where` fields resolve-where.ts resolves — inferred from {@link areaWhereSchema}. */
-type AreaWhere = z.infer<typeof areaWhereSchema>;
+export type AreaWhere = z.infer<typeof areaWhereSchema>;
 //#endregion
 //#region src/tools/shared/resolve-where.d.ts
-type WhereContext = {
+export type WhereContext = {
   viewport(): {
     bbox?: BBox;
     center?: Position;
@@ -3220,16 +3234,16 @@ type WhereContext = {
     error: string;
   };
 };
-type ResolveAreasOptions = {
+export type ResolveAreasOptions = {
   kind: ResolveKind;
 };
-type ResolveKind = 'within' | 'nearby' | 'global';
-type AreaSource = 'viewport' | 'boundingBox' | 'query' | 'placeId' | 'geometries' | 'route';
-declare function resolveWhere(opts: ResolveAreasOptions, where?: AreaWhere, ctx?: WhereContext): Promise<ResolveError | ResolvedArea[]> | ResolvedBias | Promise<ResolvedBias>;
-declare const resolveWithin: (where: AreaWhere, ctx: WhereContext) => Promise<ResolvedArea[] | ResolveError>;
-declare const resolveNearby: (where: AreaWhere, ctx: WhereContext) => Promise<ResolvedBias>;
-declare const resolveGlobal: () => ResolvedBias;
-type ResolvedArea = {
+export type ResolveKind = 'within' | 'nearby' | 'global';
+export type AreaSource = 'viewport' | 'boundingBox' | 'query' | 'placeId' | 'geometries' | 'route';
+export declare function resolveWhere(opts: ResolveAreasOptions, where?: AreaWhere, ctx?: WhereContext): Promise<ResolveError | ResolvedArea[]> | ResolvedBias | Promise<ResolvedBias>;
+export declare const resolveWithin: (where: AreaWhere, ctx: WhereContext) => Promise<ResolvedArea[] | ResolveError>;
+export declare const resolveNearby: (where: AreaWhere, ctx: WhereContext) => Promise<ResolvedBias>;
+export declare const resolveGlobal: () => ResolvedBias;
+export type ResolvedArea = {
   bbox: BBox;
   polygon?: Polygon | MultiPolygon;
   /** The GROUNDED match label — `freeformAddress, <countryCode>` for a `query` area — i.e. what the
@@ -3241,19 +3255,19 @@ type ResolvedArea = {
    * grounded `label` ("matched"). Absent for non-query sources. */
   query?: string;
 };
-type ResolveError = {
+export type ResolveError = {
   error: string;
 };
-type ResolvedBias = {
+export type ResolvedBias = {
   position?: Position;
   label?: string;
   query?: string;
 };
-type ResolvedAreaDisclosure = {
+export type ResolvedAreaDisclosure = {
   query?: string;
   matched: string;
 };
-declare const isResolveError: (r: unknown) => r is ResolveError;
+export declare const isResolveError: (r: unknown) => r is ResolveError;
 //#endregion
 //#region src/tools/shared/routes-schema-doc.d.ts
 /**
@@ -3265,7 +3279,7 @@ declare const isResolveError: (r: unknown) => r is ResolveError;
  * Only the non-GeoJSON-standard bits are spelled out — `Route` is a LineString Feature.
  */
 /** @ignore */
-declare const ROUTES_SCHEMA_DOC: string;
+export declare const ROUTES_SCHEMA_DOC: string;
 //#endregion
 //#region src/tools/shared/show-byod-on-map.d.ts
 /**
@@ -3276,11 +3290,11 @@ declare const ROUTES_SCHEMA_DOC: string;
  *
  * @ignore
  */
-declare const showByodOnMap: (state: ToolState, byodEntryId: string, show: z.infer<typeof showByodSchema>) => Promise<z.infer<typeof shownByodSchema>>;
+export declare const showByodOnMap: (state: ToolState, byodEntryId: string, show: z.infer<typeof showByodSchema>) => Promise<z.infer<typeof shownByodSchema>>;
 //#endregion
 //#region src/tools/shared/show-entry-geometries.d.ts
 /** @ignore */
-type ShowEntryGeometriesResult = {
+export type ShowEntryGeometriesResult = {
   fetched: number;
   shown: boolean;
 };
@@ -3293,24 +3307,24 @@ type ShowEntryGeometriesResult = {
  *
  * @ignore
  */
-declare const showEntryGeometries: (state: ToolState, placesEntryId: string, config: NonNullable<z.infer<typeof showPlaceGeometriesSchema>>) => Promise<ShowEntryGeometriesResult>;
+export declare const showEntryGeometries: (state: ToolState, placesEntryId: string, config: NonNullable<z.infer<typeof showPlaceGeometriesSchema>>, options?: ToolExecuteOptions) => Promise<ShowEntryGeometriesResult>;
 //#endregion
 //#region src/tools/shared/show-places-on-map.d.ts
 /** @ignore */
-declare const showResultsOnMap: (state: ToolState, placesEntryIds: readonly string[], show: z.infer<typeof showPlacesSchema>) => Promise<z.infer<typeof shownSchema>>;
+export declare const showResultsOnMap: (state: ToolState, placesEntryIds: readonly string[], show: z.infer<typeof showPlacesSchema>) => Promise<z.infer<typeof shownSchema>>;
 //#endregion
 //#region src/tools/shared/tool-state-where-context.d.ts
 /** Adapts the live `ToolState` to the narrow `WhereContext` the resolver depends on. Keeping this
  * mapping in one place is what lets resolveAreas stay testable without a ToolState. */
-declare const toolStateToWhereContext: (state: ToolState) => WhereContext;
+export declare const toolStateToWhereContext: (state: ToolState, options?: ToolExecuteOptions) => WhereContext;
 //#endregion
 //#region src/tools/shared/viewport-bias.d.ts
 /** @ignore */
-declare const MIN_VIEWPORT_BIAS_ZOOM = 6;
+export declare const MIN_VIEWPORT_BIAS_ZOOM = 6;
 /** @ignore */
-declare const getViewportBias: (map: BaseMapState, minZoom?: number) => Position | undefined;
+export declare const getViewportBias: (map: BaseMapState, minZoom?: number) => Position | undefined;
 /** @ignore */
-declare const getViewportBoundingBox: (map: BaseMapState) => BBox;
+export declare const getViewportBoundingBox: (map: BaseMapState) => BBox;
 //#endregion
 //#region src/state/custom-geometries/entry.d.ts
 /**
@@ -3504,7 +3518,7 @@ type DataEntryConfig = {
  *
  * @group Agent Toolkit
  */
-declare const DATA_ENTRY_KIND_TO_SLICE: {
+export declare const DATA_ENTRY_KIND_TO_SLICE: {
   readonly places: "places";
   readonly routes: "routing";
   readonly incidents: "trafficIncidents";
@@ -3533,7 +3547,7 @@ type EntryModeSliceName = { [K in keyof ToolState]: ToolState[K] extends EntryMo
  *
  * @group Agent Toolkit
  */
-declare const ENTRY_MODE_SLICE_NAMES: readonly EntryModeSliceName[];
+export declare const ENTRY_MODE_SLICE_NAMES: readonly EntryModeSliceName[];
 /**
  * State slice that owns a set of "entries" (routes, ranges) where each entry can be hidden
  * individually by id and the slice exposes the currently-shown set. Implemented by
@@ -3769,7 +3783,7 @@ type SystemPromptSectionOverrides = Partial<Record<SystemPromptSection, string>>
  *
  * @group Agent Toolkit
  */
-declare const SYSTEM_PROMPT_SECTIONS: Record<SystemPromptSection, string>;
+export declare const SYSTEM_PROMPT_SECTIONS: Record<SystemPromptSection, string>;
 /**
  * Composes the base system prompt from {@link SYSTEM_PROMPT_SECTIONS}, applying
  * any per-section overrides.
@@ -3795,7 +3809,7 @@ declare const SYSTEM_PROMPT_SECTIONS: Record<SystemPromptSection, string>;
  *
  * @group Agent Toolkit
  */
-declare const composeSystemPrompt: (overrides?: SystemPromptSectionOverrides) => string;
+export declare const composeSystemPrompt: (overrides?: SystemPromptSectionOverrides) => string;
 /**
  * The base system prompt that teaches the LLM how to use the agent toolkit tools.
  *
@@ -3817,7 +3831,7 @@ declare const composeSystemPrompt: (overrides?: SystemPromptSectionOverrides) =>
  *
  * @group Agent Toolkit
  */
-declare const BASE_SYSTEM_PROMPT: string;
+export declare const BASE_SYSTEM_PROMPT: string;
 /**
  * Inputs to {@link buildSystemPrompt}.
  *
@@ -3852,7 +3866,7 @@ type BuildSystemPromptOptions = {
  * @internal
  * @ignore
  */
-declare const buildSystemPrompt: ({ customPrompt, prefix, suffix }?: BuildSystemPromptOptions) => string;
+export declare const buildSystemPrompt: ({ customPrompt, prefix, suffix }?: BuildSystemPromptOptions) => string;
 //#endregion
 //#region src/tools/tool-registry.d.ts
 /**
@@ -3865,7 +3879,7 @@ declare const buildSystemPrompt: ({ customPrompt, prefix, suffix }?: BuildSystem
  *
  * @group Agent Toolkit
  */
-declare const DEFAULT_TOOLS: {
+export declare const DEFAULT_TOOLS: {
   locatePlace: ToolDefinition;
   reverseGeocode: ToolDefinition;
   discoverPlaces: ToolDefinition;
@@ -3904,6 +3918,8 @@ declare const DEFAULT_TOOLS: {
   setLanguage: ToolDefinition;
   toggleTilesBaseMapLayerGroups: ToolDefinition;
   toggleTilesPOIs: ToolDefinition;
+  describeMapStyling: ToolDefinition;
+  setMapStyling: ToolDefinition;
   toggleTilesTrafficFlow: ToolDefinition;
   toggleTilesTrafficIncidents: ToolDefinition;
   getMapStyleLayers: ToolDefinition;
@@ -3932,7 +3948,7 @@ type ToolName = keyof typeof DEFAULT_TOOLS;
  *
  * @group Agent Toolkit
  */
-declare const TOOL_NAMES: ToolName[];
+export declare const TOOL_NAMES: ToolName[];
 /**
  * Default tool names that should be dropped from the registry when a {@link DataEntryKind}
  * is disabled. Only default-tool names are listed here — user-supplied custom tools are
@@ -3944,7 +3960,7 @@ declare const TOOL_NAMES: ToolName[];
  *
  * @group Agent Toolkit
  */
-declare const TOOLS_BY_DATA_ENTRY_KIND: Record<DataEntryKind, readonly ToolName[]>;
+export declare const TOOLS_BY_DATA_ENTRY_KIND: Record<DataEntryKind, readonly ToolName[]>;
 /**
  * Returns each default tool's `examplePrompts` keyed by tool name. Builders are
  * materialised with empty {@link ToolBuildOptions} so the prompts reflect the
@@ -3955,7 +3971,7 @@ declare const TOOLS_BY_DATA_ENTRY_KIND: Record<DataEntryKind, readonly ToolName[
  *
  * @group Agent Toolkit
  */
-declare const getDefaultToolPrompts: () => Record<ToolName, readonly string[]>;
+export declare const getDefaultToolPrompts: () => Record<ToolName, readonly string[]>;
 //#endregion
 //#region src/utils/types/intent-classifier.d.ts
 /**
@@ -4025,14 +4041,14 @@ type ConversationMessage = {
  *
  * @group Agent Toolkit
  */
-declare const classifyUserIntent: (conversation: ConversationMessage[], options: ClassifierOptions) => Promise<ClassificationResult>;
+export declare const classifyUserIntent: (conversation: ConversationMessage[], options: ClassifierOptions) => Promise<ClassificationResult>;
 /**
  * Extracts the text content of the last user message in a message array.
  * Returns null if no user message is found or if content has no text.
  *
  * @group Agent Toolkit
  */
-declare const extractLastUserText: (messages: ReadonlyArray<ModelMessage>) => string | null;
+export declare const extractLastUserText: (messages: ReadonlyArray<ModelMessage>) => string | null;
 /**
  * Creates the default LLM-based classifier. Uses structured generation to select
  * the minimal tool set for each user message.
@@ -4043,7 +4059,7 @@ declare const extractLastUserText: (messages: ReadonlyArray<ModelMessage>) => st
  *
  * @group Agent Toolkit
  */
-declare const createDefaultClassifier: (options: {
+export declare const createDefaultClassifier: (options: {
   model: LanguageModel;
   maxHistoryMessages?: number;
   maxHistoryMessageLength?: number;
@@ -4060,7 +4076,7 @@ type ProviderOptions = Record<string, Record<string, JSONValue | undefined>>;
  *
  * @group Agent Toolkit
  */
-type ToolNameHint = ToolName | (string & {});
+export type ToolNameHint = ToolName | (string & {});
 /**
  * Tool-facing union of state slices that own analysable entries — the
  * vocabulary used by tools that read from multiple slices (`analyseData`,
@@ -4075,7 +4091,7 @@ type ToolNameHint = ToolName | (string & {});
  *
  * @group Agent Toolkit
  */
-type EntryDataKind = 'places' | 'routes' | 'incidents' | 'customGeometries' | 'trafficAreaAnalytics' | 'byod';
+export type EntryDataKind = 'places' | 'routes' | 'incidents' | 'customGeometries' | 'trafficAreaAnalytics' | 'byod';
 /**
  * State passed to tool factory functions. Organized by feature area,
  * each sub-state mixes lazy module access with the current service data
@@ -4096,7 +4112,7 @@ type EntryDataKind = 'places' | 'routes' | 'incidents' | 'customGeometries' | 't
  * }
  * ```
  */
-type ToolState = {
+export type ToolState = {
   /** Places layer: PlacesModule plus an append-only search history. */
   places: PlacesState;
   /** Map POI layer: visibility, filtering, and category management. */
@@ -4153,7 +4169,7 @@ type ToolState = {
  *
  * @group Agent Toolkit
  */
-type CodeExecutionConfig = {
+export type CodeExecutionConfig = {
   /** Wall-clock budget per isolated (browser) run, in ms. Default: 5000. */
   timeoutMs?: number;
   /**
@@ -4164,6 +4180,23 @@ type CodeExecutionConfig = {
    */
   loadWorkerLibrarySource?: () => string | Promise<string>;
 };
+/**
+ * Per-call options handed to a tool's `execute`, separate from its parsed input.
+ *
+ * `signal` is the AI SDK's own `abortSignal` for the tool call — it fires when the model's
+ * turn is cancelled. Forward it to any `@tomtom-org/maps-sdk/services` call the tool makes
+ * (as `signal`) so a cancelled turn also cancels its in-flight HTTP requests.
+ *
+ * Do NOT forward it into work that outlives the turn — a monitor's recurring tick, or any
+ * deferred job. Those fire after the signal has aborted, and a monitor treats a rejected tick
+ * as fatal (it clears its own interval), so a leaked signal kills the monitor rather than
+ * cancelling a request.
+ *
+ * @group Agent Toolkit
+ */
+export type ToolExecuteOptions = {
+  signal?: AbortSignal;
+};
 /**
  * A tool definition — the universal format for both built-in and third-party tools.
  * Combines execution (inputSchema + execute) with classifier metadata.
@@ -4177,7 +4210,7 @@ type CodeExecutionConfig = {
  *
  * @group Agent Toolkit
  */
-type ToolEntry<S extends ToolState = ToolState, Scope = unknown> = {
+export type ToolEntry<S extends ToolState = ToolState, Scope = unknown> = {
   /** Description of the tool's purpose. */
   description: string;
   /** Zod schema defining the tool's input parameters. */
@@ -4193,7 +4226,7 @@ type ToolEntry<S extends ToolState = ToolState, Scope = unknown> = {
    * This tags the request so TomTom's traffic analytics attribute it to agent-toolkit; an
    * untagged call is picked up by the guard test in `tools/shared/tests/agent-headers.test.ts`.
    */
-  execute: (input: any, state: S) => Promise<any>;
+  execute: (input: any, state: S, options?: ToolExecuteOptions) => Promise<any>;
   /** Compact one-liner for the intent classifier prompt. */
   classificationPrompt?: string;
   /** Category tags (e.g. 'location', 'routing'). */
@@ -4243,7 +4276,7 @@ type ToolEntry<S extends ToolState = ToolState, Scope = unknown> = {
  *
  * @group Agent Toolkit
  */
-type ToolMetadata = {
+export type ToolMetadata = {
   /** Tool identifier, derived from the config key. */
   name: string;
   /** Description of the tool's purpose. Used by the SDK's system prompt. */
@@ -4272,7 +4305,7 @@ type ToolMetadata = {
  *
  * @group Agent Toolkit
  */
-type ClassifierContext = {
+export type ClassifierContext = {
   /** Full message history for the current conversation. */
   messages: ReadonlyArray<ModelMessage>;
   /** Metadata for all registered tools. */
@@ -4284,7 +4317,7 @@ type ClassifierContext = {
  *
  * @group Agent Toolkit
  */
-type Classifier = (context: ClassifierContext) => Promise<ClassificationResult | null>;
+export type Classifier = (context: ClassifierContext) => Promise<ClassificationResult | null>;
 /**
  * Feature-flag bag for {@link createMapAgent}. Toggles in-flight or
  * opt-in agent-toolkit behaviour. Individual flags vary in stability —
@@ -4296,23 +4329,16 @@ type Classifier = (context: ClassifierContext) => Promise<ClassificationResult |
  *
  * @group Agent Toolkit
  */
-type FeatureFlags = {
+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
@@ -4325,7 +4351,7 @@ type FeatureFlags = {
  *
  * @group Agent Toolkit
  */
-type ToolBuildOptions<Scope = unknown> = {
+export type ToolBuildOptions<Scope = unknown> = {
   /** Active feature flags. */
   featureFlags?: FeatureFlags;
   /**
@@ -4356,7 +4382,7 @@ type ToolBuildOptions<Scope = unknown> = {
  *
  * @group Agent Toolkit
  */
-type ToolEntryBuilder<S extends ToolState = ToolState, Scope = unknown> = (options: ToolBuildOptions<Scope>) => ToolEntry<S, Scope>;
+export type ToolEntryBuilder<S extends ToolState = ToolState, Scope = unknown> = (options: ToolBuildOptions<Scope>) => ToolEntry<S, Scope>;
 /**
  * A registered tool definition: either a static {@link ToolEntry} or a
  * {@link ToolEntryBuilder} that builds one from {@link ToolBuildOptions} at
@@ -4369,13 +4395,13 @@ type ToolEntryBuilder<S extends ToolState = ToolState, Scope = unknown> = (optio
  *
  * @group Agent Toolkit
  */
-type ToolDefinition<S extends ToolState = ToolState, Scope = any> = ToolEntry<S, Scope> | ToolEntryBuilder<S, Scope>;
+export type ToolDefinition<S extends ToolState = ToolState, Scope = any> = ToolEntry<S, Scope> | ToolEntryBuilder<S, Scope>;
 /**
  * Per-tool execution outcome reported to {@link MapAgentOptions.onToolExecute}.
  *
  * @group Agent Toolkit
  */
-type ToolExecutionInfo = {
+export type ToolExecutionInfo = {
   /** Registered tool name (the `defaultTools` key). */
   toolName: string;
   /** Wall-clock duration of `execute`, in milliseconds (includes any network/IO). */
@@ -4390,7 +4416,7 @@ type ToolExecutionInfo = {
  *
  * @group Agent Toolkit
  */
-type OnToolExecute = (info: ToolExecutionInfo) => void;
+export type OnToolExecute = (info: ToolExecutionInfo) => void;
 /**
  * Options for creating an agent toolkit.
  *
@@ -4410,7 +4436,7 @@ type OnToolExecute = (info: ToolExecutionInfo) => void;
  * });
  * ```
  */
-type MapAgentOptions<CS extends ToolState = ToolState> = {
+export type MapAgentOptions<CS extends ToolState = ToolState> = {
   /** AI SDK language model instance. REQUIRED — no default provider. */
   model: LanguageModel;
   /**
@@ -4614,7 +4640,7 @@ type MapAgentOptions<CS extends ToolState = ToolState> = {
  *
  * @group Agent Toolkit
  */
-type MapAgentInstance<CS extends ToolState = ToolState> = ToolLoopAgent & {
+export type MapAgentInstance<CS extends ToolState = ToolState> = ToolLoopAgent & {
   /** Live agent state (built-in + custom slices). */
   readonly state: CS;
   /** Tear down: resets all state slices that have a reset() method. */
@@ -4659,7 +4685,7 @@ type MapAgentInstance<CS extends ToolState = ToolState> = ToolLoopAgent & {
  * ```
  * @group Agent Toolkit
  */
-declare const createMapAgent: <CS extends ToolState = ToolState>(map: TomTomMap, options: MapAgentOptions<CS>) => MapAgentInstance<CS>;
+export declare const createMapAgent: <CS extends ToolState = ToolState>(map: TomTomMap, options: MapAgentOptions<CS>) => MapAgentInstance<CS>;
 //#endregion
 //#region src/resolve-tools.d.ts
 /**
@@ -4679,11 +4705,11 @@ declare const createMapAgent: <CS extends ToolState = ToolState>(map: TomTomMap,
  *
  * @group Agent Toolkit
  */
-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?: { [K in ToolNameHint]?: ToolEntry<S> | false | undefined; }) => 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. */
-declare const questionSchema: z.ZodObject<{
+export declare const questionSchema: z.ZodObject<{
   id: z.ZodString;
   question: z.ZodString;
   options: z.ZodArray<z.ZodString>;
@@ -4694,7 +4720,7 @@ type ClarifyIntentQuestion = z.infer<typeof questionSchema>;
 /**
  * Input schema for {@link executeClarifyIntent}.
  */
-declare const clarifyIntentSchema: z.ZodObject<{
+export declare const clarifyIntentSchema: z.ZodObject<{
   intro: z.ZodOptional<z.ZodString>;
   questions: z.ZodArray<z.ZodObject<{
     id: z.ZodString;
@@ -4710,7 +4736,7 @@ declare const clarifyIntentSchema: z.ZodObject<{
  * (CLARIFY_FORM_PROMPT and CLARIFY_PROSE_PROMPT both tell the agent to STOP and wait), so repeating it
  * in the result would be redundant.
  */
-declare const clarifyIntentOutputSchema: z.ZodObject<{
+export declare const clarifyIntentOutputSchema: z.ZodObject<{
   status: z.ZodLiteral<"awaiting_user_response">;
   intro: z.ZodOptional<z.ZodString>;
   questions: z.ZodArray<z.ZodObject<{
@@ -4721,9 +4747,9 @@ declare const clarifyIntentOutputSchema: z.ZodObject<{
   }, z.core.$strip>>;
 }, z.core.$strip>;
 /** Usage contract appended to the description when the host renders the form: silent turn, questions not restated in prose. */
-declare const CLARIFY_FORM_PROMPT: string;
+export declare const CLARIFY_FORM_PROMPT: string;
 /** Usage contract appended to the description when there is no form: the model also writes the questions as prose so any UI shows them. */
-declare const CLARIFY_PROSE_PROMPT: string;
+export declare const CLARIFY_PROSE_PROMPT: string;
 /** Per-call overrides accepted by {@link createClarifyIntentTool}. */
 type ClarifyIntentToolOptions = {
   /** Replace the default tool description (e.g. add domain-specific guidance). */
@@ -4762,6 +4788,6 @@ type ClarifyIntentToolOptions = {
  * });
  * ```
  */
-declare const createClarifyIntentTool: (options?: ClarifyIntentToolOptions) => ToolEntry;
+export declare const createClarifyIntentTool: (options?: ClarifyIntentToolOptions) => ToolEntry;
 //#endregion
-export { AGENT_TOOLKIT_ID, AGENT_TOOLKIT_USER_AGENT, ALL_ENTRY_DATA_KINDS, ANALYSE_OUTPUT_FORMAT_DESCRIPTION, AREA_GEOGRAPHY_TYPES, AffectedEntry, type AnalysesEvents, AnalysisOutputFormat, type AnalysisRecord, AreaSource, AreaWhere, BASE_SYSTEM_PROMPT, type BYODAnalysis, type BYODDataProfile, type BYODEntry, type BYODPropertyProfile, type BYODSource, BY_ENTRY_VIEWS_DOC, type ByodSourceUrlValidation, type ByodSourceUrlValidator, CHART_TYPES, CLARIFY_FORM_PROMPT, CLARIFY_PROSE_PROMPT, type ClarifyIntentQuestion, type ClarifyIntentToolOptions, type ClassificationResult, Classifier, ClassifierContext, type ClassifierOptions, type ClusterResult, type ClusterTrend, type ClusteringOutput, type ClusteringParams, CodeExecutionConfig, CollectedGeometries, type CustomGeometriesAnalysis, type CustomGeometriesEntry, DATA_ENTRY_KIND_TO_SLICE, DEFAULT_TOOLS, type DataEntryConfig, type DataEntryKind, ENTRY_KIND_META, ENTRY_MODE_SLICE_NAMES, type EntryAnalysis, EntryDataKind, EntryKindMeta, EntryKindScope, type EntryMode, type EntryModeSlice, type EntryModeSliceName, FIT_ON_MAP_DOC, FeatureFlags, FitOnMapInput, GEOMETRIES_PROPS_DOC, GEOMETRIES_SCHEMA_DOC, GEOMETRIES_SKIPPED_DESC, GEOMETRIES_SOURCE_IDS_DESC, GeometriesId, GeometriesIdKind, GeometriesMeta, type GeometryProvenance, type IncidentSnapshot, type IncidentsAnalysis, LocateBias, LocationInput, MIN_VIEWPORT_BIAS_ZOOM, MULTI_INPUT_SANDBOX_PARAMS, MapAgentInstance, MapAgentOptions, type MemberRef, type MonitoredArea, MultiInputIds, OnToolExecute, PLACES_SCHEMA_DOC, type PlacesAnalysis, type PlacesEntry, type PollingStatus, PreparedInputs, QueryAs, ROUTES_SCHEMA_DOC, type RangesEntry, type ReachableRange, ResolveAreasOptions, ResolveError, ResolveKind, ResolvedArea, ResolvedAreaDisclosure, ResolvedBias, ResolvedEntries, ResolvedLocation, ResolvedPoiCategories, type RouteParams, type RoutesAnalysis, type RoutesEntry, SYSTEM_PROMPT_SECTIONS, SandboxExecutor, SandboxInputs, ShowEntryGeometriesResult, SkippedSource, type StateDigest, StateSlice, type SystemPromptSection, type SystemPromptSectionOverrides, TOOLS_BY_DATA_ENTRY_KIND, TOOL_NAMES, ToolBuildOptions, ToolDefinition, ToolEntry, ToolEntryBuilder, ToolExecutionInfo, ToolMetadata, type ToolName, ToolNameHint, ToolState, type Tracker, type TrackerEvent, type TrackerEventStatus, type TrackerEventType, type TrackerStateEvents, type TrafficAreaAnalyticsAnalysis, type TrafficAreaAnalyticsEntry, type TrafficAreaAnalyticsParams, type TrafficIncidentsEntry, type Verdict, WORKER_PROVIDED_PARAMS, WhereContext, applyFitOnMap, areaWhereSchema, buildAnalyseReturnPrompt, buildAtLeastOneEntryIdMessage, buildEntryFieldList, buildEntryIdFields, buildEntryKindSandboxDocs, buildEntryKindSchemaDocs, buildEntryKindScopeSchema, buildPlacesSchemaDoc, buildSandboxCodePrompt, buildSandboxToolsDoc, buildSystemPrompt, clarifyIntentOutputSchema, clarifyIntentSchema, classifyUserIntent, collectInputGeometries, composeSystemPrompt, createClarifyIntentTool, createDefaultClassifier, createMapAgent, extractLastUserText, findPlacesByEntry, fitOnMapInputSchema, fittedReportSchema, formatSandboxExecutionError, formatStateDigestDiff, geoJsonBBoxSchema, geocodeAreas, geometriesEntryIDsSchema, geometriesIdSchema, geometryDisplayConfigSchema, geometryInputSchema, getDefaultToolPrompts, getRangePolygons, getStateDigest, getViewportBias, getViewportBoundingBox, globalWhereSchema, hasAnyEntryIds, hidePreviousEntriesSchema, hidePreviousShownEntries, isChartConfiguration, isFitOnMapInput, isKindActive, isPolygonFeature, isPolygonFeatureArray, isResolveError, latestTimestamp, locatePlace, locatePlaces, locationInputSchema, mainThreadExecutor, markerTypeSchema, multiPolygonInputSchema, nearbyWhereSchema, packSandboxArgs, placesEntryIDsSchema, placesEntryIdHintSchema, polygonInputSchema, positionSchema, prepareMultiInputs, queryAsSchema, questionSchema, resolveActiveKinds, resolveGlobal, resolveNearby, resolvePoiCategories, resolveTools, resolveWhere, resolveWithin, routeUtils, routesEntryIDsSchema, runSandboxedFn, sandboxedGlobalShadows, sharedWithinFields, showByodOnMap, showByodSchema, showEntryGeometries, showModeSchema, showPlaceGeometriesSchema, showPlacesSchema, showResultsOnMap, shownByodSchema, shownSchema, skippedSourceSchema, stripInjectedRedeclarations, toolStateToWhereContext, validateAnalysisResult, whereSchema, withAgentToolkitHeaders, withinSharedFields, withinWhereSchema };
+export type { AnalysesEvents, AnalysisRecord, BYODAnalysis, BYODDataProfile, BYODEntry, BYODPropertyProfile, BYODSource, ByodSourceUrlValidation, ByodSourceUrlValidator, ClarifyIntentQuestion, ClarifyIntentToolOptions, ClassificationResult, ClassifierOptions, ClusterResult, ClusterTrend, ClusteringOutput, ClusteringParams, CustomGeometriesAnalysis, CustomGeometriesEntry, DataEntryConfig, DataEntryKind, EntryAnalysis, EntryMode, EntryModeSlice, EntryModeSliceName, GeometryProvenance, IncidentSnapshot, IncidentsAnalysis, MemberRef, MonitoredArea, PlacesAnalysis, PlacesEntry, PollingStatus, RangesEntry, ReachableRange, RouteParams, RoutesAnalysis, RoutesEntry, StateDigest, SystemPromptSection, SystemPromptSectionOverrides, ToolName, Tracker, TrackerEvent, TrackerEventStatus, TrackerEventType, TrackerStateEvents, TrafficAreaAnalyticsAnalysis, TrafficAreaAnalyticsEntry, TrafficAreaAnalyticsParams, TrafficIncidentsEntry, Verdict };