@arcgis/ai-agents 5.1.0-next.93 → 5.1.0-next.95

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

@@ -1,11 +1,11 @@
-import { AgentExecutionContext, AgentStatus, ChatHistory } from '@arcgis/ai-orchestrator';
+import { ChatHistory } from '@arcgis/ai-orchestrator';
 export declare const arcgisKnowledgeState: import('@langchain/langgraph/web').AnnotationRoot<{
-    agentExecutionContext: import('@langchain/langgraph/web').BaseChannel<AgentExecutionContext, AgentExecutionContext | import('@langchain/langgraph/web').OverwriteValue<AgentExecutionContext>, unknown>;
-    outputMessage: import('@langchain/langgraph/web').BaseChannel<string, string | import('@langchain/langgraph/web').OverwriteValue<string>, unknown>;
-    summary: import('@langchain/langgraph/web').BaseChannel<string, string | import('@langchain/langgraph/web').OverwriteValue<string>, unknown>;
-    status: import('@langchain/langgraph/web').BaseChannel<AgentStatus, AgentStatus | import('@langchain/langgraph/web').OverwriteValue<AgentStatus>, unknown>;
     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>;
+    agentExecutionContext: import('@langchain/langgraph/web').BaseChannel<import('@arcgis/ai-orchestrator').AgentExecutionContext, 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/index.d.ts

@@ -47,7 +47,13 @@ export declare const arcgisKnowledgeTools: (import('@langchain/core/tools').Dyna
     prompt: string;
 }, {
     prompt: string;
-}, string, unknown, "generateCypher">)[];
+}, string, unknown, "generateCypher"> | import('@langchain/core/tools').DynamicStructuredTool<import('zod').ZodObject<{
+    prompt: import('zod').ZodString;
+}, import('zod/v4/core').$strip>, {
+    prompt: string;
+}, {
+    prompt: string;
+}, string, unknown, "searchGraphData">)[];
 export declare const arcgisKnowledgeServerSkills: (import('@langchain/core/tools').DynamicStructuredTool<import('zod').ZodObject<{
     prompt: import('zod').ZodString;
 }, import('zod/v4/core').$strip>, {

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

@@ -0,0 +1,8 @@
+import { default as z } from 'zod';
+export declare const searchGraphData: import('@langchain/core/tools').DynamicStructuredTool<z.ZodObject<{
+    prompt: z.ZodString;
+}, z.core.$strip>, {
+    prompt: string;
+}, {
+    prompt: string;
+}, string, unknown, "searchGraphData">;

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

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

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

@@ -1,8 +1,9 @@
 import { GraphAnyValue } from '@arcgis/core/rest/knowledgeGraph/GraphAnyValue.js';
-import { default as GraphQueryStreaming } from '@arcgis/core/rest/knowledgeGraph/GraphQueryStreaming.js';
 import { default as KnowledgeGraph } from '@arcgis/core/rest/knowledgeGraph/KnowledgeGraph.js';
-import { default as GraphQueryResultHeader } from '@arcgis/core/rest/knowledgeGraph/GraphQueryResultHeader.js';
 import { RequestOptions } from '@arcgis/core/request/types.js';
+import { default as GraphNamedObject } from '@arcgis/core/rest/knowledgeGraph/GraphNamedObject.js';
+import { default as GraphQueryStreaming } from '@arcgis/core/rest/knowledgeGraph/GraphQueryStreaming.js';
+import { default as GraphQueryResultHeader } from '@arcgis/core/rest/knowledgeGraph/GraphQueryResultHeader.js';
 type RunCypherQueryResult<T> = {
     type: "aborted";
 } | {
@@ -26,4 +27,23 @@ export declare const runCypherQueryAndReduce: <T>({ kg, queryParams, targetStruc
     queryRowLimit?: number;
     queryTimeoutMs?: number;
 }) => Promise<RunCypherQueryResult<T>>;
+export declare const getLabelForGraphNamedObject: (kg: KnowledgeGraph, obj: GraphNamedObject) => string;
+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/state/dataExplorationState.d.ts

@@ -1,15 +1,15 @@
-import { AgentExecutionContext, AgentStatus, ChatHistory, VectorSearchFieldResults } from '@arcgis/ai-orchestrator';
+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<{
-    agentExecutionContext: import('@langchain/langgraph/web').BaseChannel<AgentExecutionContext, AgentExecutionContext | import('@langchain/langgraph/web').OverwriteValue<AgentExecutionContext>, unknown>;
-    outputMessage: import('@langchain/langgraph/web').BaseChannel<string, string | import('@langchain/langgraph/web').OverwriteValue<string>, unknown>;
-    summary: import('@langchain/langgraph/web').BaseChannel<string, string | import('@langchain/langgraph/web').OverwriteValue<string>, unknown>;
-    status: import('@langchain/langgraph/web').BaseChannel<AgentStatus, AgentStatus | import('@langchain/langgraph/web').OverwriteValue<AgentStatus>, unknown>;
     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[]>;
     dataExplorationMessages: import('@langchain/langgraph/web').BaseChannel<ChatHistory, ChatHistory | import('@langchain/langgraph/web').OverwriteValue<ChatHistory>, unknown>;
+    agentExecutionContext: import('@langchain/langgraph/web').BaseChannel<import('@arcgis/ai-orchestrator').AgentExecutionContext, 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 DataExplorationGraphStateType = typeof DataExplorationState.State;

package/dist/agents/help/state/helpState.d.ts

@@ -1,10 +1,9 @@
-import { AgentExecutionContext, AgentStatus } from '@arcgis/ai-orchestrator';
 import { HelpInternalState } from '../types/types';
 export declare const HelpState: import('@langchain/langgraph/web').AnnotationRoot<{
-    agentExecutionContext: import('@langchain/langgraph/web').BaseChannel<AgentExecutionContext, AgentExecutionContext | import('@langchain/langgraph/web').OverwriteValue<AgentExecutionContext>, unknown>;
-    outputMessage: import('@langchain/langgraph/web').BaseChannel<string, string | import('@langchain/langgraph/web').OverwriteValue<string>, unknown>;
-    summary: import('@langchain/langgraph/web').BaseChannel<string, string | import('@langchain/langgraph/web').OverwriteValue<string>, unknown>;
-    status: import('@langchain/langgraph/web').BaseChannel<AgentStatus, AgentStatus | import('@langchain/langgraph/web').OverwriteValue<AgentStatus>, unknown>;
     helpInternalState: import('@langchain/langgraph/web').BaseChannel<HelpInternalState, HelpInternalState | import('@langchain/langgraph/web').OverwriteValue<HelpInternalState>, unknown>;
+    agentExecutionContext: import('@langchain/langgraph/web').BaseChannel<import('@arcgis/ai-orchestrator').AgentExecutionContext, 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 HelpGraphStateType = typeof HelpState.State;

package/dist/agents/layerStyling/state/layerStylingState.d.ts

@@ -1,11 +1,13 @@
-import { AgentExecutionContext, VectorSearchFieldResults } from '@arcgis/ai-orchestrator';
+import { VectorSearchFieldResults } from '@arcgis/ai-orchestrator';
 import { LayerFieldInfo } from '../../../types/types';
 export declare const LayerStylingState: import('@langchain/langgraph/web').AnnotationRoot<{
-    agentExecutionContext: import('@langchain/langgraph/web').BaseChannel<AgentExecutionContext, AgentExecutionContext | import('@langchain/langgraph/web').OverwriteValue<AgentExecutionContext>, unknown>;
-    outputMessage: import('@langchain/langgraph/web').BaseChannel<string, string | import('@langchain/langgraph/web').OverwriteValue<string>, unknown>;
     vectorSearchLayerIds: import('@langchain/langgraph/web').LastValue<string[]>;
     vectorSearchFieldResults: import('@langchain/langgraph/web').LastValue<VectorSearchFieldResults>;
     layerFieldInfo: import('@langchain/langgraph/web').LastValue<LayerFieldInfo>;
     selectedLayerId: import('@langchain/langgraph/web').LastValue<string>;
+    agentExecutionContext: import('@langchain/langgraph/web').BaseChannel<import('@arcgis/ai-orchestrator').AgentExecutionContext, 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 LayerStylingGraphStateType = typeof LayerStylingState.State;

package/dist/agents/navigation/state/navigationState.d.ts

@@ -1,11 +1,6 @@
-import { VectorSearchFieldResults, AgentExecutionContext, AgentStatus, SharedStatePatch } from '@arcgis/ai-orchestrator';
+import { VectorSearchFieldResults } from '@arcgis/ai-orchestrator';
 import { NavigationInternalState } from '../types/types';
 export declare const NavigationState: import('@langchain/langgraph/web').AnnotationRoot<{
-    agentExecutionContext: import('@langchain/langgraph/web').BaseChannel<AgentExecutionContext, AgentExecutionContext | import('@langchain/langgraph/web').OverwriteValue<AgentExecutionContext>, unknown>;
-    outputMessage: import('@langchain/langgraph/web').BaseChannel<string, string | import('@langchain/langgraph/web').OverwriteValue<string>, unknown>;
-    summary: import('@langchain/langgraph/web').BaseChannel<string, string | import('@langchain/langgraph/web').OverwriteValue<string>, unknown>;
-    status: import('@langchain/langgraph/web').BaseChannel<AgentStatus, AgentStatus | import('@langchain/langgraph/web').OverwriteValue<AgentStatus>, unknown>;
-    sharedStatePatch: import('@langchain/langgraph/web').BaseChannel<SharedStatePatch | undefined, SharedStatePatch | import('@langchain/langgraph/web').OverwriteValue<SharedStatePatch | undefined> | undefined, unknown>;
     intent: import('@langchain/langgraph/web').BaseChannel<string, string | import('@langchain/langgraph/web').OverwriteValue<string>, unknown>;
     vectorSearchLayerResults: import('@langchain/langgraph/web').BaseChannel<{
         id: string;
@@ -25,5 +20,12 @@ export declare const NavigationState: import('@langchain/langgraph/web').Annotat
     }[]>, unknown>;
     vectorSearchFieldResults: import('@langchain/langgraph/web').BaseChannel<VectorSearchFieldResults, VectorSearchFieldResults | import('@langchain/langgraph/web').OverwriteValue<VectorSearchFieldResults>, unknown>;
     navigationInternalState: import('@langchain/langgraph/web').BaseChannel<NavigationInternalState, NavigationInternalState | import('@langchain/langgraph/web').OverwriteValue<NavigationInternalState>, unknown>;
+    agentExecutionContext: import('@langchain/langgraph/web').BaseChannel<import('@arcgis/ai-orchestrator').AgentExecutionContext, 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>;
+    sharedStatePatch: import('@langchain/langgraph/web').BaseChannel<import('@arcgis/ai-orchestrator').SharedStatePatch<{
+        lastResolvedLocation?: import('../types/types').LastResolvedLocation;
+    }> | undefined, unknown, unknown>;
 }>;
 export type NavigationGraphStateType = typeof NavigationState.State;

package/dist/agents/navigation/types/types.d.ts

@@ -1,4 +1,13 @@
+import { SharedStatePatch } from '@arcgis/ai-orchestrator';
 import { AIMessage } from '@langchain/core/messages';
 export type NavigationInternalState = {
     toolCallMessage?: AIMessage;
 };
+export type LastResolvedLocation = {
+    address: string;
+    location: unknown;
+    extent: unknown;
+};
+export type NavigationSharedStatePatch = SharedStatePatch<{
+    lastResolvedLocation?: LastResolvedLocation;
+}>;

package/dist/arcgis_knowledge_intent_prompt-BnzF_zo3.js

@@ -0,0 +1,31 @@
+const n = `## ArcgisKnowledge Agent - Tool Intent Classifier
+
+You are an assistant that classifies user intent for arcgisKnowledge agent.
+
+You are given the following tool options:
+{tools}
+
+Return exactly one intent (tool name) based on the task details below. Use the provided user request or prior steps only if needed for context based on the assigned task.
+If no tool apply, return an **empty string**.
+
+**Task Details**
+
+Assigned Task:
+{assignedTask}
+
+User Request:
+{userRequest}
+
+Prior steps:
+{priorSteps}
+
+**End Task Details**
+
+Reminder:
+Choose only from provided tools.
+
+Return the name of the tool as a string.
+`;
+export {
+  n as default
+};

package/dist/arcgis_knowledge_lucene_generation_prompt-D3mtOeWu.js

@@ -0,0 +1,100 @@
+const e = `## ArcgisKnowledge Agent - Lucene Generation for Graph Search
+
+You are an assistant that generates a lucene query for graph query searching.
+
+The knowledge graph you will be searching has the following named types, and next to each named type is a list of its searchable text fields corresponding to graph properties.
+
+The search model data below is structured as follows:
+<TYPE_NAME> - [array, of, searchable, field, names]
+
+{dataModelForSearch}
+
+The user is trying to answer the following inquiry via text search:
+{inquiry}
+
+Return a lucene search query that will answer the user's inquiry. The generated response should be an object with the following properties:
+
+- \`query\` - string - the generated lucene query expression that answers the user's inquiry.
+- \`typeFilters\` - array of strings - restricts the search to only use the named types specified. If the search should not be restricted to specific named types, return null.
+- \`typeCategoryFilter\` - either 'entity', 'relationship' or 'both' - determines whether search should be limited to only entity or relationship types, or to search both. Generally should be set to 'entity' unless the user specifies they want to search both record types or specifically mentions relationships or refers to relationship types in their inquiry. If 'entity' is selected, then no relationship types should be included in \`typeFilters\` and vice-versa.
+- \`resultLimit\` - number (min 1) or null - the max number of search results to return. Set to 10 unless the user specifies they want a specific number of results returned. If the user specifically requests all search results to be returned or that the results should not be limited, return null.
+
+Additional rules for the generated arguments:
+
+- Only include specific search fields in the lucene query expression if the user inquiry specifies specific fields or properties, and the fields are present in the searchable field list of the corresponding named type shown above, otherwise search across all fields.
+- If the user's inquiry is specific to certain entity or relationship types in the graph, then return those types as the \`typeFilters\` property. Do not attempt to use search fields for this purpose. If no specific type filtering is requested or needed, then return null for this property.
+- Regular expressions are not supported in the lucene search syntax, so do not include such queries in the \`query\` property.
+
+**START EXAMPLE**
+
+### Example searchable property data:
+
+Entity Types:
+Author - [name, title]
+Report - [organization, summary, full_text, tags]
+
+Relationship Types:
+authored - [contribution_type]
+
+Searchable fields per type:
+
+Author:
+name
+title
+
+Report:
+organization
+summary
+full_text
+tags
+
+authored:
+contributionType
+
+### User Inquiry 1:
+
+Find the first 5 reports where summary mentions flood zoning near Sacramento, and the organization name is close to City of Sacramento Utilities, and tags containing stormwater.
+
+### Example generated query arguments 1:
+
+query: 'summary:"flood zoning" AND summary:Sacramento AND organization:"City of Sacramento Utilities"~2 AND tags:stormwater'
+
+typeFilters: ['Report']
+
+typeCategoryFilter: "entity"
+
+resultLimit: 5
+
+### User Inquiry 2:
+
+Find entities containing text like 'City of Sacramento Utilities'
+
+### Example generated query arguments 2:
+
+query: '"City of Sacramento Utilities"~2'
+
+typeFilters: null
+
+typeCategoryFilter: "entity"
+
+resultLimit: 10
+
+### User Inquiry 3:
+
+Find all reports authored by someone with the title of 'Researcher'
+
+### Example generated query arguments 3:
+
+query: 'title:"Researcher"'
+
+typeFilters: ['Author']
+
+typeCategoryFilter: "entity"
+
+resultLimit: null
+
+**END EXAMPLE**
+`;
+export {
+  e as default
+};

package/dist/arcgis_knowledge_tool_prompt-BMJYd0IC.js

@@ -0,0 +1,20 @@
+const e = `# ArcgisKnowledge Tool Instructions
+
+CRITICAL: You are FORBIDDEN from making multiple tool calls. You MUST make exactly ONE tool call.
+
+Detected intent:
+{intent}
+
+Assigned task:
+{assignedTask}
+
+Latest user request:
+{userRequest}
+
+Rules:
+
+- Call exactly one arcgisKnowledge tool, with the appropriate arguments given the detected intent and assigned task. Use the latest user request for context where necessary.
+`;
+export {
+  e as default
+};