@arcgis/ai-agents 5.1.0-next.11 → 5.1.0-next.112

package/README.md

@@ -6,5 +6,5 @@ The ArcGIS Maps SDK for JavaScript provides a suite of ready-to-use UI component
 
 ## License
 
-This package is licensed under the terms described in the `LICENSE.md` file, located in the root of the package, and at https://js.arcgis.com/5.0/LICENSE.txt.
-For third party notices, see https://js.arcgis.com/5.0/third-party-notices.txt.
+This package is licensed under the terms described in the `LICENSE.md` file, located in the root of the package, and at https://js.arcgis.com/5.1/LICENSE.txt.
+For third party notices, see https://js.arcgis.com/5.1/third-party-notices.txt.

package/dist/agents/arcgisKnowledge/context/arcgisKnowledgeContext.d.ts

@@ -1,12 +1,15 @@
-import { default as KnowledgeGraph } from '@arcgis/core/rest/knowledgeGraph/KnowledgeGraph';
-import { default as LinkChartView } from '@arcgis/core/views/LinkChartView';
+import { default as KnowledgeGraph } from '@arcgis/core/rest/knowledgeGraph/KnowledgeGraph.js';
+import { default as LinkChartView } from '@arcgis/core/views/LinkChartView.js';
+import { default as MapView } from '@arcgis/core/views/MapView.js';
 /**
  * Context required by the Knowledge Link Chart agent.
  * Supplied by the application via an agent `getContext()` provider.
  */
 export type ArcgisKnowledgeContext = {
-    linkChartView: LinkChartView;
     knowledgeGraph: KnowledgeGraph;
+    view?: never;
+} | {
+    view: LinkChartView | MapView;
+    knowledgeGraph?: never;
 };
-export declare const arcgisKnowledgeContextRequiredKeys: readonly ["linkChartView"];
-export declare const serviceContextRequiredKeys: readonly ["knowledgeGraph"];
+export type KnowledgeGraphSourceType = "knowledgeGraph" | "linkChart" | "map";

package/dist/agents/arcgisKnowledge/context/getArcgisKnowledgeContext.d.ts

@@ -1,9 +1,12 @@
 import { RunnableConfig } from '@langchain/core/runnables';
-import { default as KnowledgeGraph } from '@arcgis/core/rest/knowledgeGraph/KnowledgeGraph';
-import { default as LinkChartView } from '@arcgis/core/views/LinkChartView';
-export declare function getLinkChartContext(config?: RunnableConfig): {
-    linkChartView: LinkChartView;
+import { KnowledgeGraphSourceType } from './arcgisKnowledgeContext';
+import { default as KnowledgeGraph } from '@arcgis/core/rest/knowledgeGraph/KnowledgeGraph.js';
+import { default as LinkChartView } from '@arcgis/core/views/LinkChartView.js';
+import { default as MapView } from '@arcgis/core/views/MapView.js';
+export declare function getViewContext(config?: RunnableConfig): {
+    view: LinkChartView | MapView;
 };
-export declare function getKnowledgeGraphContext(config?: RunnableConfig): {
+export declare function getContextType(config?: RunnableConfig): KnowledgeGraphSourceType;
+export declare function getKnowledgeGraphContext(config?: RunnableConfig): Promise<{
     knowledgeGraph: KnowledgeGraph;
-};
+}>;

package/dist/agents/arcgisKnowledge/graph/arcgisKnowledgeGraph.d.ts

@@ -1,8 +1,2 @@
-import { StateGraph } from '@langchain/langgraph/web';
-import { ArcgisKnowledgeGraphStateType } from '../state/arcgisKnowledgeState';
 import { AgentRegistration } from '@arcgis/ai-orchestrator';
-/**
- * Builds the ArcgisKnowledge Agent graph (intent classification + tool execution).
- */
-export declare const createArcgisKnowledgeAgentGraph: () => StateGraph<ArcgisKnowledgeGraphStateType>;
 export declare const ArcgisKnowledgeAgent: AgentRegistration;

package/dist/agents/arcgisKnowledge/nodes/arcgisKnowledgeLLM.d.ts

@@ -1,3 +1,3 @@
 import { RunnableConfig } from '@langchain/core/runnables';
 import { ArcgisKnowledgeGraphStateType } from '../state/arcgisKnowledgeState';
-export declare function arcgisKnowledgeLLM(state: ArcgisKnowledgeGraphStateType, _config?: RunnableConfig): Promise<ArcgisKnowledgeGraphStateType>;
+export declare function arcgisKnowledgeLLM(state: ArcgisKnowledgeGraphStateType, config?: RunnableConfig): Promise<ArcgisKnowledgeGraphStateType>;

package/dist/agents/arcgisKnowledge/nodes/arcgisKnowledgeSummarizationLLM.d.ts

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

package/dist/agents/arcgisKnowledge/state/arcgisKnowledgeState.d.ts

@@ -1,8 +1,13 @@
 import { ChatHistory } from '@arcgis/ai-orchestrator';
+import { ArcgisKnowledgeToolResult } from '../types/toolTypes.js';
 export declare const arcgisKnowledgeState: import('@langchain/langgraph/web').AnnotationRoot<{
-    messages: import('@langchain/langgraph/web').BinaryOperatorAggregate<ChatHistory, ChatHistory>;
-    outputMessage: import('@langchain/langgraph/web').BinaryOperatorAggregate<string, string>;
-    intent: import('@langchain/langgraph/web').BinaryOperatorAggregate<string, string>;
+    intent: import('@langchain/langgraph/web').BaseChannel<string, string | import('@langchain/langgraph/web').OverwriteValue<string>, unknown>;
+    arcgisKnowledgeMessages: import('@langchain/langgraph/web').BaseChannel<ChatHistory, ChatHistory | import('@langchain/langgraph/web').OverwriteValue<ChatHistory>, unknown>;
+    arcgisKnowledgeToolResult: import('@langchain/langgraph/web').BaseChannel<ArcgisKnowledgeToolResult[] | null, ArcgisKnowledgeToolResult[] | import('@langchain/langgraph/web').OverwriteValue<ArcgisKnowledgeToolResult[] | null> | null, unknown>;
+    agentExecutionContext: import('@langchain/langgraph/web').BaseChannel<Readonly<import('@arcgis/ai-orchestrator').AgentExecutionContextShape<import('@arcgis/ai-orchestrator').SharedState<Record<string, unknown>>>>, unknown, unknown>;
+    outputMessage: import('@langchain/langgraph/web').BaseChannel<string, unknown, unknown>;
+    summary: import('@langchain/langgraph/web').BaseChannel<string, unknown, unknown>;
+    status: import('@langchain/langgraph/web').BaseChannel<import('@arcgis/ai-orchestrator').AgentStatus | undefined, unknown, unknown>;
 }>;
 export type ArcgisKnowledgeGraphStateType = typeof arcgisKnowledgeState.State;
 export declare const arcgisKnowledgeServerSkillState: {

package/dist/agents/arcgisKnowledge/tools/addRecords/adapter.d.ts

@@ -1,16 +1,8 @@
-import { RunnableConfig } from '@langchain/core/runnables';
 import { default as z } from 'zod';
-export declare function addRecordsWrapper({ prompt }: {
-    prompt: string;
-}, config?: RunnableConfig): Promise<string>;
 export declare const addRecords: import('@langchain/core/tools').DynamicStructuredTool<z.ZodObject<{
     prompt: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    prompt: string;
-}, {
-    prompt: string;
-}>, {
+}, z.core.$strip>, {
     prompt: string;
 }, {
     prompt: string;
-}, string, "addRecords">;
+}, import('../../types/toolTypes.js').ToolCallError<"addRecords"> | import('../../types/toolTypes.js').ToolCallSuccess<"addRecords", undefined>, unknown, "addRecords">;

package/dist/agents/arcgisKnowledge/tools/addRecords/core.d.ts

@@ -1,4 +1,4 @@
 import { RunnableConfig } from '@langchain/core/runnables';
-import { default as KnowledgeGraph } from '@arcgis/core/rest/knowledgeGraph/KnowledgeGraph';
-import { default as LinkChartView } from '@arcgis/core/views/LinkChartView';
-export declare function executeAddRecords(prompt: string, knowledgeGraph: KnowledgeGraph, graphQueryServiceUrl: string, view: LinkChartView, config?: RunnableConfig): Promise<string>;
+import { default as KnowledgeGraph } from '@arcgis/core/rest/knowledgeGraph/KnowledgeGraph.js';
+import { ArcgisKnowledgeContext } from '../../context/arcgisKnowledgeContext';
+export declare function executeAddRecords(prompt: string, knowledgeGraph: KnowledgeGraph, graphQueryServiceUrl: string, context: ArcgisKnowledgeContext, config?: RunnableConfig): Promise<string>;

package/dist/agents/arcgisKnowledge/tools/applyLayout/adapter.d.ts

@@ -1,16 +1,18 @@
-import { RunnableConfig } from '@langchain/core/runnables';
 import { default as z } from 'zod';
-export declare function applyLayoutWrapper({ layout }: {
-    layout: string;
-}, config?: RunnableConfig): Promise<string>;
 export declare const applyLayout: import('@langchain/core/tools').DynamicStructuredTool<z.ZodObject<{
-    layout: z.ZodEnum<["organic-standard", "organic-community", "basic-grid", "hierarchical-bottom-to-top", "radial-root-centric", "tree-left-to-right", "geographic-organic-standard", "chronological-mono-timeline", "chronological-multi-timeline"]>;
-}, "strip", z.ZodTypeAny, {
-    layout: "basic-grid" | "chronological-mono-timeline" | "chronological-multi-timeline" | "geographic-organic-standard" | "hierarchical-bottom-to-top" | "organic-community" | "organic-standard" | "radial-root-centric" | "tree-left-to-right";
+    layout: z.ZodEnum<{
+        "organic-standard": "organic-standard";
+        "organic-community": "organic-community";
+        "basic-grid": "basic-grid";
+        "hierarchical-bottom-to-top": "hierarchical-bottom-to-top";
+        "radial-root-centric": "radial-root-centric";
+        "tree-left-to-right": "tree-left-to-right";
+        "geographic-organic-standard": "geographic-organic-standard";
+        "chronological-mono-timeline": "chronological-mono-timeline";
+        "chronological-multi-timeline": "chronological-multi-timeline";
+    }>;
+}, z.core.$strip>, {
+    layout: "organic-standard" | "organic-community" | "basic-grid" | "hierarchical-bottom-to-top" | "radial-root-centric" | "tree-left-to-right" | "geographic-organic-standard" | "chronological-mono-timeline" | "chronological-multi-timeline";
 }, {
-    layout: "basic-grid" | "chronological-mono-timeline" | "chronological-multi-timeline" | "geographic-organic-standard" | "hierarchical-bottom-to-top" | "organic-community" | "organic-standard" | "radial-root-centric" | "tree-left-to-right";
-}>, {
-    layout: string;
-}, {
-    layout: "basic-grid" | "chronological-mono-timeline" | "chronological-multi-timeline" | "geographic-organic-standard" | "hierarchical-bottom-to-top" | "organic-community" | "organic-standard" | "radial-root-centric" | "tree-left-to-right";
-}, string, "applyLayout">;
+    layout: "organic-standard" | "organic-community" | "basic-grid" | "hierarchical-bottom-to-top" | "radial-root-centric" | "tree-left-to-right" | "geographic-organic-standard" | "chronological-mono-timeline" | "chronological-multi-timeline";
+}, import('../../types/toolTypes.js').ToolCallError<"applyLayout"> | import('../../types/toolTypes.js').ToolCallSuccess<"applyLayout", undefined>, unknown, "applyLayout">;

package/dist/agents/arcgisKnowledge/tools/applyLayout/core.d.ts

@@ -1,3 +1,3 @@
-import { LayoutMode } from '@arcgis/core/layers/knowledgeGraph/types';
-import { default as LinkChartView } from '@arcgis/core/views/LinkChartView';
+import { LayoutMode } from '@arcgis/core/layers/knowledgeGraph/types.js';
+import { default as LinkChartView } from '@arcgis/core/views/LinkChartView.js';
 export declare function executeApplyLayout(layout: LayoutMode, linkChartView: LinkChartView): Promise<string>;

package/dist/agents/arcgisKnowledge/tools/changeNonspatialVisibility/adapter.d.ts

@@ -1,16 +1,11 @@
-import { RunnableConfig } from '@langchain/core/runnables';
 import { default as z } from 'zod';
-export declare function changeNonspatialVisibilityWrapper({ setting }: {
-    setting: string;
-}, config?: RunnableConfig): string;
 export declare const changeNonspatialVisibility: import('@langchain/core/tools').DynamicStructuredTool<z.ZodObject<{
-    setting: z.ZodEnum<["hidden", "visible"]>;
-}, "strip", z.ZodTypeAny, {
+    setting: z.ZodEnum<{
+        visible: "visible";
+        hidden: "hidden";
+    }>;
+}, z.core.$strip>, {
     setting: "visible" | "hidden";
 }, {
     setting: "visible" | "hidden";
-}>, {
-    setting: string;
-}, {
-    setting: "visible" | "hidden";
-}, string, "changeNonspatialVisibility">;
+}, import('../../types/toolTypes.js').ToolCallError<"changeNonspatialVisibility"> | import('../../types/toolTypes.js').ToolCallSuccess<"changeNonspatialVisibility", undefined>, unknown, "changeNonspatialVisibility">;

package/dist/agents/arcgisKnowledge/tools/changeNonspatialVisibility/core.d.ts

@@ -1,2 +1,2 @@
-import { default as LinkChartView } from '@arcgis/core/views/LinkChartView';
+import { default as LinkChartView } from '@arcgis/core/views/LinkChartView.js';
 export declare function executeChangeNonspatialVisibility(setting: "hidden" | "visible", linkChartView: LinkChartView): string;

package/dist/agents/arcgisKnowledge/tools/createLinkChart/adapter.d.ts

@@ -1,16 +1,8 @@
-import { RunnableConfig } from '@langchain/core/runnables';
 import { default as z } from 'zod';
-export declare function createLinkChartWrapper({ prompt }: {
-    prompt: string;
-}, config?: RunnableConfig): Promise<string>;
 export declare const createLinkChart: import('@langchain/core/tools').DynamicStructuredTool<z.ZodObject<{
     prompt: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    prompt: string;
-}, {
-    prompt: string;
-}>, {
+}, z.core.$strip>, {
     prompt: string;
 }, {
     prompt: string;
-}, string, "createLinkChart">;
+}, import('../../types/toolTypes.js').ToolCallError<"createLinkChart"> | import('../../types/toolTypes.js').ToolCallSuccess<"createLinkChart", undefined>, unknown, "createLinkChart">;

package/dist/agents/arcgisKnowledge/tools/createLinkChart/core.d.ts

@@ -1,4 +1,4 @@
 import { RunnableConfig } from '@langchain/core/runnables';
-import { default as KnowledgeGraph } from '@arcgis/core/rest/knowledgeGraph/KnowledgeGraph';
-import { default as LinkChartView } from '@arcgis/core/views/LinkChartView';
+import { default as KnowledgeGraph } from '@arcgis/core/rest/knowledgeGraph/KnowledgeGraph.js';
+import { default as LinkChartView } from '@arcgis/core/views/LinkChartView.js';
 export declare function executeCreateLinkChart(prompt: string, knowledgeGraph: KnowledgeGraph, graphQueryServiceUrl: string, view: LinkChartView, config?: RunnableConfig): Promise<string>;

package/dist/agents/arcgisKnowledge/tools/generateCypher/GenerateCypherDataModel.d.ts

@@ -1,6 +1,6 @@
-import { default as DataModel } from '@arcgis/core/rest/knowledgeGraph/DataModel';
-import { default as EntityType } from '@arcgis/core/rest/knowledgeGraph/EntityType';
-import { default as RelationshipType } from '@arcgis/core/rest/knowledgeGraph/RelationshipType';
+import { default as DataModel } from '@arcgis/core/rest/knowledgeGraph/DataModel.js';
+import { default as EntityType } from '@arcgis/core/rest/knowledgeGraph/EntityType.js';
+import { default as RelationshipType } from '@arcgis/core/rest/knowledgeGraph/RelationshipType.js';
 export default class GenerateCypherContext {
     dataModel: DataModel;
     kind: string;
@@ -8,7 +8,7 @@ export default class GenerateCypherContext {
     schemaInformation: GenerateCypherDataModel;
     constructor(dataModel: DataModel);
 }
-declare class GenerateCypherDataModel {
+export declare class GenerateCypherDataModel {
     schemaType: string;
     entityTypes: GenerateCypherEntityType[];
     relationshipTypes: GenerateCypherRelationshipType[];
@@ -20,6 +20,7 @@ declare class GenerateCypherDataModel {
         };
     };
     static fromDataModel(dataModel: DataModel): GenerateCypherDataModel;
+    static getDataModelTypesSummary(dataModel: DataModel): string;
 }
 declare class GenerateCypherEntityType {
     name: string;

package/dist/agents/arcgisKnowledge/tools/generateCypher/adapter.d.ts

@@ -1,16 +1,8 @@
-import { RunnableConfig } from '@langchain/core/runnables';
 import { default as z } from 'zod';
-export declare function generateCypherWrapper({ prompt }: {
-    prompt: string;
-}, config?: RunnableConfig): Promise<string>;
 export declare const generateCypher: import('@langchain/core/tools').DynamicStructuredTool<z.ZodObject<{
     prompt: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    prompt: string;
-}, {
-    prompt: string;
-}>, {
+}, z.core.$strip>, {
     prompt: string;
 }, {
     prompt: string;
-}, string, "generateCypher">;
+}, import('../../types/toolTypes.js').ToolCallError<"generateCypher"> | import('../../types/toolTypes.js').ToolCallSuccess<"generateCypher", undefined>, unknown, "generateCypher">;

package/dist/agents/arcgisKnowledge/tools/generateCypher/core.d.ts

@@ -1,7 +1,8 @@
-import { default as DataModel } from '@arcgis/core/rest/knowledgeGraph/DataModel';
+import { default as DataModel } from '@arcgis/core/rest/knowledgeGraph/DataModel.js';
 import { RunnableConfig } from '@langchain/core/runnables';
+import { GraphQueryRetryContext } from './types';
 export declare function executeGenerateCypher(prompt: string, dataModel: DataModel, graphQueryServiceUrl: string, config?: RunnableConfig): Promise<string>;
-export declare function getCypherFromPrompt(prompt: string, dataModel: DataModel, graphQueryServiceUrl: string, config?: RunnableConfig): Promise<{
+export declare function getCypherFromPrompt(prompt: string, dataModel: DataModel, graphQueryServiceUrl: string, config?: RunnableConfig, retryContext?: GraphQueryRetryContext): Promise<{
     graphQuery: string;
     explanation: string;
 }>;

package/dist/agents/arcgisKnowledge/tools/generateCypher/types.d.ts

@@ -9,3 +9,8 @@ export interface GenerateCypherJobResponse {
     };
     message?: string;
 }
+export interface GraphQueryRetryContext {
+    failedGraphQuery: string;
+    executionError: string;
+    attemptCount: number;
+}

package/dist/agents/arcgisKnowledge/tools/index.d.ts

@@ -1,82 +1,70 @@
 export declare const arcgisKnowledgeTools: (import('@langchain/core/tools').DynamicStructuredTool<import('zod').ZodObject<{
-    prompt: import('zod').ZodString;
-}, "strip", import('zod').ZodTypeAny, {
-    prompt: string;
-}, {
-    prompt: string;
-}>, {
-    prompt: string;
-}, {
-    prompt: string;
-}, string, "addRecords"> | import('@langchain/core/tools').DynamicStructuredTool<import('zod').ZodObject<{
-    layout: import('zod').ZodEnum<["organic-standard", "organic-community", "basic-grid", "hierarchical-bottom-to-top", "radial-root-centric", "tree-left-to-right", "geographic-organic-standard", "chronological-mono-timeline", "chronological-multi-timeline"]>;
-}, "strip", import('zod').ZodTypeAny, {
-    layout: "basic-grid" | "chronological-mono-timeline" | "chronological-multi-timeline" | "geographic-organic-standard" | "hierarchical-bottom-to-top" | "organic-community" | "organic-standard" | "radial-root-centric" | "tree-left-to-right";
-}, {
-    layout: "basic-grid" | "chronological-mono-timeline" | "chronological-multi-timeline" | "geographic-organic-standard" | "hierarchical-bottom-to-top" | "organic-community" | "organic-standard" | "radial-root-centric" | "tree-left-to-right";
-}>, {
-    layout: string;
-}, {
-    layout: "basic-grid" | "chronological-mono-timeline" | "chronological-multi-timeline" | "geographic-organic-standard" | "hierarchical-bottom-to-top" | "organic-community" | "organic-standard" | "radial-root-centric" | "tree-left-to-right";
-}, string, "applyLayout"> | import('@langchain/core/tools').DynamicStructuredTool<import('zod').ZodObject<{
-    setting: import('zod').ZodEnum<["hidden", "visible"]>;
-}, "strip", import('zod').ZodTypeAny, {
-    setting: "visible" | "hidden";
-}, {
+    layout: import('zod').ZodEnum<{
+        "organic-standard": "organic-standard";
+        "organic-community": "organic-community";
+        "basic-grid": "basic-grid";
+        "hierarchical-bottom-to-top": "hierarchical-bottom-to-top";
+        "radial-root-centric": "radial-root-centric";
+        "tree-left-to-right": "tree-left-to-right";
+        "geographic-organic-standard": "geographic-organic-standard";
+        "chronological-mono-timeline": "chronological-mono-timeline";
+        "chronological-multi-timeline": "chronological-multi-timeline";
+    }>;
+}, import('zod/v4/core').$strip>, {
+    layout: "organic-standard" | "organic-community" | "basic-grid" | "hierarchical-bottom-to-top" | "radial-root-centric" | "tree-left-to-right" | "geographic-organic-standard" | "chronological-mono-timeline" | "chronological-multi-timeline";
+}, {
+    layout: "organic-standard" | "organic-community" | "basic-grid" | "hierarchical-bottom-to-top" | "radial-root-centric" | "tree-left-to-right" | "geographic-organic-standard" | "chronological-mono-timeline" | "chronological-multi-timeline";
+}, import('../types/toolTypes.js').ToolCallError<"applyLayout"> | import('../types/toolTypes.js').ToolCallSuccess<"applyLayout", undefined>, unknown, "applyLayout"> | import('@langchain/core/tools').DynamicStructuredTool<import('zod').ZodObject<{
+    setting: import('zod').ZodEnum<{
+        visible: "visible";
+        hidden: "hidden";
+    }>;
+}, import('zod/v4/core').$strip>, {
     setting: "visible" | "hidden";
-}>, {
-    setting: string;
 }, {
     setting: "visible" | "hidden";
-}, string, "changeNonspatialVisibility"> | import('@langchain/core/tools').DynamicStructuredTool<import('zod').ZodObject<{
+}, import('../types/toolTypes.js').ToolCallError<"changeNonspatialVisibility"> | import('../types/toolTypes.js').ToolCallSuccess<"changeNonspatialVisibility", undefined>, unknown, "changeNonspatialVisibility"> | import('@langchain/core/tools').DynamicStructuredTool<import('zod').ZodObject<{
     prompt: import('zod').ZodString;
-}, "strip", import('zod').ZodTypeAny, {
-    prompt: string;
-}, {
-    prompt: string;
-}>, {
+}, import('zod/v4/core').$strip>, {
     prompt: string;
 }, {
     prompt: string;
-}, string, "createLinkChart"> | import('@langchain/core/tools').DynamicStructuredTool<import('zod').ZodObject<{
+}, import('../types/toolTypes.js').ToolCallError<"generateCypher"> | import('../types/toolTypes.js').ToolCallSuccess<"generateCypher", undefined>, unknown, "generateCypher"> | import('@langchain/core/tools').DynamicStructuredTool<import('zod').ZodObject<{
     prompt: import('zod').ZodString;
-}, "strip", import('zod').ZodTypeAny, {
-    prompt: string;
-}, {
-    prompt: string;
-}>, {
+}, import('zod/v4/core').$strip>, {
     prompt: string;
 }, {
     prompt: string;
-}, string, "generateCypher">)[];
-export declare const arcgisKnowledgeServerSkills: (import('@langchain/core/tools').DynamicStructuredTool<import('zod').ZodObject<{
+}, import('../types/toolTypes.js').ToolCallError<"createLinkChart"> | import('../types/toolTypes.js').ToolCallSuccess<"createLinkChart", undefined>, unknown, "createLinkChart"> | import('@langchain/core/tools').DynamicStructuredTool<import('zod').ZodObject<{
     prompt: import('zod').ZodString;
-}, "strip", import('zod').ZodTypeAny, {
-    prompt: string;
-}, {
-    prompt: string;
-}>, {
+}, import('zod/v4/core').$strip>, {
     prompt: string;
 }, {
     prompt: string;
-}, string, "addRecords"> | import('@langchain/core/tools').DynamicStructuredTool<import('zod').ZodObject<{
+}, import('../types/toolTypes.js').ToolCallError<"addRecords"> | import('../types/toolTypes.js').ToolCallSuccess<"addRecords", undefined>, unknown, "addRecords"> | import('@langchain/core/tools').DynamicStructuredTool<import('zod').ZodObject<{
     prompt: import('zod').ZodString;
-}, "strip", import('zod').ZodTypeAny, {
+}, import('zod/v4/core').$strip>, {
     prompt: string;
 }, {
     prompt: string;
-}>, {
-    prompt: string;
-}, {
-    prompt: string;
-}, string, "createLinkChart"> | import('@langchain/core/tools').DynamicStructuredTool<import('zod').ZodObject<{
+}, import('../types/toolTypes.js').ToolCallError<"searchGraphData"> | import('../types/toolTypes.js').ToolCallSuccess<"searchGraphData", {
+    generatedQuery: Awaited<ReturnType<(prompt: string, knowledgeGraph: import('@arcgis/core/rest/knowledgeGraph/KnowledgeGraph.js').default) => Promise<{
+        query: string;
+        typeFilters: string[] | null;
+        typeCategoryFilter: "both" | "entity" | "relationship";
+        resultLimit: number | null;
+    }>>>;
+    searchResults: Extract<Awaited<ReturnType<typeof import('../utils/queryUtils.js').runGraphSearch>>, {
+        type: "success";
+    }>;
+}>, unknown, "searchGraphData"> | import('@langchain/core/tools').DynamicStructuredTool<import('zod').ZodObject<{
     prompt: import('zod').ZodString;
-}, "strip", import('zod').ZodTypeAny, {
-    prompt: string;
-}, {
-    prompt: string;
-}>, {
+}, import('zod/v4/core').$strip>, {
     prompt: string;
 }, {
     prompt: string;
-}, string, "generateCypher">)[];
+}, import('../types/toolTypes.js').ToolCallError<"queryGraphData"> | import('../types/toolTypes.js').ToolCallSuccess<"queryGraphData", {
+    generatedQuery: string;
+    resultHeader: import('@arcgis/core/rest/knowledgeGraph/GraphQueryResultHeader.js').default;
+    queryResults: import('@arcgis/core/rest/knowledgeGraph/GraphAnyValue.js').GraphAnyValue[][];
+}>, unknown, "queryGraphData">)[];

package/dist/agents/arcgisKnowledge/tools/queryGraphData/adapter.d.ts

@@ -0,0 +1,14 @@
+import { GraphAnyValue } from '@arcgis/core/rest/knowledgeGraph/GraphAnyValue.js';
+import { default as z } from 'zod';
+import { default as GraphQueryResultHeader } from '@arcgis/core/rest/knowledgeGraph/GraphQueryResultHeader.js';
+export declare const queryGraphData: import('@langchain/core/tools').DynamicStructuredTool<z.ZodObject<{
+    prompt: z.ZodString;
+}, z.core.$strip>, {
+    prompt: string;
+}, {
+    prompt: string;
+}, import('../../types/toolTypes.js').ToolCallError<"queryGraphData"> | import('../../types/toolTypes.js').ToolCallSuccess<"queryGraphData", {
+    generatedQuery: string;
+    resultHeader: GraphQueryResultHeader;
+    queryResults: GraphAnyValue[][];
+}>, unknown, "queryGraphData">;

package/dist/agents/arcgisKnowledge/tools/searchGraphData/adapter.d.ts

@@ -0,0 +1,27 @@
+import { default as z } from 'zod';
+import { default as KnowledgeGraph } from '@arcgis/core/rest/knowledgeGraph/KnowledgeGraph.js';
+import { runGraphSearch } from '../../utils/queryUtils';
+/**
+ * Generates a lucene query and settings for graph search based on the user's prompt and the knowledge graph's data model and search indexes.
+ *
+ * In the future this may be a server skill similar to graph query generation but currently implemented as local structured LLM call.
+ */
+declare function generateGraphSearchParams(prompt: string, knowledgeGraph: KnowledgeGraph): Promise<{
+    query: string;
+    typeFilters: string[] | null;
+    typeCategoryFilter: "both" | "entity" | "relationship";
+    resultLimit: number | null;
+}>;
+export declare const searchGraphData: import('@langchain/core/tools').DynamicStructuredTool<z.ZodObject<{
+    prompt: z.ZodString;
+}, z.core.$strip>, {
+    prompt: string;
+}, {
+    prompt: string;
+}, import('../../types/toolTypes.js').ToolCallError<"searchGraphData"> | import('../../types/toolTypes.js').ToolCallSuccess<"searchGraphData", {
+    generatedQuery: Awaited<ReturnType<typeof generateGraphSearchParams>>;
+    searchResults: Extract<Awaited<ReturnType<typeof runGraphSearch>>, {
+        type: "success";
+    }>;
+}>, unknown, "searchGraphData">;
+export {};

package/dist/agents/arcgisKnowledge/tools/searchGraphData/index.d.ts

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

package/dist/agents/arcgisKnowledge/types/toolTypes.d.ts

@@ -0,0 +1,23 @@
+import { ToolMessage } from '@langchain/core/messages';
+import { RunnableConfig } from '@langchain/core/runnables';
+import { arcgisKnowledgeTools } from '../tools';
+type ArcgisKnowledgeTool = (typeof arcgisKnowledgeTools)[number];
+export type ArcgisKnowledgeToolResult = Exclude<Awaited<ReturnType<ArcgisKnowledgeTool["invoke"]>>, ToolMessage>;
+type ArcgisKnowledgeToolName = ArcgisKnowledgeTool["name"];
+/** @knipIgnore Exported for TypeScript declaration emit (TS4023-style) */
+export interface ToolCallSuccess<TName, TDetails> {
+    toolName: TName;
+    status: "success";
+    summary: string;
+    details?: TDetails;
+}
+/** @knipIgnore Exported for TypeScript declaration emit (TS4023-style) */
+export interface ToolCallError<TName> {
+    toolName: TName;
+    status: "error";
+    errorMessage: string;
+    error: unknown;
+}
+type ToolCallResult<TName, TDetails> = ToolCallError<TName> | ToolCallSuccess<TName, TDetails>;
+export type KGAgentTool<TName extends ArcgisKnowledgeToolName, TSchema, TDetails extends object | undefined = undefined> = (toolSchema: TSchema, config?: RunnableConfig) => Promise<ToolCallResult<TName, TDetails>>;
+export {};

package/dist/agents/arcgisKnowledge/utils/dataTransformationUtils.d.ts

@@ -1,12 +1,14 @@
-import { IdTypePair } from '@arcgis/core/layers/knowledgeGraph/types';
-import { GraphAnyValue } from '@arcgis/core/rest/knowledgeGraph/GraphAnyValue';
-import { default as GraphNamedObject } from '@arcgis/core/rest/knowledgeGraph/GraphNamedObject';
-import { default as GraphObject } from '@arcgis/core/rest/knowledgeGraph/GraphObject';
-import { default as KnowledgeGraph } from '@arcgis/core/rest/knowledgeGraph/KnowledgeGraph';
-import { default as Path } from '@arcgis/core/rest/knowledgeGraph/Path';
-import { default as WebLinkChart } from '@arcgis/core/WebLinkChart';
+import { IdTypePair } from '@arcgis/core/layers/knowledgeGraph/types.js';
+import { GraphAnyValue } from '@arcgis/core/rest/knowledgeGraph/GraphAnyValue.js';
+import { default as GraphNamedObject } from '@arcgis/core/rest/knowledgeGraph/GraphNamedObject.js';
+import { default as KnowledgeGraph } from '@arcgis/core/rest/knowledgeGraph/KnowledgeGraph.js';
+import { default as WebLinkChart } from '@arcgis/core/WebLinkChart.js';
+import { default as WebMap } from '@arcgis/core/WebMap.js';
 export declare function extractGraphNamedObjectsFromQueryValueRecursive(resultValue: GraphAnyValue, results: Map<string, IdTypePair>): void;
-export declare function isGraphNamedObject(item: GraphAnyValue): item is GraphNamedObject;
-export declare function isPathObject(item: GraphAnyValue): item is Path;
-export declare function isGraphObject(item: GraphAnyValue): item is GraphObject;
+export declare function forEachGraphNamedObjectInQueryValueRecursive(resultValue: GraphAnyValue, callback: (graphNamedObject: GraphNamedObject) => void): void;
 export declare function getAllIdTypePairsFromLinkChart(linkChart: WebLinkChart, knowledgeGraph: KnowledgeGraph): IdTypePair[];
+export declare function getAllIdTypePairsAndDynamicTypesFromMap(map: WebMap): {
+    allNamedTypesFullyDynamic: boolean;
+    idTypePairs: IdTypePair[];
+    dynamicTypes: string[];
+};

package/dist/agents/arcgisKnowledge/utils/mapUtils.d.ts

@@ -0,0 +1,4 @@
+import { default as LinkChartView } from '@arcgis/core/views/LinkChartView.js';
+import { default as MapView } from '@arcgis/core/views/MapView.js';
+export declare function validateMapLayers(mapView: MapView): void;
+export declare function isMapView(view: LinkChartView | MapView | undefined): view is MapView;

package/dist/agents/arcgisKnowledge/utils/queryUtils.d.ts

@@ -1,3 +1,67 @@
-import { IdTypePair } from '@arcgis/core/layers/knowledgeGraph/types';
-import { default as GraphQueryStreamingResult } from '@arcgis/core/rest/knowledgeGraph/GraphQueryStreamingResult';
-export declare const queryResultToIdTypePairs: (queryResult: GraphQueryStreamingResult) => Promise<IdTypePair[]>;
+import { default as KnowledgeGraph } from '@arcgis/core/rest/knowledgeGraph/KnowledgeGraph.js';
+import { RequestOptions } from '@arcgis/core/request/types.js';
+import { default as GraphNamedObject } from '@arcgis/core/rest/knowledgeGraph/GraphNamedObject.js';
+import { default as GraphQueryResultHeader } from '@arcgis/core/rest/knowledgeGraph/GraphQueryResultHeader.js';
+import { GraphAnyValue } from '@arcgis/core/rest/knowledgeGraph/GraphAnyValue.js';
+import { RunnableConfig } from '@langchain/core/runnables';
+export declare const MAX_GRAPH_QUERY_ATTEMPTS = 3;
+export declare function truncateGraphNamedObjectStringProperties(record: GraphNamedObject, maxLength?: number): GraphNamedObject;
+type GenerateAndExecuteFailureResult = {
+    type: "aborted";
+    errorMessage: string;
+    graphQuery?: string;
+    explanation?: string;
+} | {
+    type: "execution-error";
+    errorMessage: string;
+    error: unknown;
+    graphQuery: string;
+    explanation: string;
+} | {
+    type: "generation-error";
+    errorMessage: string;
+    error: unknown;
+} | {
+    type: "timeout";
+    errorMessage: string;
+    graphQuery: string;
+    explanation: string;
+};
+type GenerateAndExecuteResult<T> = GenerateAndExecuteFailureResult | {
+    type: "success";
+    graphQuery: string;
+    explanation: string;
+    rowLimitReached: boolean;
+    resultHeader: GraphQueryResultHeader;
+    processedResult: T;
+};
+export declare function generateAndExecuteCypherQueryAndReduce<T>({ prompt, kg, graphQueryServiceUrl, targetStructure, targetStructureReducer, requestOptions, queryRowLimit, queryTimeoutMs, config, }: {
+    prompt: string;
+    kg: KnowledgeGraph;
+    graphQueryServiceUrl: string;
+    targetStructure: T;
+    targetStructureReducer: (prev: T, nextRow: GraphAnyValue[]) => T;
+    requestOptions?: RequestOptions;
+    queryRowLimit?: number;
+    queryTimeoutMs?: number;
+    config?: RunnableConfig;
+}): Promise<GenerateAndExecuteResult<T>>;
+type RunGraphSearchResult = {
+    type: "error";
+    errorMessage: string;
+    error: unknown;
+} | {
+    type: "success";
+    results: GraphNamedObject[];
+} | {
+    type: "aborted";
+};
+export declare const runGraphSearch: ({ kg, searchQuery, typeCategoryFilter, namedTypesFilter, searchResultLimit, requestOptions, }: {
+    kg: KnowledgeGraph;
+    searchQuery: string;
+    typeCategoryFilter: "both" | "entity" | "relationship";
+    namedTypesFilter: string[] | null;
+    searchResultLimit: number | null;
+    requestOptions?: RequestOptions;
+}) => Promise<RunGraphSearchResult>;
+export {};

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

@@ -1,4 +1,4 @@
-import { default as MapView } from '@arcgis/core/views/MapView';
+import { default as MapView } from '@arcgis/core/views/MapView.js';
 /**
  * Context required by the Data Exploration agent.
  * Supplied by the application via an agent `getContext()` provider.