@microsoft/agents-hosting 1.6.1 → 1.7.0-beta.5.g67b2005119

package/src/cloudAdapter.ts

@@ -6,13 +6,13 @@
 import { AgentHandler, INVOKE_RESPONSE_KEY } from './activityHandler'
 import { BaseAdapter } from './baseAdapter'
 import { TurnContext } from './turnContext'
-import { Response } from 'express'
 import { Request } from './auth/request'
+import { WebResponse } from './interfaces/webResponse'
 import { ConnectorClient } from './connector-client/connectorClient'
 import { AuthConfiguration, getAuthConfigWithDefaults } from './auth/authConfiguration'
 import { AuthProvider } from './auth/authProvider'
 import { ApxProductionScope } from './auth/authConstants'
-import { MsalConnectionManager } from './auth/msalConnectionManager'
+import { MsalConnectionManager } from './auth/msal/msalConnectionManager'
 import { Activity, ActivityEventNames, ActivityTypes, Channels, ConversationReference, DeliveryModes, ConversationParameters, RoleTypes, ExceptionHelper } from '@microsoft/agents-activity'
 import { Errors } from './errorHelper'
 import { ResourceResponse } from './connector-client/resourceResponse'
@@ -289,7 +289,7 @@ export class CloudAdapter extends BaseAdapter {
    */
   protected resolveIfConnectorClientIsNeeded (activity: Activity): boolean {
     if (!activity) {
-      throw new TypeError('`activity` parameter required')
+      throw ExceptionHelper.generateException(TypeError, Errors.ActivityParameterRequired)
     }
 
     switch (activity.deliveryMode) {
@@ -392,7 +392,7 @@ export class CloudAdapter extends BaseAdapter {
             headers
           )
         } else {
-          throw new Error('Could not create connector client for agentic user')
+          throw ExceptionHelper.generateException(Error, Errors.CannotCreateConnectorClientForAgenticUser)
         }
       } else {
         // ABS tokens will not have an azp/appid so use the botframework scope.
@@ -580,7 +580,7 @@ export class CloudAdapter extends BaseAdapter {
    */
   public async process (
     request: Request,
-    res: Response,
+    res: WebResponse,
     logic: (context: TurnContext) => Promise<void>,
     headerPropagation?: HeaderPropagationDefinition): Promise<void> {
     return trace(AdapterTraceDefinitions.process, async ({ record }) => {
@@ -609,7 +609,7 @@ export class CloudAdapter extends BaseAdapter {
         res.end()
       }
       if (!request.body) {
-        throw new TypeError('`request.body` parameter required, make sure express.json() is used as middleware')
+        throw ExceptionHelper.generateException(TypeError, Errors.MissingRequestBody)
       }
       const incoming = normalizeIncomingActivity(request.body!)
       const activity = Activity.fromObject(incoming)
@@ -726,11 +726,11 @@ export class CloudAdapter extends BaseAdapter {
   async updateActivity (context: TurnContext, activity: Activity): Promise<ResourceResponse | void> {
     return trace(AdapterTraceDefinitions.updateActivity, async ({ record }) => {
       if (!context) {
-        throw new TypeError('`context` parameter required')
+        throw ExceptionHelper.generateException(TypeError, Errors.ContextParameterRequired)
       }
 
       if (!activity) {
-        throw new TypeError('`activity` parameter required')
+        throw ExceptionHelper.generateException(TypeError, Errors.ActivityParameterRequired)
       }
 
       record({ activity })
@@ -758,7 +758,7 @@ export class CloudAdapter extends BaseAdapter {
   async deleteActivity (context: TurnContext, reference: Partial<ConversationReference>): Promise<void> {
     return trace(AdapterTraceDefinitions.deleteActivity, async ({ record }) => {
       if (!context) {
-        throw new TypeError('`context` parameter required')
+        throw ExceptionHelper.generateException(TypeError, Errors.ContextParameterRequired)
       }
 
       if (!reference || !reference.serviceUrl || (reference.conversation == null) || !reference.conversation.id || !reference.activityId) {
@@ -791,7 +791,7 @@ export class CloudAdapter extends BaseAdapter {
       }
 
       if (!botAppIdOrIdentity) {
-        throw new TypeError('continueConversation: botAppIdOrIdentity is required')
+        throw ExceptionHelper.generateException(TypeError, Errors.ContinueConversationBotAppIdOrIdentityRequired)
       }
       const botAppId = typeof botAppIdOrIdentity === 'string' ? botAppIdOrIdentity : botAppIdOrIdentity.aud as string
 
@@ -911,10 +911,10 @@ export class CloudAdapter extends BaseAdapter {
     logic: (context: TurnContext) => Promise<void>
   ): Promise<void> {
     if (typeof serviceUrl !== 'string' || !serviceUrl) {
-      throw new TypeError('`serviceUrl` must be a non-empty string')
+      throw ExceptionHelper.generateException(TypeError, Errors.ServiceUrlRequired)
     }
-    if (!conversationParameters) throw new TypeError('`conversationParameters` must be defined')
-    if (!logic) throw new TypeError('`logic` must be defined')
+    if (!conversationParameters) throw ExceptionHelper.generateException(TypeError, Errors.ConversationParametersRequired)
+    if (!logic) throw ExceptionHelper.generateException(TypeError, Errors.LogicParameterRequired)
 
     const identity = CloudAdapter.createIdentity(audience)
     const restClient = await this.createConnectorClient(serviceUrl, audience, identity)

package/src/createCloudAdapter.ts

@@ -0,0 +1,56 @@
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+
+import { ActivityHandler } from './activityHandler'
+import { AgentApplication } from './app/agentApplication'
+import { AuthConfiguration } from './auth/authConfiguration'
+import { CloudAdapter } from './cloudAdapter'
+import { HeaderPropagationDefinition } from './headerPropagation'
+import { TurnState } from './app/turnState'
+
+/**
+ * Result of creating a CloudAdapter from an agent.
+ */
+export interface CloudAdapterResult {
+  adapter: CloudAdapter
+  headerPropagation: HeaderPropagationDefinition | undefined
+}
+
+/**
+ * Creates a CloudAdapter for the given agent.
+ *
+ * If the agent is an AgentApplication with a pre-configured adapter, that adapter is reused.
+ * Otherwise, a new CloudAdapter is created.
+ *
+ * @param agent - The AgentApplication or ActivityHandler instance.
+ * @param authConfig - Optional auth configuration used when creating a new CloudAdapter.
+ * If the agent already has an adapter, that adapter is reused and this value is ignored.
+ * @returns An object containing the CloudAdapter and optional header propagation configuration.
+ *
+ * @example
+ * ```typescript
+ * import { AgentApplication, TurnState, createCloudAdapter } from '@microsoft/agents-hosting';
+ *
+ * const app = new AgentApplication<TurnState>();
+ * const { adapter, headerPropagation } = createCloudAdapter(app, { clientId: process.env.CLIENT_ID });
+ *
+ * // Use the adapter directly with request/response objects compatible with CloudAdapter.process
+ * adapter.process(req, res, (context) => app.run(context), headerPropagation);
+ * ```
+ */
+export const createCloudAdapter = (
+  agent: AgentApplication<TurnState<any, any>> | ActivityHandler,
+  authConfig?: AuthConfiguration
+): CloudAdapterResult => {
+  if (agent instanceof ActivityHandler) {
+    return { adapter: new CloudAdapter(authConfig), headerPropagation: undefined }
+  }
+
+  // AgentApplication: reuse its pre-configured adapter when present, otherwise create one.
+  // headerPropagation is an application-level option, so read it regardless of adapter source.
+  const headerPropagation = agent.options?.headerPropagation
+  const adapter = agent.adapter ?? new CloudAdapter(authConfig)
+  return { adapter, headerPropagation }
+}

package/src/errorHelper.ts

@@ -196,6 +196,21 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
     description: 'missing context.activity.channelId'
   },
 
+  MissingContextActivityRecipientId: {
+    code: -120221,
+    description: 'missing context.activity.recipient.id'
+  },
+
+  MissingContextActivityConversationId: {
+    code: -120222,
+    description: 'missing context.activity.conversation.id'
+  },
+
+  MissingContextActivityFromId: {
+    code: -120223,
+    description: 'missing context.activity.from.id'
+  },
+
   /**
      * Error thrown when both channelId and from.id are required for operation.
      */
@@ -213,7 +228,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
   },
 
   // ============================================================================
-  // Attachment Errors (-120250 to -120290)
+  // Attachment Errors (-120250 to -120291)
   // ============================================================================
 
   /**
@@ -232,6 +247,14 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
     description: 'attachmentId is required'
   },
 
+  /**
+     * Error thrown when attachment is null or undefined.
+     */
+  AttachmentNullOrUndefined: {
+    code: -120265,
+    description: 'attachment cannot be null or undefined.'
+  },
+
   /**
      * Error thrown when viewId is required but missing.
      */
@@ -265,7 +288,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
   },
 
   // ============================================================================
-  // Connection and Authentication Errors (-120300 to -120590)
+  // Connection and Authentication Errors (-120300 to -120599)
   // ============================================================================
 
   /**
@@ -273,7 +296,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
      */
   ConnectionNotFoundInEnvironment: {
     code: -120300,
-    description: 'Connection "{connectionName}" not found in environment.'
+    description: 'Connection "{connectionName}" not found in environment connections.'
   },
 
   /**
@@ -340,6 +363,51 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
     description: 'Connection settings must be provided for this operation.'
   },
 
+  ConnectionSettingsRequiredForGetAccessTokenScope: {
+    code: -120381,
+    description: 'Connection settings must be provided to constructor when calling getAccessToken(scope)'
+  },
+
+  ConnectionSettingsRequiredForAcquireTokenOnBehalfOf: {
+    code: -120382,
+    description: 'Connection settings must be provided to constructor when calling acquireTokenOnBehalfOf(scopes, oboAssertion)'
+  },
+
+  FailedToAcquireTokenOnBehalfOf: {
+    code: -120383,
+    description: 'Failed to acquire token on behalf of user'
+  },
+
+  ConnectionSettingsRequiredForGetAgenticInstanceToken: {
+    code: -120384,
+    description: 'Connection settings must be provided when calling getAgenticInstanceToken'
+  },
+
+  FailedToAcquireInstanceTokenForAgentInstance: {
+    code: -120385,
+    description: 'Failed to acquire instance token for agent instance: {agentAppInstanceId}'
+  },
+
+  FailedToAcquireInstanceTokenForUserToken: {
+    code: -120386,
+    description: 'Failed to acquire instance token for user token: {agentAppInstanceId}'
+  },
+
+  ConnectionSettingsRequiredForGetAgenticApplicationToken: {
+    code: -120387,
+    description: 'Connection settings must be provided when calling getAgenticApplicationToken'
+  },
+
+  IdpmResourceAbsoluteUriRequired: {
+    code: -120388,
+    description: 'idpmResource must be a valid absolute URI'
+  },
+
+  FailedToAcquireTokenViaIdentityProxyManagerForAgentInstance: {
+    code: -120389,
+    description: 'Failed to acquire token via IdentityProxyManager for agent instance: {agentAppInstanceId}'
+  },
+
   /**
      * Error thrown when identity is required to get token provider.
      */
@@ -348,6 +416,31 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
     description: 'Identity is required to get the token provider.'
   },
 
+  FailedToAcquireTokenUsingCertificate: {
+    code: -120395,
+    description: 'Failed to acquire token using certificate'
+  },
+
+  FailedToAcquireTokenUsingClientSecret: {
+    code: -120396,
+    description: 'Failed to acquire token using client secret'
+  },
+
+  FailedToAcquireTokenUsingFICClientAssertion: {
+    code: -120397,
+    description: 'Failed to acquire token using FIC client assertion'
+  },
+
+  FailedToAcquireTokenUsingWIDClientAssertion: {
+    code: -120398,
+    description: 'Failed to acquire token using WID client assertion'
+  },
+
+  FailedToAcquireExternalTokenForFICClientAssertion: {
+    code: -120399,
+    description: 'Failed to acquire external token for FIC client assertion'
+  },
+
   /**
      * Error thrown when audience and service URL are required for token provider.
      */
@@ -580,6 +673,108 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
     description: 'Token request timed out after {timeoutMs} ms'
   },
 
+  // ============================================================================
+  // Entra Agent ID Sidecar Authentication Errors (-120800 to -120849)
+  // ============================================================================
+
+  /**
+   * Error thrown when the Entra sidecar auth provider is used without connection settings.
+   */
+  SidecarConnectionSettingsRequired: {
+    code: -120800,
+    description: 'Connection settings must be provided when using the Entra sidecar auth provider'
+  },
+
+  /**
+   * Error thrown when the resolved sidecar base URL is not a valid absolute URL.
+   */
+  SidecarBaseUrlInvalid: {
+    code: -120801,
+    description: 'The resolved sidecar base URL `{url}` is not a valid absolute URL'
+  },
+
+  /**
+   * Error thrown when the resolved sidecar base URL does not use the http or https scheme.
+   */
+  SidecarBaseUrlInsecureScheme: {
+    code: -120802,
+    description: 'The resolved sidecar base URL `{url}` must use the http or https scheme'
+  },
+
+  /**
+   * Error thrown when the resolved sidecar base URL contains userinfo (credentials).
+   */
+  SidecarBaseUrlUserInfo: {
+    code: -120803,
+    description: 'The resolved sidecar base URL `{url}` must not contain userinfo (credentials)'
+  },
+
+  /**
+   * Error thrown when the resolved sidecar base URL points to a non-loopback, non-private address.
+   */
+  SidecarBaseUrlNotLocal: {
+    code: -120804,
+    description: 'The resolved sidecar base URL `{url}` points to a non-loopback, non-private address. The Entra Agent ID sidecar (agent container) must be reachable only from within the agent\'s network boundary. Set `bypassLocalNetworkRestriction` to true in the connection configuration to override this safety check (UNSAFE: only for carefully validated private-network configurations)'
+  },
+
+  /**
+   * Error thrown when both AgentUsername and AgentUserId are supplied on a sidecar request (mutually exclusive).
+   */
+  SidecarUserIdentityMutuallyExclusive: {
+    code: -120805,
+    description: 'AgentUsername and AgentUserId are mutually exclusive; set only one on the sidecar request options'
+  },
+
+  /**
+   * Error thrown when a sidecar request fails after exhausting all retry attempts.
+   */
+  SidecarRequestFailed: {
+    code: -120806,
+    description: 'Sidecar request failed after {attempts} attempt(s): {message}'
+  },
+
+  /**
+   * Error thrown when the sidecar responds with a non-success status code.
+   */
+  SidecarErrorResponse: {
+    code: -120807,
+    description: 'Sidecar returned error status {status}: {message}'
+  },
+
+  /**
+   * Error thrown when the sidecar response is missing the authorizationHeader field.
+   */
+  SidecarResponseMissingAuthorizationHeader: {
+    code: -120808,
+    description: 'Sidecar response missing `authorizationHeader` field'
+  },
+
+  /**
+   * Error thrown when the sidecar response body cannot be parsed.
+   */
+  SidecarResponseUnparsable: {
+    code: -120809,
+    description: 'Sidecar returned an unparsable response body'
+  },
+
+  /**
+   * Error thrown when acquireTokenOnBehalfOf is called on the sidecar provider, which does not support OBO in Phase 1.
+   */
+  OnBehalfOfNotSupportedBySidecar: {
+    code: -120810,
+    description: 'acquireTokenOnBehalfOf is not supported by the Entra sidecar auth provider in Phase 1'
+  },
+
+  /**
+   * Error thrown when the sidecar returns a token with an authorization scheme other than Bearer.
+   * The hosting stack always transmits tokens as `Bearer {token}`, so a non-Bearer scheme cannot be
+   * honored and is rejected rather than silently sent as an invalid Authorization header.
+   */
+  SidecarUnsupportedAuthScheme: {
+    code: -120811,
+    description: 'The Entra Agent ID sidecar returned an unsupported authorization scheme `{scheme}`. Only the Bearer scheme is supported'
+  },
+
   // ============================================================================
   // Agent and Client Errors (-120600 to -120650)
   // ============================================================================
@@ -616,6 +811,11 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
     description: 'Agent name contains invalid characters: {agentName}'
   },
 
+  ContinueConversationBotAppIdOrIdentityRequired: {
+    code: -120631,
+    description: 'continueConversation: botAppIdOrIdentity is required'
+  },
+
   /**
    * Error thrown when failed to post activity to agent.
    */
@@ -633,7 +833,7 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
   },
 
   // ============================================================================
-  // Storage and State Errors (-120700 to -120730)
+  // Storage and State Errors (-120700 to -120732)
   // ============================================================================
 
   /**
@@ -644,6 +844,22 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
     description: 'Storage: error writing "{key}" due to eTag conflict.'
   },
 
+  /**
+     * Error thrown when keys are required for storage read operations.
+     */
+  StorageReadKeysRequired: {
+    code: -120701,
+    description: 'Keys are required when reading.'
+  },
+
+  /**
+     * Error thrown when changes are required for storage write operations.
+     */
+  StorageWriteChangesRequired: {
+    code: -120702,
+    description: 'Changes are required when writing.'
+  },
+
   /**
      * Error thrown when storage option is not available in app options.
      */
@@ -668,96 +884,18 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
     description: 'Invalid state scope: {scope}'
   },
 
-  // ============================================================================
-  // Application Configuration Errors (-120850 to -120900)
-  // ============================================================================
-
-  /**
-     * Error thrown when longRunningMessages property is unavailable.
-     */
-  LongRunningMessagesPropertyUnavailable: {
-    code: -120850,
-    description: 'The Application.longRunningMessages property is unavailable because no adapter was configured in the app.'
-  },
-
-  /**
-     * Error thrown when transcriptLogger property is unavailable.
-     */
-  TranscriptLoggerPropertyUnavailable: {
-    code: -120860,
-    description: 'The Application.transcriptLogger property is unavailable because no adapter was configured in the app.'
-  },
-
-  /**
-     * Error thrown when TranscriptLoggerMiddleware requires a TranscriptLogger instance.
-     */
-  TranscriptLoggerInstanceRequired: {
-    code: -120870,
-    description: 'TranscriptLoggerMiddleware requires a TranscriptLogger instance.'
-  },
-
-  /**
-     * Error thrown when extension is already registered.
-     */
-  ExtensionAlreadyRegistered: {
-    code: -120880,
-    description: 'Extension already registered'
+  InvalidStatePath: {
+    code: -120731,
+    description: 'Invalid state path: {path}'
   },
 
-  /**
-     * Error thrown when invalid plugin type is added to MiddlewareSet.
-     */
-  InvalidMiddlewarePluginType: {
-    code: -120890,
-    description: 'MiddlewareSet.use(): invalid plugin type being added.'
-  },
-
-  /**
-     * Error thrown when the stream has already ended.
-     */
-  StreamAlreadyEnded: {
-    code: -120900,
-    description: 'The stream has already ended.'
-  },
-
-  // ============================================================================
-  // Adaptive Cards Errors (-120950 to -120980)
-  // ============================================================================
-
-  /**
-     * Error thrown when unexpected AdaptiveCards.actionExecute() is triggered.
-     */
-  UnexpectedActionExecute: {
-    code: -120950,
-    description: 'Unexpected AdaptiveCards.actionExecute() triggered for activity type: {activityType}'
-  },
-
-  /**
-     * Error thrown when unexpected AdaptiveCards.actionSubmit() is triggered.
-     */
-  UnexpectedActionSubmit: {
-    code: -120960,
-    description: 'Unexpected AdaptiveCards.actionSubmit() triggered for activity type: {activityType}'
-  },
-
-  /**
-     * Error thrown when unexpected AdaptiveCards.search() is triggered.
-     */
-  UnexpectedSearchAction: {
-    code: -120970,
-    description: 'Unexpected AdaptiveCards.search() triggered for activity type: {activityType}'
-  },
-
-  /**
-     * Error thrown when invalid action value is provided.
-     */
-  InvalidActionValue: {
-    code: -120980,
-    description: 'Invalid action value: {error}'
+  TurnStateMissingStateScope: {
+    code: -120732,
+    description: 'TurnState missing state scope named "{scope}".'
   },
 
   // ============================================================================
-  // Proactive Messaging Errors (-120740 to -120799)
+  // Proactive Messaging Errors (-120740 to -120753)
   // ============================================================================
 
   /**
@@ -873,6 +1011,133 @@ export const Errors: { [key: string]: AgentErrorDefinition } = {
     description: 'CreateConversationOptionsBuilder: Teams channel conversations require an initial activity. Call withActivity() before build().'
   },
 
+  // ============================================================================
+  // Hosting / Web layer errors (-120800 to -120840)
+  // ============================================================================
+
+  /**
+   * Error thrown by CloudAdapter.process when the incoming request lacks a parsed body.
+   * Indicates the hosting layer (e.g. express.json() or Fastify's JSON parser) was not configured.
+   */
+  MissingRequestBody: {
+    code: -120800,
+    description: '`request.body` parameter required; ensure your hosting layer parses JSON request bodies before invoking the adapter (e.g., express.json() with Express or Fastify\'s built-in JSON parser).'
+  },
+
+  /**
+   * Error thrown by verifyToken when the provided JWT cannot be decoded.
+   */
+  InvalidJwtToken: {
+    code: -120810,
+    description: 'invalid token'
+  },
+
+  /**
+   * Error thrown by verifyToken when the token audience does not match any configured connection clientId.
+   */
+  JwtAudienceMismatch: {
+    code: -120820,
+    description: 'Audience mismatch'
+  },
+
+  // ============================================================================
+  // Application Configuration Errors (-120850 to -120902)
+  // ============================================================================
+
+  /**
+     * Error thrown when longRunningMessages property is unavailable.
+     */
+  LongRunningMessagesPropertyUnavailable: {
+    code: -120850,
+    description: 'The Application.longRunningMessages property is unavailable because no adapter was configured in the app.'
+  },
+
+  /**
+     * Error thrown when transcriptLogger property is unavailable.
+     */
+  TranscriptLoggerPropertyUnavailable: {
+    code: -120860,
+    description: 'The Application.transcriptLogger property is unavailable because no adapter was configured in the app.'
+  },
+
+  /**
+     * Error thrown when TranscriptLoggerMiddleware requires a TranscriptLogger instance.
+     */
+  TranscriptLoggerInstanceRequired: {
+    code: -120870,
+    description: 'TranscriptLoggerMiddleware requires a TranscriptLogger instance.'
+  },
+
+  /**
+     * Error thrown when extension is already registered.
+     */
+  ExtensionAlreadyRegistered: {
+    code: -120880,
+    description: 'Extension already registered'
+  },
+
+  /**
+     * Error thrown when invalid plugin type is added to MiddlewareSet.
+     */
+  InvalidMiddlewarePluginType: {
+    code: -120890,
+    description: 'MiddlewareSet.use(): invalid plugin type being added.'
+  },
+
+  /**
+     * Error thrown when the stream has already ended.
+     */
+  StreamAlreadyEnded: {
+    code: -120900,
+    description: 'The stream has already ended.'
+  },
+
+  ConversationUpdateHandlerMustBeFunction: {
+    code: -120901,
+    description: "ConversationUpdate 'handler' for {event} is {handlerType}. Type of 'handler' must be a function."
+  },
+
+  ContinueConversationAdapterRequired: {
+    code: -120902,
+    description: "You must configure the Application with an 'adapter' before calling Application.continueConversationAsync()"
+  },
+
+  // ============================================================================
+  // Adaptive Cards Errors (-120950 to -120980)
+  // ============================================================================
+
+  /**
+     * Error thrown when unexpected AdaptiveCards.actionExecute() is triggered.
+     */
+  UnexpectedActionExecute: {
+    code: -120950,
+    description: 'Unexpected AdaptiveCards.actionExecute() triggered for activity type: {activityType}'
+  },
+
+  /**
+     * Error thrown when unexpected AdaptiveCards.actionSubmit() is triggered.
+     */
+  UnexpectedActionSubmit: {
+    code: -120960,
+    description: 'Unexpected AdaptiveCards.actionSubmit() triggered for activity type: {activityType}'
+  },
+
+  /**
+     * Error thrown when unexpected AdaptiveCards.search() is triggered.
+     */
+  UnexpectedSearchAction: {
+    code: -120970,
+    description: 'Unexpected AdaptiveCards.search() triggered for activity type: {activityType}'
+  },
+
+  /**
+     * Error thrown when invalid action value is provided.
+     */
+  InvalidActionValue: {
+    code: -120980,
+    description: 'Invalid action value: {error}'
+  },
+
   // ============================================================================
   // General Errors (-120990)
   // ============================================================================