@microsoft/agents-hosting-dialogs 1.5.0-beta.6.ga236d9a19c → 1.5.1

package/dist/src/observability/traces.js

@@ -0,0 +1,174 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DialogsTraceDefinitions = void 0;
+const agents_telemetry_1 = require("@microsoft/agents-telemetry");
+const metrics_1 = require("./metrics");
+const agents_activity_1 = require("@microsoft/agents-activity");
+const unknownValue = (value) => value || 'unknown';
+const defaultActivity = agents_activity_1.Activity.fromObject({ type: 'unknown' });
+exports.DialogsTraceDefinitions = {
+    run: agents_telemetry_1.trace.define({
+        name: agents_telemetry_1.SpanNames.DIALOGS_RUN,
+        record: {
+            dialogId: '',
+            activity: defaultActivity,
+            status: 'unknown',
+            attemptCount: 0,
+        },
+        end({ span, record }) {
+            var _a, _b, _c, _d, _e;
+            span.setAttributes({
+                'dialog.root_id': unknownValue(record.dialogId),
+                'activity.type': unknownValue((_a = record.activity) === null || _a === void 0 ? void 0 : _a.type),
+                'activity.channel_id': unknownValue((_b = record.activity) === null || _b === void 0 ? void 0 : _b.channelId),
+                'activity.conversation_id': unknownValue((_d = (_c = record.activity) === null || _c === void 0 ? void 0 : _c.conversation) === null || _d === void 0 ? void 0 : _d.id),
+                'dialog.status': unknownValue(record.status),
+                'dialog.attempt_count': (_e = record.attemptCount) !== null && _e !== void 0 ? _e : 0,
+            });
+        }
+    }),
+    contextBegin: agents_telemetry_1.trace.define({
+        name: agents_telemetry_1.SpanNames.DIALOGS_CONTEXT_BEGIN,
+        record: {
+            dialogId: '',
+            name: 'unknown',
+            parentId: '',
+            status: 'unknown',
+            activity: defaultActivity,
+        },
+        end({ span, record, duration }) {
+            var _a, _b, _c;
+            const spanAttributes = {
+                'activity.type': unknownValue((_a = record.activity) === null || _a === void 0 ? void 0 : _a.type),
+                'activity.conversation_id': unknownValue((_c = (_b = record.activity) === null || _b === void 0 ? void 0 : _b.conversation) === null || _c === void 0 ? void 0 : _c.id),
+                'dialog.id': unknownValue(record.dialogId),
+                'dialog.name': unknownValue(record.name),
+                'dialog.parent_id': unknownValue(record.parentId),
+                'dialog.status': unknownValue(record.status),
+            };
+            span.setAttributes(spanAttributes);
+            const metricAttributes = {
+                operation: 'begin',
+                'result.status': unknownValue(record.status),
+            };
+            metrics_1.DialogsMetrics.contextCount.add(1, metricAttributes);
+            metrics_1.DialogsMetrics.contextDuration.record(duration, metricAttributes);
+        }
+    }),
+    contextContinue: agents_telemetry_1.trace.define({
+        name: agents_telemetry_1.SpanNames.DIALOGS_CONTEXT_CONTINUE,
+        record: {
+            dialogId: '',
+            name: 'unknown',
+            status: 'unknown',
+            activity: defaultActivity,
+        },
+        end({ span, record, duration }) {
+            var _a, _b, _c;
+            const spanAttributes = {
+                'activity.type': unknownValue((_a = record.activity) === null || _a === void 0 ? void 0 : _a.type),
+                'activity.conversation_id': unknownValue((_c = (_b = record.activity) === null || _b === void 0 ? void 0 : _b.conversation) === null || _c === void 0 ? void 0 : _c.id),
+                'dialog.id': unknownValue(record.dialogId),
+                'dialog.name': unknownValue(record.name),
+                'dialog.status': unknownValue(record.status),
+            };
+            span.setAttributes(spanAttributes);
+            const metricAttributes = {
+                operation: 'continue',
+                'result.status': unknownValue(record.status),
+            };
+            metrics_1.DialogsMetrics.contextCount.add(1, metricAttributes);
+            metrics_1.DialogsMetrics.contextDuration.record(duration, metricAttributes);
+        }
+    }),
+    contextEnd: agents_telemetry_1.trace.define({
+        name: agents_telemetry_1.SpanNames.DIALOGS_CONTEXT_END,
+        record: {
+            activity: defaultActivity,
+            dialogId: '',
+            name: 'unknown',
+            status: 'unknown',
+        },
+        end({ span, record, duration }) {
+            var _a, _b, _c;
+            const spanAttributes = {
+                'activity.type': unknownValue((_a = record.activity) === null || _a === void 0 ? void 0 : _a.type),
+                'activity.conversation_id': unknownValue((_c = (_b = record.activity) === null || _b === void 0 ? void 0 : _b.conversation) === null || _c === void 0 ? void 0 : _c.id),
+                'dialog.id': unknownValue(record.dialogId),
+                'dialog.name': unknownValue(record.name),
+                'dialog.status': unknownValue(record.status),
+            };
+            span.setAttributes(spanAttributes);
+            const metricAttributes = {
+                operation: 'end',
+                'result.status': unknownValue(record.status),
+            };
+            metrics_1.DialogsMetrics.contextCount.add(1, metricAttributes);
+            metrics_1.DialogsMetrics.contextDuration.record(duration, metricAttributes);
+        }
+    }),
+    contextReplace: agents_telemetry_1.trace.define({
+        name: agents_telemetry_1.SpanNames.DIALOGS_CONTEXT_REPLACE,
+        record: {
+            activity: defaultActivity,
+            dialogId: '',
+            name: 'unknown',
+            replacementDialogId: '',
+            replacementName: 'unknown',
+            status: 'unknown',
+        },
+        end({ span, record, duration }) {
+            var _a, _b, _c;
+            const spanAttributes = {
+                'activity.type': unknownValue((_a = record.activity) === null || _a === void 0 ? void 0 : _a.type),
+                'activity.conversation_id': unknownValue((_c = (_b = record.activity) === null || _b === void 0 ? void 0 : _b.conversation) === null || _c === void 0 ? void 0 : _c.id),
+                'dialog.id': unknownValue(record.dialogId),
+                'dialog.name': unknownValue(record.name),
+                'dialog.replacement_id': unknownValue(record.replacementDialogId),
+                'dialog.replacement_name': unknownValue(record.replacementName),
+                'dialog.status': unknownValue(record.status),
+            };
+            span.setAttributes(spanAttributes);
+            const metricAttributes = {
+                operation: 'replace',
+                'result.status': unknownValue(record.status),
+            };
+            metrics_1.DialogsMetrics.contextCount.add(1, metricAttributes);
+            metrics_1.DialogsMetrics.contextDuration.record(duration, metricAttributes);
+        }
+    }),
+    contextCancelAll: agents_telemetry_1.trace.define({
+        name: agents_telemetry_1.SpanNames.DIALOGS_CONTEXT_CANCEL_ALL,
+        record: {
+            activity: defaultActivity,
+            cancelParents: false,
+            dialogId: '',
+            eventName: '',
+            name: 'unknown',
+            status: 'unknown',
+        },
+        end({ span, record, duration }) {
+            var _a, _b, _c;
+            const spanAttributes = {
+                'activity.type': unknownValue((_a = record.activity) === null || _a === void 0 ? void 0 : _a.type),
+                'activity.conversation_id': unknownValue((_c = (_b = record.activity) === null || _b === void 0 ? void 0 : _b.conversation) === null || _c === void 0 ? void 0 : _c.id),
+                'dialog.cancel_parents': record.cancelParents,
+                'dialog.event_name': unknownValue(record.eventName),
+                'dialog.id': unknownValue(record.dialogId),
+                'dialog.name': unknownValue(record.name),
+                'dialog.status': unknownValue(record.status),
+            };
+            span.setAttributes(spanAttributes);
+            const metricAttributes = {
+                operation: 'cancel_all',
+                'result.status': unknownValue(record.status),
+                'dialog.cancel_parents': record.cancelParents,
+            };
+            metrics_1.DialogsMetrics.contextCount.add(1, metricAttributes);
+            metrics_1.DialogsMetrics.contextDuration.record(duration, metricAttributes);
+        }
+    }),
+};
+//# sourceMappingURL=traces.js.map

package/dist/src/observability/traces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traces.js","sourceRoot":"","sources":["../../../src/observability/traces.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-dialogs",
-  "version": "1.5.0-beta.6.ga236d9a19c",
+  "version": "1.5.1",
   "homepage": "https://github.com/microsoft/Agents-for-js",
   "repository": {
     "type": "git",
@@ -16,16 +16,17 @@
   "main": "dist/index.js",
   "types": "dist/src/index.d.ts",
   "dependencies": {
-    "@microsoft/agents-hosting": "1.5.0-beta.6.ga236d9a19c",
-    "@microsoft/agents-activity": "1.5.0-beta.6.ga236d9a19c",
-    "@types/lodash": "^4.17.24",
-    "dependency-graph": "^1.0.0",
-    "@microsoft/recognizers-text-suite": "^1.3.1",
-    "@microsoft/recognizers-text-number": "^1.3.1",
-    "@microsoft/recognizers-text-date-time": "^1.3.2",
-    "@microsoft/recognizers-text-choice": "^1.3.1",
-    "globalize": "^1.7.1",
-    "zod": "^3.25.75"
+    "@microsoft/agents-hosting": "1.5.1",
+    "@microsoft/agents-activity": "1.5.1",
+    "@types/lodash": "4.17.24",
+    "dependency-graph": "1.0.0",
+    "@microsoft/recognizers-text-suite": "1.3.1",
+    "@microsoft/recognizers-text-number": "1.3.1",
+    "@microsoft/recognizers-text-date-time": "1.3.2",
+    "@microsoft/recognizers-text-choice": "1.3.1",
+    "globalize": "1.7.1",
+    "zod": "3.25.75",
+    "@microsoft/agents-telemetry": "1.5.1"
   },
   "license": "MIT",
   "files": [

package/src/choices/recognizeChoices.ts

@@ -5,7 +5,7 @@
 import { findChoices, FindChoicesOptions, FoundChoice } from './findChoices'
 import { ModelResult } from './modelResult'
 import { Choice } from './choice'
-import { debug } from '@microsoft/agents-activity/logger'
+import { debug } from '@microsoft/agents-telemetry'
 import * as Recognizers from '@microsoft/recognizers-text-number'
 
 const logger = debug('dialogs:recognizeChoices')

package/src/dialogContext.ts

@@ -19,6 +19,7 @@ import { DialogTurnResult } from './dialogTurnResult'
 import { DialogTurnStatus } from './dialogTurnStatus'
 import { Choice } from './choices'
 import { Activity } from '@microsoft/agents-activity'
+import { DialogsTraceDefinitions, trace } from './observability'
 
 /**
  * Wraps a promise in a try-catch that automatically enriches errors with extra dialog context.
@@ -248,24 +249,36 @@ export class DialogContext {
      *
      */
   async beginDialog (dialogId: string, options?: object): Promise<DialogTurnResult> {
-    // Lookup dialog
-    const dialog: Dialog<{}> = this.findDialog(dialogId)
-    if (!dialog) {
-      throw new DialogContextError(
-                `DialogContext.beginDialog(): A dialog with an id of '${dialogId}' wasn't found.`,
-                this
-      )
-    }
+    return trace(DialogsTraceDefinitions.contextBegin, async ({ record }) => {
+      record({
+        dialogId,
+        parentId: this.activeDialog?.id,
+        activity: this.context.activity,
+      })
 
-    // Push new instance onto stack.
-    const instance: DialogInstance<any> = {
-      id: dialogId,
-      state: {},
-    }
-    this.stack.push(instance)
+      // Lookup dialog
+      const dialog: Dialog<{}> = this.findDialog(dialogId)
+      if (!dialog) {
+        throw new DialogContextError(
+                    `DialogContext.beginDialog(): A dialog with an id of '${dialogId}' wasn't found.`,
+                    this
+        )
+      }
 
-    // Call dialogs begin() method.
-    return wrapErrors(this, dialog.beginDialog(this, options))
+      record({ name: dialog.constructor.name })
+
+      // Push new instance onto stack.
+      const instance: DialogInstance<any> = {
+        id: dialogId,
+        state: {},
+      }
+      this.stack.push(instance)
+
+      // Call dialogs begin() method.
+      const result = await wrapErrors(this, dialog.beginDialog(this, options))
+      record({ status: result?.status })
+      return result
+    })
   }
 
   /**
@@ -286,36 +299,52 @@ export class DialogContext {
      *
      */
   async cancelAllDialogs (cancelParents = false, eventName?: string, eventValue?: any): Promise<DialogTurnResult> {
-    eventName = eventName || DialogEvents.cancelDialog
-    if (this.stack.length > 0 || this.parent !== undefined) {
-      // Cancel all local and parent dialogs while checking for interception
-      let notify = false
-
-      let dialogContext: DialogContext = this
-      while (dialogContext !== undefined) {
-        if (dialogContext.stack.length > 0) {
-          // Check to see if the dialog wants to handle the event
-          // - We skip notifying the first dialog which actually called cancelAllDialogs()
-          if (notify) {
-            const handled = await dialogContext.emitEvent(eventName, eventValue, false, false)
-            if (handled) {
-              break
+    return trace(DialogsTraceDefinitions.contextCancelAll, async ({ record }) => {
+      eventName = eventName || DialogEvents.cancelDialog
+      const activeDialogDefinition = this.activeDialog ? this.findDialog(this.activeDialog.id) : undefined
+
+      record({
+        activity: this.context.activity,
+        cancelParents,
+        dialogId: this.activeDialog?.id,
+        eventName,
+        name: activeDialogDefinition?.constructor.name,
+      })
+
+      let result: DialogTurnResult
+      if (this.stack.length > 0 || this.parent !== undefined) {
+        // Cancel all local and parent dialogs while checking for interception
+        let notify = false
+
+        let dialogContext: DialogContext = this
+        while (dialogContext !== undefined) {
+          if (dialogContext.stack.length > 0) {
+            // Check to see if the dialog wants to handle the event
+            // - We skip notifying the first dialog which actually called cancelAllDialogs()
+            if (notify) {
+              const handled = await dialogContext.emitEvent(eventName, eventValue, false, false)
+              if (handled) {
+                break
+              }
             }
+
+            // End the active dialog
+            await dialogContext.endActiveDialog(DialogReason.cancelCalled)
+          } else {
+            dialogContext = cancelParents ? dialogContext.parent : undefined
           }
 
-          // End the active dialog
-          await dialogContext.endActiveDialog(DialogReason.cancelCalled)
-        } else {
-          dialogContext = cancelParents ? dialogContext.parent : undefined
+          notify = true
         }
 
-        notify = true
+        result = { status: DialogTurnStatus.cancelled }
+      } else {
+        result = { status: DialogTurnStatus.empty }
       }
 
-      return { status: DialogTurnStatus.cancelled }
-    } else {
-      return { status: DialogTurnStatus.empty }
-    }
+      record({ status: result.status })
+      return result
+    })
   }
 
   /**
@@ -430,33 +459,46 @@ export class DialogContext {
      *
      */
   async continueDialog (): Promise<DialogTurnResult> {
-    // if we are continuing and haven't emitted the activityReceived event, emit it
-    // NOTE: This is backward compatible way for activity received to be fired even if you have legacy dialog loop
-    if (!this.context.turnState.has(ACTIVITY_RECEIVED_EMITTED)) {
-      this.context.turnState.set(ACTIVITY_RECEIVED_EMITTED, true)
-
-      // Dispatch "activityReceived" event
-      // - This fired from teh leaf and will queue up any interruptions.
-      await this.emitEvent(DialogEvents.activityReceived, this.context.activity, true, true)
-    }
+    return trace(DialogsTraceDefinitions.contextContinue, async ({ record }) => {
+      record({
+        dialogId: this.activeDialog?.id,
+        activity: this.context.activity,
+      })
+
+      // if we are continuing and haven't emitted the activityReceived event, emit it
+      // NOTE: This is backward compatible way for activity received to be fired even if you have legacy dialog loop
+      if (!this.context.turnState.has(ACTIVITY_RECEIVED_EMITTED)) {
+        this.context.turnState.set(ACTIVITY_RECEIVED_EMITTED, true)
+
+        // Dispatch "activityReceived" event
+        // - This fired from the leaf and will queue up any interruptions.
+        await this.emitEvent(DialogEvents.activityReceived, this.context.activity, true, true)
+      }
 
-    // Check for a dialog on the stack
-    const instance: DialogInstance<any> = this.activeDialog
-    if (instance) {
-      // Lookup dialog
-      const dialog: Dialog<{}> = this.findDialog(instance.id)
-      if (!dialog) {
-        throw new DialogContextError(
-                    `DialogContext.continueDialog(): Can't continue dialog. A dialog with an id of '${instance.id}' wasn't found.`,
-                    this
-        )
+      // Check for a dialog on the stack
+      const instance: DialogInstance<any> = this.activeDialog
+      let result: DialogTurnResult
+      if (instance) {
+        // Lookup dialog
+        const dialog: Dialog<{}> = this.findDialog(instance.id)
+        if (!dialog) {
+          throw new DialogContextError(
+                        `DialogContext.continueDialog(): Can't continue dialog. A dialog with an id of '${instance.id}' wasn't found.`,
+                        this
+          )
+        }
+
+        record({ name: dialog.constructor.name })
+
+        // Continue execution of dialog
+        result = await wrapErrors(this, dialog.continueDialog(this))
+      } else {
+        result = { status: DialogTurnStatus.empty }
       }
 
-      // Continue execution of dialog
-      return wrapErrors(this, dialog.continueDialog(this))
-    } else {
-      return { status: DialogTurnStatus.empty }
-    }
+      record({ status: result.status })
+      return result
+    })
   }
 
   /**
@@ -483,27 +525,41 @@ export class DialogContext {
      *
      */
   async endDialog (result?: any): Promise<DialogTurnResult> {
-    // End the active dialog
-    await this.endActiveDialog(DialogReason.endCalled, result)
+    return trace(DialogsTraceDefinitions.contextEnd, async ({ record }) => {
+      const activeDialogDefinition = this.activeDialog ? this.findDialog(this.activeDialog.id) : undefined
 
-    // Resume parent dialog
-    const instance: DialogInstance<any> = this.activeDialog
-    if (instance) {
-      // Lookup dialog
-      const dialog: Dialog<{}> = this.findDialog(instance.id)
-      if (!dialog) {
-        throw new DialogContextError(
-                    `DialogContext.endDialog(): Can't resume previous dialog. A dialog with an id of '${instance.id}' wasn't found.`,
-                    this
-        )
+      record({
+        activity: this.context.activity,
+        dialogId: this.activeDialog?.id,
+        name: activeDialogDefinition?.constructor.name,
+      })
+
+      // End the active dialog
+      await this.endActiveDialog(DialogReason.endCalled, result)
+
+      // Resume parent dialog
+      const instance: DialogInstance<any> = this.activeDialog
+      let turnResult: DialogTurnResult
+      if (instance) {
+        // Lookup dialog
+        const dialog: Dialog<{}> = this.findDialog(instance.id)
+        if (!dialog) {
+          throw new DialogContextError(
+                        `DialogContext.endDialog(): Can't resume previous dialog. A dialog with an id of '${instance.id}' wasn't found.`,
+                        this
+          )
+        }
+
+        // Return result to previous dialog
+        turnResult = await wrapErrors(this, dialog.resumeDialog(this, DialogReason.endCalled, result))
+      } else {
+        // Signal completion
+        turnResult = { status: DialogTurnStatus.complete, result }
       }
 
-      // Return result to previous dialog
-      return wrapErrors(this, dialog.resumeDialog(this, DialogReason.endCalled, result))
-    } else {
-      // Signal completion
-      return { status: DialogTurnStatus.complete, result }
-    }
+      record({ status: turnResult.status })
+      return turnResult
+    })
   }
 
   /**
@@ -524,11 +580,26 @@ export class DialogContext {
      *
      */
   async replaceDialog (dialogId: string, options?: object): Promise<DialogTurnResult> {
-    // End the active dialog
-    await this.endActiveDialog(DialogReason.replaceCalled)
-
-    // Start replacement dialog
-    return this.beginDialog(dialogId, options)
+    return trace(DialogsTraceDefinitions.contextReplace, async ({ record }) => {
+      const activeDialogDefinition = this.activeDialog ? this.findDialog(this.activeDialog.id) : undefined
+      const replacementDialog = this.findDialog(dialogId)
+
+      record({
+        activity: this.context.activity,
+        dialogId: this.activeDialog?.id,
+        name: activeDialogDefinition?.constructor.name,
+        replacementDialogId: dialogId,
+        replacementName: replacementDialog?.constructor.name,
+      })
+
+      // End the active dialog
+      await this.endActiveDialog(DialogReason.replaceCalled)
+
+      // Start replacement dialog
+      const result = await this.beginDialog(dialogId, options)
+      record({ status: result?.status })
+      return result
+    })
   }
 
   /**

package/src/dialogHelper.ts

@@ -16,6 +16,7 @@ import { DialogSet } from './dialogSet'
 import { DialogStateManager, DialogStateManagerConfiguration } from './memory'
 import { DialogTurnResult } from './dialogTurnResult'
 import { DialogTurnStatus } from './dialogTurnStatus'
+import { DialogsTraceDefinitions, trace } from './observability'
 
 /**
  * Runs a dialog from a given context and accessor.
@@ -78,45 +79,53 @@ export async function internalRun (
   dialogContext: DialogContext,
   dialogStateManagerConfiguration?: DialogStateManagerConfiguration
 ): Promise<DialogTurnResult> {
-  // map TurnState into root dialog context.services
-  context.turnState.forEach((service, key) => {
-    dialogContext.services.push(key, service)
-  })
-
-  const dialogStateManager = new DialogStateManager(dialogContext, dialogStateManagerConfiguration)
-
-  await dialogStateManager.loadAllScopes()
-  dialogContext.context.turnState.push('DialogStateManager', dialogStateManager)
-  let dialogTurnResult: DialogTurnResult = null
-
-  // Loop as long as we are getting valid OnError handled we should continue executing the actions for the turn.
-  // NOTE: We loop around this block because each pass through we either complete the turn and break out of the loop
-  // or we have had an exception AND there was an OnError action which captured the error. We need to continue the
-  // turn based on the actions the OnError handler introduced.
-  let endOfTurn = false
-  while (!endOfTurn) {
-    try {
-      dialogTurnResult = await innerRun(context, dialogId, dialogContext)
-
-      // turn successfully completed, break the loop
-      endOfTurn = true
-    } catch (err) {
-      // fire error event, bubbling from the leaf.
-      const handled = await dialogContext.emitEvent(DialogEvents.error, err, true, true)
-
-      if (!handled) {
-        // error was NOT handled, throw the exception and end the turn.
-        // (This will trigger the Adapter.OnError handler and end the entire dialog stack)
-        throw err
+  return trace(DialogsTraceDefinitions.run, async ({ record }) => {
+    record({ activity: context.activity, dialogId })
+
+    // map TurnState into root dialog context.services
+    context.turnState.forEach((service, key) => {
+      dialogContext.services.push(key, service)
+    })
+
+    const dialogStateManager = new DialogStateManager(dialogContext, dialogStateManagerConfiguration)
+
+    await dialogStateManager.loadAllScopes()
+    dialogContext.context.turnState.push('DialogStateManager', dialogStateManager)
+    let dialogTurnResult: DialogTurnResult = null
+    let attemptCount = 0
+
+    // Loop as long as we are getting valid OnError handled we should continue executing the actions for the turn.
+    // NOTE: We loop around this block because each pass through we either complete the turn and break out of the loop
+    // or we have had an exception AND there was an OnError action which captured the error. We need to continue the
+    // turn based on the actions the OnError handler introduced.
+    let endOfTurn = false
+    while (!endOfTurn) {
+      attemptCount += 1
+      record({ attemptCount })
+      try {
+        dialogTurnResult = await innerRun(context, dialogId, dialogContext)
+        record({ status: dialogTurnResult?.status })
+
+        // turn successfully completed, break the loop
+        endOfTurn = true
+      } catch (err) {
+        // fire error event, bubbling from the leaf.
+        const handled = await dialogContext.emitEvent(DialogEvents.error, err, true, true)
+
+        if (!handled) {
+          // error was NOT handled, throw the exception and end the turn.
+          // (This will trigger the Adapter.OnError handler and end the entire dialog stack)
+          throw err
+        }
       }
     }
-  }
 
-  // save all state scopes to their respective agentState locations.
-  await dialogStateManager.saveAllChanges()
+    // save all state scopes to their respective agentState locations.
+    await dialogStateManager.saveAllChanges()
 
-  // return the redundant result because the DialogManager contract expects it
-  return dialogTurnResult
+    // return the redundant result because the DialogManager contract expects it
+    return dialogTurnResult
+  })
 }
 
 /**

package/src/observability/index.ts

@@ -0,0 +1,6 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+export * from './metrics'
+export * from './traces'
+export { trace } from '@microsoft/agents-telemetry'