@arcgis/ai-components 5.2.0-next.99 → 6.0.0-next.1

package/dist/orchestrator/types.d.ts

@@ -0,0 +1,305 @@
+import type { SharedState, SharedResource } from "./state/types.js";
+import type { BaseMessage } from "@langchain/core/messages";
+import type { AnnotationRoot, StateGraph } from "@langchain/langgraph/web";
+import type { AgentRegistry } from "./registry/agentRegistry.js";
+import type { FieldSearchService } from "./services/fieldSearch.js";
+import type { LayerSearchService } from "./services/layerSearch.js";
+import type { UniqueValueCountInfo, SummaryStatisticsResult } from "@arcgis/core/smartMapping/statistics/types.js";
+import type { DomainUnion } from "@arcgis/core/layers/support/types.js";
+
+/**
+ * Represents the chat message history between the user and the assistant, including all messages sent and received during the conversation.
+ * This structure is used to provide context for the assistant's responses and can be utilized when invoking prompts to ensure the model
+ * has access to the full conversation history.
+ */
+export type ChatHistory = BaseMessage[];
+
+/**
+ * Definition of a client-side agent to register to the [arcgis-assistant-agent](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant-agent/) component.
+ * To construct an agent, you must build a state graph using LangGraph that defines the agent's
+ * nodes, edges, workspace variables, and tools.
+ *
+ * @see [LangGraph documentation](https://docs.langchain.com/oss/javascript/langgraph/overview)
+ * @see [Custom agents guide](https://developers.arcgis.com/javascript/latest/agentic-apps/ai-custom-agents/)
+ * @beta
+ */
+export interface AgentRegistration {
+  /** A unique identifier for the agent. */
+  id: string;
+  /** A human-readable name for the agent. This must be unique, but also be semantically meaningful. */
+  name: string;
+  /**
+   * A brief description of the agent's purpose and functionality. This is required for the agent to be
+   * discoverable in the orchestration of the [arcgis-assistant](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/). It should provide enough information
+   * for the Assistant component and users to understand when to use this agent and what it can do.
+   * This description should provide examples of user prompts that would indicate this agent should be used.
+   *
+   * @example
+   * ```js
+   * agentRegistration.description = "This agent calculates service areas for a given location.
+   * Use this agent when users ask questions about drive or walk times from a specific location, or when they
+   * ask for areas reachable within a certain time frame from a location.";
+   * ```
+   */
+  description: string;
+  /**
+   * A function that creates and returns the agent's state graph. This graph defines the agent's behavior,
+   * including how it processes inputs, makes decisions, and produces outputs. The graph consists of nodes and edges
+   * that represent the agent's deterministic logic and flow. This is a structure defined using LangGraph's StateGraph.
+   *
+   * @see [LangGraph documentation](https://docs.langchain.com/oss/javascript/langgraph/overview)
+   * @see [StateGraph documentation](https://langchain-ai.github.io/langgraphjs/reference/classes/langgraph.StateGraph.html)
+   * @see [Custom agents guide](https://developers.arcgis.com/javascript/latest/agentic-apps/ai-custom-agents/)
+   */
+  createGraph: () => StateGraph<unknown>;
+  /**
+   * The workspace variables or context required by the agent's graph. This includes messages, results,
+   * and any other relevant data required by the LLM to make decisions and determine parameters for function calls.
+   * This is a structure defined using LangGraph's AnnotationRoot.
+   *
+   * @see [LangGraph documentation](https://docs.langchain.com/oss/javascript/langgraph/overview)
+   * @see [AnnotationRoot documentation](https://langchain-ai.github.io/langgraphjs/reference/modules/langgraph.Annotation.html)
+   * @see [Custom agents guide](https://developers.arcgis.com/javascript/latest/agentic-apps/ai-custom-agents/)
+   */
+  workspace: AnnotationRoot<any>;
+}
+
+/** @internal */
+export type GetContext<TContext extends Record<string, unknown>> = () => Promise<TContext> | TContext;
+
+/** @internal */
+export interface AgentWithContext<TContext extends Record<string, unknown> = Record<string, unknown>> {
+  agent: AgentRegistration;
+  /**
+   * Lazily resolves runtime context.
+   * Can be sync or async, and may perform lifecycle checks (e.g. await view.when()).
+   */
+  getContext?: GetContext<TContext>;
+}
+
+export type VectorSearchFieldResults = FieldVectors[];
+
+/**
+ * Structured input associated with an assistant request.
+ *
+ * @internal
+ * @since 5.2
+ */
+export type AssistantInputPart = Readonly<{
+    kind: "command";
+    id: string;
+    label: string;
+    agentId?: string;
+    data?: unknown;
+}> | Readonly<{
+    kind: "entity";
+    providerId: string;
+    trigger: string;
+    id: string;
+    label: string;
+    data?: unknown;
+}>;
+
+/** @internal */
+export type AskInputOptions = {
+  /**
+   * Structured input submitted with this orchestrator request.
+   *
+   * @internal
+   */
+  inputParts?: readonly AssistantInputPart[];
+};
+
+/** Options for executing a registered agent directly. */
+export type DirectRoutingOptions = {
+  /** Execute a registered agent directly without calling the intent LLM. */
+  routing: "direct";
+  /** ID of the registered agent that will execute the request. */
+  agentId: string;
+  /** Locale used for localized agent responses. */
+  locale?: string;
+};
+
+/** Options for routing a request through the intent LLM. */
+export type AutoRoutingOptions = {
+  /** Route the request through the intent LLM. */
+  routing?: "auto";
+  /** Optional subset of registered agents available to the intent LLM. */
+  agentIds?: readonly string[];
+  /** Locale used for localized agent responses. */
+  locale?: string;
+};
+
+/** Agent selection and routing behavior for an orchestrator run. */
+export type AskOptions = AutoRoutingOptions | DirectRoutingOptions;
+
+/**
+ * Object used for getting and managing the context provided to an agent via its `context` property.
+ * This is used to access application state context, such as the map view or other relevant variables,
+ * that an agent may require to perform its tasks.
+ */
+export type CustomConfigurableType = Record<string, unknown>
+  & {
+  thread_id: string;
+  /** Locale used for localized agent responses. */
+  locale: string;
+  /** Optional HITL response injected by the host application. */
+  hitlResponse: HITLResponse | null;
+  /** Runtime services provided to agents and nodes. */
+  services: Services;
+  agentId?: string;
+  context?: unknown;
+};
+
+/** Cache for query embeddings to avoid duplicate API calls within a request */
+export type QueryEmbeddingCache = Map<string, number[]>;
+
+/**
+ * Runtime execution context available to agent graph nodes and tools.
+ *
+ * @since 5.1
+ */
+export type AgentExecutionContext<TState extends SharedState = SharedState> = Readonly<AgentExecutionContextShape<TState>>;
+
+/** Summary of a previously executed agent step. */
+export interface PriorStep {
+  /** The agent that handled the step. */
+  agentId: string;
+  /** The task assigned to the agent for this step. */
+  assignedTask: string;
+  /** A brief summary of the step's execution. */
+  summary: string;
+  /** The execution status of the step. */
+  status: AgentStatus;
+}
+
+/** Execution status returned by an agent run. */
+export type AgentStatus = "failed" | "success" | "unknown";
+
+/**
+ * Represents a user-facing interruption emitted by an agent that requires
+ * input before execution can continue. This is used to implement human-in-the-loop workflows where
+ * the agent needs to ask the user for clarification, confirmation, or additional information
+ * before proceeding with its tasks.
+ *
+ * Used to pause an agent flow and request clarification, confirmation,
+ * or additional information from the user.
+ */
+export interface UiInterrupt {
+  /**
+   * Unique identifier for this interrupt instance. This is used to associate the interrupt with a
+   * specific message or action in the agent's workflow, allowing the system to track and manage the
+   * interrupt effectively.
+   */
+  id: string;
+  /**
+   * Identifier of the agent requesting input (e.g. "navigation", "myCustomAgent", etc.).
+   * This is used to associate the interrupt with the specific agent that emitted it, which
+   * can be helpful for debugging, logging, and providing context to the user about which agent
+   * is requesting input.
+   */
+  agentId: string;
+  /**
+   * The type of input being requested. See the list below for the currently supported input types. This is used
+   * to determine how to render the interrupt in the user interface and what kind of input to expect from the user.
+   *
+   * - `booleanChoice` - Presents the user with a yes or no option. This is typically used for confirmation
+   * prompts where the agent needs to confirm an action with the user before proceeding. For example, some actions
+   * may have a high risk of being destructive, such as applying an edit, submitting a form, or deleting data.
+   * In these cases, the agent might ask for confirmation before proceeding.
+   * - `multipleSelection` - Presents the user with multiple options that the user may choose from in a checkbox
+   * interface.
+   * - `singleSelection` - Presents the user with a list of options in a radio button interface, prompting the user
+   * to select a single option from a list.
+   * - `textInput` - Prompts the user to enter free-form text before proceeding. This is a flexible input
+   * type that can be used for a wide variety of purposes, such as asking the user for more details about
+   * a request, requesting specific information needed to complete a task, or allowing the user to
+   * provide feedback or additional context.
+   */
+  kind: "booleanChoice" | "multipleSelection" | "singleSelection" | "textInput";
+  /**
+   * The message shown to the user when prompting for input. This should provide clear instructions or
+   * questions related to the interrupt, guiding the user on what information is needed or what action
+   * they should take in response to the prompt.
+   */
+  message?: string;
+  /**
+   * Additional data required to render or handle the interrupt. This is typically an array of strings
+   * representing options for selection when the `kind` is `multipleSelection` or `singleSelection`.
+   * For `booleanChoice`, the options are implicitly "Yes" and "No" and do not need to be provided.
+   * For `textInput`, options are not applicable and should be omitted.
+   */
+  metadata?: unknown;
+}
+
+export type FieldVectors = {
+  layerId: string;
+  results: {
+      name: string;
+      score: number;
+  }[];
+};
+
+export type Services = Readonly<{
+    agentRegistry: AgentRegistry;
+    layerSearch?: LayerSearchService;
+    fieldSearch?: FieldSearchService;
+    layersAndFieldsRegistry?: LayersAndFieldsRegistry;
+    embeddingCache: QueryEmbeddingCache;
+}>;
+
+export type AgentExecutionContextShape<TState extends SharedState = SharedState> = {
+  /** The user's original request. */
+  userRequest: string;
+  /**
+   * Structured input associated with the current request.
+   *
+   * @internal
+   */
+  inputParts?: readonly AssistantInputPart[];
+  /** The task assigned to the agent. */
+  assignedTask: string;
+  /** The message history for the run. */
+  messages: ChatHistory;
+  /** Previous steps. */
+  priorSteps: PriorStep[];
+  /** Shared state available to the agent. */
+  sharedState: TState;
+  /** The 50 most recent resources created by agents in the conversation. */
+  sharedResources: readonly SharedResource[];
+};
+
+export interface HITLResponse {
+  id: string;
+  agentId: string;
+  payload: unknown;
+}
+
+/** Registry mapping layer IDs to their description and associated field registry. */
+export type LayersAndFieldsRegistry = Map<string, {
+    layerItem: LayerDescriptionWrapper;
+    fieldRegistry: FieldsRegistry;
+}>;
+
+export type FieldsRegistry = Map<string, FieldInfo>;
+
+export type LayerDescriptionWrapper = {
+  title: string;
+  description: string;
+  name: string | null;
+};
+
+export type FieldInfo = {
+  name: string;
+  alias: string;
+  type: string;
+  description: string;
+  valueType: string;
+  statistics?: FieldStatistics;
+  domain?: DomainUnion;
+};
+
+export type FieldStatistics = {
+  summaryStatistics: SummaryStatisticsResult | null;
+  uniqueValues: UniqueValueCountInfo[] | null;
+};

package/dist/orchestrator/types.js

@@ -0,0 +1,2 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+

package/dist/types/lumina.d.ts

@@ -20,9 +20,14 @@ import type { ArcgisAssistantMessageText } from "../components/arcgis-assistant-
 import type { ArcgisAssistantSpeechInput } from "../components/arcgis-assistant-speech-input/customElement.js";
 import type { ArcgisAssistantSuggestedPrompts } from "../components/arcgis-assistant-suggested-prompts/customElement.js";
 import type { ArcgisAssistantUserMessage } from "../components/arcgis-assistant-user-message/customElement.js";
+import type { ArcgisAssistantObservationPanel } from "../components/arcgis-assistant-observation-panel/customElement.js";
+import type { ArcgisAssistantObservationInspector } from "../components/arcgis-assistant-observation-inspector/customElement.js";
+import type { ArcgisAssistantObservationLatency } from "../components/arcgis-assistant-observation-latency/customElement.js";
+import type { ArcgisAssistantObservationRun } from "../components/arcgis-assistant-observation-run/customElement.js";
+import type { ArcgisAssistantObservationUsage } from "../components/arcgis-assistant-observation-usage/customElement.js";
 import type { h, EventHandler } from "@arcgis/lumina";
 
-interface LuminaArcgisAssistant extends Partial<Pick<ArcgisAssistant, "allowedAgentIds" | "alwaysUseAgentId" | "assistantAvatarEnabled" | "copyEnabled" | "description" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "runtimeEventsEnabled" | "streamingDisabled" | "suggestedPrompts" | "userAvatarEnabled">>, h.JSX.HTMLAttributes<ArcgisAssistant> {
+interface LuminaArcgisAssistant extends Partial<Pick<ArcgisAssistant, "allowedAgentIds" | "alwaysUseAgentId" | "assistantAvatarEnabled" | "commandProvider" | "copyEnabled" | "description" | "entityProviders" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "runtimeEventsEnabled" | "streamingDisabled" | "suggestedPrompts" | "userAvatarEnabled">>, h.JSX.HTMLAttributes<ArcgisAssistant> {
   onarcgisCancel?: EventHandler<ArcgisAssistant["arcgisCancel"]>;
   onarcgisError?: EventHandler<ArcgisAssistant["arcgisError"]>;
   onarcgisFeedback?: EventHandler<ArcgisAssistant["arcgisFeedback"]>;
@@ -58,7 +63,7 @@ interface LuminaArcgisAssistantNavigationAgent extends Partial<Pick<ArcgisAssist
 interface LuminaArcgisAssistantChat extends Partial<Pick<ArcgisAssistantChat, "interrupt" | "loading" | "messages">>, h.JSX.HTMLAttributes<ArcgisAssistantChat> {
 }
 
-interface LuminaArcgisAssistantChatEntry extends Partial<Pick<ArcgisAssistantChatEntry, "awaitingResponse" | "disabled" | "entryPlaceholder" | "inputValue" | "keyboardShortcutsDisabled" | "messages" | "status" | "voiceInputEnabled">>, h.JSX.HTMLAttributes<ArcgisAssistantChatEntry> {
+interface LuminaArcgisAssistantChatEntry extends Partial<Pick<ArcgisAssistantChatEntry, "awaitingResponse" | "commandProvider" | "disabled" | "entityProviders" | "entryPlaceholder" | "inputValue" | "keyboardShortcutsDisabled" | "messages" | "status" | "voiceInputEnabled">>, h.JSX.HTMLAttributes<ArcgisAssistantChatEntry> {
   onarcgisCancel?: EventHandler<ArcgisAssistantChatEntry["arcgisCancel"]>;
   onarcgisSubmit?: EventHandler<ArcgisAssistantChatEntry["arcgisSubmit"]>;
 }
@@ -110,6 +115,21 @@ interface LuminaArcgisAssistantSuggestedPrompts extends Partial<Pick<ArcgisAssis
 interface LuminaArcgisAssistantUserMessage extends Partial<Pick<ArcgisAssistantUserMessage, "content" | "message" | "user" | "userAvatarEnabled">>, h.JSX.HTMLAttributes<ArcgisAssistantUserMessage> {
 }
 
+interface LuminaArcgisAssistantObservationPanel extends Partial<Pick<ArcgisAssistantObservationPanel, "events" | "pricing" | "referenceElement" | "snapshot">>, h.JSX.HTMLAttributes<ArcgisAssistantObservationPanel> {
+}
+
+interface LuminaArcgisAssistantObservationInspector extends Partial<Pick<ArcgisAssistantObservationInspector, "pricing" | "run" | "span">>, h.JSX.HTMLAttributes<ArcgisAssistantObservationInspector> {
+}
+
+interface LuminaArcgisAssistantObservationLatency extends Partial<Pick<ArcgisAssistantObservationLatency, "run" | "span">>, h.JSX.HTMLAttributes<ArcgisAssistantObservationLatency> {
+}
+
+interface LuminaArcgisAssistantObservationRun extends Partial<Pick<ArcgisAssistantObservationRun, "events" | "pricing" | "run" | "selectedSpanId">>, h.JSX.HTMLAttributes<ArcgisAssistantObservationRun> {
+}
+
+interface LuminaArcgisAssistantObservationUsage extends Partial<Pick<ArcgisAssistantObservationUsage, "aggregate" | "pricing" | "usage">>, h.JSX.HTMLAttributes<ArcgisAssistantObservationUsage> {
+}
+
 declare module "@arcgis/lumina" {
   export namespace h.JSX {
     interface IntrinsicElements {
@@ -134,6 +154,11 @@ declare module "@arcgis/lumina" {
       "arcgis-assistant-speech-input": LuminaArcgisAssistantSpeechInput;
       "arcgis-assistant-suggested-prompts": LuminaArcgisAssistantSuggestedPrompts;
       "arcgis-assistant-user-message": LuminaArcgisAssistantUserMessage;
+      "arcgis-assistant-observation-panel": LuminaArcgisAssistantObservationPanel;
+      "arcgis-assistant-observation-inspector": LuminaArcgisAssistantObservationInspector;
+      "arcgis-assistant-observation-latency": LuminaArcgisAssistantObservationLatency;
+      "arcgis-assistant-observation-run": LuminaArcgisAssistantObservationRun;
+      "arcgis-assistant-observation-usage": LuminaArcgisAssistantObservationUsage;
     }
   }
 }

package/dist/types/preact.d.ts

@@ -20,10 +20,15 @@ import type { ArcgisAssistantMessageText } from "../components/arcgis-assistant-
 import type { ArcgisAssistantSpeechInput } from "../components/arcgis-assistant-speech-input/customElement.js";
 import type { ArcgisAssistantSuggestedPrompts } from "../components/arcgis-assistant-suggested-prompts/customElement.js";
 import type { ArcgisAssistantUserMessage } from "../components/arcgis-assistant-user-message/customElement.js";
+import type { ArcgisAssistantObservationPanel } from "../components/arcgis-assistant-observation-panel/customElement.js";
+import type { ArcgisAssistantObservationInspector } from "../components/arcgis-assistant-observation-inspector/customElement.js";
+import type { ArcgisAssistantObservationLatency } from "../components/arcgis-assistant-observation-latency/customElement.js";
+import type { ArcgisAssistantObservationRun } from "../components/arcgis-assistant-observation-run/customElement.js";
+import type { ArcgisAssistantObservationUsage } from "../components/arcgis-assistant-observation-usage/customElement.js";
 import { HTMLAttributes } from "preact";
 import type { EventHandler } from "@arcgis/lumina";
 
-interface PreactArcgisAssistant extends Partial<Pick<ArcgisAssistant, "allowedAgentIds" | "alwaysUseAgentId" | "assistantAvatarEnabled" | "copyEnabled" | "description" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "runtimeEventsEnabled" | "streamingDisabled" | "suggestedPrompts" | "userAvatarEnabled">>, HTMLAttributes<ArcgisAssistant> {
+interface PreactArcgisAssistant extends Partial<Pick<ArcgisAssistant, "allowedAgentIds" | "alwaysUseAgentId" | "assistantAvatarEnabled" | "commandProvider" | "copyEnabled" | "description" | "entityProviders" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "runtimeEventsEnabled" | "streamingDisabled" | "suggestedPrompts" | "userAvatarEnabled">>, HTMLAttributes<ArcgisAssistant> {
   onarcgisCancel?: EventHandler<ArcgisAssistant["arcgisCancel"]>;
   onarcgisError?: EventHandler<ArcgisAssistant["arcgisError"]>;
   onarcgisFeedback?: EventHandler<ArcgisAssistant["arcgisFeedback"]>;
@@ -59,7 +64,7 @@ interface PreactArcgisAssistantNavigationAgent extends Partial<Pick<ArcgisAssist
 interface PreactArcgisAssistantChat extends Partial<Pick<ArcgisAssistantChat, "interrupt" | "loading" | "messages">>, HTMLAttributes<ArcgisAssistantChat> {
 }
 
-interface PreactArcgisAssistantChatEntry extends Partial<Pick<ArcgisAssistantChatEntry, "awaitingResponse" | "disabled" | "entryPlaceholder" | "inputValue" | "keyboardShortcutsDisabled" | "messages" | "status" | "voiceInputEnabled">>, HTMLAttributes<ArcgisAssistantChatEntry> {
+interface PreactArcgisAssistantChatEntry extends Partial<Pick<ArcgisAssistantChatEntry, "awaitingResponse" | "commandProvider" | "disabled" | "entityProviders" | "entryPlaceholder" | "inputValue" | "keyboardShortcutsDisabled" | "messages" | "status" | "voiceInputEnabled">>, HTMLAttributes<ArcgisAssistantChatEntry> {
   onarcgisCancel?: EventHandler<ArcgisAssistantChatEntry["arcgisCancel"]>;
   onarcgisSubmit?: EventHandler<ArcgisAssistantChatEntry["arcgisSubmit"]>;
 }
@@ -111,6 +116,21 @@ interface PreactArcgisAssistantSuggestedPrompts extends Partial<Pick<ArcgisAssis
 interface PreactArcgisAssistantUserMessage extends Partial<Pick<ArcgisAssistantUserMessage, "content" | "message" | "user" | "userAvatarEnabled">>, HTMLAttributes<ArcgisAssistantUserMessage> {
 }
 
+interface PreactArcgisAssistantObservationPanel extends Partial<Pick<ArcgisAssistantObservationPanel, "events" | "pricing" | "referenceElement" | "snapshot">>, HTMLAttributes<ArcgisAssistantObservationPanel> {
+}
+
+interface PreactArcgisAssistantObservationInspector extends Partial<Pick<ArcgisAssistantObservationInspector, "pricing" | "run" | "span">>, HTMLAttributes<ArcgisAssistantObservationInspector> {
+}
+
+interface PreactArcgisAssistantObservationLatency extends Partial<Pick<ArcgisAssistantObservationLatency, "run" | "span">>, HTMLAttributes<ArcgisAssistantObservationLatency> {
+}
+
+interface PreactArcgisAssistantObservationRun extends Partial<Pick<ArcgisAssistantObservationRun, "events" | "pricing" | "run" | "selectedSpanId">>, HTMLAttributes<ArcgisAssistantObservationRun> {
+}
+
+interface PreactArcgisAssistantObservationUsage extends Partial<Pick<ArcgisAssistantObservationUsage, "aggregate" | "pricing" | "usage">>, HTMLAttributes<ArcgisAssistantObservationUsage> {
+}
+
 declare module 'preact' {
   namespace createElement.JSX {
     interface IntrinsicElements {
@@ -135,6 +155,11 @@ declare module 'preact' {
       "arcgis-assistant-speech-input": PreactArcgisAssistantSpeechInput;
       "arcgis-assistant-suggested-prompts": PreactArcgisAssistantSuggestedPrompts;
       "arcgis-assistant-user-message": PreactArcgisAssistantUserMessage;
+      "arcgis-assistant-observation-panel": PreactArcgisAssistantObservationPanel;
+      "arcgis-assistant-observation-inspector": PreactArcgisAssistantObservationInspector;
+      "arcgis-assistant-observation-latency": PreactArcgisAssistantObservationLatency;
+      "arcgis-assistant-observation-run": PreactArcgisAssistantObservationRun;
+      "arcgis-assistant-observation-usage": PreactArcgisAssistantObservationUsage;
     }
   }
   namespace h.JSX {
@@ -160,6 +185,11 @@ declare module 'preact' {
       "arcgis-assistant-speech-input": PreactArcgisAssistantSpeechInput;
       "arcgis-assistant-suggested-prompts": PreactArcgisAssistantSuggestedPrompts;
       "arcgis-assistant-user-message": PreactArcgisAssistantUserMessage;
+      "arcgis-assistant-observation-panel": PreactArcgisAssistantObservationPanel;
+      "arcgis-assistant-observation-inspector": PreactArcgisAssistantObservationInspector;
+      "arcgis-assistant-observation-latency": PreactArcgisAssistantObservationLatency;
+      "arcgis-assistant-observation-run": PreactArcgisAssistantObservationRun;
+      "arcgis-assistant-observation-usage": PreactArcgisAssistantObservationUsage;
     }
   }
 }

package/dist/types/react.d.ts

@@ -20,10 +20,15 @@ import type { ArcgisAssistantMessageText } from "../components/arcgis-assistant-
 import type { ArcgisAssistantSpeechInput } from "../components/arcgis-assistant-speech-input/customElement.js";
 import type { ArcgisAssistantSuggestedPrompts } from "../components/arcgis-assistant-suggested-prompts/customElement.js";
 import type { ArcgisAssistantUserMessage } from "../components/arcgis-assistant-user-message/customElement.js";
+import type { ArcgisAssistantObservationPanel } from "../components/arcgis-assistant-observation-panel/customElement.js";
+import type { ArcgisAssistantObservationInspector } from "../components/arcgis-assistant-observation-inspector/customElement.js";
+import type { ArcgisAssistantObservationLatency } from "../components/arcgis-assistant-observation-latency/customElement.js";
+import type { ArcgisAssistantObservationRun } from "../components/arcgis-assistant-observation-run/customElement.js";
+import type { ArcgisAssistantObservationUsage } from "../components/arcgis-assistant-observation-usage/customElement.js";
 import type { HTMLProps } from 'react';
 import type { EventHandler } from "@arcgis/lumina"; 
 
-interface ReactArcgisAssistant extends Partial<Pick<ArcgisAssistant, "allowedAgentIds" | "alwaysUseAgentId" | "assistantAvatarEnabled" | "copyEnabled" | "description" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "runtimeEventsEnabled" | "streamingDisabled" | "suggestedPrompts" | "userAvatarEnabled">>, HTMLProps<ArcgisAssistant> {
+interface ReactArcgisAssistant extends Partial<Pick<ArcgisAssistant, "allowedAgentIds" | "alwaysUseAgentId" | "assistantAvatarEnabled" | "commandProvider" | "copyEnabled" | "description" | "entityProviders" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "runtimeEventsEnabled" | "streamingDisabled" | "suggestedPrompts" | "userAvatarEnabled">>, HTMLProps<ArcgisAssistant> {
   onarcgisCancel?: EventHandler<ArcgisAssistant["arcgisCancel"]>;
   onarcgisError?: EventHandler<ArcgisAssistant["arcgisError"]>;
   onarcgisFeedback?: EventHandler<ArcgisAssistant["arcgisFeedback"]>;
@@ -59,7 +64,7 @@ interface ReactArcgisAssistantNavigationAgent extends Partial<Pick<ArcgisAssista
 interface ReactArcgisAssistantChat extends Partial<Pick<ArcgisAssistantChat, "interrupt" | "loading" | "messages">>, HTMLProps<ArcgisAssistantChat> {
 }
 
-interface ReactArcgisAssistantChatEntry extends Partial<Pick<ArcgisAssistantChatEntry, "awaitingResponse" | "disabled" | "entryPlaceholder" | "inputValue" | "keyboardShortcutsDisabled" | "messages" | "status" | "voiceInputEnabled">>, HTMLProps<ArcgisAssistantChatEntry> {
+interface ReactArcgisAssistantChatEntry extends Partial<Pick<ArcgisAssistantChatEntry, "awaitingResponse" | "commandProvider" | "disabled" | "entityProviders" | "entryPlaceholder" | "inputValue" | "keyboardShortcutsDisabled" | "messages" | "status" | "voiceInputEnabled">>, HTMLProps<ArcgisAssistantChatEntry> {
   onarcgisCancel?: EventHandler<ArcgisAssistantChatEntry["arcgisCancel"]>;
   onarcgisSubmit?: EventHandler<ArcgisAssistantChatEntry["arcgisSubmit"]>;
 }
@@ -111,6 +116,21 @@ interface ReactArcgisAssistantSuggestedPrompts extends Partial<Pick<ArcgisAssist
 interface ReactArcgisAssistantUserMessage extends Partial<Pick<ArcgisAssistantUserMessage, "content" | "message" | "user" | "userAvatarEnabled">>, HTMLProps<ArcgisAssistantUserMessage> {
 }
 
+interface ReactArcgisAssistantObservationPanel extends Partial<Pick<ArcgisAssistantObservationPanel, "events" | "pricing" | "referenceElement" | "snapshot">>, HTMLProps<ArcgisAssistantObservationPanel> {
+}
+
+interface ReactArcgisAssistantObservationInspector extends Partial<Pick<ArcgisAssistantObservationInspector, "pricing" | "run" | "span">>, HTMLProps<ArcgisAssistantObservationInspector> {
+}
+
+interface ReactArcgisAssistantObservationLatency extends Partial<Pick<ArcgisAssistantObservationLatency, "run" | "span">>, HTMLProps<ArcgisAssistantObservationLatency> {
+}
+
+interface ReactArcgisAssistantObservationRun extends Partial<Pick<ArcgisAssistantObservationRun, "events" | "pricing" | "run" | "selectedSpanId">>, HTMLProps<ArcgisAssistantObservationRun> {
+}
+
+interface ReactArcgisAssistantObservationUsage extends Partial<Pick<ArcgisAssistantObservationUsage, "aggregate" | "pricing" | "usage">>, HTMLProps<ArcgisAssistantObservationUsage> {
+}
+
 declare module "react" {
   namespace JSX {
     interface IntrinsicElements {
@@ -135,6 +155,11 @@ declare module "react" {
       "arcgis-assistant-speech-input": ReactArcgisAssistantSpeechInput;
       "arcgis-assistant-suggested-prompts": ReactArcgisAssistantSuggestedPrompts;
       "arcgis-assistant-user-message": ReactArcgisAssistantUserMessage;
+      "arcgis-assistant-observation-panel": ReactArcgisAssistantObservationPanel;
+      "arcgis-assistant-observation-inspector": ReactArcgisAssistantObservationInspector;
+      "arcgis-assistant-observation-latency": ReactArcgisAssistantObservationLatency;
+      "arcgis-assistant-observation-run": ReactArcgisAssistantObservationRun;
+      "arcgis-assistant-observation-usage": ReactArcgisAssistantObservationUsage;
     }
   }
 }
@@ -162,6 +187,11 @@ declare module "react/jsx-runtime" {
       "arcgis-assistant-speech-input": ReactArcgisAssistantSpeechInput;
       "arcgis-assistant-suggested-prompts": ReactArcgisAssistantSuggestedPrompts;
       "arcgis-assistant-user-message": ReactArcgisAssistantUserMessage;
+      "arcgis-assistant-observation-panel": ReactArcgisAssistantObservationPanel;
+      "arcgis-assistant-observation-inspector": ReactArcgisAssistantObservationInspector;
+      "arcgis-assistant-observation-latency": ReactArcgisAssistantObservationLatency;
+      "arcgis-assistant-observation-run": ReactArcgisAssistantObservationRun;
+      "arcgis-assistant-observation-usage": ReactArcgisAssistantObservationUsage;
     }
   }
 }
@@ -189,6 +219,11 @@ declare module "react/jsx-dev-runtime" {
       "arcgis-assistant-speech-input": ReactArcgisAssistantSpeechInput;
       "arcgis-assistant-suggested-prompts": ReactArcgisAssistantSuggestedPrompts;
       "arcgis-assistant-user-message": ReactArcgisAssistantUserMessage;
+      "arcgis-assistant-observation-panel": ReactArcgisAssistantObservationPanel;
+      "arcgis-assistant-observation-inspector": ReactArcgisAssistantObservationInspector;
+      "arcgis-assistant-observation-latency": ReactArcgisAssistantObservationLatency;
+      "arcgis-assistant-observation-run": ReactArcgisAssistantObservationRun;
+      "arcgis-assistant-observation-usage": ReactArcgisAssistantObservationUsage;
     }
   }
 }

package/dist/types/stencil.d.ts

@@ -20,10 +20,15 @@ import type { ArcgisAssistantMessageText } from "../components/arcgis-assistant-
 import type { ArcgisAssistantSpeechInput } from "../components/arcgis-assistant-speech-input/customElement.js";
 import type { ArcgisAssistantSuggestedPrompts } from "../components/arcgis-assistant-suggested-prompts/customElement.js";
 import type { ArcgisAssistantUserMessage } from "../components/arcgis-assistant-user-message/customElement.js";
+import type { ArcgisAssistantObservationPanel } from "../components/arcgis-assistant-observation-panel/customElement.js";
+import type { ArcgisAssistantObservationInspector } from "../components/arcgis-assistant-observation-inspector/customElement.js";
+import type { ArcgisAssistantObservationLatency } from "../components/arcgis-assistant-observation-latency/customElement.js";
+import type { ArcgisAssistantObservationRun } from "../components/arcgis-assistant-observation-run/customElement.js";
+import type { ArcgisAssistantObservationUsage } from "../components/arcgis-assistant-observation-usage/customElement.js";
 import { JSXBase as StencilJsx } from "@stencil/core/internal";
 import type { EventHandler } from "@arcgis/lumina";
 
-interface StencilArcgisAssistant extends Partial<Pick<ArcgisAssistant, "allowedAgentIds" | "alwaysUseAgentId" | "assistantAvatarEnabled" | "copyEnabled" | "description" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "runtimeEventsEnabled" | "streamingDisabled" | "suggestedPrompts" | "userAvatarEnabled">>, StencilJsx.HTMLAttributes<ArcgisAssistant> {
+interface StencilArcgisAssistant extends Partial<Pick<ArcgisAssistant, "allowedAgentIds" | "alwaysUseAgentId" | "assistantAvatarEnabled" | "commandProvider" | "copyEnabled" | "description" | "entityProviders" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "runtimeEventsEnabled" | "streamingDisabled" | "suggestedPrompts" | "userAvatarEnabled">>, StencilJsx.HTMLAttributes<ArcgisAssistant> {
   onArcgisCancel?: EventHandler<ArcgisAssistant["arcgisCancel"]>;
   onArcgisError?: EventHandler<ArcgisAssistant["arcgisError"]>;
   onArcgisFeedback?: EventHandler<ArcgisAssistant["arcgisFeedback"]>;
@@ -59,7 +64,7 @@ interface StencilArcgisAssistantNavigationAgent extends Partial<Pick<ArcgisAssis
 interface StencilArcgisAssistantChat extends Partial<Pick<ArcgisAssistantChat, "interrupt" | "loading" | "messages">>, StencilJsx.HTMLAttributes<ArcgisAssistantChat> {
 }
 
-interface StencilArcgisAssistantChatEntry extends Partial<Pick<ArcgisAssistantChatEntry, "awaitingResponse" | "disabled" | "entryPlaceholder" | "inputValue" | "keyboardShortcutsDisabled" | "messages" | "status" | "voiceInputEnabled">>, StencilJsx.HTMLAttributes<ArcgisAssistantChatEntry> {
+interface StencilArcgisAssistantChatEntry extends Partial<Pick<ArcgisAssistantChatEntry, "awaitingResponse" | "commandProvider" | "disabled" | "entityProviders" | "entryPlaceholder" | "inputValue" | "keyboardShortcutsDisabled" | "messages" | "status" | "voiceInputEnabled">>, StencilJsx.HTMLAttributes<ArcgisAssistantChatEntry> {
   onArcgisCancel?: EventHandler<ArcgisAssistantChatEntry["arcgisCancel"]>;
   onArcgisSubmit?: EventHandler<ArcgisAssistantChatEntry["arcgisSubmit"]>;
 }
@@ -111,6 +116,21 @@ interface StencilArcgisAssistantSuggestedPrompts extends Partial<Pick<ArcgisAssi
 interface StencilArcgisAssistantUserMessage extends Partial<Pick<ArcgisAssistantUserMessage, "content" | "message" | "user" | "userAvatarEnabled">>, StencilJsx.HTMLAttributes<ArcgisAssistantUserMessage> {
 }
 
+interface StencilArcgisAssistantObservationPanel extends Partial<Pick<ArcgisAssistantObservationPanel, "events" | "pricing" | "referenceElement" | "snapshot">>, StencilJsx.HTMLAttributes<ArcgisAssistantObservationPanel> {
+}
+
+interface StencilArcgisAssistantObservationInspector extends Partial<Pick<ArcgisAssistantObservationInspector, "pricing" | "run" | "span">>, StencilJsx.HTMLAttributes<ArcgisAssistantObservationInspector> {
+}
+
+interface StencilArcgisAssistantObservationLatency extends Partial<Pick<ArcgisAssistantObservationLatency, "run" | "span">>, StencilJsx.HTMLAttributes<ArcgisAssistantObservationLatency> {
+}
+
+interface StencilArcgisAssistantObservationRun extends Partial<Pick<ArcgisAssistantObservationRun, "events" | "pricing" | "run" | "selectedSpanId">>, StencilJsx.HTMLAttributes<ArcgisAssistantObservationRun> {
+}
+
+interface StencilArcgisAssistantObservationUsage extends Partial<Pick<ArcgisAssistantObservationUsage, "aggregate" | "pricing" | "usage">>, StencilJsx.HTMLAttributes<ArcgisAssistantObservationUsage> {
+}
+
 interface ExposedElements {
   "arcgis-assistant": StencilArcgisAssistant;
   "arcgis-assistant-agent": StencilArcgisAssistantAgent;
@@ -133,6 +153,11 @@ interface ExposedElements {
   "arcgis-assistant-speech-input": StencilArcgisAssistantSpeechInput;
   "arcgis-assistant-suggested-prompts": StencilArcgisAssistantSuggestedPrompts;
   "arcgis-assistant-user-message": StencilArcgisAssistantUserMessage;
+  "arcgis-assistant-observation-panel": StencilArcgisAssistantObservationPanel;
+  "arcgis-assistant-observation-inspector": StencilArcgisAssistantObservationInspector;
+  "arcgis-assistant-observation-latency": StencilArcgisAssistantObservationLatency;
+  "arcgis-assistant-observation-run": StencilArcgisAssistantObservationRun;
+  "arcgis-assistant-observation-usage": StencilArcgisAssistantObservationUsage;
 }
 
 export namespace JSX {