@microsoft/agents-hosting 1.5.0-beta.10.gc9dfbe84d2 → 1.5.0-beta.12.ga9a2b23c19

package/dist/src/errorHelper.js.map

@@ -1 +1 @@
-{"version":3,"file":"errorHelper.js","sourceRoot":"","sources":["../../src/errorHelper.ts"],"names":[],"mappings":";AAAA,4DAA4D;AAC5D,kCAAkC;;;AAIrB,QAAA,MAAM,GAA4C;IAC7D,+EAA+E;IAC/E,uDAAuD;IACvD,+EAA+E;IAE/E;;SAEK;IACL,kBAAkB,EAAE;QAClB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,+BAA+B;KAC7C;IAED;;SAEK;IACL,0BAA0B,EAAE;QAC1B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,0CAA0C;KACxD;IAED;;SAEK;IACL,mBAAmB,EAAE;QACnB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,8BAA8B;KAC5C;IAED;;SAEK;IACL,qBAAqB,EAAE;QACrB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,yBAAyB;KACvC;IAED;;SAEK;IACL,gBAAgB,EAAE;QAChB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,uBAAuB;KACrC;IAED;;SAEK;IACL,yBAAyB,EAAE;QACzB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,6BAA6B;KAC3C;IAED;;SAEK;IACL,oBAAoB,EAAE;QACpB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,4DAA4D;KAC1E;IAED;;SAEK;IACL,2BAA2B,EAAE;QAC3B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,+BAA+B;KAC7C;IAED;;SAEK;IACL,yBAAyB,EAAE;QACzB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,4DAA4D;KAC1E;IAED;;SAEK;IACL,wBAAwB,EAAE;QACxB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,4BAA4B;KAC1C;IAED,+EAA+E;IAC/E,uDAAuD;IACvD,+EAA+E;IAE/E;;SAEK;IACL,iBAAiB,EAAE;QACjB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,wBAAwB;KACtC;IAED;;SAEK;IACL,sBAAsB,EAAE;QACtB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,6BAA6B;KAC3C;IAED;;SAEK;IACL,4BAA4B,EAAE;QAC5B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,uCAAuC;KACrD;IAED;;SAEK;IACL,oCAAoC,EAAE;QACpC,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,6DAA6D;KAC3E;IAED;;SAEK;IACL,eAAe,EAAE;QACf,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,qBAAqB;KACnC;IAED;;SAEK;IACL,+BAA+B,EAAE;QAC/B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,wCAAwC;KACtD;IAED;;SAEK;IACL,mCAAmC,EAAE;QACnC,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,4CAA4C;KAC1D;IAED;;SAEK;IACL,kBAAkB,EAAE;QAClB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,uCAAuC;KACrD;IAED;;SAEK;IACL,8BAA8B,EAAE;QAC9B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,wCAAwC;KACtD;IAED;;SAEK;IACL,wBAAwB,EAAE;QACxB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,4BAA4B;KAC1C;IAED;;SAEK;IACL,qBAAqB,EAAE;QACrB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,0BAA0B;KACxC;IAED;;SAEK;IACL,6BAA6B,EAAE;QAC7B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,kCAAkC;KAChD;IAED;;SAEK;IACL,+BAA+B,EAAE;QAC/B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,oCAAoC;KAClD;IAED;;SAEK;IACL,0BAA0B,EAAE;QAC1B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,mFAAmF;KACjG;IAED;;SAEK;IACL,oCAAoC,EAAE;QACpC,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,mFAAmF;KACjG;IAED,+EAA+E;IAC/E,yCAAyC;IACzC,+EAA+E;IAE/E;;SAEK;IACL,sBAAsB,EAAE;QACtB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,4BAA4B;KAC1C;IAED;;SAEK;IACL,oBAAoB,EAAE;QACpB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,0BAA0B;KACxC;IAED;;SAEK;IACL,cAAc,EAAE;QACd,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,oBAAoB;KAClC;IAED;;SAEK;IACL,eAAe,EAAE;QACf,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,2BAA2B;KACzC;IAED;;SAEK;IACL,4BAA4B,EAAE;QAC5B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,iCAAiC;KAC/C;IAED,+EAA+E;IAC/E,4DAA4D;IAC5D,+EAA+E;IAE/E;;SAEK;IACL,+BAA+B,EAAE;QAC/B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,yDAAyD;KACvE;IAED;;SAEK;IACL,wBAAwB,EAAE;QACxB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,yDAAyD;KACvE;IAED;;SAEK;IACL,4BAA4B,EAAE;QAC5B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,iCAAiC;KAC/C;IAED;;SAEK;IACL,6BAA6B,EAAE;QAC7B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,qDAAqD;KACnE;IAED;;SAEK;IACL,yCAAyC,EAAE;QACzC,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,oDAAoD;KAClE;IAED;;SAEK;IACL,kBAAkB,EAAE;QAClB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,wCAAwC;KACtD;IAED;;SAEK;IACL,iCAAiC,EAAE;QACjC,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,uEAAuE;KACrF;IAED;;SAEK;IACL,6BAA6B,EAAE;QAC7B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,2GAA2G;KACzH;IAED;;SAEK;IACL,0BAA0B,EAAE;QAC1B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,0DAA0D;KACxE;IAED;;SAEK;IACL,gCAAgC,EAAE;QAChC,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,iDAAiD;KAC/D;IAED;;SAEK;IACL,6CAA6C,EAAE;QAC7C,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,kEAAkE;KAChF;IAED;;SAEK;IACL,oCAAoC,EAAE;QACpC,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,2EAA2E;KACzF;IAED;;SAEK;IACL,YAAY,EAAE;QACZ,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,eAAe;KAC7B;IAED;;SAEK;IACL,8BAA8B,EAAE;QAC9B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,8CAA8C;KAC5D;IAED;;SAEK;IACL,iBAAiB,EAAE;QACjB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,qBAAqB;KACnC;IAED;;SAEK;IACL,oBAAoB,EAAE;QACpB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,yBAAyB;KACvC;IAED;;SAEK;IACL,4BAA4B,EAAE;QAC5B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,kCAAkC;KAChD;IAED;;SAEK;IACL,2BAA2B,EAAE;QAC3B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,gHAAgH;KAC9H;IAED;;SAEK;IACL,0BAA0B,EAAE;QAC1B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,iHAAiH;KAC/H;IAED;;SAEK;IACL,mCAAmC,EAAE;QACnC,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,yGAAyG;KACvH;IAED;;SAEK;IACL,eAAe,EAAE;QACf,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,oBAAoB;KAClC;IAED;;SAEK;IACL,cAAc,EAAE;QACd,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,mBAAmB;KACjC;IAED;;SAEK;IACL,uBAAuB,EAAE;QACvB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,6EAA6E;KAC3F;IAED;;SAEK;IACL,+BAA+B,EAAE;QAC/B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,yGAAyG;KACvH;IAED;;SAEK;IACL,mBAAmB,EAAE;QACnB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,2GAA2G;KACzH;IAED;;SAEK;IACL,oBAAoB,EAAE;QACpB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,oDAAoD;KAClE;IAED;;SAEK;IACL,wBAAwB,EAAE;QACxB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,oEAAoE;KAClF;IAED;;SAEK;IACL,0BAA0B,EAAE;QAC1B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,uDAAuD;KACrE;IAED;;SAEK;IACL,4BAA4B,EAAE;QAC5B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,0CAA0C;KACxD;IAED;;SAEK;IACL,+BAA+B,EAAE;QAC/B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,yGAAyG;KACvH;IAED,+EAA+E;IAC/E,+CAA+C;IAC/C,+EAA+E;IAE/E;;SAEK;IACL,wBAAwB,EAAE;QACxB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,mDAAmD;KACjE;IAED;;SAEK;IACL,iBAAiB,EAAE;QACjB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,wBAAwB;KACtC;IAED;;SAEK;IACL,2BAA2B,EAAE;QAC3B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,gDAAgD;KAC9D;IAED;;SAEK;IACL,sBAAsB,EAAE;QACtB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,uBAAuB;KACrC;IAED,+EAA+E;IAC/E,gDAAgD;IAChD,+EAA+E;IAE/E;;SAEK;IACL,mBAAmB,EAAE;QACnB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,sDAAsD;KACpE;IAED;;SAEK;IACL,yBAAyB,EAAE;QACzB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,uGAAuG;KACrH;IAED;;SAEK;IACL,cAAc,EAAE;QACd,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,kEAAkE;KAChF;IAED;;SAEK;IACL,iBAAiB,EAAE;QACjB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,8BAA8B;KAC5C;IAED,+EAA+E;IAC/E,wDAAwD;IACxD,+EAA+E;IAE/E;;SAEK;IACL,sCAAsC,EAAE;QACtC,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,2GAA2G;KACzH;IAED;;SAEK;IACL,mCAAmC,EAAE;QACnC,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,wGAAwG;KACtH;IAED;;SAEK;IACL,gCAAgC,EAAE;QAChC,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,kEAAkE;KAChF;IAED;;SAEK;IACL,0BAA0B,EAAE;QAC1B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,8BAA8B;KAC5C;IAED;;SAEK;IACL,2BAA2B,EAAE;QAC3B,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,uDAAuD;KACrE;IAED;;SAEK;IACL,kBAAkB,EAAE;QAClB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,+BAA+B;KAC7C;IAED,+EAA+E;IAC/E,6CAA6C;IAC7C,+EAA+E;IAE/E;;SAEK;IACL,uBAAuB,EAAE;QACvB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,sFAAsF;KACpG;IAED;;SAEK;IACL,sBAAsB,EAAE;QACtB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,qFAAqF;KACnG;IAED;;SAEK;IACL,sBAAsB,EAAE;QACtB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,+EAA+E;KAC7F;IAED;;SAEK;IACL,kBAAkB,EAAE;QAClB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,+BAA+B;KAC7C;IAED,+EAA+E;IAC/E,2BAA2B;IAC3B,+EAA+E;IAE/E;;SAEK;IACL,gBAAgB,EAAE;QAChB,IAAI,EAAE,CAAC,MAAM;QACb,WAAW,EAAE,oCAAoC;KAClD;CACF,CAAA"}
+{"version":3,"file":"errorHelper.js","sourceRoot":"","sources":["../../src/errorHelper.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@microsoft/agents-hosting",
-  "version": "1.5.0-beta.10.gc9dfbe84d2",
+  "version": "1.5.0-beta.12.ga9a2b23c19",
   "homepage": "https://github.com/microsoft/Agents-for-js",
   "repository": {
     "type": "git",
@@ -21,7 +21,7 @@
   "dependencies": {
     "@azure/core-auth": "^1.10.1",
     "@azure/msal-node": "^5.0.6",
-    "@microsoft/agents-activity": "1.5.0-beta.10.gc9dfbe84d2",
+    "@microsoft/agents-activity": "1.5.0-beta.12.ga9a2b23c19",
     "axios": "^1.13.6",
     "jsonwebtoken": "^9.0.3",
     "jwks-rsa": "^4.0.1",

package/src/app/agentApplication.ts

@@ -20,7 +20,10 @@ import { RouteList } from './routeList'
 import { TranscriptLoggerMiddleware } from '../transcript'
 import { CloudAdapter } from '../cloudAdapter'
 import { Authorization, UserAuthorization, AuthorizationManager } from './auth'
+import { Proactive } from './proactive'
 import { JwtPayload } from 'jsonwebtoken'
+import { ExceptionHelper } from '@microsoft/agents-activity'
+import { Errors } from '../errorHelper'
 
 const logger = debug('agents:app')
 
@@ -76,6 +79,7 @@ export class AgentApplication<TState extends TurnState> {
   private readonly _adapter?: CloudAdapter
   private readonly _authorizationManager?: AuthorizationManager
   private readonly _authorization?: Authorization
+  private readonly _proactive?: Proactive<TState>
   private _typingTimer: NodeJS.Timeout | undefined
   protected readonly _extensions: AgentExtension<TState>[] = []
   private readonly _adaptiveCards: AdaptiveCardsActions<TState>
@@ -130,6 +134,14 @@ export class AgentApplication<TState extends TurnState> {
       this._authorization = new UserAuthorization(this._authorizationManager)
     }
 
+    // Create Proactive whenever proactive options are explicitly configured or a storage
+    // backend is available — no explicit `proactive` option is required.
+    if (this._options.proactive !== undefined || this._options.storage !== undefined) {
+      const proactiveOpts = this._options.proactive ?? {}
+      const proactiveStorage = proactiveOpts.storage ?? this._options.storage
+      this._proactive = new Proactive<TState>(this, { ...proactiveOpts, storage: proactiveStorage })
+    }
+
     if (this._options.longRunningMessages && !this._adapter && !this._options.agentAppId) {
       throw new Error('The Application.longRunningMessages property is unavailable because no adapter was configured in the app.')
     }
@@ -157,6 +169,27 @@ export class AgentApplication<TState extends TurnState> {
     return this._authorization
   }
 
+  /**
+   * Gets the proactive messaging subsystem.
+   *
+   * @throws Error if no storage backend was configured (neither `options.storage` nor
+   *   `options.proactive.storage`).
+   */
+  public get proactive (): Proactive<TState> {
+    if (!this._proactive) {
+      throw ExceptionHelper.generateException(Error, Errors.ProactivePropertyUnavailable)
+    }
+    return this._proactive
+  }
+
+  /**
+   * Returns `true` if user authorization was configured, without throwing.
+   * Used internally by the Proactive subsystem to check whether token acquisition is available.
+   */
+  public get hasUserAuthorization (): boolean {
+    return this._authorization !== undefined
+  }
+
   /**
    * Gets the options used to configure the application.
    *

package/src/app/agentApplicationBuilder.ts

@@ -7,6 +7,7 @@ import { Storage } from '../storage'
 import { AgentApplication } from './agentApplication'
 import { AgentApplicationOptions } from './agentApplicationOptions'
 import { AuthorizationOptions } from './auth/types'
+import { ProactiveOptions } from './proactive'
 import { TurnState } from './turnState'
 
 /**
@@ -64,6 +65,16 @@ export class AgentApplicationBuilder<TState extends TurnState = TurnState> {
     return this
   }
 
+  /**
+   * Configures the proactive messaging subsystem.
+   * @param options Proactive options including optional storage backend
+   * @returns This builder instance for chaining
+   */
+  public withProactive (options: ProactiveOptions): this {
+    this._options.proactive = options
+    return this
+  }
+
   /**
    * Builds and returns a new AgentApplication instance configured with the provided options.
    * @returns A new AgentApplication instance

package/src/app/agentApplicationOptions.ts

@@ -12,6 +12,7 @@ import { TurnState } from './turnState'
 import { HeaderPropagationDefinition } from '../headerPropagation'
 import { AuthorizationOptions } from './auth/types'
 import { Connections } from '../auth/connections'
+import { ProactiveOptions } from './proactive'
 
 /**
  * Configuration options for creating and initializing an Agent Application.
@@ -147,4 +148,10 @@ export interface AgentApplicationOptions<TState extends TurnState> {
    * identity providers.
    */
   connections?: Connections
+
+  /**
+   * Optional. Configuration for the proactive messaging subsystem.
+   * When provided, `app.proactive` will be available.
+   */
+  proactive?: ProactiveOptions
 }

package/src/app/index.ts

@@ -19,3 +19,4 @@ export * from './adaptiveCards'
 export * from './streaming/streamingResponse'
 export * from './streaming/citation'
 export * from './teamsAttachmentDownloader'
+export * from './proactive'

package/src/app/proactive/conversation.ts

@@ -0,0 +1,87 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+import type { JwtPayload } from 'jsonwebtoken'
+import type { ConversationReference } from '@microsoft/agents-activity'
+import { ExceptionHelper } from '@microsoft/agents-activity'
+import type { TurnContext } from '../../turnContext'
+import { Errors } from '../../errorHelper'
+
+/**
+ * JWT-like claims identifying the agent for proactive authentication.
+ * `aud` (the agent's client ID) is required; all other fields are optional.
+ */
+export interface ConversationClaims {
+  aud: string
+  azp?: string
+  appid?: string
+  tid?: string
+  [key: string]: string | undefined
+}
+
+/**
+ * A serializable pair of a `ConversationReference` and the JWT claims needed
+ * to authenticate proactive calls on behalf of this agent.
+ *
+ * Instances are stored in and retrieved from the proactive storage backend.
+ * The `identity` getter produces the `JwtPayload` shape expected by
+ * `adapter.continueConversation()`.
+ */
+export class Conversation {
+  reference: ConversationReference
+  claims: ConversationClaims
+
+  constructor (context: TurnContext)
+  constructor (claims: ConversationClaims, reference: ConversationReference)
+  constructor (
+    contextOrClaims: TurnContext | ConversationClaims,
+    reference?: ConversationReference
+  ) {
+    if ('activity' in contextOrClaims) {
+      // TurnContext overload
+      const context = contextOrClaims as TurnContext
+      this.reference = context.activity.getConversationReference()
+      const id = context.identity as JwtPayload | undefined
+      this.claims = {
+        ...(id ?? {}),
+        aud: Array.isArray(id?.aud) ? (id.aud as string[])[0] : (id?.aud ?? '')
+      } as ConversationClaims
+    } else {
+      // (claims, reference) overload — matches C# parameter order
+      this.claims = contextOrClaims as ConversationClaims
+      this.reference = reference!
+    }
+  }
+
+  /**
+   * Returns a `JwtPayload`-compatible object for passing to
+   * `adapter.continueConversation()` as `botAppIdOrIdentity`.
+   */
+  get identity (): JwtPayload {
+    return this.claims as unknown as JwtPayload
+  }
+
+  /**
+   * Returns a JSON string of `{ reference, claims }` — suitable for use in
+   * HTTP request bodies when passing a conversation to another service.
+   */
+  toJson (): string {
+    return JSON.stringify({ reference: this.reference, claims: this.claims })
+  }
+
+  /**
+   * Throws if any required field is missing.
+   * Called by `Proactive.storeConversation()` before writing to storage.
+   */
+  validate (): void {
+    if (!this.reference.conversation?.id) {
+      throw ExceptionHelper.generateException(Error, Errors.ConversationInvalidId)
+    }
+    if (!this.reference.serviceUrl) {
+      throw ExceptionHelper.generateException(Error, Errors.ConversationInvalidServiceUrl)
+    }
+    if (!this.claims.aud) {
+      throw ExceptionHelper.generateException(Error, Errors.ConversationInvalidAud)
+    }
+  }
+}

package/src/app/proactive/conversationBuilder.ts

@@ -0,0 +1,139 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+import type { ChannelAccount, ConversationAccount, ConversationReference } from '@microsoft/agents-activity'
+import type { TurnContext } from '../../turnContext'
+import { Conversation, type ConversationClaims } from './conversation'
+import { ConversationReferenceBuilder } from './conversationReferenceBuilder'
+
+/**
+ * Fluent builder for the `Conversation` class.
+ *
+ * @example
+ * ```typescript
+ * // Build from scratch
+ * const conv = ConversationBuilder
+ *   .create('my-client-id', 'msteams')
+ *   .withUser('user-aad-id')
+ *   .withConversationId('19:channel@thread.skype')
+ *   .build()
+ *
+ * // Build from a live TurnContext
+ * const conv = ConversationBuilder.fromContext(turnContext).build()
+ * ```
+ */
+export class ConversationBuilder {
+  private readonly _agentClientId: string
+  private readonly _channelId: string
+  private readonly _serviceUrl: string
+  private _claims: ConversationClaims
+  private _reference: Partial<ConversationReference>
+
+  private constructor (
+    agentClientId: string,
+    channelId: string,
+    serviceUrl: string,
+    claims: ConversationClaims,
+    reference: Partial<ConversationReference>
+  ) {
+    this._agentClientId = agentClientId
+    this._channelId = channelId
+    this._serviceUrl = serviceUrl
+    this._claims = claims
+    this._reference = reference
+  }
+
+  /**
+   * Creates a new builder for the given agent and channel.
+   * @param requestorId Optional: the client ID of the app making the request.
+   *   Becomes the `appid` claim, used in multi-tenant Azure Bot scenarios.
+   */
+  static create (
+    agentClientId: string,
+    channelId: string,
+    serviceUrl?: string,
+    requestorId?: string
+  ): ConversationBuilder {
+    const claims: ConversationClaims = { aud: agentClientId }
+    if (requestorId) claims.appid = requestorId
+    return new ConversationBuilder(agentClientId, channelId, serviceUrl ?? '', claims, ConversationReferenceBuilder.create(agentClientId, channelId, serviceUrl).build())
+  }
+
+  /**
+   * Creates a builder pre-populated from a live `TurnContext`.
+   * Captures both the conversation reference and the JWT identity claims.
+   */
+  static fromContext (context: TurnContext): ConversationBuilder {
+    const ref = context.activity.getConversationReference()
+    const id = context.identity
+    const aud = Array.isArray(id?.aud) ? id.aud[0] : (id?.aud ?? '')
+    const claims: ConversationClaims = {
+      ...(id ?? {}),
+      aud,
+    } as ConversationClaims
+    return new ConversationBuilder(
+      aud,
+      ref.channelId,
+      ref.serviceUrl ?? '',
+      claims,
+      ref
+    )
+  }
+
+  /** Sets `reference.user`. */
+  withUser (userId: string, userName?: string): this {
+    const user: ChannelAccount = { id: userId, name: userName }
+    this._reference = { ...this._reference, user }
+    return this
+  }
+
+  /** Sets `reference.conversation.id`. */
+  withConversationId (id: string): this {
+    const conversation: ConversationAccount = { ...(this._reference.conversation ?? { isGroup: false }), id }
+    this._reference = { ...this._reference, conversation }
+    return this
+  }
+
+  /** Sets `reference.conversation` from a full `ConversationAccount`. */
+  withConversation (account: ConversationAccount): this {
+    this._reference = { ...this._reference, conversation: account }
+    return this
+  }
+
+  /** Sets `reference.activityId`. */
+  withActivityId (activityId: string): this {
+    this._reference = { ...this._reference, activityId }
+    return this
+  }
+
+  /**
+   * Merges a partial `ConversationReference` into the current one.
+   * Useful for overlaying externally-provided reference data without losing
+   * fields set by earlier builder calls.
+   */
+  withReference (ref: Partial<ConversationReference>): this {
+    this._reference = { ...this._reference, ...ref }
+    return this
+  }
+
+  /** Builds the `Conversation`, auto-filling `serviceUrl` from channel defaults if needed. */
+  build (): Conversation {
+    const serviceUrl =
+      this._serviceUrl ||
+      this._reference.serviceUrl ||
+      ConversationReferenceBuilder.serviceUrlForChannel(this._channelId)
+
+    const reference: ConversationReference = {
+      conversation: this._reference.conversation ?? { id: '', isGroup: false },
+      agent: this._reference.agent ?? { id: this._agentClientId },
+      ...this._reference,
+      // Ensure channelId and serviceUrl always use our resolved values
+      channelId: this._channelId,
+      serviceUrl,
+    }
+
+    const conv = new Conversation(this._claims, reference)
+    conv.validate()
+    return conv
+  }
+}

package/src/app/proactive/conversationReferenceBuilder.ts

@@ -0,0 +1,161 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+import type { ChannelAccount, ConversationReference } from '@microsoft/agents-activity'
+import { Channels, RoleTypes } from '@microsoft/agents-activity'
+import { debug } from '@microsoft/agents-activity/logger'
+
+const logger = debug('agents:conversation-reference-builder')
+
+/** Set of all channel IDs defined in the Channels enum, used for validation. */
+const knownChannelIds = new Set(Object.values(Channels) as string[])
+
+/**
+ * Well-known Teams service URLs for proactive messaging.
+ *
+ * Use only when the incoming `serviceUrl` from a real conversation is unavailable.
+ * Once you have received a `serviceUrl` from a real turn, cache and prefer that value.
+ */
+export const TeamsServiceEndpoints = {
+  /** Standard public cloud Teams endpoint. */
+  publicGlobal: 'https://smba.trafficmanager.net/teams/',
+  /** US Government Community Cloud (GCC). */
+  gcc: 'https://smba.infra.gcc.teams.microsoft.com/teams',
+  /** US Government Community Cloud High (GCC-High). */
+  gccHigh: 'https://smba.infra.gov.teams.microsoft.us/teams',
+  /** US Department of Defense (DoD). */
+  dod: 'https://smba.infra.dod.teams.microsoft.us/teams',
+} as const
+
+/**
+ * Fluent builder for `ConversationReference`.
+ */
+export class ConversationReferenceBuilder {
+  private readonly _channelId: string
+  private _serviceUrl: string
+  private _agent: ChannelAccount
+  private _user?: ChannelAccount
+  private _conversationId?: string
+  private _activityId?: string
+  private _locale?: string
+
+  private constructor (channelId: string, serviceUrl: string, agent: ChannelAccount) {
+    this._channelId = channelId
+    this._serviceUrl = serviceUrl
+    this._agent = agent
+  }
+
+  /**
+   * Creates a new builder seeded with the agent identity and channel.
+   * On Teams, the agent id is prefixed with `28:` automatically.
+   * @param agentClientId The agent's client (app) ID.
+   * @param channelId The target channel (e.g. `'msteams'`, `'webchat'`).
+   * @param serviceUrl Optional override. If omitted, `build()` fills in the
+   *   channel default via `serviceUrlForChannel()`.
+   */
+  static create (
+    agentClientId: string,
+    channelId: string,
+    serviceUrl?: string
+  ): ConversationReferenceBuilder {
+    return new ConversationReferenceBuilder(
+      channelId,
+      serviceUrl ?? '',
+      ConversationReferenceBuilder.agentForChannel(channelId, agentClientId)
+    )
+  }
+
+  /**
+   * Returns the default service URL for a channel.
+   * Teams returns the public global endpoint; all other channels use the
+   * `https://{channelId}.botframework.com/` pattern (matching C# behavior).
+   */
+  static serviceUrlForChannel (channelId: string): string {
+    if (!channelId) return ''
+    if (channelId === Channels.Msteams) return TeamsServiceEndpoints.publicGlobal
+    if (!knownChannelIds.has(channelId)) {
+      logger.warn(
+        `serviceUrlForChannel: unrecognized channelId '${channelId}' — constructing fallback URL ` +
+        'https://<channelId>.botframework.com/. Provide an explicit serviceUrl to suppress this warning.'
+      )
+    }
+    return `https://${channelId}.botframework.com/`
+  }
+
+  /** Sets `reference.user` from an id + optional name. Role defaults to `RoleTypes.User`. */
+  withUser (userId: string, userName?: string): this
+  /** Sets `reference.user` from a full `ChannelAccount`. */
+  withUser (account: ChannelAccount): this
+  withUser (userIdOrAccount: string | ChannelAccount, userName?: string): this {
+    this._user = typeof userIdOrAccount === 'string'
+      ? { id: userIdOrAccount, name: userName, role: RoleTypes.User }
+      : userIdOrAccount
+    return this
+  }
+
+  /** Sets `reference.agent` from an id + optional name. Role defaults to `RoleTypes.Agent`. On Teams, id is prefixed with `28:`. */
+  withAgent (agentClientId: string, agentName?: string): this
+  /** Sets `reference.agent` from a full `ChannelAccount`. */
+  withAgent (account: ChannelAccount): this
+  withAgent (agentIdOrAccount: string | ChannelAccount, agentName?: string): this {
+    this._agent = typeof agentIdOrAccount === 'string'
+      ? ConversationReferenceBuilder.agentForChannel(this._channelId, agentIdOrAccount, agentName)
+      : agentIdOrAccount
+    return this
+  }
+
+  /** Sets `reference.serviceUrl`. */
+  withServiceUrl (serviceUrl: string): this {
+    this._serviceUrl = serviceUrl
+    return this
+  }
+
+  /** Sets `reference.conversation.id`. */
+  withConversationId (id: string): this {
+    this._conversationId = id
+    return this
+  }
+
+  /** Sets `reference.activityId`. */
+  withActivityId (activityId: string): this {
+    this._activityId = activityId
+    return this
+  }
+
+  /** Sets `reference.locale`. */
+  withLocale (locale: string): this {
+    this._locale = locale
+    return this
+  }
+
+  /** Builds and returns the `ConversationReference`. */
+  build (): ConversationReference {
+    const serviceUrl =
+      this._serviceUrl || ConversationReferenceBuilder.serviceUrlForChannel(this._channelId)
+
+    const ref: ConversationReference = {
+      channelId: this._channelId,
+      serviceUrl,
+      conversation: { id: this._conversationId ?? '', isGroup: false },
+      agent: this._agent,
+      user: this._user ?? { role: RoleTypes.User },
+    }
+
+    if (this._activityId !== undefined) ref.activityId = this._activityId
+    if (this._locale !== undefined) ref.locale = this._locale
+
+    return ref
+  }
+
+  /**
+   * Builds a `ChannelAccount` for the agent, applying the Teams `28:` id prefix
+   * when the channel is `msteams`.
+   */
+  private static agentForChannel (channelId: string, agentClientId: string, agentName?: string): ChannelAccount {
+    return {
+      id: channelId === Channels.Msteams ? `28:${agentClientId}` : agentClientId,
+      name: agentName,
+      role: RoleTypes.Agent,
+    }
+  }
+}

package/src/app/proactive/createConversationOptions.ts

@@ -0,0 +1,35 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+import type { ConversationParameters } from '@microsoft/agents-activity'
+import type { ConversationClaims } from './conversation'
+
+/**
+ * Default OAuth scope for Azure Bot Service authentication.
+ */
+export const AzureBotScope = 'https://api.botframework.com'
+
+/**
+ * Options passed to `Proactive.createConversation()`.
+ * Flattened — no nested Conversation wrapper.
+ */
+export interface CreateConversationOptions {
+  /** JWT claims for the agent identity. `aud` must be the agent's client ID. */
+  identity: ConversationClaims
+  /** The target channel (e.g. `'msteams'`). */
+  channelId: string
+  /** The service URL for the channel. */
+  serviceUrl: string
+  /**
+   * OAuth scope for token acquisition.
+   * Defaults to `AzureBotScope` when not set by the builder.
+   */
+  scope: string
+  /**
+   * When `true`, the resulting `Conversation` is stored automatically after
+   * creation. Defaults to `false`.
+   */
+  storeConversation?: boolean
+  /** Conversation configuration passed to `adapter.createConversationAsync()`. */
+  parameters: Partial<ConversationParameters>
+}