@arcgis/ai-agents 5.0.0-next.133

package/LICENSE.md

@@ -0,0 +1,17 @@
+# Licensing
+
+COPYRIGHT © Esri
+
+All rights reserved under the copyright laws of the United States and applicable international laws, treaties, and conventions.
+
+This material is licensed for use under the [Esri Master License Agreement (MLA)](https://www.esri.com/content/dam/esrisites/en-us/media/legal/ma-full/ma-full.pdf), and is bound by the terms of that agreement.
+You may redistribute and use this code without modification, provided you adhere to the terms of the MLA and include this copyright notice.
+
+For additional information, contact:
+Environmental Systems Research Institute, Inc.
+Attn: Contracts and Legal Services Department
+380 New York Street
+Redlands, California, USA 92373
+USA
+
+email: legal@esri.com

package/README.md

@@ -0,0 +1,11 @@
+# ArcGIS Maps SDK for JavaScript - AI Agents package (beta)
+
+**No Esri Technical Support included.**
+
+The ArcGIS Maps SDK for JavaScript provides a suite of ready-to-use UI components that simplify the process of creating GIS web applications. This package contains **AI agents** with functionality made possible through the SDK's core API which is also accessible through the components.
+
+## License
+
+COPYRIGHT © Esri
+
+This package is licensed under the terms described in the `LICENSE.md` file, located in the root of the package.

package/dist/agents/dataExploration/context/dataExplorationContext.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Context required by the Data Exploration agent.
+ * Supplied by the application via an agent `getContext()` provider.
+ */
+export type DataExplorationContext = {
+    mapView: __esri.MapView;
+};
+export declare const dataExplorationContextRequiredKeys: readonly ["mapView"];

package/dist/agents/dataExploration/context/getDataExplorationContext.d.ts

@@ -0,0 +1,3 @@
+import { RunnableConfig } from '@langchain/core/runnables';
+import { DataExplorationContext } from './dataExplorationContext';
+export declare function getDataExplorationContext(config?: RunnableConfig): DataExplorationContext;

package/dist/agents/dataExploration/graph/dataExplorationGraph.d.ts

@@ -0,0 +1,8 @@
+import { StateGraph } from '@langchain/langgraph/web';
+import { AgentRegistration } from '@arcgis/ai-orchestrator';
+import { DataExplorationGraphStateType } from '../state/dataExplorationState';
+/**
+ * Builds the Data Exploration Agent graph (intent classification + tool execution).
+ */
+export declare const createDataExplorationAgentGraph: () => StateGraph<DataExplorationGraphStateType>;
+export declare const DataExplorationAgent: AgentRegistration;

package/dist/agents/dataExploration/index.d.ts

@@ -0,0 +1,2 @@
+export { DataExplorationAgent } from './graph/dataExplorationGraph';
+export type { DataExplorationContext } from './context/dataExplorationContext';

package/dist/agents/dataExploration/nodes/dataExplorationExit.d.ts

@@ -0,0 +1,3 @@
+import { RunnableConfig } from '@langchain/core/runnables';
+import { DataExplorationGraphStateType } from '../state/dataExplorationState';
+export declare const DataExplorationExit: (state: DataExplorationGraphStateType, config?: RunnableConfig) => Promise<typeof state>;

package/dist/agents/dataExploration/nodes/fieldStatistics.d.ts

@@ -0,0 +1,3 @@
+import { RunnableConfig } from '@langchain/core/runnables';
+import { DataExplorationGraphStateType } from '../state/dataExplorationState';
+export declare const fieldStatistics: (state: DataExplorationGraphStateType, config?: RunnableConfig) => Promise<DataExplorationGraphStateType>;

package/dist/agents/dataExploration/nodes/layerFilterLLM.d.ts

@@ -0,0 +1,3 @@
+import { RunnableConfig } from '@langchain/core/runnables';
+import { DataExplorationGraphStateType } from '../state/dataExplorationState';
+export declare const layerFilterLLM: (state: DataExplorationGraphStateType, config?: RunnableConfig) => Promise<DataExplorationGraphStateType>;

package/dist/agents/dataExploration/nodes/layerFilterToolCalling.d.ts

@@ -0,0 +1,3 @@
+import { RunnableConfig } from '@langchain/core/runnables';
+import { DataExplorationGraphStateType } from '../state/dataExplorationState';
+export declare function layerFilterToolCalling(state: DataExplorationGraphStateType, config?: RunnableConfig): Promise<DataExplorationGraphStateType>;

package/dist/agents/dataExploration/nodes/layerQueryLLM.d.ts

@@ -0,0 +1,3 @@
+import { RunnableConfig } from '@langchain/core/runnables';
+import { DataExplorationGraphStateType } from '../state/dataExplorationState';
+export declare const layerQueryLLM: (state: DataExplorationGraphStateType, config?: RunnableConfig) => Promise<DataExplorationGraphStateType>;

package/dist/agents/dataExploration/nodes/layerQueryToolCalling.d.ts

@@ -0,0 +1,3 @@
+import { RunnableConfig } from '@langchain/core/runnables';
+import { DataExplorationGraphStateType } from '../state/dataExplorationState';
+export declare function layerQueryToolCalling(state: DataExplorationGraphStateType, config?: RunnableConfig): Promise<DataExplorationGraphStateType>;

package/dist/agents/dataExploration/nodes/requireDataExplorationServices.d.ts

@@ -0,0 +1,7 @@
+import { RunnableConfig } from '@langchain/core/runnables';
+import { DataExplorationGraphStateType } from '../state/dataExplorationState';
+/**
+ * Entry guard for Data Exploration Agent.
+ * Ensures layerSearch + fieldSearch + layersAndFieldsRegistry services are available.
+ */
+export declare const requireDataExplorationServices: (state: DataExplorationGraphStateType, config?: RunnableConfig) => typeof state;

package/dist/agents/dataExploration/nodes/summarizeQueryResponseLLM.d.ts

@@ -0,0 +1,3 @@
+import { RunnableConfig } from '@langchain/core/runnables';
+import { DataExplorationGraphStateType } from '../state/dataExplorationState';
+export declare const summarizeQueryResponseLLM: (state: DataExplorationGraphStateType, config?: RunnableConfig) => Promise<DataExplorationGraphStateType>;

package/dist/agents/dataExploration/nodes/vectorSearchFields.d.ts

@@ -0,0 +1,3 @@
+import { RunnableConfig } from '@langchain/core/runnables';
+import { DataExplorationGraphStateType } from '../state/dataExplorationState';
+export declare const vectorSearchFields: (state: DataExplorationGraphStateType, config?: RunnableConfig) => Promise<DataExplorationGraphStateType>;

package/dist/agents/dataExploration/nodes/vectorSearchLayers.d.ts

@@ -0,0 +1,3 @@
+import { RunnableConfig } from '@langchain/core/runnables';
+import { DataExplorationGraphStateType } from '../state/dataExplorationState';
+export declare const vectorSearchLayers: (state: DataExplorationGraphStateType, config?: RunnableConfig) => Promise<DataExplorationGraphStateType>;

package/dist/agents/dataExploration/state/dataExplorationState.d.ts

@@ -0,0 +1,12 @@
+import { ChatHistory, VectorSearchFieldResults } from '@arcgis/ai-orchestrator';
+import { QueryResponse } from '../types/types';
+import { LayerFieldInfo } from '../../../types/types';
+export declare const DataExplorationState: import('@langchain/langgraph/web').AnnotationRoot<{
+    messages: import('@langchain/langgraph/web').BinaryOperatorAggregate<ChatHistory, ChatHistory>;
+    outputMessage: import('@langchain/langgraph/web').BinaryOperatorAggregate<string, string>;
+    vectorSearchLayerIds: import('@langchain/langgraph/web').LastValue<string[]>;
+    vectorSearchFieldResults: import('@langchain/langgraph/web').LastValue<VectorSearchFieldResults>;
+    layerFieldInfo: import('@langchain/langgraph/web').LastValue<LayerFieldInfo>;
+    queryResponse: import('@langchain/langgraph/web').LastValue<QueryResponse[]>;
+}>;
+export type DataExplorationGraphStateType = typeof DataExplorationState.State;

package/dist/agents/dataExploration/tools/filterTools/setDefinitionExpression/adapter.d.ts

@@ -0,0 +1,22 @@
+import { RunnableConfig } from '@langchain/core/runnables';
+import { default as z } from 'zod';
+export declare const setDefinitionExpressionWrapper: ({ layerId, definitionExpression, }: {
+    layerId: string;
+    definitionExpression: string;
+}, config?: RunnableConfig) => Promise<string>;
+export declare const setDefinitionExpressionTool: import('@langchain/core/tools').DynamicStructuredTool<z.ZodObject<{
+    layerId: z.ZodString;
+    definitionExpression: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    layerId: string;
+    definitionExpression: string;
+}, {
+    layerId: string;
+    definitionExpression: string;
+}>, {
+    layerId: string;
+    definitionExpression: string;
+}, {
+    layerId: string;
+    definitionExpression: string;
+}, string>;

package/dist/agents/dataExploration/tools/filterTools/setDefinitionExpression/core.d.ts

@@ -0,0 +1 @@
+export declare const setDefinitionExpression: (layerId: string, definitionExpression: string, arcgisMapView: __esri.MapView) => Promise<string>;

package/dist/agents/dataExploration/tools/filterTools/setDefinitionExpression/index.d.ts

@@ -0,0 +1 @@
+export * from './adapter';

package/dist/agents/dataExploration/tools/filterTools/setFeatureEffect/adapter.d.ts

@@ -0,0 +1,99 @@
+import { RunnableConfig } from '@langchain/core/runnables';
+import { default as z } from 'zod';
+import { distanceUnitsSchema } from '../../../types/types';
+export declare const setFeatureEffectWrapper: ({ targetLayer, geometryLayer, includedEffect, excludedEffect, }: {
+    targetLayer: {
+        layerId: string;
+        where: string;
+    };
+    geometryLayer?: {
+        layerId: string;
+        where: string;
+        distance: number;
+        units: typeof distanceUnitsSchema._type;
+    };
+    includedEffect?: string;
+    excludedEffect?: string;
+}, config?: RunnableConfig) => Promise<string>;
+export declare const setFeatureEffectTool: import('@langchain/core/tools').DynamicStructuredTool<z.ZodObject<{
+    targetLayer: z.ZodObject<{
+        layerId: z.ZodString;
+        where: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        where: string;
+        layerId: string;
+    }, {
+        where: string;
+        layerId: string;
+    }>;
+    geometryLayer: z.ZodOptional<z.ZodObject<{
+        layerId: z.ZodString;
+        where: z.ZodString;
+        distance: z.ZodNumber;
+        units: z.ZodEnum<["feet", "kilometers", "meters", "miles", "nautical-miles", "us-nautical-miles"]>;
+    }, "strip", z.ZodTypeAny, {
+        distance: number;
+        units: "feet" | "miles" | "nautical-miles" | "us-nautical-miles" | "meters" | "kilometers";
+        where: string;
+        layerId: string;
+    }, {
+        distance: number;
+        units: "feet" | "miles" | "nautical-miles" | "us-nautical-miles" | "meters" | "kilometers";
+        where: string;
+        layerId: string;
+    }>>;
+    includedEffect: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    excludedEffect: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    includedEffect: string;
+    excludedEffect: string;
+    targetLayer: {
+        where: string;
+        layerId: string;
+    };
+    geometryLayer?: {
+        distance: number;
+        units: "feet" | "miles" | "nautical-miles" | "us-nautical-miles" | "meters" | "kilometers";
+        where: string;
+        layerId: string;
+    } | undefined;
+}, {
+    targetLayer: {
+        where: string;
+        layerId: string;
+    };
+    includedEffect?: string | undefined;
+    excludedEffect?: string | undefined;
+    geometryLayer?: {
+        distance: number;
+        units: "feet" | "miles" | "nautical-miles" | "us-nautical-miles" | "meters" | "kilometers";
+        where: string;
+        layerId: string;
+    } | undefined;
+}>, {
+    targetLayer: {
+        layerId: string;
+        where: string;
+    };
+    geometryLayer?: {
+        layerId: string;
+        where: string;
+        distance: number;
+        units: typeof distanceUnitsSchema._type;
+    };
+    includedEffect?: string;
+    excludedEffect?: string;
+}, {
+    targetLayer: {
+        where: string;
+        layerId: string;
+    };
+    includedEffect?: string | undefined;
+    excludedEffect?: string | undefined;
+    geometryLayer?: {
+        distance: number;
+        units: "feet" | "miles" | "nautical-miles" | "us-nautical-miles" | "meters" | "kilometers";
+        where: string;
+        layerId: string;
+    } | undefined;
+}, string>;

package/dist/agents/dataExploration/tools/filterTools/setFeatureEffect/core.d.ts

@@ -0,0 +1,5 @@
+import { GeometryLayerConfig } from '../../../types/types';
+export declare const setFeatureEffect: (targetLayer: {
+    layerId: string;
+    where: string;
+}, arcgisMapView: __esri.MapView, includedEffect: string, excludedEffect: string, geometryLayer?: GeometryLayerConfig) => Promise<string>;

package/dist/agents/dataExploration/tools/filterTools/setFeatureEffect/index.d.ts

@@ -0,0 +1 @@
+export * from './adapter';

package/dist/agents/dataExploration/tools/filterTools/setFeatureFilter/adapter.d.ts

@@ -0,0 +1,87 @@
+import { RunnableConfig } from '@langchain/core/runnables';
+import { default as z } from 'zod';
+import { distanceUnitsSchema } from '../../../types/types';
+export declare const setFeatureFilterWrapper: ({ targetLayer, geometryLayer, }: {
+    targetLayer: {
+        layerId: string;
+        where: string;
+    };
+    geometryLayer?: {
+        layerId: string;
+        where: string;
+        distance: number;
+        units: typeof distanceUnitsSchema._type;
+    };
+}, config?: RunnableConfig) => Promise<string>;
+export declare const setFeatureFilterTool: import('@langchain/core/tools').DynamicStructuredTool<z.ZodObject<{
+    targetLayer: z.ZodObject<{
+        layerId: z.ZodString;
+        where: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        where: string;
+        layerId: string;
+    }, {
+        where: string;
+        layerId: string;
+    }>;
+    geometryLayer: z.ZodOptional<z.ZodObject<{
+        layerId: z.ZodString;
+        where: z.ZodString;
+        distance: z.ZodNumber;
+        units: z.ZodEnum<["feet", "kilometers", "meters", "miles", "nautical-miles", "us-nautical-miles"]>;
+    }, "strip", z.ZodTypeAny, {
+        distance: number;
+        units: "feet" | "miles" | "nautical-miles" | "us-nautical-miles" | "meters" | "kilometers";
+        where: string;
+        layerId: string;
+    }, {
+        distance: number;
+        units: "feet" | "miles" | "nautical-miles" | "us-nautical-miles" | "meters" | "kilometers";
+        where: string;
+        layerId: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    targetLayer: {
+        where: string;
+        layerId: string;
+    };
+    geometryLayer?: {
+        distance: number;
+        units: "feet" | "miles" | "nautical-miles" | "us-nautical-miles" | "meters" | "kilometers";
+        where: string;
+        layerId: string;
+    } | undefined;
+}, {
+    targetLayer: {
+        where: string;
+        layerId: string;
+    };
+    geometryLayer?: {
+        distance: number;
+        units: "feet" | "miles" | "nautical-miles" | "us-nautical-miles" | "meters" | "kilometers";
+        where: string;
+        layerId: string;
+    } | undefined;
+}>, {
+    targetLayer: {
+        layerId: string;
+        where: string;
+    };
+    geometryLayer?: {
+        layerId: string;
+        where: string;
+        distance: number;
+        units: typeof distanceUnitsSchema._type;
+    };
+}, {
+    targetLayer: {
+        where: string;
+        layerId: string;
+    };
+    geometryLayer?: {
+        distance: number;
+        units: "feet" | "miles" | "nautical-miles" | "us-nautical-miles" | "meters" | "kilometers";
+        where: string;
+        layerId: string;
+    } | undefined;
+}, string>;

package/dist/agents/dataExploration/tools/filterTools/setFeatureFilter/core.d.ts

@@ -0,0 +1,5 @@
+import { GeometryLayerConfig } from '../../../types/types';
+export declare const setFeatureFilter: (targetLayer: {
+    layerId: string;
+    where: string;
+}, arcgisMapView: __esri.MapView, geometryLayer?: GeometryLayerConfig) => Promise<string>;

package/dist/agents/dataExploration/tools/filterTools/setFeatureFilter/index.d.ts

@@ -0,0 +1 @@
+export * from './adapter';