@arcgis/ai-orchestrator 5.1.0-next.7 → 5.1.0-next.71

package/dist/assets/embeddings.worker-k9_Ou679.js

@@ -0,0 +1 @@
+(function(){"use strict";const h=(a,r)=>{if(a.length!==r.length)throw new Error("Vectors must be the same length");let c=0,t=0,e=0;for(let n=0;n<a.length;++n){const s=a[n],l=r[n];c+=s*l,t+=s*s,e+=l*l}const i=Math.sqrt(t*e);if(i===0)return 0;const m=c/i;return Math.max(-1,Math.min(1,m))},f=(a,r,c=.6)=>{const t=[],e=[...a];for(;t.length<r&&e.length>0;){let i=-1,m=-1/0;for(let n=0;n<e.length;n++){const s=e[n].score,l=t.length===0?0:Math.max(...t.map(o=>h(e[n].vector,o.vector))),d=c*s-(1-c)*l;d>m&&(m=d,i=n)}t.push(e[i]),e.splice(i,1)}return t.map(({name:i,score:m})=>({name:i,score:m}))};let p=[];const u=new Map,v=12,y=10,M=a=>{p=a.layers.map(r=>({id:r.id,vector:r.vector}))},E=a=>{u.clear();for(const r of a.layers){const c=r.fields.map(t=>({name:t.name,vector:t.vector}));u.set(r.id,c)}};globalThis.addEventListener("message",a=>{(async()=>{const{type:r,webmapEmbeddings:c,layerIdForFieldsSearch:t=[],requestId:e,precomputedEmbedding:i,minScore:m=0,topResults:n=v}=a.data;switch(r){case"generateEmbeddings":{c&&(M(c),E(c)),globalThis.postMessage("completed");break}case"layerSearch":{if(p.length>0)try{const s=p.map(o=>({id:o.id,vector:o.vector,score:h(i,o.vector)})),d=f(s.map(o=>({name:o.id,vector:o.vector,score:o.score})),y).map(({name:o,score:b})=>({id:o,score:b}));globalThis.postMessage({requestId:e,results:d})}catch(s){globalThis.postMessage({requestId:e,results:[],error:s instanceof Error?s.message:"Calculation error"})}else globalThis.postMessage({requestId:e,results:[],error:"Layer embeddings not initialized"});break}case"fieldSearch":{if(t.length>0)try{const s=t.map(l=>{const d=u.get(l);if(!d)return{layerId:l,results:[]};const o=d.map(g=>({name:g.name,vector:g.vector,score:h(i,g.vector)})).filter(({score:g})=>g>=m),b=f(o,n);return{layerId:l,results:b}});globalThis.postMessage({requestId:e,results:s})}catch(s){globalThis.postMessage({requestId:e,results:[],error:s instanceof Error?s.message:"Field search calculation error"})}break}default:console.warn("Unknown message type:",r)}})()})})();

package/dist/dispatcherAgent/reducers/commonReducers.d.ts

@@ -1 +1,2 @@
 export declare const replaceReducer: <T>(_prev: T, next: T) => T;
+export declare const mergeReducer: <T extends object>(prev: T, next: Partial<T>) => T;

package/dist/dispatcherAgent/state/dispatcherGraphState.d.ts

@@ -1,8 +1,8 @@
-import { ChatHistory } from '../../types/types';
+import { AgentExecutionContext } from '../../types/types';
 export declare const DispatcherGraphState: import('@langchain/langgraph').AnnotationRoot<{
-    userInput: import('@langchain/langgraph').LastValue<string>;
-    messages: import('@langchain/langgraph').BinaryOperatorAggregate<ChatHistory, ChatHistory>;
-    pendingIntents: import('@langchain/langgraph').BinaryOperatorAggregate<string[], string[]>;
-    currentIntent: import('@langchain/langgraph').BinaryOperatorAggregate<string, string>;
+    agentExecutionContext: import('@langchain/langgraph').BaseChannel<AgentExecutionContext, AgentExecutionContext | import('@langchain/langgraph').OverwriteValue<AgentExecutionContext>, unknown>;
+    currentIntent: import('@langchain/langgraph').BaseChannel<string, string | import('@langchain/langgraph').OverwriteValue<string>, unknown>;
+    requiresFollowUp: import('@langchain/langgraph').BaseChannel<boolean, boolean | import('@langchain/langgraph').OverwriteValue<boolean>, unknown>;
+    stepCount: import('@langchain/langgraph').BaseChannel<number, number | import('@langchain/langgraph').OverwriteValue<number>, unknown>;
 }>;
 export type DispatcherGraphStateType = typeof DispatcherGraphState.State;

package/dist/embeddings/cosineSimilarity.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Calculates the cosine similarity between two numeric vectors.
+ * * This implementation is safeguarded against zero-magnitudes (returns 0)
+ * and ensures the result is clamped between -1 and 1 to account for
+ * floating-point precision errors.
+ *
+ * @param a - The first vector array.
+ * @param b - The second vector array.
+ * @returns A similarity score from -1 (opposite) to 1 (identical).
+ * @throws {Error} If the vectors have different lengths.
+ */
+export declare const cosineSimilarity: (a: number[], b: number[]) => number;

package/dist/embeddings/embeddings-parser.d.ts

@@ -0,0 +1,6 @@
+import { LayersAndFieldsRegistry } from '../types/types';
+import { VectorizedLayer } from './webmapEmbeddings';
+import { WebmapEmbedding } from './webmapSchema';
+import { default as ArcGISMap } from '@arcgis/core/Map.js';
+export declare const validateEmbeddingsResponse: (data: unknown) => WebmapEmbedding;
+export declare const restoreRegistryFromVectorsAndValidation: (vectorizedLayers: VectorizedLayer[], arcgisMap: ArcGISMap) => LayersAndFieldsRegistry;

package/dist/embeddings/embeddingsUtil.d.ts

@@ -1 +1,7 @@
+/**
+ * Generates vector embeddings for a given array of strings.
+ * * @param {string[]} queries - An array of text strings to be embedded.
+ * @returns {Promise<number[][]>} A promise that resolves to an array of embedding vectors.
+ * @throws {Error} Throws an error if the embedding model fails to initialize or process the request.
+ */
 export declare const getEmbeddings: (queries: string[]) => Promise<number[][]>;

package/dist/embeddings/fetchWebMapEmbeddings.d.ts

@@ -0,0 +1,6 @@
+import { default as MapView } from '@arcgis/core/views/MapView.js';
+import { WebmapEmbedding } from './webmapSchema';
+/**
+ * Fetches and validates embeddings from a WebMap's portal resources.
+ */
+export declare const fetchWebMapEmbeddings: (view: MapView) => Promise<WebmapEmbedding>;

package/dist/embeddings/mmr.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Maximal Marginal Relevance selection.
+ * Balances relevance to the query against redundancy with already-selected items.
+ *
+ * @param candidates  - Scored candidates with their vectors retained
+ * @param topK        - How many results to return
+ * @param lambda      - 0 = max diversity, 1 = max relevance
+ */
+export declare const maximalMarginalRelevance: (candidates: {
+    name: string;
+    vector: number[];
+    score: number;
+}[], topK: number, lambda?: number) => {
+    name: string;
+    score: number;
+}[];

package/dist/embeddings/webmapEmbeddings.d.ts

@@ -1,10 +1,13 @@
 import { WebmapEmbedding } from './webmapSchema';
+import { default as MapView } from '@arcgis/core/views/MapView.js';
+export type VectorizedLayer = WebmapEmbedding["layers"][number];
+export type VectorizedField = VectorizedLayer["fields"][number];
 /**
  * Generates a structured, vectorized representation of a Webmap's layers and fields.
  * * Extracts metadata from the MapView, generates embeddings using a batched
  * API call, and validates the final object against the WebmapEmbeddingSchema.
- * * @param {__esri.MapView} mapView - The ArcGIS MapView containing layers to embed.
+ * * @param {MapView} mapView - The ArcGIS MapView containing layers to embed.
  * @returns {Promise<WebmapEmbedding>} The validated and vectorized webmap data.
  * @throws {Error} If the generated data fails schema validation.
  */
-export declare const createWebmapEmbeddings: (mapView: __esri.MapView) => Promise<WebmapEmbedding>;
+export declare const createWebmapEmbeddings: (mapView: MapView) => Promise<WebmapEmbedding>;

package/dist/embeddings/webmapSchema.d.ts

@@ -2,7 +2,7 @@ import { z } from 'zod';
 export declare const schemaVersion = "0.1";
 export declare const dimensions = 1536;
 export declare const modelProvider = "openai";
-export declare const model = "text-embedding-ada-002";
+export declare const model: string;
 export declare const layerTemplate = "Name: {name}\nTitle: {title}\nDescription: {description}";
 export declare const fieldTemplate = "Name: {name}\nAlias: {alias}\nDescription: {description}";
 export declare const WebmapEmbeddingSchema: z.ZodObject<{
@@ -10,131 +10,25 @@ export declare const WebmapEmbeddingSchema: z.ZodObject<{
     modified: z.ZodNumber;
     embeddings: z.ZodObject<{
         modelProvider: z.ZodLiteral<"openai">;
-        model: z.ZodLiteral<"text-embedding-ada-002">;
+        model: z.ZodLiteral<string>;
         dimensions: z.ZodLiteral<1536>;
         templates: z.ZodObject<{
             layer: z.ZodDefault<z.ZodString>;
             field: z.ZodDefault<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            layer: string;
-            field: string;
-        }, {
-            layer?: string | undefined;
-            field?: string | undefined;
-        }>;
-    }, "strip", z.ZodTypeAny, {
-        model: "text-embedding-ada-002";
-        dimensions: 1536;
-        modelProvider: "openai";
-        templates: {
-            layer: string;
-            field: string;
-        };
-    }, {
-        model: "text-embedding-ada-002";
-        dimensions: 1536;
-        modelProvider: "openai";
-        templates: {
-            layer?: string | undefined;
-            field?: string | undefined;
-        };
-    }>;
-    layers: z.ZodArray<z.ZodObject<{
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    layers: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
         title: z.ZodCatch<z.ZodString>;
         description: z.ZodCatch<z.ZodString>;
-        vector: z.ZodArray<z.ZodNumber, "many">;
+        vector: z.ZodArray<z.ZodNumber>;
         fields: z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             alias: z.ZodCatch<z.ZodString>;
             description: z.ZodCatch<z.ZodString>;
-            vector: z.ZodArray<z.ZodNumber, "many">;
-        }, "strip", z.ZodTypeAny, {
-            name: string;
-            description: string;
-            alias: string;
-            vector: number[];
-        }, {
-            name: string;
-            vector: number[];
-            description?: unknown;
-            alias?: unknown;
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        id: string;
-        name: string;
-        title: string;
-        description: string;
-        fields: {
-            name: string;
-            description: string;
-            alias: string;
-            vector: number[];
-        }[];
-        vector: number[];
-    }, {
-        id: string;
-        name: string;
-        fields: {
-            name: string;
-            vector: number[];
-            description?: unknown;
-            alias?: unknown;
-        }[];
-        vector: number[];
-        title?: unknown;
-        description?: unknown;
-    }>, "many">;
-}, "strip", z.ZodTypeAny, {
-    schemaVersion: "0.1";
-    modified: number;
-    embeddings: {
-        model: "text-embedding-ada-002";
-        dimensions: 1536;
-        modelProvider: "openai";
-        templates: {
-            layer: string;
-            field: string;
-        };
-    };
-    layers: {
-        id: string;
-        name: string;
-        title: string;
-        description: string;
-        fields: {
-            name: string;
-            description: string;
-            alias: string;
-            vector: number[];
-        }[];
-        vector: number[];
-    }[];
-}, {
-    schemaVersion: "0.1";
-    modified: number;
-    embeddings: {
-        model: "text-embedding-ada-002";
-        dimensions: 1536;
-        modelProvider: "openai";
-        templates: {
-            layer?: string | undefined;
-            field?: string | undefined;
-        };
-    };
-    layers: {
-        id: string;
-        name: string;
-        fields: {
-            name: string;
-            vector: number[];
-            description?: unknown;
-            alias?: unknown;
-        }[];
-        vector: number[];
-        title?: unknown;
-        description?: unknown;
-    }[];
-}>;
+            vector: z.ZodArray<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
 export type WebmapEmbedding = z.infer<typeof WebmapEmbeddingSchema>;

package/dist/embeddings.worker-GH7zdYqF.js

@@ -0,0 +1,24 @@
+const o = `(function(){"use strict";const h=(a,r)=>{if(a.length!==r.length)throw new Error("Vectors must be the same length");let c=0,t=0,e=0;for(let n=0;n<a.length;++n){const s=a[n],l=r[n];c+=s*l,t+=s*s,e+=l*l}const i=Math.sqrt(t*e);if(i===0)return 0;const m=c/i;return Math.max(-1,Math.min(1,m))},f=(a,r,c=.6)=>{const t=[],e=[...a];for(;t.length<r&&e.length>0;){let i=-1,m=-1/0;for(let n=0;n<e.length;n++){const s=e[n].score,l=t.length===0?0:Math.max(...t.map(o=>h(e[n].vector,o.vector))),d=c*s-(1-c)*l;d>m&&(m=d,i=n)}t.push(e[i]),e.splice(i,1)}return t.map(({name:i,score:m})=>({name:i,score:m}))};let p=[];const u=new Map,v=12,y=10,M=a=>{p=a.layers.map(r=>({id:r.id,vector:r.vector}))},E=a=>{u.clear();for(const r of a.layers){const c=r.fields.map(t=>({name:t.name,vector:t.vector}));u.set(r.id,c)}};globalThis.addEventListener("message",a=>{(async()=>{const{type:r,webmapEmbeddings:c,layerIdForFieldsSearch:t=[],requestId:e,precomputedEmbedding:i,minScore:m=0,topResults:n=v}=a.data;switch(r){case"generateEmbeddings":{c&&(M(c),E(c)),globalThis.postMessage("completed");break}case"layerSearch":{if(p.length>0)try{const s=p.map(o=>({id:o.id,vector:o.vector,score:h(i,o.vector)})),d=f(s.map(o=>({name:o.id,vector:o.vector,score:o.score})),y).map(({name:o,score:b})=>({id:o,score:b}));globalThis.postMessage({requestId:e,results:d})}catch(s){globalThis.postMessage({requestId:e,results:[],error:s instanceof Error?s.message:"Calculation error"})}else globalThis.postMessage({requestId:e,results:[],error:"Layer embeddings not initialized"});break}case"fieldSearch":{if(t.length>0)try{const s=t.map(l=>{const d=u.get(l);if(!d)return{layerId:l,results:[]};const o=d.map(g=>({name:g.name,vector:g.vector,score:h(i,g.vector)})).filter(({score:g})=>g>=m),b=f(o,n);return{layerId:l,results:b}});globalThis.postMessage({requestId:e,results:s})}catch(s){globalThis.postMessage({requestId:e,results:[],error:s instanceof Error?s.message:"Field search calculation error"})}break}default:console.warn("Unknown message type:",r)}})()})})();
+`, s = typeof self < "u" && self.Blob && new Blob(["(self.URL || self.webkitURL).revokeObjectURL(self.location.href);", o], { type: "text/javascript;charset=utf-8" });
+function a(r) {
+  let e;
+  try {
+    if (e = s && (self.URL || self.webkitURL).createObjectURL(s), !e) throw "";
+    const t = new Worker(e, {
+      name: r?.name
+    });
+    return t.addEventListener("error", () => {
+      (self.URL || self.webkitURL).revokeObjectURL(e);
+    }), t;
+  } catch {
+    return new Worker(
+      "data:text/javascript;charset=utf-8," + encodeURIComponent(o),
+      {
+        name: r?.name
+      }
+    );
+  }
+}
+export {
+  a as default
+};

package/dist/index.d.ts

@@ -2,6 +2,9 @@ export { Orchestrator } from './orchestrator/orchestrator';
 export { sendTraceMessage, sendUXSuggestion } from './signals';
 export { invokeTextPrompt, invokeStructuredPrompt, invokeToolPrompt } from './providers/arcgis/promptChain';
 export { createWebmapEmbeddings } from './embeddings/webmapEmbeddings';
-export type { CustomConfigurableType, VectorSearchFieldResults, LayersAndFieldsRegistry, Services, FieldInfo, FieldStatistics, ChatHistory, } from './types/types';
+export { getEmbeddings } from './embeddings/embeddingsUtil';
+export { cosineSimilarity } from './embeddings/cosineSimilarity';
+export type { CustomConfigurableType, VectorSearchFieldResults, LayersAndFieldsRegistry, Services, FieldInfo, FieldStatistics, ChatHistory, AgentExecutionContext, AgentStatus, PriorStep, } from './types/types';
+export type { UXSuggestion } from './orchestrator/orchestratorEvents';
 export type { UiInterrupt } from './hitl/types';
 export type { AgentRegistration, AgentWithContext } from './registry/agentRegistry';