@microsoft/agents-hosting-dialogs 0.2.10-g3ac88ff25e → 0.3.5

package/dist/src/prompts/promptCultureModels.js

@@ -7,18 +7,21 @@ const recognizers_text_suite_1 = require("@microsoft/recognizers-text-suite");
  */
 class PromptCultureModels {
     /**
+       * Retrieves a list of supported culture codes.
+       *
+       * @returns An array of supported locale strings.
        * @private
        */
     static getSupportedCultureCodes() {
         return this.getSupportedCultures().map((c) => c.locale);
     }
     /**
-       * Use Recognizers-Text to normalize various potential Locale strings to a standard.
+       * Normalizes a given locale string to the nearest supported language.
        *
+       * @param cultureCode The locale string to normalize (e.g., "en-US").
+       * @returns The normalized locale string.
        * @remarks This is mostly a copy/paste from https://github.com/microsoft/Recognizers-Text/blob/master/JavaScript/packages/recognizers-text/src/culture.ts#L39
        *          This doesn't directly use Recognizers-Text's MapToNearestLanguage because if they add language support before we do, it will break our prompts.
-       * @param cultureCode Represents locale. Examples: "en-US, en-us, EN".
-       * @returns Normalized locale.
        */
     static mapToNearestLanguage(cultureCode) {
         if (cultureCode) {
@@ -37,6 +40,9 @@ class PromptCultureModels {
     }
 }
 exports.PromptCultureModels = PromptCultureModels;
+/**
+ * Represents the Chinese culture model with locale and language-specific settings.
+ */
 PromptCultureModels.Chinese = {
     locale: recognizers_text_suite_1.Culture.Chinese,
     separator: ', ',
@@ -45,6 +51,9 @@ PromptCultureModels.Chinese = {
     yesInLanguage: '是的',
     noInLanguage: '不',
 };
+/**
+ * Represents the Dutch culture model with locale and language-specific settings.
+ */
 PromptCultureModels.Dutch = {
     locale: recognizers_text_suite_1.Culture.Dutch,
     separator: ', ',
@@ -53,6 +62,9 @@ PromptCultureModels.Dutch = {
     yesInLanguage: 'Ja',
     noInLanguage: 'Nee',
 };
+/**
+ * Represents the English culture model with locale and language-specific settings.
+ */
 PromptCultureModels.English = {
     locale: recognizers_text_suite_1.Culture.English,
     separator: ', ',
@@ -61,6 +73,9 @@ PromptCultureModels.English = {
     yesInLanguage: 'Yes',
     noInLanguage: 'No',
 };
+/**
+ * Represents the French culture model with locale and language-specific settings.
+ */
 PromptCultureModels.French = {
     locale: recognizers_text_suite_1.Culture.French,
     separator: ', ',
@@ -69,6 +84,9 @@ PromptCultureModels.French = {
     yesInLanguage: 'Oui',
     noInLanguage: 'Non',
 };
+/**
+ * Represents the German culture model with locale and language-specific settings.
+ */
 PromptCultureModels.German = {
     locale: recognizers_text_suite_1.Culture.German,
     separator: ', ',
@@ -77,6 +95,9 @@ PromptCultureModels.German = {
     yesInLanguage: 'Ja',
     noInLanguage: 'Nein',
 };
+/**
+ * Represents the Italian culture model with locale and language-specific settings.
+ */
 PromptCultureModels.Italian = {
     locale: recognizers_text_suite_1.Culture.Italian,
     separator: ', ',
@@ -85,6 +106,9 @@ PromptCultureModels.Italian = {
     yesInLanguage: 'Si',
     noInLanguage: 'No',
 };
+/**
+ * Represents the Japanese culture model with locale and language-specific settings.
+ */
 PromptCultureModels.Japanese = {
     locale: recognizers_text_suite_1.Culture.Japanese,
     separator: '、 ',
@@ -93,6 +117,9 @@ PromptCultureModels.Japanese = {
     yesInLanguage: 'はい',
     noInLanguage: 'いいえ',
 };
+/**
+ * Represents the Portuguese culture model with locale and language-specific settings.
+ */
 PromptCultureModels.Portuguese = {
     locale: recognizers_text_suite_1.Culture.Portuguese,
     separator: ', ',
@@ -101,6 +128,9 @@ PromptCultureModels.Portuguese = {
     yesInLanguage: 'Sim',
     noInLanguage: 'Não',
 };
+/**
+ * Represents the Spanish culture model with locale and language-specific settings.
+ */
 PromptCultureModels.Spanish = {
     locale: recognizers_text_suite_1.Culture.Spanish,
     separator: ', ',
@@ -109,6 +139,11 @@ PromptCultureModels.Spanish = {
     yesInLanguage: 'Sí',
     noInLanguage: 'No',
 };
+/**
+   * Retrieves a list of supported culture models.
+   *
+   * @returns An array of `PromptCultureModel` objects representing supported cultures.
+   */
 PromptCultureModels.getSupportedCultures = () => [
     PromptCultureModels.Chinese,
     PromptCultureModels.Dutch,

package/dist/src/prompts/promptCultureModels.js.map

@@ -1 +1 @@
-{"version":3,"file":"promptCultureModels.js","sourceRoot":"","sources":["../../../src/prompts/promptCultureModels.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"promptCultureModels.js","sourceRoot":"","sources":["../../../src/prompts/promptCultureModels.ts"],"names":[],"mappings":"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"}

package/dist/src/recognizer.d.ts

@@ -10,9 +10,16 @@ export interface RecognizerConfiguration {
     id?: string;
 }
 /**
- * Recognizer base class.
+ * Base class for implementing custom recognizers to identify intents and entities from user input.
+ *
+ * Recognizers process user input, such as text or speech, and return structured data representing
+ * the recognized intents, entities, and other relevant information. This class provides a foundation
+ * for creating custom recognizers by defining common methods and properties.
  */
 export declare class Recognizer extends Configurable implements RecognizerConfiguration {
+    /**
+     * Optional. The unique identifier for the recognizer.
+     */
     id?: string;
     /**
        * To recognize intents and entities in a users utterance.

package/dist/src/recognizer.js

@@ -8,7 +8,11 @@ const configurable_1 = require("./configurable");
 const omit_1 = __importDefault(require("lodash/omit"));
 const recognizerResult_1 = require("./recognizerResult");
 /**
- * Recognizer base class.
+ * Base class for implementing custom recognizers to identify intents and entities from user input.
+ *
+ * Recognizers process user input, such as text or speech, and return structured data representing
+ * the recognized intents, entities, and other relevant information. This class provides a foundation
+ * for creating custom recognizers by defining common methods and properties.
  */
 class Recognizer extends configurable_1.Configurable {
     /**

package/dist/src/recognizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"recognizer.js","sourceRoot":"","sources":["../../src/recognizer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"recognizer.js","sourceRoot":"","sources":["../../src/recognizer.ts"],"names":[],"mappings":"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"}

package/dist/src/recognizerResult.d.ts

@@ -7,10 +7,25 @@ import { IntentScore } from './intentScore';
  * Value returned from a recognizer.
  */
 export interface RecognizerResult {
+    /**
+     * The original text input provided by the user.
+     */
     text: string;
+    /**
+     * Optional. The modified version of the text input, if applicable.
+     */
     alteredText?: string;
+    /**
+     * A mapping of intent names to their corresponding confidence scores.
+     */
     intents: Record<string, IntentScore>;
+    /**
+     * Optional. Entities recognized in the input, if any.
+     */
     entities?: any;
+    /**
+     * Additional properties that may be included in the recognizer result.
+     */
     [propName: string]: any;
 }
 export declare const getTopScoringIntent: (result: RecognizerResult) => {

package/dist/src/recognizerResult.js.map

@@ -1 +1 @@
-{"version":3,"file":"recognizerResult.js","sourceRoot":"","sources":["../../src/recognizerResult.ts"],"names":[],"mappings":";;;AAiBO,MAAM,mBAAmB,GAAG,CAAC,MAAwB,EAAqC,EAAE;;IACjG,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;IACpC,CAAC;IAED,IAAI,SAAS,GAAG,EAAE,CAAA;IAClB,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAA;IACjB,KAAK,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAClE,MAAM,KAAK,GAAG,MAAA,MAAM,CAAC,KAAK,mCAAI,CAAC,CAAC,CAAA;QAChC,IAAI,CAAC,SAAS,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;YACnC,SAAS,GAAG,UAAU,CAAA;YACtB,QAAQ,GAAG,KAAK,CAAA;QAClB,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,QAAQ;KAChB,CAAA;AACH,CAAC,CAAA;AAnBY,QAAA,mBAAmB,uBAmB/B"}
+{"version":3,"file":"recognizerResult.js","sourceRoot":"","sources":["../../src/recognizerResult.ts"],"names":[],"mappings":";;;AAoCO,MAAM,mBAAmB,GAAG,CAAC,MAAwB,EAAqC,EAAE;;IACjG,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;IACpC,CAAC;IAED,IAAI,SAAS,GAAG,EAAE,CAAA;IAClB,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAA;IACjB,KAAK,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAClE,MAAM,KAAK,GAAG,MAAA,MAAM,CAAC,KAAK,mCAAI,CAAC,CAAC,CAAA;QAChC,IAAI,CAAC,SAAS,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;YACnC,SAAS,GAAG,UAAU,CAAA;YACtB,QAAQ,GAAG,KAAK,CAAA;QAClB,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,QAAQ;KAChB,CAAA;AACH,CAAC,CAAA;AAnBY,QAAA,mBAAmB,uBAmB/B"}

package/dist/src/serviceCollection.d.ts

@@ -39,33 +39,32 @@ export declare class ServiceCollection {
     /**
        * Register an instance by key. This will overwrite existing instances.
        *
-       * @param key key of the instance being provided
-       * @param instance instance to provide
-       * @returns this for chaining
+       * @param key Key of the instance being provided.
+       * @param instance Instance to provide.
+       * @returns `this` for chaining.
        */
     addInstance<InstanceType>(key: string, instance: InstanceType): this;
     /**
        * Register a factory for a key.
        *
-       * @param key key that factory will provide
-       * @param factory function that creates an instance to provide
-       * @returns this for chaining
+       * @param key Key that factory will provide.
+       * @param factory Function that creates an instance to provide.
+       * @returns `this` for chaining.
        */
     addFactory<InstanceType>(key: string, factory: Factory<InstanceType, false>): this;
     /**
        * Register a factory for a key with a set of dependencies.
        *
-       * @param key key that factory will provide
-       * @param dependencies set of things this instance depends on. Will be provided to factory function via `services`.
-       * @param factory function that creates an instance to provide
-       * @returns this for chaining
+       * @param key Key that factory will provide.
+       * @param dependencies Set of things this instance depends on. Will be provided to factory function via `services`.
+       * @param factory Function that creates an instance to provide.
+       * @returns `this` for chaining.
        */
     addFactory<InstanceType, Dependencies>(key: string, dependencies: string[], factory: DependencyFactory<InstanceType, Dependencies, false>): this;
     /**
        * Register a factory (that expects the initial value that is not undefined) for a key.
        *
        * @param key key of the instance being provided
-       * @param instance instance to provide
        * @returns this for chaining
        */
     composeFactory<InstanceType>(key: string, factory: Factory<InstanceType, true>): this;
@@ -73,27 +72,27 @@ export declare class ServiceCollection {
        * Register a factory (that expects an initial value that is not undefined) for a key
        * with a set of dependencies.
        *
-       * @param key key that factory will provide
-       * @param dependencies set of things this instance depends on. Will be provided to factory function via `services`.
-       * @param factory function that creates an instance to provide
-       * @returns this for chaining
+       * @param key Key that factory will provide.
+       * @param dependencies Set of things this instance depends on. Will be provided to factory function via `services`.
+       * @param factory Function that creates an instance to provide.
+       * @returns `this` for chaining.
        */
     composeFactory<InstanceType, Dependencies>(key: string, dependencies: string[], factory: DependencyFactory<InstanceType, Dependencies, true>): this;
     private buildNodes;
     /**
        * Build a single service.
        *
-       * @param key service to build
-       * @param deep reconstruct all dependencies
-       * @returns the service instance, or undefined
+       * @param key Service to build.
+       * @param deep Whether to reconstruct all dependencies.
+       * @returns The service instance, or undefined.
        */
     makeInstance<InstanceType = unknown>(key: string, deep?: boolean): InstanceType | undefined;
     /**
        * Build a single service and assert that it is not undefined.
        *
-       * @param key service to build
-       * @param deep reconstruct all dependencies
-       * @returns the service instance
+       * @param key Service to build.
+       * @param deep Wheter to reconstruct all dependencies.
+       * @returns The service instance
        */
     mustMakeInstance<InstanceType = unknown>(key: string, deep?: boolean): InstanceType;
     /**
@@ -105,8 +104,8 @@ export declare class ServiceCollection {
     /**
        * Build the full set of services, asserting that the specified keys are not undefined.
        *
-       * @param keys instances that must be not undefined
-       * @returns all resolve services
+       * @param keys Instances that must be not undefined
+       * @returns All resolve services
        */
     mustMakeInstances<InstancesType extends Record<string, unknown> = Record<string, unknown>>(...keys: string[]): InstancesType;
 }

package/dist/src/serviceCollection.js

@@ -69,9 +69,9 @@ class ServiceCollection {
     /**
        * Register an instance by key. This will overwrite existing instances.
        *
-       * @param key key of the instance being provided
-       * @param instance instance to provide
-       * @returns this for chaining
+       * @param key Key of the instance being provided.
+       * @param instance Instance to provide.
+       * @returns `this` for chaining.
        */
     addInstance(key, instance) {
         if (this.graph.hasNode(key)) {
@@ -157,9 +157,9 @@ class ServiceCollection {
     /**
        * Build a single service.
        *
-       * @param key service to build
-       * @param deep reconstruct all dependencies
-       * @returns the service instance, or undefined
+       * @param key Service to build.
+       * @param deep Whether to reconstruct all dependencies.
+       * @returns The service instance, or undefined.
        */
     makeInstance(key, deep = false) {
         // If this is not a deep reconstruction, reuse any services that `key` depends on
@@ -174,9 +174,9 @@ class ServiceCollection {
     /**
        * Build a single service and assert that it is not undefined.
        *
-       * @param key service to build
-       * @param deep reconstruct all dependencies
-       * @returns the service instance
+       * @param key Service to build.
+       * @param deep Wheter to reconstruct all dependencies.
+       * @returns The service instance
        */
     mustMakeInstance(key, deep = false) {
         const instance = this.makeInstance(key, deep);
@@ -194,8 +194,8 @@ class ServiceCollection {
     /**
        * Build the full set of services, asserting that the specified keys are not undefined.
        *
-       * @param keys instances that must be not undefined
-       * @returns all resolve services
+       * @param keys Instances that must be not undefined
+       * @returns All resolve services
        */
     mustMakeInstances(...keys) {
         const instances = this.makeInstances();

package/dist/src/serviceCollection.js.map

@@ -1 +1 @@
-{"version":3,"file":"serviceCollection.js","sourceRoot":"","sources":["../../src/serviceCollection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"serviceCollection.js","sourceRoot":"","sources":["../../src/serviceCollection.ts"],"names":[],"mappings":"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"}

package/dist/src/waterfallDialog.d.ts

@@ -20,7 +20,7 @@ export declare class WaterfallDialog<O extends object = {}> extends Dialog<O> {
        * Creates a new waterfall dialog containing the given array of steps.
        *
        * @remarks
-       * See the addstep function for details on creating a valid step function.
+       * See the {@link WaterfallDialog.addStep | addStep function} for details on creating a valid step function.
        * @param dialogId Unique ID of the dialog within the component or set its being added to.
        * @param steps (Optional) array of asynchronous waterfall step functions.
        */
@@ -41,7 +41,7 @@ export declare class WaterfallDialog<O extends object = {}> extends Dialog<O> {
     /**
        * Called when the WaterfallDialog is started and pushed onto the dialog stack.
        *
-       * @param dialogContext The DialogContext for the current turn of conversation.
+       * @param dialogContext The {@link DialogContext} for the current turn of conversation.
        * @param options Optional, initial information to pass to the Dialog.
        * @returns A Promise representing the asynchronous operation.
        * @remarks
@@ -53,7 +53,7 @@ export declare class WaterfallDialog<O extends object = {}> extends Dialog<O> {
        * Called when the WaterfallDialog is _continued_, where it is the active dialog and the
        * user replies with a new Activity.
        *
-       * @param dialogContext The DialogContext for the current turn of conversation.
+       * @param dialogContext The {@link DialogContext} for the current turn of conversation.
        * @returns A Promise representing the asynchronous operation.
        * @remarks
        * If the task is successful, the result indicates whether the dialog is still
@@ -64,7 +64,7 @@ export declare class WaterfallDialog<O extends object = {}> extends Dialog<O> {
     /**
        * Called when a child WaterfallDialog completed its turn, returning control to this dialog.
        *
-       * @param dc The DialogContext for the current turn of the conversation.
+       * @param dc The {@link DialogContext} for the current turn of the conversation.
        * @param reason DialogReason why the dialog resumed.
        * @param result Optional, value returned from the dialog that was called. The type
        * of the value returned is dependent on the child dialog.
@@ -84,7 +84,7 @@ export declare class WaterfallDialog<O extends object = {}> extends Dialog<O> {
     /**
        * Executes a step of the WaterfallDialog.
        *
-       * @param dc The DialogContext for the current turn of conversation.
+       * @param dc The {@link DialogContext} for the current turn of conversation.
        * @param index The index of the current waterfall step to execute.
        * @param reason The DialogReason the waterfall step is being executed.
        * @param result Optional, result returned by a dialog called in the previous waterfall step.

package/dist/src/waterfallDialog.js

@@ -19,7 +19,7 @@ class WaterfallDialog extends dialog_1.Dialog {
        * Creates a new waterfall dialog containing the given array of steps.
        *
        * @remarks
-       * See the addstep function for details on creating a valid step function.
+       * See the {@link WaterfallDialog.addStep | addStep function} for details on creating a valid step function.
        * @param dialogId Unique ID of the dialog within the component or set its being added to.
        * @param steps (Optional) array of asynchronous waterfall step functions.
        */
@@ -53,7 +53,7 @@ class WaterfallDialog extends dialog_1.Dialog {
     /**
        * Called when the WaterfallDialog is started and pushed onto the dialog stack.
        *
-       * @param dialogContext The DialogContext for the current turn of conversation.
+       * @param dialogContext The {@link DialogContext} for the current turn of conversation.
        * @param options Optional, initial information to pass to the Dialog.
        * @returns A Promise representing the asynchronous operation.
        * @remarks
@@ -73,7 +73,7 @@ class WaterfallDialog extends dialog_1.Dialog {
        * Called when the WaterfallDialog is _continued_, where it is the active dialog and the
        * user replies with a new Activity.
        *
-       * @param dialogContext The DialogContext for the current turn of conversation.
+       * @param dialogContext The {@link DialogContext} for the current turn of conversation.
        * @returns A Promise representing the asynchronous operation.
        * @remarks
        * If the task is successful, the result indicates whether the dialog is still
@@ -91,7 +91,7 @@ class WaterfallDialog extends dialog_1.Dialog {
     /**
        * Called when a child WaterfallDialog completed its turn, returning control to this dialog.
        *
-       * @param dc The DialogContext for the current turn of the conversation.
+       * @param dc The {@link DialogContext} for the current turn of the conversation.
        * @param reason DialogReason why the dialog resumed.
        * @param result Optional, value returned from the dialog that was called. The type
        * of the value returned is dependent on the child dialog.
@@ -117,7 +117,7 @@ class WaterfallDialog extends dialog_1.Dialog {
     /**
        * Executes a step of the WaterfallDialog.
        *
-       * @param dc The DialogContext for the current turn of conversation.
+       * @param dc The {@link DialogContext} for the current turn of conversation.
        * @param index The index of the current waterfall step to execute.
        * @param reason The DialogReason the waterfall step is being executed.
        * @param result Optional, result returned by a dialog called in the previous waterfall step.

package/dist/src/waterfallStepContext.d.ts

@@ -9,11 +9,32 @@ import { DialogTurnResult } from './dialogTurnResult';
  * Values passed to the `WaterfallStepContext` constructor.
  */
 export interface WaterfallStepInfo<O extends object> {
+    /**
+     * The index of the current step in the waterfall dialog.
+     */
     index: number;
+    /**
+     * The options passed to the waterfall dialog when it was started.
+     */
     options: O;
+    /**
+     * The reason the current step is being executed.
+     */
     reason: DialogReason;
+    /**
+     * The result returned by the previous step or dialog.
+     */
     result: any;
+    /**
+     * A dictionary of values shared across all steps in the waterfall dialog.
+     */
     values: object;
+    /**
+     * A function to proceed to the next step in the waterfall dialog.
+     *
+     * @param result Optional result to pass to the next step.
+     * @returns A promise resolving to the result of the next dialog turn.
+     */
     onNext(result?: any): Promise<DialogTurnResult>;
 }
 /**

package/dist/src/waterfallStepContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"waterfallStepContext.js","sourceRoot":"","sources":["../../src/waterfallStepContext.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,mDAA+C;AAgB/C;;;;GAIG;AACH,MAAa,oBAA4C,SAAQ,6BAAa;IAG5E;;;;;SAKK;IACL,YAAa,aAA4B,EAAE,QAA8B;QACvE,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,WAAW,EAAE,aAAa,CAAC,KAAK,EAAE,CAAC,CAAA;QACjF,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAA;QACzB,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAA;IACpC,CAAC;IAED;;;;SAIK;IACL,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAA;IAC7B,CAAC;IAED;;;;;SAKK;IACL,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAA;IAC/B,CAAC;IAED;;;;SAIK;IACL,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAA;IAC9B,CAAC;IAED;;;;SAIK;IACL,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAA;IAC9B,CAAC;IAED;;;;SAIK;IACL,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAA;IAC9B,CAAC;IAED;;;;;SAKK;IACL,KAAK,CAAC,IAAI,CAAE,MAAY;QACtB,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC5C,CAAC;CACF;AAtED,oDAsEC"}
+{"version":3,"file":"waterfallStepContext.js","sourceRoot":"","sources":["../../src/waterfallStepContext.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,mDAA+C;AA0C/C;;;;GAIG;AACH,MAAa,oBAA4C,SAAQ,6BAAa;IAG5E;;;;;SAKK;IACL,YAAa,aAA4B,EAAE,QAA8B;QACvE,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,WAAW,EAAE,aAAa,CAAC,KAAK,EAAE,CAAC,CAAA;QACjF,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAA;QACzB,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAA;IACpC,CAAC;IAED;;;;SAIK;IACL,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAA;IAC7B,CAAC;IAED;;;;;SAKK;IACL,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAA;IAC/B,CAAC;IAED;;;;SAIK;IACL,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAA;IAC9B,CAAC;IAED;;;;SAIK;IACL,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAA;IAC9B,CAAC;IAED;;;;SAIK;IACL,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAA;IAC9B,CAAC;IAED;;;;;SAKK;IACL,KAAK,CAAC,IAAI,CAAE,MAAY;QACtB,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC5C,CAAC;CACF;AAtED,oDAsEC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@microsoft/agents-hosting-dialogs",
-  "version": "0.2.10-g3ac88ff25e",
+  "version": "0.3.5",
   "homepage": "https://github.com/microsoft/Agents-for-js",
   "repository": {
     "type": "git",
@@ -16,7 +16,7 @@
   "main": "dist/index.js",
   "types": "dist/src/index.d.ts",
   "dependencies": {
-    "@microsoft/agents-hosting": "0.2.10-g3ac88ff25e",
+    "@microsoft/agents-hosting": "0.3.5",
     "@types/lodash": "^4.17.16",
     "dependency-graph": "^1.0.0",
     "@microsoft/recognizers-text-suite": "^1.3.1",

package/src/agentComponent.ts

@@ -8,16 +8,30 @@ import { ServiceCollection } from './serviceCollection'
 import { Configuration } from './configuration'
 
 /**
- * Definition of an AgentComponent that allows registration of services, custom actions, memory scopes and adapters.
+ * Abstract base class for defining an AgentComponent.
  *
- * To make your components available to the system you derive from AgentComponent and register services to add functionality.
- * These components then are consumed in appropriate places by the systems that need them. When using Composer, configureServices
- * gets called automatically on the components by the agent runtime, as long as the components are registered in the configuration.
+ * @remarks
+ * An `AgentComponent` allows the registration of services, custom actions, memory scopes, and adapters.
+ * To make components available to the system, derive from this class and implement the `configureServices` method.
+ * These components are consumed by the system in appropriate places. When using Composer, the `configureServices`
+ * method is called automatically by the agent runtime, provided the components are registered in the configuration.
  */
 export abstract class AgentComponent {
+  /**
+   * A Zod schema for validating that an object is an `AgentComponent`.
+   *
+   * @remarks
+   * This schema checks if the object has a `configureServices` method.
+   */
   static z = z.custom<AgentComponent>((val: any) => typeof val.configureServices === 'function', {
     message: 'AgentComponent',
   })
 
+  /**
+   * Configures the services, custom actions, memory scopes, and adapters for the component.
+   *
+   * @param services - The service collection to which services can be added.
+   * @param configuration - The configuration object for accessing settings.
+   */
   abstract configureServices (services: ServiceCollection, configuration: Configuration): void
 }

package/src/agentStateSet.ts

@@ -42,7 +42,7 @@ export class AgentStateSet {
   }
 
   /**
-     * Calls `AgentState.load()` on all of the AgentState plugins in the set.
+     * Calls the {@link AgentState.load | AgentState.load method} on all of the AgentState plugins in the set.
      *
      * @remarks
      * This will trigger all of the plugins to read in their state in parallel.
@@ -57,7 +57,7 @@ export class AgentStateSet {
   }
 
   /**
-     * Calls `AgentState.saveChanges()` on all of the AgentState plugins in the set.
+     * Calls {@link AgentState.saveChanges | AgentState.saveChanges method} on all of the AgentState plugins in the set.
      *
      * @remarks
      * This will trigger all of the plugins to write out their state in parallel.

package/src/choices/choice.ts

@@ -10,7 +10,18 @@ import { CardAction } from '@microsoft/agents-activity'
  * user picked.
  */
 export interface Choice {
+  /**
+   * The value of the choice, which is used to identify the choice.
+   */
   value: string;
+
+  /**
+   * An optional action associated with the choice, such as a button click.
+   */
   action?: CardAction;
+
+  /**
+   * Optional synonyms that can be used to recognize the choice.
+   */
   synonyms?: string[];
 }

package/src/choices/findChoices.ts

@@ -8,9 +8,24 @@ import { ModelResult } from './modelResult'
 import { Choice } from './choice'
 
 export interface FindChoicesOptions extends FindValuesOptions {
+  /**
+   * If true, the value of the choice will not be included in the search.
+   */
   noValue?: boolean;
+
+  /**
+   * If true, the action title of the choice will not be included in the search.
+   */
   noAction?: boolean;
+
+  /**
+   * If true, numbers will be recognized as choices.
+   */
   recognizeNumbers?: boolean;
+
+  /**
+   * If true, ordinals (e.g., first, second) will be recognized as choices.
+   */
   recognizeOrdinals?: boolean;
 }