@arcgis/ai-components 5.2.0-next.12 → 5.2.0-next.120

package/dist/agent-utils/index.js

@@ -1,148 +1,167 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-let r, a, i, c, u, l, s, w, f, m, p;
-async function n(o, e) {
-  if (e in o)
-    return o[e];
-  if ("default" in o) {
-    const t = await o.default;
-    return typeof t == "object" && t !== null && e in t ? t[e] : t;
+let i, a, c, u, l, s, w, m, f, p, d, g;
+async function n(e, t) {
+  if (t in e)
+    return e[t];
+  if ("default" in e) {
+    const o = await e.default;
+    return typeof o == "object" && o !== null && t in o ? o[t] : o;
   }
-  throw new Error(`Unable to resolve ${String(e)} from module.`);
+  throw new Error(`Unable to resolve ${String(t)} from module.`);
 }
-function k(o, e) {
-  const t = {};
-  for (const [d, W] of Object.entries(e))
-    t[d] = g(o, W);
-  return t;
+function y(e, t) {
+  const o = {};
+  for (const [r, k] of Object.entries(t))
+    o[r] = S(e, k);
+  return o;
 }
-function h(o, e) {
-  return o.object(k(o, e));
+function W(e, t) {
+  return e.object(y(e, t));
 }
-function g(o, e) {
-  const t = y(o, e);
-  return e.required === !0 ? t : t.optional();
+function S(e, t) {
+  const o = h(e, t);
+  return t.required === !0 ? o : o.optional();
 }
-function y(o, e) {
-  let t = P(o, e);
-  return e.description !== void 0 && (t = t.describe(e.description)), t;
+function h(e, t) {
+  let o = P(e, t);
+  return t.description !== void 0 && (o = o.describe(t.description)), o;
 }
-function M(o, e) {
-  switch (e) {
+function b(e, t) {
+  switch (t) {
     case "string":
-      return o.string();
+      return e.string();
     case "number":
-      return o.number();
+      return e.number();
     case "boolean":
-      return o.boolean();
+      return e.boolean();
   }
 }
-function P(o, e) {
-  switch (e.type) {
+function M(e) {
+  return e === "string" || e === "number" || e === "boolean";
+}
+function P(e, t) {
+  switch (t.type) {
     case "string": {
-      if (e.enum !== void 0) {
-        if (e.enum.length === 0)
+      if (t.enum != null) {
+        if (t.enum.length === 0)
           throw new Error("String schema field enum must include at least one value.");
-        return o.enum(e.enum);
+        return e.enum(t.enum);
       }
-      return o.string();
+      return e.string();
     }
     case "number":
-      return o.number();
+      return e.number();
     case "boolean":
-      return o.boolean();
+      return e.boolean();
     case "array": {
-      if (e.itemType === void 0)
+      if (t.itemType == null)
         throw new Error("Array schema field requires an itemType definition.");
-      return o.array(M(o, e.itemType));
+      return e.array(
+        M(t.itemType) ? b(e, t.itemType) : h(e, t.itemType)
+      );
+    }
+    case "object": {
+      if (t.fields == null)
+        throw new Error("Object schema field requires a fields definition.");
+      return W(e, t.fields);
     }
   }
 }
-async function S(o) {
-  p ??= import("zod");
-  const e = await p;
-  return h(e.z, o);
-}
-async function b(o) {
-  r ??= import("./FunctionAgent.js");
-  const e = await r, t = await n(
-    e,
+async function A(e) {
+  d ??= import("zod");
+  const t = await d;
+  return W(t.z, e);
+}
+async function T(e, t) {
+  g ??= import("../utils/index.js");
+  const o = await g;
+  return await (await n(
+    o,
+    "sendUXSuggestion"
+  ))(e, t);
+}
+async function L(e) {
+  i ??= import("./FunctionAgent.js");
+  const t = await i, o = await n(
+    t,
     "FunctionAgent"
   );
-  return new t(o);
+  return new o(e);
 }
-async function A(o) {
+async function q(e) {
   a ??= import("./tools/FunctionTool.js");
-  const e = await a, t = await n(
-    e,
+  const t = await a, o = await n(
+    t,
     "FunctionTool"
   );
-  return new t(o);
+  return new o(e);
 }
-async function L(o) {
-  i ??= import("./LLMAgent.js");
-  const e = await i, t = await n(e, "LLMAgent");
-  return new t(o);
+async function F(e) {
+  c ??= import("./LLMAgent.js");
+  const t = await c, o = await n(t, "LLMAgent");
+  return new o(e);
 }
-async function q(o) {
-  c ??= import("./WorkflowAgent.js");
-  const e = await c, t = await n(
-    e,
+async function j(e) {
+  u ??= import("./WorkflowAgent.js");
+  const t = await u, o = await n(
+    t,
     "WorkflowAgent"
   );
-  return new t(o);
+  return new o(e);
 }
-async function F(o) {
-  u ??= import("./workflows/ConditionalWorkflow.js");
-  const e = await u, t = await n(e, "ConditionalWorkflow");
-  return new t(o);
+async function E(e) {
+  l ??= import("./workflows/ConditionalWorkflow.js");
+  const t = await l, o = await n(t, "ConditionalWorkflow");
+  return new o(e);
 }
-async function T(o) {
-  l ??= import("./workflows/LoopWorkflow.js");
-  const e = await l, t = await n(
-    e,
+async function v(e) {
+  s ??= import("./workflows/LoopWorkflow.js");
+  const t = await s, o = await n(
+    t,
     "LoopWorkflow"
   );
-  return new t(o);
+  return new o(e);
 }
-async function v(o) {
-  s ??= import("./workflows/ParallelWorkflow.js");
-  const e = await s, t = await n(
-    e,
+async function U(e) {
+  w ??= import("./workflows/ParallelWorkflow.js");
+  const t = await w, o = await n(
+    t,
     "ParallelWorkflow"
   );
-  return new t(o);
+  return new o(e);
 }
-async function E(o) {
-  w ??= import("./workflows/RouterWorkflow.js");
-  const e = await w, t = await n(
-    e,
+async function R(e) {
+  m ??= import("./workflows/RouterWorkflow.js");
+  const t = await m, o = await n(
+    t,
     "RouterWorkflow"
   );
-  return new t(o);
+  return new o(e);
 }
-async function j(o) {
+async function X(e) {
   f ??= import("./workflows/SequentialWorkflow.js");
-  const e = await f, t = await n(e, "SequentialWorkflow");
-  return new t(o);
+  const t = await f, o = await n(t, "SequentialWorkflow");
+  return new o(e);
 }
-async function R(o) {
-  m ??= import("./workflows/SwitchWorkflow.js");
-  const e = await m, t = await n(
-    e,
+async function x(e) {
+  p ??= import("./workflows/SwitchWorkflow.js");
+  const t = await p, o = await n(
+    t,
     "SwitchWorkflow"
   );
-  return new t(o);
+  return new o(e);
 }
 export {
-  F as createConditionalWorkflow,
-  b as createFunctionAgent,
-  A as createFunctionTool,
-  L as createLLMAgent,
-  T as createLoopWorkflow,
-  v as createParallelWorkflow,
-  E as createRouterWorkflow,
-  S as createSchema,
-  j as createSequentialWorkflow,
-  R as createSwitchWorkflow,
-  q as createWorkflowAgent
+  E as createConditionalWorkflow,
+  L as createFunctionAgent,
+  q as createFunctionTool,
+  F as createLLMAgent,
+  v as createLoopWorkflow,
+  U as createParallelWorkflow,
+  R as createRouterWorkflow,
+  A as createSchema,
+  X as createSequentialWorkflow,
+  x as createSwitchWorkflow,
+  j as createWorkflowAgent,
+  T as sendUXSuggestion
 };

package/dist/agent-utils/middlewares/trace.d.ts

@@ -10,6 +10,7 @@ import type { AgentData } from "../types.js";
  * executions, which can be useful for debugging and monitoring the agent's behavior.
  *
  * @returns An agent middleware that wraps model calls and sends trace messages.
+ * @internal
  * @since 5.1
  */
 export function createAgentTraceMiddleware(): AgentMiddleware;
@@ -20,6 +21,7 @@ export function createAgentTraceMiddleware(): AgentMiddleware;
  * debugging and monitoring the behavior of tools within the agent's execution.
  *
  * @returns A function tool middleware that wraps tool calls and sends trace messages.
+ * @internal
  * @since 5.1
  */
 export function createToolTraceMiddleware<TInput extends AgentData = AgentData, TOutput = unknown>(): FunctionToolMiddleware<TInput, TOutput>;

package/dist/agent-utils/middlewares/trace.js

@@ -1,5 +1,5 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { s as r } from "../../chunks/index.js";
+import { s as n } from "../../chunks/index.js";
 import { AIMessage as i, ToolMessage as s } from "@langchain/core/messages";
 import { createAgentMiddleware as c, createToolMiddleware as d } from "./middleware.js";
 const g = "agent-trace", f = "tool-trace";
@@ -9,9 +9,9 @@ function p() {
       const t = await a(e), o = e.runtime, l = m(t);
       return await Promise.all(
         l.map(
-          async (n) => await r(
+          async (r) => await n(
             {
-              text: `LLM requested tool call "${n.name}" with arguments: ${JSON.stringify(n.args, null, 2)}`
+              text: `LLM requested tool call "${r.name}" with arguments: ${JSON.stringify(r.args, null, 2)}`
             },
             o
           )
@@ -24,9 +24,9 @@ function T() {
   return d(f, {
     wrapToolCall: async (e, a) => {
       const t = await a(e), o = e.config;
-      return await r(
+      return await n(
         {
-          text: `Finished executing tool: ${s.isInstance(t) ? t.content.toString() : typeof t == "string" ? t : e.tool.name}`
+          text: `Finished executing tool: ${s.isInstance(t) ? t.text : typeof t == "string" ? t : e.tool.name}`
         },
         o
       ), t;

package/dist/agent-utils/types.d.ts

@@ -1,12 +1,11 @@
 import type z from "zod";
 import type { BaseChannel, BinaryOperatorAggregate } from "@langchain/langgraph/channels";
 import type { AnnotationRoot, StateDefinitionInit, StateGraph } from "@langchain/langgraph/web";
-import type { AgentExecutionContext, AgentRegistration, AgentStatus } from "../utils/index.js";
+import type { AgentExecutionContext, AgentRegistration, AgentStatus, AssistantInputPart } from "../utils/index.js";
+import type { SharedResourceInput } from "../orchestrator/types/types.js";
 
-/** @internal */
 export type AgentData = Record<string, unknown>;
 
-/** @internal */
 export type EmptyAgentData = Record<never, never>;
 
 /** @internal */
@@ -16,13 +15,18 @@ export type ZodModule = {
 
 export type SchemaPrimitiveFieldType = "boolean" | "number" | "string";
 
+export type SchemaArrayItemDefinition = SchemaFieldDefinition | SchemaPrimitiveFieldType;
+
 export type SchemaFieldDefinition = ({
-    enum?: readonly string[];
-    type: "string";
-} | {
-    itemType: SchemaPrimitiveFieldType;
     type: "array";
-} | { type: "boolean" | "number"; }) & {
+    itemType: SchemaArrayItemDefinition;
+} | { type: "boolean" | "number"; } | {
+    type: "object";
+    fields: SchemaDefinition;
+} | {
+    type: "string";
+    enum?: readonly string[];
+}) & {
   description?: string;
   required?: boolean;
 };
@@ -36,7 +40,7 @@ export type SchemaDefinitionData<TDefinition extends SchemaDefinition> = {
     [K in keyof TDefinition as TDefinition[K] extends { required: true; } ? never : K]?: SchemaFieldData<TDefinition[K]>;
 };
 
-/** @privateRemark All ADK agents are orchestrator-driven, so these channels exist for every agent graph. */
+/** @privateRemark All agents are orchestrator-driven, so these channels exist for every agent graph. */
 export type AgentRuntimeState = {
   agentExecutionContext: AgentExecutionContext;
   /** The outputMessage is a string representing the output of an agent execution. */
@@ -45,9 +49,10 @@ export type AgentRuntimeState = {
   summary: string;
   /** The status field represents the current status of the agent execution, which can be used to indicate success, failure, or other relevant states. */
   status?: AgentStatus;
+  sharedResourceAdditions?: readonly SharedResourceInput[];
 };
 
-export type AgentGraphState<TState extends AgentData = EmptyAgentData> = AgentRuntimeState
+export type AgentGraphState<TState extends AgentData = EmptyAgentData> = InternalAgentRuntimeState
   & Omit<TState, keyof AgentRuntimeState>;
 
 export interface BaseAgentLike<TCustomState extends AgentData = EmptyAgentData> {
@@ -128,7 +133,6 @@ export type AgentNodeUpdate<TInput extends AgentData, TOutput extends AgentData>
  * AgentStateAnnotation defines the shape of the agent state used in LangGraph nodes, including both the built-in runtime channels
  * and any custom fields defined by the agent.
  *
- * @internal
  * @since 5.1
  */
 export type AgentStateAnnotation<TState extends AgentData> = AnnotationRoot<{
@@ -138,6 +142,7 @@ export type AgentStateAnnotation<TState extends AgentData> = AnnotationRoot<{
     outputMessage: BaseChannel<string, unknown, unknown>;
     summary: BaseChannel<string, unknown, unknown>;
     status: BaseChannel<AgentStatus | undefined, unknown, unknown>;
+    sharedResourceAdditions: BaseChannel<readonly SharedResourceInput[] | undefined, unknown, unknown>;
 }>;
 
 /**
@@ -150,7 +155,6 @@ export type RunnableUpdate<TState extends AgentData> = Partial<TState> extends o
 /**
  * Internal type representing the compiled graph used for agent execution.
  *
- * @internal
  * @since 5.1
  */
 export type TypedStateGraph<TState extends AgentData> = StateGraph<StateDefinitionInit, AgentGraphState<TState>, RunnableUpdate<AgentGraphState<TState>>, string>;
@@ -159,7 +163,6 @@ export type TypedStateGraph<TState extends AgentData> = StateGraph<StateDefiniti
  * The shape of the `createGraph` function used by agents to generate their internal graph representation.
  * This function is responsible for defining the nodes and edges of the graph, as well as any associated state and middleware.
  *
- * @internal
  * @since 5.1
  */
 export type AgentCreateGraph<TState extends AgentData> = () => TypedStateGraph<TState>;
@@ -168,7 +171,7 @@ export type AgentCreateGraph<TState extends AgentData> = () => TypedStateGraph<T
 export type ZodObjectSchema<T extends object = AgentData> = Pick<z.ZodType<T>, "safeParse">
   & z.ZodObject;
 
-export type GraphNodes<S extends AgentData> = Record<string, (state: S, config?: AgentExecutionConfig) => Partial<S> | Promise<Partial<S> | S> | S>;
+export type GraphNodes<S extends AgentData, TUpdate = Partial<S>> = Record<string, (state: S, config?: AgentExecutionConfig) => Promise<S | TUpdate> | S | TUpdate>;
 
 export type GraphEdge<S extends AgentData> = {
     from: string;
@@ -178,4 +181,14 @@ export type GraphEdge<S extends AgentData> = {
     to: string;
 };
 
-export type SchemaFieldData<TField extends SchemaFieldDefinition> = TField extends { type: "string"; } ? TField["enum"] extends readonly (infer TValue extends string)[] ? TValue : string : TField extends { type: "array"; } ? (TField["itemType"] extends "string" ? string : TField["itemType"] extends "number" ? number : boolean)[] : TField extends { type: "number"; } ? number : boolean;
+export type SchemaFieldData<TField extends SchemaFieldDefinition> = TField extends { type: "string"; } ? TField["enum"] extends readonly (infer TValue extends string)[] ? TValue : string : TField extends { type: "array"; } ? (TField["itemType"] extends "string" ? string : TField["itemType"] extends "number" ? number : TField["itemType"] extends "boolean" ? boolean : TField["itemType"] extends SchemaFieldDefinition ? SchemaFieldData<TField["itemType"]> : never)[] : TField extends { type: "object"; } ? SchemaDefinitionData<TField["fields"]> : TField extends { type: "number"; } ? number : boolean;
+
+export type InternalAgentRuntimeState = Omit<AgentRuntimeState, "agentExecutionContext">
+  & {
+  agentExecutionContext: InternalAgentExecutionContext;
+};
+
+export type InternalAgentExecutionContext = AgentExecutionContext
+  & {
+  inputParts?: readonly AssistantInputPart[];
+};

package/dist/agentic-workflow/AgenticWorkflowRuntime.d.ts

@@ -0,0 +1,24 @@
+import type { AgentCreateGraph, AgentCustomState, AgentData, AgentStateAnnotation, ZodObjectSchema } from "../agent-utils/types.js";
+import type { AgenticWorkflowJson } from "./jsonTypes.js";
+import type { GraphNodeResultsState } from "./types.js";
+
+/**
+ * Loads and compiles an ArcGIS Agentic Workflow definition into an executable graph.
+ *
+ * @internal
+ */
+export class AgenticWorkflowRuntime<TInput extends AgentData = AgentData, TOutput extends AgentData = AgentData> {
+  /** @param sourceJSON */
+  static fromJSON<TInput extends AgentData = AgentData, TOutput extends AgentData = AgentData>(sourceJSON: AgenticWorkflowJson): AgenticWorkflowRuntime<TInput, TOutput>;
+  generate(): AgenticWorkflowGenerateResult<TInput, TOutput>;
+  getSchemas(): ZodObjectSchema<object>[];
+  load(): Promise<this>;
+}
+
+export type AgenticWorkflowGenerateResult<TInput extends AgentData, TOutput extends AgentData> = {
+  createGraph: AgentCreateGraph<AgenticWorkflowState<TInput, TOutput>>;
+  workspace: AgentStateAnnotation<AgenticWorkflowState<TInput, TOutput>>;
+};
+
+export type AgenticWorkflowState<TInput extends AgentData, TOutput extends AgentData> = GraphNodeResultsState
+  & Omit<AgentCustomState<TInput, TOutput>, "nodes">;

package/dist/agentic-workflow/Edge.d.ts

@@ -0,0 +1,16 @@
+import type Accessor from "@arcgis/core/core/Accessor.js";
+import type { AgenticWorkflowEdgeJson } from "./jsonTypes.js";
+
+/** @internal */
+export class Edge extends Accessor {
+  /** @param json */
+  static fromJSON(json: AgenticWorkflowEdgeJson): Edge;
+  constructor(properties?: EdgeConstructProperties);
+  accessor id: string;
+  accessor sourceAnchorId: string;
+  accessor sourceNodeId: string;
+  accessor targetAnchorId: string | undefined;
+  accessor targetNodeId: string;
+}
+
+export type EdgeConstructProperties = Pick<Edge, "id" | "sourceAnchorId" | "sourceNodeId" | "targetAnchorId" | "targetNodeId">;

package/dist/agentic-workflow/WebAgent.d.ts

@@ -0,0 +1,39 @@
+import type PortalItem from "@arcgis/core/portal/PortalItem.js";
+import type { BaseAgent } from "../agent-utils/BaseAgent.js";
+import type { AgentData, ZodObjectSchema } from "../agent-utils/types.js";
+import type { AgenticWorkflowJson } from "./jsonTypes.js";
+import type { AgenticWorkflowState } from "./AgenticWorkflowRuntime.js";
+
+/** @internal */
+export class WebAgent<TInput extends AgentData = AgentData, TOutput extends AgentData = AgentData> extends BaseAgent<WebAgentState<TInput, TOutput>> {
+  constructor(properties?: WebAgentConstructProperties<TInput, TOutput>);
+  /**
+   * The portal item associated with this web agent
+   *
+   * @required
+   */
+  accessor portalItem: PortalItem | undefined;
+  accessor sourceJSON: AgenticWorkflowJson | undefined;
+  /**
+   * Rebuilds internal workspace and createGraph wiring. This is automatically called during initialization and whenever
+   * the name or description properties change, but can also be called manually if needed to refresh the agent's graph definition.
+   *
+   * The agent implementation is responsible for defining the createGraph function and workspace structure in this method, which are then used during execution.
+   *
+   * @internal
+   */
+  generate(): void;
+  /**
+   * Returns all schemas required by this agent implementation.
+   *
+   * @returns An array of Zod object schemas that define the structure of the agent's expected input and output data.
+   * These schemas are used for validation and type inference during graph execution.
+   * @internal
+   */
+  getSchemas(): ZodObjectSchema<object>[];
+  load(): Promise<this>;
+}
+
+export type WebAgentState<TInput extends AgentData, TOutput extends AgentData> = AgenticWorkflowState<TInput, TOutput>;
+
+export type WebAgentConstructProperties<TInput extends AgentData, TOutput extends AgentData> = Partial<Pick<WebAgent<TInput, TOutput>, "portalItem" | "sourceJSON">>;