@microsoft/agents-hosting 0.2.10-g3ac88ff25e → 0.2.14

package/dist/src/logger.js

@@ -3,9 +3,18 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
 exports.debug = debug;
 const debug_1 = __importDefault(require("debug"));
+/**
+ * Logger class that provides colored logging functionality using the debug package.
+ * Supports different log levels: info, warn, error, and debug.
+ */
 class Logger {
+    /**
+     * Creates a new Logger instance with the specified namespace.
+     * @param namespace The namespace to use for the logger
+     */
     constructor(namespace = '') {
         this.loggers = {};
         this.levelColors = {
@@ -23,19 +32,45 @@ class Logger {
             this.loggers[level] = logger;
         }
     }
+    /**
+     * Logs an informational message.
+     * @param message The message to log
+     * @param args Additional arguments to include in the log
+     */
     info(message, ...args) {
         this.loggers.info(message, ...args);
     }
+    /**
+     * Logs a warning message.
+     * @param message The message to log
+     * @param args Additional arguments to include in the log
+     */
     warn(message, ...args) {
         this.loggers.warn(message, ...args);
     }
+    /**
+     * Logs an error message.
+     * @param message The message to log
+     * @param args Additional arguments to include in the log
+     */
     error(message, ...args) {
         this.loggers.error(message, ...args);
     }
+    /**
+     * Logs a debug message.
+     * @param message The message to log
+     * @param args Additional arguments to include in the log
+     */
     debug(message, ...args) {
         this.loggers.debug(message, ...args);
     }
 }
+exports.Logger = Logger;
+/**
+ * Creates a new Logger instance with the specified namespace.
+ * @param namespace The namespace to use for the logger
+ * @returns A new Logger instance
+ */
 function debug(namespace) {
     return new Logger(namespace);
 }

package/dist/src/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":";;;;;AAwCA,sBAEC;AA1CD,kDAA6C;AAE7C,MAAM,MAAM;IASV,YAAa,YAAoB,EAAE;QAR3B,YAAO,GAAkC,EAAE,CAAA;QAClC,gBAAW,GAAgC;YAC1D,IAAI,EAAE,GAAG,EAAE,QAAQ;YACnB,IAAI,EAAE,GAAG,EAAE,SAAS;YACpB,KAAK,EAAE,GAAG,EAAE,MAAM;YAClB,KAAK,EAAE,GAAG,CAAC,OAAO;SACnB,CAAA;QAGC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAA;IACnC,CAAC;IAEO,iBAAiB,CAAE,SAAiB;QAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAClD,MAAM,MAAM,GAAG,IAAA,eAAW,EAAC,GAAG,SAAS,IAAI,KAAK,EAAE,CAAC,CAAA;YACnD,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;YACtC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,CAAA;QAC9B,CAAC;IACH,CAAC;IAED,IAAI,CAAE,OAAe,EAAE,GAAG,IAAW;QACnC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IACrC,CAAC;IAED,IAAI,CAAE,OAAe,EAAE,GAAG,IAAW;QACnC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IACrC,CAAC;IAED,KAAK,CAAE,OAAe,EAAE,GAAG,IAAW;QACpC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IACtC,CAAC;IAED,KAAK,CAAE,OAAe,EAAE,GAAG,IAAW;QACpC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IACtC,CAAC;CACF;AAED,SAAgB,KAAK,CAAE,SAAiB;IACtC,OAAO,IAAI,MAAM,CAAC,SAAS,CAAC,CAAA;AAC9B,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":";;;;;;AAyEA,sBAEC;AA3ED,kDAA6C;AAE7C;;;GAGG;AACH,MAAa,MAAM;IASjB;;;OAGG;IACH,YAAa,YAAoB,EAAE;QAZ3B,YAAO,GAAkC,EAAE,CAAA;QAClC,gBAAW,GAAgC;YAC1D,IAAI,EAAE,GAAG,EAAE,QAAQ;YACnB,IAAI,EAAE,GAAG,EAAE,SAAS;YACpB,KAAK,EAAE,GAAG,EAAE,MAAM;YAClB,KAAK,EAAE,GAAG,CAAC,OAAO;SACnB,CAAA;QAOC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAA;IACnC,CAAC;IAEO,iBAAiB,CAAE,SAAiB;QAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAClD,MAAM,MAAM,GAAG,IAAA,eAAW,EAAC,GAAG,SAAS,IAAI,KAAK,EAAE,CAAC,CAAA;YACnD,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;YACtC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,CAAA;QAC9B,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAE,OAAe,EAAE,GAAG,IAAW;QACnC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IACrC,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAE,OAAe,EAAE,GAAG,IAAW;QACnC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IACrC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAE,OAAe,EAAE,GAAG,IAAW;QACpC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IACtC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAE,OAAe,EAAE,GAAG,IAAW;QACpC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IACtC,CAAC;CACF;AA5DD,wBA4DC;AAED;;;;GAIG;AACH,SAAgB,KAAK,CAAE,SAAiB;IACtC,OAAO,IAAI,MAAM,CAAC,SAAS,CAAC,CAAA;AAC9B,CAAC"}

package/dist/src/state/agentState.d.ts

@@ -5,72 +5,124 @@
 import { Storage, StorageKeyFactory } from '../storage/storage';
 import { TurnContext } from '../turnContext';
 import { AgentStatePropertyAccessor } from './agentStatePropertyAccesor';
+/**
+ * Represents agent state that has been cached in the turn context.
+ * Used internally to track state changes and avoid unnecessary storage operations.
+ */
 export interface CachedAgentState {
+    /**
+     * The state object containing all properties and their values
+     */
     state: {
         [id: string]: any;
     };
+    /**
+     * Hash of the state used to detect changes
+     */
     hash: string;
 }
+/**
+ * Represents a custom key for storing state in a specific location.
+ * Allows state to be persisted with channel and conversation identifiers
+ * independent of the current context.
+ */
 export interface CustomKey {
+    /**
+     * The ID of the channel where the state should be stored
+     */
     channelId: string;
+    /**
+     * The ID of the conversation where the state should be stored
+     */
     conversationId: string;
 }
 /**
- * Manages the state of an Agent.
+ * Manages the state of an Agent across turns in a conversation.
+ *
+ * AgentState provides functionality to persist and retrieve state data using
+ * a storage provider. It handles caching state in the turn context for performance,
+ * calculating change hashes to detect modifications, and managing property accessors
+ * for typed access to state properties.
  */
 export declare class AgentState {
     protected storage: Storage;
     protected storageKey: StorageKeyFactory;
     private readonly stateKey;
     /**
-      * Creates a new instance of AgentState.
-      * @param storage The storage provider.
-      * @param storageKey The storage key factory.
-      */
+     * Creates a new instance of AgentState.
+     *
+     * @param storage The storage provider used to persist state between turns
+     * @param storageKey A factory function that generates keys for storing state data
+     */
     constructor(storage: Storage, storageKey: StorageKeyFactory);
     /**
      * Creates a property accessor for the specified property.
-     * @param name The name of the property.
-     * @returns A property accessor for the specified property.
+     * Property accessors provide typed access to properties within the state object.
+     *
+     * @param name The name of the property to access
+     * @returns A property accessor for the specified property
      */
     createProperty<T = any>(name: string): AgentStatePropertyAccessor<T>;
     /**
-     * Loads the state from storage.
-     * @param context The turn context.
-     * @param force Whether to force loading the state.
-     * @returns A promise that resolves to the loaded state.
+     * Loads the state from storage into the turn context.
+     * If state is already cached in the turn context and force is not set, the cached version will be used.
+     *
+     * @param context The turn context to load state into
+     * @param force If true, forces a reload from storage even if state is cached
+     * @param customKey Optional custom storage key to use instead of the default
+     * @returns A promise that resolves to the loaded state object
      */
     load(context: TurnContext, force?: boolean, customKey?: CustomKey): Promise<any>;
     /**
-     * Saves the state to storage.
-     * @param context The turn context.
-     * @param force Whether to force saving the state.
-     * @returns A promise that resolves when the save operation is complete.
+     * Saves the state to storage if it has changed since it was loaded.
+     * Change detection uses a hash of the state object to determine if saving is necessary.
+     *
+     * @param context The turn context containing the state to save
+     * @param force If true, forces a save to storage even if no changes are detected
+     * @param customKey Optional custom storage key to use instead of the default
+     * @returns A promise that resolves when the save operation is complete
      */
     saveChanges(context: TurnContext, force?: boolean, customKey?: CustomKey): Promise<void>;
+    /**
+     * Determines whether to use a custom key or generate one from the context.
+     *
+     * @param customKey Optional custom key with channel and conversation IDs
+     * @param context The turn context used to generate a key if no custom key is provided
+     * @returns The storage key to use
+     * @private
+     */
     private getStorageOrCustomKey;
     /**
-     * Clears the state from the turn context.
-     * @param context The turn context.
-     * @returns A promise that resolves when the clear operation is complete.
+     * Clears the state by setting it to an empty object in the turn context.
+     * Note: This does not remove the state from storage, it only clears the in-memory representation.
+     * Call saveChanges() after this to persist the empty state to storage.
+     *
+     * @param context The turn context containing the state to clear
+     * @returns A promise that resolves when the clear operation is complete
      */
     clear(context: TurnContext): Promise<void>;
     /**
-     * Deletes the state from storage.
-     * @param context The turn context.
-     * @returns A promise that resolves when the delete operation is complete.
+     * Deletes the state from both the turn context and storage.
+     *
+     * @param context The turn context containing the state to delete
+     * @param customKey Optional custom storage key to use instead of the default
+     * @returns A promise that resolves when the delete operation is complete
      */
     delete(context: TurnContext, customKey?: CustomKey): Promise<void>;
     /**
-     * Gets the state from the turn context.
-     * @param context The turn context.
-     * @returns The state, or undefined if the state is not found.
+     * Gets the state from the turn context without loading it from storage.
+     *
+     * @param context The turn context containing the state to get
+     * @returns The state object, or undefined if no state is found in the turn context
      */
     get(context: TurnContext): any | undefined;
     /**
-     * Calculates the change hash for the specified item.
-     * @param item The item to calculate the hash for.
-     * @returns The calculated hash.
+     * Calculates a hash for the specified state object to detect changes.
+     * The eTag property is excluded from the hash calculation.
+     *
+     * @param item The state object to calculate the hash for
+     * @returns A string hash representing the state
+     * @private
      */
     private readonly calculateChangeHash;
 }

package/dist/src/state/agentState.js

@@ -10,22 +10,31 @@ const agentStatePropertyAccesor_1 = require("./agentStatePropertyAccesor");
 const logger_1 = require("../logger");
 const logger = (0, logger_1.debug)('agents:state');
 /**
- * Manages the state of an Agent.
+ * Manages the state of an Agent across turns in a conversation.
+ *
+ * AgentState provides functionality to persist and retrieve state data using
+ * a storage provider. It handles caching state in the turn context for performance,
+ * calculating change hashes to detect modifications, and managing property accessors
+ * for typed access to state properties.
  */
 class AgentState {
     /**
-      * Creates a new instance of AgentState.
-      * @param storage The storage provider.
-      * @param storageKey The storage key factory.
-      */
+     * Creates a new instance of AgentState.
+     *
+     * @param storage The storage provider used to persist state between turns
+     * @param storageKey A factory function that generates keys for storing state data
+     */
     constructor(storage, storageKey) {
         this.storage = storage;
         this.storageKey = storageKey;
         this.stateKey = Symbol('state');
         /**
-         * Calculates the change hash for the specified item.
-         * @param item The item to calculate the hash for.
-         * @returns The calculated hash.
+         * Calculates a hash for the specified state object to detect changes.
+         * The eTag property is excluded from the hash calculation.
+         *
+         * @param item The state object to calculate the hash for
+         * @returns A string hash representing the state
+         * @private
          */
         this.calculateChangeHash = (item) => {
             const { eTag, ...rest } = item;
@@ -38,18 +47,23 @@ class AgentState {
     }
     /**
      * Creates a property accessor for the specified property.
-     * @param name The name of the property.
-     * @returns A property accessor for the specified property.
+     * Property accessors provide typed access to properties within the state object.
+     *
+     * @param name The name of the property to access
+     * @returns A property accessor for the specified property
      */
     createProperty(name) {
         const prop = new agentStatePropertyAccesor_1.AgentStatePropertyAccessor(this, name);
         return prop;
     }
     /**
-     * Loads the state from storage.
-     * @param context The turn context.
-     * @param force Whether to force loading the state.
-     * @returns A promise that resolves to the loaded state.
+     * Loads the state from storage into the turn context.
+     * If state is already cached in the turn context and force is not set, the cached version will be used.
+     *
+     * @param context The turn context to load state into
+     * @param force If true, forces a reload from storage even if state is cached
+     * @param customKey Optional custom storage key to use instead of the default
+     * @returns A promise that resolves to the loaded state object
      */
     async load(context, force = false, customKey) {
         const cached = context.turnState.get(this.stateKey);
@@ -65,10 +79,13 @@ class AgentState {
         return cached.state;
     }
     /**
-     * Saves the state to storage.
-     * @param context The turn context.
-     * @param force Whether to force saving the state.
-     * @returns A promise that resolves when the save operation is complete.
+     * Saves the state to storage if it has changed since it was loaded.
+     * Change detection uses a hash of the state object to determine if saving is necessary.
+     *
+     * @param context The turn context containing the state to save
+     * @param force If true, forces a save to storage even if no changes are detected
+     * @param customKey Optional custom storage key to use instead of the default
+     * @returns A promise that resolves when the save operation is complete
      */
     async saveChanges(context, force = false, customKey) {
         let cached = context.turnState.get(this.stateKey);
@@ -86,6 +103,14 @@ class AgentState {
             context.turnState.set(this.stateKey, cached);
         }
     }
+    /**
+     * Determines whether to use a custom key or generate one from the context.
+     *
+     * @param customKey Optional custom key with channel and conversation IDs
+     * @param context The turn context used to generate a key if no custom key is provided
+     * @returns The storage key to use
+     * @private
+     */
     async getStorageOrCustomKey(customKey, context) {
         let key;
         if (customKey && customKey.channelId && customKey.conversationId) {
@@ -98,18 +123,23 @@ class AgentState {
         return key;
     }
     /**
-     * Clears the state from the turn context.
-     * @param context The turn context.
-     * @returns A promise that resolves when the clear operation is complete.
+     * Clears the state by setting it to an empty object in the turn context.
+     * Note: This does not remove the state from storage, it only clears the in-memory representation.
+     * Call saveChanges() after this to persist the empty state to storage.
+     *
+     * @param context The turn context containing the state to clear
+     * @returns A promise that resolves when the clear operation is complete
      */
     async clear(context) {
         const emptyObjectToForceSave = { state: {}, hash: '' };
         context.turnState.set(this.stateKey, emptyObjectToForceSave);
     }
     /**
-     * Deletes the state from storage.
-     * @param context The turn context.
-     * @returns A promise that resolves when the delete operation is complete.
+     * Deletes the state from both the turn context and storage.
+     *
+     * @param context The turn context containing the state to delete
+     * @param customKey Optional custom storage key to use instead of the default
+     * @returns A promise that resolves when the delete operation is complete
      */
     async delete(context, customKey) {
         if (context.turnState.has(this.stateKey)) {
@@ -120,9 +150,10 @@ class AgentState {
         await this.storage.delete([key]);
     }
     /**
-     * Gets the state from the turn context.
-     * @param context The turn context.
-     * @returns The state, or undefined if the state is not found.
+     * Gets the state from the turn context without loading it from storage.
+     *
+     * @param context The turn context containing the state to get
+     * @returns The state object, or undefined if no state is found in the turn context
      */
     get(context) {
         const cached = context.turnState.get(this.stateKey);

package/dist/src/state/agentState.js.map

@@ -1 +1 @@
-{"version":3,"file":"agentState.js","sourceRoot":"","sources":["../../../src/state/agentState.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH,6CAAwC;AACxC,2EAAwE;AACxE,sCAAiC;AAEjC,MAAM,MAAM,GAAG,IAAA,cAAK,EAAC,cAAc,CAAC,CAAA;AAapC;;GAEG;AACH,MAAa,UAAU;IAGrB;;;;QAII;IACJ,YAAuB,OAAgB,EAAY,UAA6B;QAAzD,YAAO,GAAP,OAAO,CAAS;QAAY,eAAU,GAAV,UAAU,CAAmB;QAP/D,aAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;QAoH3C;;;;WAIG;QACc,wBAAmB,GAAG,CAAC,IAAe,EAAU,EAAE;YACjE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;YAE9B,sCAAsC;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;YAEnC,MAAM,IAAI,GAAG,IAAA,wBAAU,EAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAA;YACxD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAEhD,OAAO,MAAM,CAAA;QACf,CAAC,CAAA;IA5HmF,CAAC;IAErF;;;;OAIG;IACH,cAAc,CAAU,IAAY;QAClC,MAAM,IAAI,GAAkC,IAAI,sDAA0B,CAAI,IAAI,EAAE,IAAI,CAAC,CAAA;QACzF,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,IAAI,CAAE,OAAoB,EAAE,KAAK,GAAG,KAAK,EAAE,SAAqB;QAC3E,MAAM,MAAM,GAAqB,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAErE,IAAI,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACtC,MAAM,GAAG,GAAW,MAAM,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;YACxE,MAAM,CAAC,IAAI,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAA;YAC9C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;YAEjD,MAAM,KAAK,GAAQ,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;YACxC,MAAM,IAAI,GAAW,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAA;YACpD,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;YAErD,OAAO,KAAK,CAAA;QACd,CAAC;QAED,OAAO,MAAM,CAAC,KAAK,CAAA;IACrB,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,WAAW,CAAE,OAAoB,EAAE,KAAK,GAAG,KAAK,EAAE,SAAqB;QAClF,IAAI,MAAM,GAAqB,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACnE,IAAI,KAAK,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,mBAAmB,CAAC,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,KAAK,CAAC,CAAC,EAAE,CAAC;YACjF,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;YAClC,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAA;YACvB,MAAM,OAAO,GAAc,EAAe,CAAA;YAE1C,MAAM,GAAG,GAAW,MAAM,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;YAExE,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAA;YAE3B,MAAM,CAAC,IAAI,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAA;YAC9C,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YACjC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACpD,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC9C,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,qBAAqB,CAAE,SAAgC,EAAE,OAAoB;QACzF,IAAI,GAAuB,CAAA;QAC3B,IAAI,SAAS,IAAI,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,cAAc,EAAE,CAAC;YACjE,0FAA0F;YAC1F,GAAG,GAAG,GAAG,SAAU,CAAC,SAAS,kBAAkB,SAAU,CAAC,cAAc,EAAE,CAAA;QAC5E,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QACtC,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,KAAK,CAAE,OAAoB;QACtC,MAAM,sBAAsB,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;QAEtD,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAA;IAC9D,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,MAAM,CAAE,OAAoB,EAAE,SAAqB;QAC9D,IAAI,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACzC,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QAChE,MAAM,CAAC,IAAI,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAA;QAC/C,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IAClC,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAE,OAAoB;QAC9B,MAAM,MAAM,GAAqB,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAErE,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;IAClG,CAAC;CAkBF;AArID,gCAqIC"}
+{"version":3,"file":"agentState.js","sourceRoot":"","sources":["../../../src/state/agentState.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH,6CAAwC;AACxC,2EAAwE;AACxE,sCAAiC;AAEjC,MAAM,MAAM,GAAG,IAAA,cAAK,EAAC,cAAc,CAAC,CAAA;AAkCpC;;;;;;;GAOG;AACH,MAAa,UAAU;IAGrB;;;;;OAKG;IACH,YAAuB,OAAgB,EAAY,UAA6B;QAAzD,YAAO,GAAP,OAAO,CAAS;QAAY,eAAU,GAAV,UAAU,CAAmB;QAR/D,aAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;QA2I3C;;;;;;;WAOG;QACc,wBAAmB,GAAG,CAAC,IAAe,EAAU,EAAE;YACjE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;YAE9B,sCAAsC;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;YAEnC,MAAM,IAAI,GAAG,IAAA,wBAAU,EAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAA;YACxD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAEhD,OAAO,MAAM,CAAA;QACf,CAAC,CAAA;IArJmF,CAAC;IAErF;;;;;;OAMG;IACH,cAAc,CAAU,IAAY;QAClC,MAAM,IAAI,GAAkC,IAAI,sDAA0B,CAAI,IAAI,EAAE,IAAI,CAAC,CAAA;QACzF,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;;;;OAQG;IACI,KAAK,CAAC,IAAI,CAAE,OAAoB,EAAE,KAAK,GAAG,KAAK,EAAE,SAAqB;QAC3E,MAAM,MAAM,GAAqB,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAErE,IAAI,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACtC,MAAM,GAAG,GAAW,MAAM,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;YACxE,MAAM,CAAC,IAAI,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAA;YAC9C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;YAEjD,MAAM,KAAK,GAAQ,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;YACxC,MAAM,IAAI,GAAW,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAA;YACpD,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;YAErD,OAAO,KAAK,CAAA;QACd,CAAC;QAED,OAAO,MAAM,CAAC,KAAK,CAAA;IACrB,CAAC;IAED;;;;;;;;OAQG;IACI,KAAK,CAAC,WAAW,CAAE,OAAoB,EAAE,KAAK,GAAG,KAAK,EAAE,SAAqB;QAClF,IAAI,MAAM,GAAqB,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACnE,IAAI,KAAK,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,mBAAmB,CAAC,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,KAAK,CAAC,CAAC,EAAE,CAAC;YACjF,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;YAClC,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAA;YACvB,MAAM,OAAO,GAAc,EAAe,CAAA;YAE1C,MAAM,GAAG,GAAW,MAAM,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;YAExE,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAA;YAE3B,MAAM,CAAC,IAAI,CAAC,4BAA4B,GAAG,EAAE,CAAC,CAAA;YAC9C,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YACjC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACpD,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC9C,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACK,KAAK,CAAC,qBAAqB,CAAE,SAAgC,EAAE,OAAoB;QACzF,IAAI,GAAuB,CAAA;QAC3B,IAAI,SAAS,IAAI,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,cAAc,EAAE,CAAC;YACjE,0FAA0F;YAC1F,GAAG,GAAG,GAAG,SAAU,CAAC,SAAS,kBAAkB,SAAU,CAAC,cAAc,EAAE,CAAA;QAC5E,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QACtC,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,KAAK,CAAE,OAAoB;QACtC,MAAM,sBAAsB,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;QAEtD,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAA;IAC9D,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,MAAM,CAAE,OAAoB,EAAE,SAAqB;QAC9D,IAAI,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACzC,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QAChE,MAAM,CAAC,IAAI,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAA;QAC/C,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IAClC,CAAC;IAED;;;;;OAKG;IACI,GAAG,CAAE,OAAoB;QAC9B,MAAM,MAAM,GAAqB,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAErE,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;IAClG,CAAC;CAqBF;AA/JD,gCA+JC"}

package/dist/src/state/agentStatePropertyAccesor.d.ts

@@ -4,6 +4,15 @@
  */
 import { TurnContext } from '../turnContext';
 import { AgentState, CustomKey } from './agentState';
+/**
+ * Interface for accessing a property in state storage with type safety.
+ *
+ * The interface defines standard methods for working with persisted state properties,
+ * allowing property access with strong typing to reduce errors when working with
+ * complex state objects.
+ *
+ * @typeParam T The type of the property being accessed
+ */
 export interface StatePropertyAccessor<T = any> {
     /**
      * Deletes the persisted property from its backing storage object.
@@ -58,35 +67,82 @@ export interface StatePropertyAccessor<T = any> {
     set(context: TurnContext, value: T): Promise<void>;
 }
 /**
- * Provides access to an Agent state property.
+ * Provides typed access to an Agent state property with automatic state loading.
+ *
+ * The AgentStatePropertyAccessor simplifies working with state by abstracting
+ * the details of loading state from storage and manipulating specific properties.
+ * It automatically handles:
+ *
+ * - Loading state when needed
+ * - Deep cloning of default values to prevent reference issues
+ * - Type checking for properties (when using TypeScript)
+ * - Ensuring properties exist before access
+ *
+ * Property accessors are created through the AgentState.createProperty() method:
+ *
+ * ```typescript
+ * // Create a property accessor for a user profile
+ * const userProfile = userState.createProperty<UserProfile>("userProfile");
+ *
+ * // Get the profile with a default if not exists
+ * const profile = await userProfile.get(context, { name: "", preferences: {} });
+ *
+ * // Update a value
+ * profile.preferences.theme = "dark";
+ *
+ * // Save the change
+ * await userProfile.set(context, profile);
+ *
+ * // Later, call userState.saveChanges(context) to persist to storage
+ * ```
+ *
+ * @typeParam T The type of the property being accessed
  */
 export declare class AgentStatePropertyAccessor<T = any> implements StatePropertyAccessor<T> {
     protected readonly state: AgentState;
     readonly name: string;
     /**
      * Creates a new instance of AgentStatePropertyAccessor.
-     * @param state The agent state.
-     * @param name The name of the property.
+     *
+     * @param state The agent state object that will contain this property
+     * @param name The name of the property in the state object
      */
     constructor(state: AgentState, name: string);
     /**
      * Deletes the property from the state.
-     * @param context The turn context.
-     * @returns A promise that resolves when the delete operation is complete.
+     *
+     * This removes the property from the state object but does not automatically
+     * persist the change to storage. Call state.saveChanges() afterwards to
+     * persist changes.
+     *
+     * @param context The turn context
+     * @param customKey Optional custom key for storing the state in a specific location
+     * @returns A promise that resolves when the delete operation is complete
      */
     delete(context: TurnContext, customKey?: CustomKey): Promise<void>;
     /**
      * Gets the value of the property from the state.
-     * @param context The turn context.
-     * @param defaultValue The default value to return if the property is not found.
-     * @returns A promise that resolves to the value of the property.
+     *
+     * If the property doesn't exist and a default value is provided, a deep clone
+     * of the default value will be stored in state and returned. This ensures that
+     * modifications to the returned object will be properly tracked.
+     *
+     * @param context The turn context
+     * @param defaultValue Optional default value to use if the property doesn't exist
+     * @param customKey Optional custom key for storing the state in a specific location
+     * @returns A promise that resolves to the value of the property or undefined
      */
     get(context: TurnContext, defaultValue?: T, customKey?: CustomKey): Promise<T>;
     /**
      * Sets the value of the property in the state.
-     * @param context The turn context.
-     * @param value The value to set.
-     * @returns A promise that resolves when the set operation is complete.
+     *
+     * This updates the property in the in-memory state object but does not automatically
+     * persist the change to storage. Call state.saveChanges() afterwards to persist changes.
+     *
+     * @param context The turn context
+     * @param value The value to set
+     * @param customKey Optional custom key for storing the state in a specific location
+     * @returns A promise that resolves when the set operation is complete
      */
     set(context: TurnContext, value: T, customKey?: CustomKey): Promise<void>;
 }

package/dist/src/state/agentStatePropertyAccesor.js

@@ -6,13 +6,43 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentStatePropertyAccessor = void 0;
 /**
- * Provides access to an Agent state property.
+ * Provides typed access to an Agent state property with automatic state loading.
+ *
+ * The AgentStatePropertyAccessor simplifies working with state by abstracting
+ * the details of loading state from storage and manipulating specific properties.
+ * It automatically handles:
+ *
+ * - Loading state when needed
+ * - Deep cloning of default values to prevent reference issues
+ * - Type checking for properties (when using TypeScript)
+ * - Ensuring properties exist before access
+ *
+ * Property accessors are created through the AgentState.createProperty() method:
+ *
+ * ```typescript
+ * // Create a property accessor for a user profile
+ * const userProfile = userState.createProperty<UserProfile>("userProfile");
+ *
+ * // Get the profile with a default if not exists
+ * const profile = await userProfile.get(context, { name: "", preferences: {} });
+ *
+ * // Update a value
+ * profile.preferences.theme = "dark";
+ *
+ * // Save the change
+ * await userProfile.set(context, profile);
+ *
+ * // Later, call userState.saveChanges(context) to persist to storage
+ * ```
+ *
+ * @typeParam T The type of the property being accessed
  */
 class AgentStatePropertyAccessor {
     /**
      * Creates a new instance of AgentStatePropertyAccessor.
-     * @param state The agent state.
-     * @param name The name of the property.
+     *
+     * @param state The agent state object that will contain this property
+     * @param name The name of the property in the state object
      */
     constructor(state, name) {
         this.state = state;
@@ -20,8 +50,14 @@ class AgentStatePropertyAccessor {
     }
     /**
      * Deletes the property from the state.
-     * @param context The turn context.
-     * @returns A promise that resolves when the delete operation is complete.
+     *
+     * This removes the property from the state object but does not automatically
+     * persist the change to storage. Call state.saveChanges() afterwards to
+     * persist changes.
+     *
+     * @param context The turn context
+     * @param customKey Optional custom key for storing the state in a specific location
+     * @returns A promise that resolves when the delete operation is complete
      */
     async delete(context, customKey) {
         const obj = await this.state.load(context, false, customKey);
@@ -31,9 +67,15 @@ class AgentStatePropertyAccessor {
     }
     /**
      * Gets the value of the property from the state.
-     * @param context The turn context.
-     * @param defaultValue The default value to return if the property is not found.
-     * @returns A promise that resolves to the value of the property.
+     *
+     * If the property doesn't exist and a default value is provided, a deep clone
+     * of the default value will be stored in state and returned. This ensures that
+     * modifications to the returned object will be properly tracked.
+     *
+     * @param context The turn context
+     * @param defaultValue Optional default value to use if the property doesn't exist
+     * @param customKey Optional custom key for storing the state in a specific location
+     * @returns A promise that resolves to the value of the property or undefined
      */
     async get(context, defaultValue, customKey) {
         const obj = await this.state.load(context, false, customKey);
@@ -47,9 +89,14 @@ class AgentStatePropertyAccessor {
     }
     /**
      * Sets the value of the property in the state.
-     * @param context The turn context.
-     * @param value The value to set.
-     * @returns A promise that resolves when the set operation is complete.
+     *
+     * This updates the property in the in-memory state object but does not automatically
+     * persist the change to storage. Call state.saveChanges() afterwards to persist changes.
+     *
+     * @param context The turn context
+     * @param value The value to set
+     * @param customKey Optional custom key for storing the state in a specific location
+     * @returns A promise that resolves when the set operation is complete
      */
     async set(context, value, customKey) {
         const obj = await this.state.load(context, false, customKey);

package/dist/src/state/agentStatePropertyAccesor.js.map

@@ -1 +1 @@
-{"version":3,"file":"agentStatePropertyAccesor.js","sourceRoot":"","sources":["../../../src/state/agentStatePropertyAccesor.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA8DH;;GAEG;AACH,MAAa,0BAA0B;IACrC;;;;OAIG;IACH,YAAgC,KAAiB,EAAkB,IAAY;QAA/C,UAAK,GAAL,KAAK,CAAY;QAAkB,SAAI,GAAJ,IAAI,CAAQ;IAAI,CAAC;IAEpF;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAE,OAAoB,EAAE,SAAqB;QACvD,MAAM,GAAG,GAAQ,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAA;QACjE,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAE,OAAoB,EAAE,YAAgB,EAAE,SAAqB;QACtE,MAAM,GAAG,GAAQ,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAA;QACjE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YACxF,MAAM,KAAK,GACT,OAAO,YAAY,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;gBAC7D,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;gBAC1C,CAAC,CAAC,YAAY,CAAA;YAClB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;QACxB,CAAC;QAED,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACvB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAE,OAAoB,EAAE,KAAQ,EAAE,SAAqB;QAC9D,MAAM,GAAG,GAAQ,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAA;QACjE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;IACxB,CAAC;CACF;AAjDD,gEAiDC"}
+{"version":3,"file":"agentStatePropertyAccesor.js","sourceRoot":"","sources":["../../../src/state/agentStatePropertyAccesor.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAuEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAa,0BAA0B;IACrC;;;;;OAKG;IACH,YAAgC,KAAiB,EAAkB,IAAY;QAA/C,UAAK,GAAL,KAAK,CAAY;QAAkB,SAAI,GAAJ,IAAI,CAAQ;IAAI,CAAC;IAEpF;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAM,CAAE,OAAoB,EAAE,SAAqB;QACvD,MAAM,GAAG,GAAQ,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAA;QACjE,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvB,CAAC;IACH,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,GAAG,CAAE,OAAoB,EAAE,YAAgB,EAAE,SAAqB;QACtE,MAAM,GAAG,GAAQ,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAA;QACjE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YACxF,MAAM,KAAK,GACT,OAAO,YAAY,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;gBAC7D,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;gBAC1C,CAAC,CAAC,YAAY,CAAA;YAClB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;QACxB,CAAC;QAED,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACvB,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,GAAG,CAAE,OAAoB,EAAE,KAAQ,EAAE,SAAqB;QAC9D,MAAM,GAAG,GAAQ,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAA;QACjE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;IACxB,CAAC;CACF;AAnED,gEAmEC"}