@elizaos/core 2.0.0-alpha.52 → 2.0.0-alpha.53

package/dist/browser/index.d.ts

@@ -0,0 +1,2 @@
+// Type definitions for @elizaos/core (Browser)
+export * from '../index.browser.js';

package/dist/character-loader.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Character Loader
+ *
+ * File I/O operations for loading and saving Eliza characters.
+ * Supports both JSON and TypeScript character files.
+ *
+ * @module character-loader
+ */
+import type { Character } from "./types";
+/**
+ * Result of loading a character from file or creating a default.
+ */
+export interface LoadCharacterResult {
+    /** The loaded or created character */
+    character: Character;
+    /** Path to the character file, or null if using default */
+    filePath: string | null;
+    /** True if the character was created from the default, not loaded from file */
+    fromDefault: boolean;
+}
+/**
+ * Get default character file paths in priority order.
+ * Supports both JSON and TypeScript character files.
+ *
+ * @returns Array of file paths to search for character files
+ */
+export declare function getCharacterPaths(): string[];
+/**
+ * Find the first existing character file from the default paths.
+ *
+ * @returns Path to the first found character file, or null if none exist
+ */
+export declare function findCharacterFile(): string | null;
+/**
+ * Load and validate a JSON character file.
+ *
+ * @param filePath - Path to the JSON character file
+ * @returns The validated Character, or null if loading/validation failed
+ */
+export declare function loadCharacterJson(filePath: string): Character | null;
+/**
+ * Load and validate a TypeScript character file via dynamic import.
+ * Supports default export, named 'character' export, or 'defaultCharacter' export.
+ *
+ * @param filePath - Path to the TypeScript character file
+ * @returns The validated Character, or null if loading/validation failed
+ */
+export declare function loadCharacterTs(filePath: string): Promise<Character | null>;
+/**
+ * Load a character file, routing to the appropriate loader based on extension.
+ *
+ * @param filePath - Path to the character file (JSON or TypeScript)
+ * @returns The validated Character, or null if loading/validation failed
+ */
+export declare function loadCharacterFile(filePath: string): Promise<Character | null>;
+/**
+ * Ensure the character has an encryption salt in settings.secrets.
+ * Generates a random 32-byte hex salt if not present.
+ *
+ * @param character - The character to check/update
+ * @returns A new character with encryption salt guaranteed
+ */
+export declare function ensureEncryptionSalt(character: Character): Character;
+/**
+ * Load an Eliza character from file or create from default.
+ *
+ * This function:
+ * 1. Loads character from file (or uses provided default)
+ * 2. Imports common secrets from process.env
+ * 3. Ensures encryption salt exists
+ * 4. Syncs character secrets back to process.env
+ *
+ * @param characterPath - Override character file path (optional)
+ * @param defaultCharacter - Default character to use if no file found (optional)
+ * @returns LoadCharacterResult with the character, file path, and fromDefault flag
+ */
+export declare function loadCharacter(characterPath?: string, defaultCharacter?: Character): Promise<LoadCharacterResult>;
+/**
+ * Save a character to a JSON file with secure permissions.
+ *
+ * @param character - The character to save
+ * @param filePath - Path to save to (defaults to first found or character.json)
+ */
+export declare function saveCharacter(character: Character, filePath?: string): Promise<void>;
+//# sourceMappingURL=character-loader.d.ts.map

package/dist/character-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-loader.d.ts","sourceRoot":"","sources":["../src/character-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,OAAO,KAAK,EAAE,SAAS,EAAQ,MAAM,SAAS,CAAC;AAO/C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,sCAAsC;IACtC,SAAS,EAAE,SAAS,CAAC;IACrB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,+EAA+E;IAC/E,WAAW,EAAE,OAAO,CAAC;CACrB;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAU5C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAOjD;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAapE;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACpC,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CA2B3B;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACtC,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAQ3B;AAMD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CASpE;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CAClC,aAAa,CAAC,EAAE,MAAM,EACtB,gBAAgB,CAAC,EAAE,SAAS,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAmD9B;AAkBD;;;;;GAKG;AACH,wBAAsB,aAAa,CAClC,SAAS,EAAE,SAAS,EACpB,QAAQ,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/character-utils.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Character Utilities
+ *
+ * Utilities for managing character secrets, plugins, and model provider detection.
+ * These are immutable operations that return new character objects.
+ *
+ * Note: Secrets are stored in character.settings.secrets for compatibility
+ * with the Eliza runtime and existing character files.
+ *
+ * @module character-utils
+ */
+import { CHANNEL_SECRETS, resolveSecretKeyAlias, SECRET_KEY_ALIASES } from "./constants/secrets";
+import type { Character } from "./types";
+/**
+ * Mapping of model provider names to their corresponding API key environment variables.
+ * Re-exported from constants/secrets for backward compatibility.
+ * @see {@link ./constants/secrets} for the comprehensive list
+ */
+export declare const MODEL_PROVIDER_SECRETS: Record<string, string>;
+/**
+ * Re-export CHANNEL_SECRETS and alias utilities from constants
+ */
+export { CHANNEL_SECRETS, resolveSecretKeyAlias, SECRET_KEY_ALIASES };
+/**
+ * Common secret keys that are typically imported from environment variables.
+ * These include API keys for various services the agent may use.
+ * Based on CANONICAL_SECRET_KEYS but filtered to commonly used keys.
+ */
+export declare const COMMON_SECRET_KEYS: string[];
+/**
+ * Get a secret value from character.settings.secrets, falling back to process.env.
+ *
+ * @param character - The character to get the secret from
+ * @param key - The secret key to look up
+ * @returns The secret value, or null if not found in either location
+ */
+export declare function getCharacterSecret(character: Character, key: string): string | null;
+/**
+ * Set a secret in character.settings.secrets. This is an immutable operation
+ * that returns a new character object.
+ *
+ * @param character - The character to modify
+ * @param key - The secret key to set
+ * @param value - The secret value
+ * @returns A new character with the secret set
+ */
+export declare function setCharacterSecret(character: Character, key: string, value: string): Character;
+/**
+ * Check if a secret exists in character.settings.secrets or process.env.
+ *
+ * @param character - The character to check
+ * @param key - The secret key to look for
+ * @returns true if the secret exists and has a non-empty value
+ */
+export declare function hasCharacterSecret(character: Character, key: string): boolean;
+/**
+ * Delete a secret from character.settings.secrets. This is an immutable operation
+ * that returns a new character object.
+ *
+ * @param character - The character to modify
+ * @param key - The secret key to delete
+ * @returns A new character with the secret removed
+ */
+export declare function deleteCharacterSecret(character: Character, key: string): Character;
+/**
+ * List all secret keys (not values) from character.settings.secrets.
+ *
+ * @param character - The character to list secrets from
+ * @returns Array of secret key names
+ */
+export declare function listCharacterSecretKeys(character: Character): string[];
+/**
+ * Sync character secrets to process.env. Existing environment variables
+ * are not overwritten.
+ *
+ * @param character - The character whose secrets to sync
+ * @returns The number of secrets that were synced
+ */
+export declare function syncCharacterSecretsToEnv(character: Character): number;
+/**
+ * Import secrets from process.env into character.settings.secrets.
+ * Existing character secrets take priority and are not overwritten.
+ *
+ * @param character - The character to import secrets into
+ * @param keys - Array of environment variable keys to import
+ * @returns A new character with the imported secrets
+ */
+export declare function importSecretsFromEnv(character: Character, keys: string[]): Character;
+/**
+ * Merge secrets into character.settings.secrets. Existing character secrets
+ * take priority and are not overwritten.
+ *
+ * @param character - The character to merge secrets into
+ * @param secrets - The secrets to merge
+ * @returns A new character with the merged secrets
+ */
+export declare function mergeCharacterSecrets(character: Character, secrets: Record<string, string>): Character;
+/**
+ * Add a plugin to character.plugins. This is an immutable operation.
+ * If the plugin is already present, the original character is returned.
+ *
+ * @param character - The character to modify
+ * @param pluginName - The plugin name to add (e.g., "@elizaos/plugin-discord")
+ * @returns A new character with the plugin added, or the original if already present
+ */
+export declare function addCharacterPlugin(character: Character, pluginName: string): Character;
+/**
+ * Remove a plugin from character.plugins. This is an immutable operation.
+ *
+ * @param character - The character to modify
+ * @param pluginName - The plugin name to remove
+ * @returns A new character with the plugin removed
+ */
+export declare function removeCharacterPlugin(character: Character, pluginName: string): Character;
+/**
+ * Check if a plugin is enabled on the character.
+ *
+ * @param character - The character to check
+ * @param pluginName - The plugin name to look for
+ * @returns true if the plugin is in character.plugins
+ */
+export declare function hasCharacterPlugin(character: Character, pluginName: string): boolean;
+/**
+ * Detect which AI model provider is configured based on available API keys.
+ * Checks character.secrets first, then falls back to process.env.
+ *
+ * @param character - The character to check
+ * @returns The provider name (e.g., "anthropic", "openai") or null if none found
+ */
+export declare function getModelProvider(character: Character): string | null;
+/**
+ * Get all configured model providers for a character.
+ *
+ * @param character - The character to check
+ * @returns Array of provider names that have API keys configured
+ */
+export declare function getConfiguredModelProviders(character: Character): string[];
+//# sourceMappingURL=character-utils.d.ts.map

package/dist/character-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-utils.d.ts","sourceRoot":"","sources":["../src/character-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAEN,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAMzC;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,wBAA0B,CAAC;AAE9D;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,UAqB9B,CAAC;AAMF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CACjC,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,GACT,MAAM,GAAG,IAAI,CAYf;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CACjC,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACX,SAAS,CAaX;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE7E;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACpC,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,GACT,SAAS,CAWX;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE,CAKtE;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAYtE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CACnC,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,EAAE,GACZ,SAAS,CAWX;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACpC,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,SAAS,CAmBX;AAMD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CACjC,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,MAAM,GAChB,SAAS,CAUX;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACpC,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,MAAM,GAChB,SAAS,CAOX;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CACjC,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,MAAM,GAChB,OAAO,CAET;AAMD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAOpE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE,CAQ1E"}

package/dist/character.d.ts

@@ -0,0 +1,68 @@
+import type { Character, CharacterSettings, KnowledgeSourceItem, MessageExample, MessageExampleGroup } from "./types";
+type LegacyKnowledgeItem = string | {
+    path: string;
+    shared?: boolean;
+} | {
+    directory: string;
+    shared?: boolean;
+} | KnowledgeSourceItem;
+type MessageExamplesInput = MessageExampleGroup[] | MessageExample[][];
+export interface CharacterInput {
+    id?: string;
+    name?: string;
+    username?: string;
+    system?: string;
+    templates?: Record<string, string>;
+    bio?: string | string[];
+    messageExamples?: MessageExamplesInput;
+    postExamples?: string[];
+    topics?: string[];
+    adjectives?: string[];
+    knowledge?: LegacyKnowledgeItem[];
+    plugins?: string[];
+    settings?: CharacterSettings;
+    secrets?: Record<string, string>;
+    style?: {
+        all?: string[];
+        chat?: string[];
+        post?: string[];
+    };
+    advancedPlanning?: boolean;
+    advancedMemory?: boolean;
+}
+interface NormalizedCharacterInput {
+    id?: string;
+    name?: string;
+    username?: string;
+    system?: string;
+    templates: Record<string, string>;
+    bio: string[];
+    messageExamples: MessageExampleGroup[];
+    postExamples: string[];
+    topics: string[];
+    adjectives: string[];
+    knowledge: KnowledgeSourceItem[];
+    plugins: string[];
+    settings?: CharacterSettings;
+    secrets: Record<string, string>;
+    style?: {
+        all?: string[];
+        chat?: string[];
+        post?: string[];
+    };
+    advancedPlanning?: boolean;
+    advancedMemory?: boolean;
+}
+export declare function normalizeCharacterInput(input: CharacterInput): NormalizedCharacterInput;
+export declare function createCharacter(input: CharacterInput & {
+    name: string;
+}): Character;
+export declare function parseCharacter(input: string | object | Character | CharacterInput): Character;
+export declare function validateCharacterConfig(character: Character): {
+    isValid: boolean;
+    errors: string[];
+};
+export declare function mergeCharacterDefaults(char: CharacterInput): Character;
+export declare function buildCharacterPlugins(env?: Record<string, string | undefined>): string[];
+export {};
+//# sourceMappingURL=character.d.ts.map

package/dist/character.d.ts.map

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

package/dist/constants/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Constants Module
+ *
+ * Re-exports all constants from submodules.
+ */
+export * from "./secrets";
+//# sourceMappingURL=index.d.ts.map

package/dist/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,WAAW,CAAC"}

package/dist/constants/secrets.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Secret Key Constants and Aliases
+ *
+ * This module provides canonical secret key names, aliases for backward compatibility,
+ * and mappings for model providers. All secret key naming should reference this module
+ * to ensure consistency across the codebase.
+ *
+ * @module constants/secrets
+ */
+/**
+ * Maps legacy/alternative secret key names to their canonical names.
+ * When looking up a secret, check if it's an alias first and resolve to canonical name.
+ *
+ * Key: Legacy/alternative name
+ * Value: Canonical name
+ */
+export declare const SECRET_KEY_ALIASES: Record<string, string>;
+/**
+ * List of all canonical secret key names.
+ * These are the "official" key names that should be used throughout the codebase.
+ */
+export declare const CANONICAL_SECRET_KEYS: readonly ["OPENAI_API_KEY", "ANTHROPIC_API_KEY", "GOOGLE_API_KEY", "GROQ_API_KEY", "XAI_API_KEY", "OPENROUTER_API_KEY", "MISTRAL_API_KEY", "COHERE_API_KEY", "TOGETHER_API_KEY", "FIREWORKS_API_KEY", "PERPLEXITY_API_KEY", "DEEPSEEK_API_KEY", "DISCORD_BOT_TOKEN", "DISCORD_APPLICATION_ID", "TELEGRAM_BOT_TOKEN", "SLACK_BOT_TOKEN", "SLACK_APP_TOKEN", "WHATSAPP_TOKEN", "SIGNAL_CLI_PATH", "TWITTER_USERNAME", "TWITTER_PASSWORD", "TWITTER_EMAIL", "TWITTER_2FA_SECRET", "ELEVENLABS_API_KEY", "ELEVENLABS_VOICE_ID", "ENCRYPTION_SALT", "DATABASE_URL", "OLLAMA_BASE_URL"];
+/**
+ * Type for canonical secret keys
+ */
+export type CanonicalSecretKey = (typeof CANONICAL_SECRET_KEYS)[number];
+/**
+ * Comprehensive mapping of model provider names to their API key environment variables.
+ * Used for detecting which AI provider is configured and for auto-enabling provider plugins.
+ */
+export declare const MODEL_PROVIDER_SECRETS: Record<string, string>;
+/**
+ * Model providers that don't require API keys (local inference).
+ * These are validated differently (check for URL availability).
+ */
+export declare const LOCAL_MODEL_PROVIDERS: readonly ["ollama"];
+/**
+ * Required secrets for each communication channel.
+ * Used to determine if a channel can be enabled.
+ */
+export declare const CHANNEL_SECRETS: Record<string, string[]>;
+/**
+ * Optional secrets for channels (enhance functionality but not required).
+ */
+export declare const CHANNEL_OPTIONAL_SECRETS: Record<string, string[]>;
+/**
+ * Resolve a secret key alias to its canonical name.
+ * If the key is not an alias, returns the original key.
+ *
+ * @param key - The secret key to resolve
+ * @returns The canonical key name
+ */
+export declare function resolveSecretKeyAlias(key: string): string;
+/**
+ * Check if a key is a known alias.
+ *
+ * @param key - The key to check
+ * @returns true if the key is an alias
+ */
+export declare function isSecretKeyAlias(key: string): boolean;
+/**
+ * Get all aliases for a canonical key.
+ *
+ * @param canonicalKey - The canonical key name
+ * @returns Array of alias names that map to this canonical key
+ */
+export declare function getAliasesForKey(canonicalKey: string): string[];
+/**
+ * Check if a key is a canonical secret key.
+ *
+ * @param key - The key to check
+ * @returns true if the key is in the canonical keys list
+ */
+export declare function isCanonicalSecretKey(key: string): key is CanonicalSecretKey;
+/**
+ * Get the model provider name for a given API key.
+ *
+ * @param apiKey - The API key environment variable name
+ * @returns The provider name, or null if not found
+ */
+export declare function getProviderForApiKey(apiKey: string): string | null;
+/**
+ * Get required secrets for a channel.
+ *
+ * @param channel - The channel name
+ * @returns Array of required secret key names
+ */
+export declare function getRequiredSecretsForChannel(channel: string): string[];
+/**
+ * Get all secrets (required + optional) for a channel.
+ *
+ * @param channel - The channel name
+ * @returns Object with required and optional secret arrays
+ */
+export declare function getAllSecretsForChannel(channel: string): {
+    required: string[];
+    optional: string[];
+};
+//# sourceMappingURL=secrets.d.ts.map

package/dist/constants/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../../src/constants/secrets.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA4DrD,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,mjBAwCxB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAMxE;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmBzD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,qBAAsB,CAAC;AAMzD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAOpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAG7D,CAAC;AAMF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAI/D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAE3E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOlE;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAEtE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG;IACzD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB,CAKA"}