@arcgis/ai-components 5.2.0-next.103 → 5.2.0-next.105

package/dist/chunks/generateLayerDescriptions.js

@@ -124,6 +124,9 @@ const se = () => {
   return new Y({
     modelName: n,
     apiKey: "dummy-key",
+    useResponsesApi: !0,
+    // Prevent follow-up Responses API calls from replaying encrypted reasoning items the ArcGIS proxy cannot verify.
+    zdrEnabled: !0,
     configuration: {
       baseURL: i,
       fetch: await _({ config: o })
@@ -147,7 +150,7 @@ const se = () => {
   description: r.string().min(1)
 });
 r.array(fe);
-const A = (e) => JSON.stringify(e, null, 2), he = (e) => {
+const C = (e) => JSON.stringify(e, null, 2), he = (e) => {
   const t = e.map((n) => n.id), o = r.enum(t);
   return r.object({
     intent: o.nullable(),
@@ -176,11 +179,11 @@ const A = (e) => JSON.stringify(e, null, 2), he = (e) => {
         currentIntent: "none",
         finalOutputMessage: "No agents registered; skipping intent detection."
       };
-    const a = await E("intent_prompt"), c = A(s), l = he(s), p = {
+    const a = await E("intent_prompt"), c = C(s), l = he(s), p = {
       registeredAgents: c,
-      priorSteps: A(e.agentExecutionContext.priorSteps),
+      priorSteps: C(e.agentExecutionContext.priorSteps),
       userRequest: e.agentExecutionContext.userRequest
-    }, b = await q.fromTemplate(a).format(p), C = G({
+    }, b = await q.fromTemplate(a).format(p), A = G({
       model: await w({
         modelTier: "fast",
         config: t
@@ -205,7 +208,7 @@ const A = (e) => JSON.stringify(e, null, 2), he = (e) => {
         Q({ runLimit: 2 })
       ]
     }), { structuredResponse: v } = await le({
-      agent: C,
+      agent: A,
       messages: e.agentExecutionContext.messages,
       config: t
     }), u = l.parse(
@@ -321,11 +324,8 @@ Description: {description}`, Ke = r.object({
     messages: n,
     config: s
   })).invoke(i ?? {}, s);
-  if (typeof c == "string")
-    return c;
-  const l = c.content;
-  return typeof l == "string" ? l : JSON.stringify(l);
-}, O = async (e) => {
+  return typeof c == "string" ? c : c.text;
+}, $ = async (e) => {
   const { promptText: t, modelTier: o = "default", messages: n, inputVariables: i, schema: s, config: a } = e, c = R(t, n ?? []), p = (await w({ modelTier: o, config: a })).withStructuredOutput(s);
   return await c.pipe(p).invoke(i ?? {}, a);
 }, He = async (e) => {
@@ -338,8 +338,8 @@ Description: {description}`, Ke = r.object({
   alias: m.string()
 }), Ie = m.object({
   fields: m.array(Se)
-}), $ = (e, t) => e.getFieldAlias(t) ?? void 0, I = (e, t) => $(e, t.name) ?? t.alias ?? "", ke = (e, t) => {
-  const o = $(e, t.name);
+}), O = (e, t) => e.getFieldAlias(t) ?? void 0, I = (e, t) => O(e, t.name) ?? t.alias ?? "", ke = (e, t) => {
+  const o = O(e, t.name);
   return !!(o && o !== (t.alias ?? ""));
 };
 function D(e, t) {
@@ -371,7 +371,7 @@ const We = async (e) => {
     existingLayerTitle: e.title,
     existingLayerDescription: e.portalItem?.description,
     fieldInformation: n
-  }, s = await O({
+  }, s = await $({
     promptText: o,
     schema: Ie,
     inputVariables: i
@@ -389,7 +389,7 @@ const We = async (e) => {
     existingLayerSnippet: e.portalItem?.snippet,
     layerGeometryType: e.geometryType
   };
-  return { ...await O({
+  return { ...await $({
     promptText: n,
     schema: Ee,
     inputVariables: s
@@ -406,7 +406,7 @@ export {
   xe as f,
   We as g,
   He as h,
-  O as i,
+  $ as i,
   ie as j,
   ae as k,
   ve as l,

package/dist/components/arcgis-assistant/customElement.d.ts

@@ -118,26 +118,46 @@ export abstract class ArcgisAssistant extends LitElement {
       waitingForUserInputMessage: string;
   }>;
   /**
-   * The IDs of the agents available to automatic intent routing.
+   * The IDs of the agents available for automatic intent routing.
    * A single ID still uses automatic routing and does not enable direct routing.
    * This property cannot be used together with [alwaysUseAgentId](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/#alwaysUseAgentId).
+   * If this property is not set, all registered agents are available for routing.
+   *
+   * > **Note:** Agent ids for custom agents are automatically created from the agent's
+   * > [BaseAgent.name](https://developers.arcgis.com/javascript/latest/references/ai-components/agent-utils/BaseAgent/#name) property.
+   * > For example, an agent with the name "My Custom Agent" will have the id "my-custom-agent".
+   *
+   * Agent ids for SDK agents are as follows:
+   *
+   * - Navigation Agent: `navigation`
+   * - Data Exploration Agent: `dataExploration`
+   * - Help Agent: `help`
+   * - Knowledge Agent: `arcgisKnowledge`
    *
    * @since 5.2
    * @example
    * ```js
    * const assistant = document.querySelector("arcgis-assistant");
+   * // only route user questions to either the navigation or help agents
+   * // even if other agents are registered to the assistant
    * assistant.allowedAgentIds = ["navigation", "help"];
    * ```
    */
   accessor allowedAgentIds: readonly string[] | undefined;
   /**
    * The ID of the agent that should process every user message without intent routing.
-   * When this property is set, it cannot be used together with [allowedAgentIds](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/#allowedAgentIds).
+   * When set, the assistant will route all user messages to the specified agent.
+   *
+   * This is useful for applications that want to bypass the orchestrator's default intent routing
+   * in favor of a single custom agent that directly handles its own intent orchestration to one or more sub-agents. This property
+   * should not be used to route requests to an SDK agent, as the SDK agents do not have their own intent routing outside of the orchestrator.
+   *
+   * This property cannot be used together with [allowedAgentIds](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/#allowedAgentIds).
    *
    * @since 5.2
    * @example
    * ```html
-   * <arcgis-assistant always-use-agent-id="navigation"></arcgis-assistant>
+   * <arcgis-assistant always-use-agent-id="my-custom-orchestration-agent"></arcgis-assistant>
    * ```
    */
   accessor alwaysUseAgentId: string | undefined;

package/dist/components/arcgis-assistant-knowledge-agent/customElement.d.ts

@@ -107,7 +107,7 @@ import type { ArcgisMap as ArcgisMap } from "@arcgis/map-components/components/a
 export abstract class ArcgisAssistantKnowledgeAgent extends LitElement {
   /**
    * Optional context for the knowledge agent. If the agent does not have a view or kg service url provided via reference element or serviceUrl property
-   * a knowledge graph can be provided directly via context to enable Knowledge Service related capabilties.
+   * a knowledge graph can be provided directly via context to enable Knowledge Service related capabilities.
    *
    * Depending on the context provided, different capabilities will be available.
    */