@arcgis/ai-components 5.2.0-next.11 → 5.2.0-next.110

package/dist/types/lumina.d.ts

@@ -22,7 +22,7 @@ import type { ArcgisAssistantSuggestedPrompts } from "../components/arcgis-assis
 import type { ArcgisAssistantUserMessage } from "../components/arcgis-assistant-user-message/customElement.js";
 import type { h, EventHandler } from "@arcgis/lumina";
 
-interface LuminaArcgisAssistant extends Partial<Pick<ArcgisAssistant, "assistantAvatarEnabled" | "copyEnabled" | "description" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "suggestedPrompts">>, h.JSX.HTMLAttributes<ArcgisAssistant> {
+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> {
   onarcgisCancel?: EventHandler<ArcgisAssistant["arcgisCancel"]>;
   onarcgisError?: EventHandler<ArcgisAssistant["arcgisError"]>;
   onarcgisFeedback?: EventHandler<ArcgisAssistant["arcgisFeedback"]>;
@@ -32,11 +32,12 @@ interface LuminaArcgisAssistant extends Partial<Pick<ArcgisAssistant, "assistant
   onarcgisPromptSelect?: EventHandler<ArcgisAssistant["arcgisPromptSelect"]>;
   onarcgisReady?: EventHandler<ArcgisAssistant["arcgisReady"]>;
   onarcgisResponse?: EventHandler<ArcgisAssistant["arcgisResponse"]>;
+  onarcgisRuntime?: EventHandler<ArcgisAssistant["arcgisRuntime"]>;
   onarcgisSlottableRequest?: EventHandler<ArcgisAssistant["arcgisSlottableRequest"]>;
   onarcgisSubmit?: EventHandler<ArcgisAssistant["arcgisSubmit"]>;
 }
 
-interface LuminaArcgisAssistantAgent extends Required<Pick<ArcgisAssistantAgent, "agent">>, Partial<Pick<ArcgisAssistantAgent, "context">>, h.JSX.HTMLAttributes<ArcgisAssistantAgent> {
+interface LuminaArcgisAssistantAgent extends Partial<Pick<ArcgisAssistantAgent, "agent" | "context" | "itemId" | "workflow">>, h.JSX.HTMLAttributes<ArcgisAssistantAgent> {
 }
 
 interface LuminaArcgisAssistantDataExplorationAgent extends Partial<Pick<ArcgisAssistantDataExplorationAgent, "referenceElement">>, h.JSX.HTMLAttributes<ArcgisAssistantDataExplorationAgent> {
@@ -89,7 +90,7 @@ interface LuminaArcgisAssistantMessageLog extends Partial<Pick<ArcgisAssistantMe
 interface LuminaArcgisAssistantMessageReadAloud extends Partial<Pick<ArcgisAssistantMessageReadAloud, "message" | "readAloudEnabled">>, h.JSX.HTMLAttributes<ArcgisAssistantMessageReadAloud> {
 }
 
-interface LuminaArcgisAssistantMessageText extends Partial<Pick<ArcgisAssistantMessageText, "content">>, h.JSX.HTMLAttributes<ArcgisAssistantMessageText> {
+interface LuminaArcgisAssistantMessageText extends Partial<Pick<ArcgisAssistantMessageText, "content" | "parts">>, h.JSX.HTMLAttributes<ArcgisAssistantMessageText> {
 }
 
 interface LuminaArcgisAssistantSpeechInput extends Partial<Pick<ArcgisAssistantSpeechInput, "awaitingResponse" | "inputValue" | "language" | "mode">>, h.JSX.HTMLAttributes<ArcgisAssistantSpeechInput> {
@@ -106,7 +107,7 @@ interface LuminaArcgisAssistantSuggestedPrompts extends Partial<Pick<ArcgisAssis
   onarcgisPromptSelect?: EventHandler<ArcgisAssistantSuggestedPrompts["arcgisPromptSelect"]>;
 }
 
-interface LuminaArcgisAssistantUserMessage extends Partial<Pick<ArcgisAssistantUserMessage, "content" | "message" | "user">>, h.JSX.HTMLAttributes<ArcgisAssistantUserMessage> {
+interface LuminaArcgisAssistantUserMessage extends Partial<Pick<ArcgisAssistantUserMessage, "content" | "message" | "user" | "userAvatarEnabled">>, h.JSX.HTMLAttributes<ArcgisAssistantUserMessage> {
 }
 
 declare module "@arcgis/lumina" {

package/dist/types/preact.d.ts

@@ -23,7 +23,7 @@ import type { ArcgisAssistantUserMessage } from "../components/arcgis-assistant-
 import { HTMLAttributes } from "preact";
 import type { EventHandler } from "@arcgis/lumina";
 
-interface PreactArcgisAssistant extends Partial<Pick<ArcgisAssistant, "assistantAvatarEnabled" | "copyEnabled" | "description" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "suggestedPrompts">>, HTMLAttributes<ArcgisAssistant> {
+interface PreactArcgisAssistant extends Partial<Pick<ArcgisAssistant, "allowedAgentIds" | "alwaysUseAgentId" | "assistantAvatarEnabled" | "copyEnabled" | "description" | "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"]>;
@@ -33,11 +33,12 @@ interface PreactArcgisAssistant extends Partial<Pick<ArcgisAssistant, "assistant
   onarcgisPromptSelect?: EventHandler<ArcgisAssistant["arcgisPromptSelect"]>;
   onarcgisReady?: EventHandler<ArcgisAssistant["arcgisReady"]>;
   onarcgisResponse?: EventHandler<ArcgisAssistant["arcgisResponse"]>;
+  onarcgisRuntime?: EventHandler<ArcgisAssistant["arcgisRuntime"]>;
   onarcgisSlottableRequest?: EventHandler<ArcgisAssistant["arcgisSlottableRequest"]>;
   onarcgisSubmit?: EventHandler<ArcgisAssistant["arcgisSubmit"]>;
 }
 
-interface PreactArcgisAssistantAgent extends Required<Pick<ArcgisAssistantAgent, "agent">>, Partial<Pick<ArcgisAssistantAgent, "context">>, HTMLAttributes<ArcgisAssistantAgent> {
+interface PreactArcgisAssistantAgent extends Partial<Pick<ArcgisAssistantAgent, "agent" | "context" | "itemId" | "workflow">>, HTMLAttributes<ArcgisAssistantAgent> {
 }
 
 interface PreactArcgisAssistantDataExplorationAgent extends Partial<Pick<ArcgisAssistantDataExplorationAgent, "referenceElement">>, HTMLAttributes<ArcgisAssistantDataExplorationAgent> {
@@ -90,7 +91,7 @@ interface PreactArcgisAssistantMessageLog extends Partial<Pick<ArcgisAssistantMe
 interface PreactArcgisAssistantMessageReadAloud extends Partial<Pick<ArcgisAssistantMessageReadAloud, "message" | "readAloudEnabled">>, HTMLAttributes<ArcgisAssistantMessageReadAloud> {
 }
 
-interface PreactArcgisAssistantMessageText extends Partial<Pick<ArcgisAssistantMessageText, "content">>, HTMLAttributes<ArcgisAssistantMessageText> {
+interface PreactArcgisAssistantMessageText extends Partial<Pick<ArcgisAssistantMessageText, "content" | "parts">>, HTMLAttributes<ArcgisAssistantMessageText> {
 }
 
 interface PreactArcgisAssistantSpeechInput extends Partial<Pick<ArcgisAssistantSpeechInput, "awaitingResponse" | "inputValue" | "language" | "mode">>, HTMLAttributes<ArcgisAssistantSpeechInput> {
@@ -107,7 +108,7 @@ interface PreactArcgisAssistantSuggestedPrompts extends Partial<Pick<ArcgisAssis
   onarcgisPromptSelect?: EventHandler<ArcgisAssistantSuggestedPrompts["arcgisPromptSelect"]>;
 }
 
-interface PreactArcgisAssistantUserMessage extends Partial<Pick<ArcgisAssistantUserMessage, "content" | "message" | "user">>, HTMLAttributes<ArcgisAssistantUserMessage> {
+interface PreactArcgisAssistantUserMessage extends Partial<Pick<ArcgisAssistantUserMessage, "content" | "message" | "user" | "userAvatarEnabled">>, HTMLAttributes<ArcgisAssistantUserMessage> {
 }
 
 declare module 'preact' {

package/dist/types/react.d.ts

@@ -23,7 +23,7 @@ import type { ArcgisAssistantUserMessage } from "../components/arcgis-assistant-
 import type { HTMLProps } from 'react';
 import type { EventHandler } from "@arcgis/lumina"; 
 
-interface ReactArcgisAssistant extends Partial<Pick<ArcgisAssistant, "assistantAvatarEnabled" | "copyEnabled" | "description" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "suggestedPrompts">>, HTMLProps<ArcgisAssistant> {
+interface ReactArcgisAssistant extends Partial<Pick<ArcgisAssistant, "allowedAgentIds" | "alwaysUseAgentId" | "assistantAvatarEnabled" | "copyEnabled" | "description" | "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"]>;
@@ -33,11 +33,12 @@ interface ReactArcgisAssistant extends Partial<Pick<ArcgisAssistant, "assistantA
   onarcgisPromptSelect?: EventHandler<ArcgisAssistant["arcgisPromptSelect"]>;
   onarcgisReady?: EventHandler<ArcgisAssistant["arcgisReady"]>;
   onarcgisResponse?: EventHandler<ArcgisAssistant["arcgisResponse"]>;
+  onarcgisRuntime?: EventHandler<ArcgisAssistant["arcgisRuntime"]>;
   onarcgisSlottableRequest?: EventHandler<ArcgisAssistant["arcgisSlottableRequest"]>;
   onarcgisSubmit?: EventHandler<ArcgisAssistant["arcgisSubmit"]>;
 }
 
-interface ReactArcgisAssistantAgent extends Required<Pick<ArcgisAssistantAgent, "agent">>, Partial<Pick<ArcgisAssistantAgent, "context">>, HTMLProps<ArcgisAssistantAgent> {
+interface ReactArcgisAssistantAgent extends Partial<Pick<ArcgisAssistantAgent, "agent" | "context" | "itemId" | "workflow">>, HTMLProps<ArcgisAssistantAgent> {
 }
 
 interface ReactArcgisAssistantDataExplorationAgent extends Partial<Pick<ArcgisAssistantDataExplorationAgent, "referenceElement">>, HTMLProps<ArcgisAssistantDataExplorationAgent> {
@@ -90,7 +91,7 @@ interface ReactArcgisAssistantMessageLog extends Partial<Pick<ArcgisAssistantMes
 interface ReactArcgisAssistantMessageReadAloud extends Partial<Pick<ArcgisAssistantMessageReadAloud, "message" | "readAloudEnabled">>, HTMLProps<ArcgisAssistantMessageReadAloud> {
 }
 
-interface ReactArcgisAssistantMessageText extends Partial<Pick<ArcgisAssistantMessageText, "content">>, HTMLProps<ArcgisAssistantMessageText> {
+interface ReactArcgisAssistantMessageText extends Partial<Pick<ArcgisAssistantMessageText, "content" | "parts">>, HTMLProps<ArcgisAssistantMessageText> {
 }
 
 interface ReactArcgisAssistantSpeechInput extends Partial<Pick<ArcgisAssistantSpeechInput, "awaitingResponse" | "inputValue" | "language" | "mode">>, HTMLProps<ArcgisAssistantSpeechInput> {
@@ -107,7 +108,7 @@ interface ReactArcgisAssistantSuggestedPrompts extends Partial<Pick<ArcgisAssist
   onarcgisPromptSelect?: EventHandler<ArcgisAssistantSuggestedPrompts["arcgisPromptSelect"]>;
 }
 
-interface ReactArcgisAssistantUserMessage extends Partial<Pick<ArcgisAssistantUserMessage, "content" | "message" | "user">>, HTMLProps<ArcgisAssistantUserMessage> {
+interface ReactArcgisAssistantUserMessage extends Partial<Pick<ArcgisAssistantUserMessage, "content" | "message" | "user" | "userAvatarEnabled">>, HTMLProps<ArcgisAssistantUserMessage> {
 }
 
 declare module "react" {

package/dist/types/stencil.d.ts

@@ -23,7 +23,7 @@ import type { ArcgisAssistantUserMessage } from "../components/arcgis-assistant-
 import { JSXBase as StencilJsx } from "@stencil/core/internal";
 import type { EventHandler } from "@arcgis/lumina";
 
-interface StencilArcgisAssistant extends Partial<Pick<ArcgisAssistant, "assistantAvatarEnabled" | "copyEnabled" | "description" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "suggestedPrompts">>, StencilJsx.HTMLAttributes<ArcgisAssistant> {
+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> {
   onArcgisCancel?: EventHandler<ArcgisAssistant["arcgisCancel"]>;
   onArcgisError?: EventHandler<ArcgisAssistant["arcgisError"]>;
   onArcgisFeedback?: EventHandler<ArcgisAssistant["arcgisFeedback"]>;
@@ -33,11 +33,12 @@ interface StencilArcgisAssistant extends Partial<Pick<ArcgisAssistant, "assistan
   onArcgisPromptSelect?: EventHandler<ArcgisAssistant["arcgisPromptSelect"]>;
   onArcgisReady?: EventHandler<ArcgisAssistant["arcgisReady"]>;
   onArcgisResponse?: EventHandler<ArcgisAssistant["arcgisResponse"]>;
+  onArcgisRuntime?: EventHandler<ArcgisAssistant["arcgisRuntime"]>;
   onArcgisSlottableRequest?: EventHandler<ArcgisAssistant["arcgisSlottableRequest"]>;
   onArcgisSubmit?: EventHandler<ArcgisAssistant["arcgisSubmit"]>;
 }
 
-interface StencilArcgisAssistantAgent extends Required<Pick<ArcgisAssistantAgent, "agent">>, Partial<Pick<ArcgisAssistantAgent, "context">>, StencilJsx.HTMLAttributes<ArcgisAssistantAgent> {
+interface StencilArcgisAssistantAgent extends Partial<Pick<ArcgisAssistantAgent, "agent" | "context" | "itemId" | "workflow">>, StencilJsx.HTMLAttributes<ArcgisAssistantAgent> {
 }
 
 interface StencilArcgisAssistantDataExplorationAgent extends Partial<Pick<ArcgisAssistantDataExplorationAgent, "referenceElement">>, StencilJsx.HTMLAttributes<ArcgisAssistantDataExplorationAgent> {
@@ -90,7 +91,7 @@ interface StencilArcgisAssistantMessageLog extends Partial<Pick<ArcgisAssistantM
 interface StencilArcgisAssistantMessageReadAloud extends Partial<Pick<ArcgisAssistantMessageReadAloud, "message" | "readAloudEnabled">>, StencilJsx.HTMLAttributes<ArcgisAssistantMessageReadAloud> {
 }
 
-interface StencilArcgisAssistantMessageText extends Partial<Pick<ArcgisAssistantMessageText, "content">>, StencilJsx.HTMLAttributes<ArcgisAssistantMessageText> {
+interface StencilArcgisAssistantMessageText extends Partial<Pick<ArcgisAssistantMessageText, "content" | "parts">>, StencilJsx.HTMLAttributes<ArcgisAssistantMessageText> {
 }
 
 interface StencilArcgisAssistantSpeechInput extends Partial<Pick<ArcgisAssistantSpeechInput, "awaitingResponse" | "inputValue" | "language" | "mode">>, StencilJsx.HTMLAttributes<ArcgisAssistantSpeechInput> {
@@ -107,7 +108,7 @@ interface StencilArcgisAssistantSuggestedPrompts extends Partial<Pick<ArcgisAssi
   onArcgisPromptSelect?: EventHandler<ArcgisAssistantSuggestedPrompts["arcgisPromptSelect"]>;
 }
 
-interface StencilArcgisAssistantUserMessage extends Partial<Pick<ArcgisAssistantUserMessage, "content" | "message" | "user">>, StencilJsx.HTMLAttributes<ArcgisAssistantUserMessage> {
+interface StencilArcgisAssistantUserMessage extends Partial<Pick<ArcgisAssistantUserMessage, "content" | "message" | "user" | "userAvatarEnabled">>, StencilJsx.HTMLAttributes<ArcgisAssistantUserMessage> {
 }
 
 interface ExposedElements {
@@ -138,8 +139,8 @@ export namespace JSX {
   export interface IntrinsicElements extends ExposedElements {}
 }
 
-declare module "@stencil/core/internal/stencil-public-runtime" {
-  export namespace h.JSX {
+declare module "@stencil/core" {
+  export namespace JSX {
     interface IntrinsicElements extends ExposedElements {}
   }
 }

package/dist/utils/index.d.ts

@@ -11,6 +11,7 @@ import type { AgentRegistration as AgentRegistration2 } from "../orchestrator/re
 
 export { type CustomConfigurableType } from "../orchestrator.js";
 export { Orchestrator } from "../orchestrator.js";
+export { type AskOptions } from "../orchestrator.js";
 
 /** @internal */
 export type ChatModelTier = "advanced" | "default" | "fast";
@@ -144,31 +145,25 @@ export type ArcgisPromptOptions = {
   /**
    * The model tier to use. See the following options:
    *
-   * - `default` - The default model tier, which provides a balance of performance and cost.
-   *   This is suitable for most general-purpose use cases. At JS SDK v5.0, this model
-   *   tier corresponds to GPT-5 mini model.
-   * - `advanced` - An advanced model tier that may provide improved accuracy or capabilities compared to
-   *   the default tier. However, it may also come with increased cost and slower performance. At
-   *   JS SDK v5.0, this model tier corresponds to GPT-5.2 model.
-   * - `fast` - A lower cost model suitable for tasks like classification and summarization. This tier may have limitations in terms of response length and complexity.
-   *   New at JS SDK v5.1, this model tier corresponds to GPT-5.4-nano model.
+   * - `default` - The default model tier, suitable for most general-purpose use cases.
+   *   At v5.2, this tier uses the `gpt-5.6-terra` model.
+   * - `advanced` - A model tier for tasks that benefit from more advanced capabilities.
+   *   At v5.2, this tier uses the `gpt-5.6-sol` model.
+   * - `fast` - A model tier for tasks such as classification and summarization, where
+   *   faster responses are preferred.
+   *   At v5.2, this tier uses the `gpt-5.6-luna` model.
    *
-   * The specific models available in each tier may evolve over time as new models are released and existing
-   * models are retired. The dates models are retired depends on the model provider and therefore may not
-   * align with the semantic versioning rules of the JS SDK. Therefore, the user experience of apps may break
-   * in a minor version update of the JS SDK. It is important to keep your implementation flexible and test your prompts
-   * regularly to ensure they continue to perform as expected, especially when updating the JS SDK version or
-   *  when new models are released.
-   *
-   * Note that the same prompt will not necessarily produce the same results across different
-   * models. As models are updated, you will need to re-evaluate the prompts you send to the LLM, including
-   * agent descriptions and tool node descriptions to
-   * ensure they still return the expected responses. You should adjust your implementation as needed.
+   * The models available for each tier may change as models are released and retired by
+   * the model provider and may not align with the semantic versioning rules of the JS SDK.
+   * The same prompt may produce different results when a tier's model changes.
+   * Re-evaluate and adjust prompts, agent descriptions, and tool descriptions
+   * when updating the ArcGIS Maps SDK for JavaScript or when model updates occur.
    */
   modelTier?: ChatModelTier;
   /**
-   * The temperature to use for the model (a number between 0 and 1). Higher values will result in more
-   * creative and varied responses, while lower values will produce more focused and deterministic responses.
+   * This option is ignored. The model provider's default temperature is always used.
+   *
+   * @deprecated This option is no longer supported and will be removed in a future release.
    */
   temperature?: number;
   /**
@@ -256,8 +251,7 @@ export interface TraceEventData {
  * Sends a prompt to an LLM and returns a plain text response. This function should be used when you expect
  * a simple text response from the model without the need for structured parsing or tool invocation.
  *
- * @param options - Options for the prompt, including the prompt text, model tier,
- *   temperature, chat history, and input variables.
+ * @param options - Options for the prompt, including the prompt text, model tier, chat history, and input variables.
  * @returns The model response.
  * @since 5.0
  * @see [Custom agents guide](https://developers.arcgis.com/javascript/latest/agentic-apps/ai-custom-agents/)
@@ -375,10 +369,15 @@ export interface AgentExecutionContext<TState extends Record<string, unknown> =
   priorSteps: PriorStep[];
   /** Shared state available to the agent. */
   sharedState: SharedState<TState>;
+  /** The 50 most recent resources created by agents in the conversation. */
+  sharedResources: readonly SharedResource[];
 }
 
 /** @internal */
-export const NavigationAgent: AgentRegistration;
+export const NavigationAgent: AgentRegistration2;
+
+/** @internal */
+export const NavigationGraphAgent: AgentRegistration;
 
 /** @internal */
 export type NavigationContext = {
@@ -394,7 +393,10 @@ export type LayerStylingContext = {
 };
 
 /** @internal */
-export const DataExplorationAgent: AgentRegistration;
+export const DataExplorationAgent: AgentRegistration2;
+
+/** @internal */
+export const DataExplorationGraphAgent: AgentRegistration;
 
 /** @internal */
 export type DataExplorationContext = {
@@ -402,10 +404,13 @@ export type DataExplorationContext = {
 };
 
 /** @internal */
-export const HelpAgent: AgentRegistration;
+export const HelpAgent: AgentRegistration2;
+
+/** @internal */
+export const HelpGraphAgent: AgentRegistration;
 
 /** @internal */
-export const ArcgisKnowledgeAgent: AgentRegistration2;
+export const ArcgisKnowledgeAgent: AgentRegistration;
 
 /** @internal */
 export type ArcgisKnowledgeContext = {
@@ -461,34 +466,30 @@ export interface AgentWithContext<TContext extends Record<string, unknown> = Rec
 export type AgentExecutionContextWithSharedState<TState extends Record<string, unknown> = Record<string, unknown>> = AgentExecutionContext<TState>;
 
 /** @internal */
-export type StatelessAgentBaseState<TState extends Record<string, unknown> = Record<string, unknown>> = {
+export type AgentBaseState<TState extends Record<string, unknown> = Record<string, unknown>> = {
   agentExecutionContext: BaseChannel<AgentExecutionContextWithSharedState<TState>, unknown, unknown>;
   outputMessage: BaseChannel<string, unknown, unknown>;
   summary: BaseChannel<string, unknown, unknown>;
   status: BaseChannel<AgentStatus | undefined, unknown, unknown>;
-};
-
-/** @internal */
-export type StatefulAgentBaseState<TState extends Record<string, unknown> = Record<string, unknown>> = StatelessAgentBaseState<TState>
-  & {
   sharedStatePatch: BaseChannel<SharedStatePatch<TState> | undefined, unknown, unknown>;
+  sharedResourceAdditions: BaseChannel<readonly SharedResourceInput[] | undefined, unknown, unknown>;
 };
 
 /**
  * Creates the standard runtime state for a custom agent graph.
- * Includes common fields used by the assistant flow (request context, output message, summary, and status), so you only add your agent-specific state.
+ * Includes common fields used by the assistant flow and channels for shared state and shared resource updates, so you only add your agent-specific state.
  *
  * @since 5.1
  */
-export function createAgentRuntimeState<TState extends Record<string, unknown> = Record<string, unknown>>(): StatelessAgentBaseState<TState>;
+export function createAgentRuntimeState<TState extends Record<string, unknown> = Record<string, unknown>>(): AgentBaseState<TState>;
 
 /**
- * Creates the standard runtime state for a custom agent graph, plus support for shared state updates.
- * Use this when your agent needs to write values that other agents can read later in the same orchestration flow.
+ * Use `createAgentRuntimeState` instead.
  *
+ * @deprecated Use `createAgentRuntimeState` instead.
  * @since 5.1
  */
-export function createAgentRuntimeStateWithSharedState<TState extends Record<string, unknown> = Record<string, unknown>>(): StatefulAgentBaseState<TState>;
+export function createAgentRuntimeStateWithSharedState<TState extends Record<string, unknown> = Record<string, unknown>>(): AgentBaseState<TState>;
 
 /**
  * Sends an optional UX suggestion from an agent run to the host application.
@@ -532,12 +533,47 @@ export type SharedStatePatch<T extends Record<string, unknown> = Record<string,
     [K in keyof T]?: SharedStatePatchEntry<T[K]>;
 };
 
+/**
+ * Kinds of resources an agent can share with subsequent agents.
+ *
+ * @since 5.2
+ */
+export type SharedResourceKind = "custom" | "extent" | "point" | "polygon" | "polyline";
+
+/**
+ * Resource available to agents during a conversation.
+ *
+ * @remarks Descriptions are limited to 256 characters. Payloads must be compatible with the structured clone algorithm.
+ * @since 5.2
+ */
+export type SharedResource = Readonly<{
+    id: string;
+    kind: SharedResourceKind;
+    description: string;
+    payload: unknown;
+    meta: {
+        createdByAgentId: string;
+        createdAt: number;
+    };
+}>;
+
+/**
+ * Resource supplied by an agent before the orchestrator adds identity and metadata.
+ *
+ * @remarks Description values longer than 256 characters are truncated. Payloads are cloned using the structured clone algorithm.
+ * @since 5.2
+ */
+export type SharedResourceInput = Readonly<{
+    kind: SharedResourceKind;
+    description: string;
+    payload: unknown;
+}>;
+
 /**
  * @param parameter0
  * @internal
  */
 export function createChatModel(parameter0?: {
     modelTier?: ChatModelTier;
-    temperature?: number;
     config?: RunnableConfig;
 }): Promise<ChatOpenAI>;