hazo_llm_api 1.0.3 → 1.0.4

package/dist/lib/llm_api/types.d.ts

@@ -1,525 +0,0 @@
-/**
- * LLM API Types
- *
- * TypeScript interfaces and types for the LLM API module.
- * Includes configuration, function parameters, and response types.
- */
-import type { ServiceType, ProviderName } from '../providers/types.js';
-/**
- * Logger interface matching Winston logger methods
- * Parent application provides this logger instance
- */
-export interface Logger {
-    error: (message: string, meta?: Record<string, unknown>) => void;
-    info: (message: string, meta?: Record<string, unknown>) => void;
-    warn: (message: string, meta?: Record<string, unknown>) => void;
-    debug: (message: string, meta?: Record<string, unknown>) => void;
-}
-/**
- * Gemini API generation configuration parameters
- * All parameters are optional - only include in API calls if explicitly set
- *
- * Note: This is used internally by the Gemini provider.
- * Configure via hazo_llm_api_config.ini [llm_gemini] section instead of passing directly.
- */
-export interface GeminiGenerationConfig {
-    /** Controls randomness in output (0.0-2.0). Lower = more deterministic */
-    temperature?: number;
-    /** Maximum number of tokens in the response */
-    max_output_tokens?: number;
-    /** Nucleus sampling probability (0.0-1.0). Considers tokens up to cumulative probability */
-    top_p?: number;
-    /** Top-k sampling. Considers only the top K most probable tokens */
-    top_k?: number;
-    /** Number of response candidates to generate (1-8) */
-    candidate_count?: number;
-    /** Sequences that stop generation when encountered */
-    stop_sequences?: string[];
-    /** Format of the response: "text/plain" or "application/json" */
-    response_mime_type?: string;
-}
-/**
- * Context passed to beforeRequest hook
- */
-export interface LLMRequestContext {
-    /** Service type being called */
-    service_type: ServiceType;
-    /** Provider name */
-    provider: string;
-    /** Request parameters (type varies by service) */
-    params: Record<string, unknown>;
-    /** Timestamp when request started */
-    timestamp: Date;
-}
-/**
- * Context passed to afterResponse hook
- */
-export interface LLMResponseContext extends LLMRequestContext {
-    /** The response from the LLM */
-    response: LLMResponse;
-    /** Duration of the request in milliseconds */
-    duration_ms: number;
-}
-/**
- * Context passed to onError hook
- */
-export interface LLMErrorContext extends LLMRequestContext {
-    /** The error that occurred */
-    error: LLMError;
-    /** Duration until error in milliseconds */
-    duration_ms: number;
-}
-/**
- * Hook function called before each LLM request
- * Can be async for logging to external services
- */
-export type BeforeRequestHook = (context: LLMRequestContext) => void | Promise<void>;
-/**
- * Hook function called after each successful LLM response
- * Can be async for logging/analytics
- */
-export type AfterResponseHook = (context: LLMResponseContext) => void | Promise<void>;
-/**
- * Hook function called when an error occurs
- * Can be async for error reporting
- */
-export type OnErrorHook = (context: LLMErrorContext) => void | Promise<void>;
-/**
- * Lifecycle hooks for LLM API calls
- * All hooks are optional and can be async
- *
- * @example
- * ```typescript
- * await initialize_llm_api({
- *   hooks: {
- *     beforeRequest: (ctx) => {
- *       console.log(`Calling ${ctx.provider}.${ctx.service_type}`);
- *     },
- *     afterResponse: (ctx) => {
- *       console.log(`Response in ${ctx.duration_ms}ms`);
- *     },
- *     onError: (ctx) => {
- *       console.error(`Error: ${ctx.error.code}`);
- *     },
- *   },
- * });
- * ```
- */
-export interface LLMHooks {
-    /** Called before each LLM request */
-    beforeRequest?: BeforeRequestHook;
-    /** Called after each successful LLM response */
-    afterResponse?: AfterResponseHook;
-    /** Called when an error occurs */
-    onError?: OnErrorHook;
-}
-/**
- * Configuration options for initializing the LLM API
- * Supports provider-based architecture where providers are loaded from config file
- *
- * All configuration fields are optional - the API will use sensible defaults:
- * - logger: Default console logger
- * - sqlite_path: From config file or "prompt_library.sqlite" in cwd
- * - hooks: None
- *
- * @example
- * ```typescript
- * // Minimal initialization
- * await initialize_llm_api({});
- *
- * // With custom logger and hooks
- * await initialize_llm_api({
- *   logger: myLogger,
- *   hooks: {
- *     beforeRequest: (ctx) => console.log(`Calling ${ctx.provider}`),
- *   },
- * });
- * ```
- */
-export interface LLMApiConfig {
-    /**
-     * Logger instance from parent application
-     * Optional - if not provided, uses default console logger
-     */
-    logger?: Logger;
-    /**
-     * Path to SQLite database file
-     * Supports: relative paths, absolute paths, ~ expansion, environment variables
-     * Default: "prompt_library.sqlite" (relative to process.cwd())
-     */
-    sqlite_path?: string;
-    /**
-     * Lifecycle hooks for monitoring, logging, and analytics
-     * Optional - hooks are called at various points during LLM API calls
-     */
-    hooks?: LLMHooks;
-}
-/**
- * Single prompt variable key-value pair
- */
-export interface PromptVariable {
-    [key: string]: string;
-}
-/**
- * Array of prompt variables for substitution
- * Format: [{ "variable1": "value1", "variable2": "value2" }]
- */
-export type PromptVariables = PromptVariable[];
-/**
- * Base64 encoded data with MIME type
- * Used for sending images/files to LLM APIs
- */
-export interface Base64Data {
-    /** MIME type of the data (e.g., "image/jpeg", "image/png") */
-    mime_type: string;
-    /** Base64 encoded string of the data */
-    data: string;
-}
-/**
- * Prompt text mode - determines how prompt text is obtained
- */
-export type PromptTextMode = 'static' | 'dynamic';
-/**
- * Parameters for the call_llm function
- */
-export interface CallLLMParams {
-    /** Area/category of the prompt (required for dynamic mode) */
-    prompt_area?: string;
-    /** Key identifier for the prompt (required for dynamic mode) */
-    prompt_key?: string;
-    /** Variables to substitute in the prompt text */
-    prompt_variables?: PromptVariables;
-    /** Base64 encoded data to include in the prompt (images, etc.) */
-    prompt_b64_data?: Base64Data[];
-    /** Static prompt text (required for static mode) */
-    static_prompt?: string;
-    /** Mode for obtaining prompt text: "static" uses static_prompt, "dynamic" fetches from database */
-    prompt_text_mode: PromptTextMode;
-}
-/**
- * Prompt record from the prompts_library table
- */
-export interface PromptRecord {
-    /** Unique identifier for the prompt */
-    uuid: string;
-    /** Area/category of the prompt */
-    prompt_area: string;
-    /** Key identifier for the prompt */
-    prompt_key: string;
-    /** The actual prompt text */
-    prompt_text: string;
-    /** JSON string of variables used in the prompt */
-    prompt_variables: string;
-    /** Additional notes about the prompt */
-    prompt_notes: string;
-    /** Timestamp when the record was created */
-    created_at: string;
-    /** Timestamp when the record was last changed */
-    changed_by: string;
-}
-/**
- * Error codes for LLM API errors
- * Use these codes for programmatic error handling
- *
- * @example
- * ```typescript
- * import { LLM_ERROR_CODES } from 'hazo_llm_api/server';
- *
- * if (response.error_info?.code === LLM_ERROR_CODES.RATE_LIMITED) {
- *   // Implement retry logic
- * }
- * ```
- */
-export declare const LLM_ERROR_CODES: {
-    /** Provider not found in registry */
-    readonly PROVIDER_NOT_FOUND: "PROVIDER_NOT_FOUND";
-    /** Provider is not enabled in configuration */
-    readonly PROVIDER_NOT_ENABLED: "PROVIDER_NOT_ENABLED";
-    /** Provider does not support the requested service type */
-    readonly CAPABILITY_NOT_SUPPORTED: "CAPABILITY_NOT_SUPPORTED";
-    /** API key is missing or invalid */
-    readonly API_KEY_MISSING: "API_KEY_MISSING";
-    /** Rate limit exceeded */
-    readonly RATE_LIMITED: "RATE_LIMITED";
-    /** Network error (connection failed, timeout, etc.) */
-    readonly NETWORK_ERROR: "NETWORK_ERROR";
-    /** Invalid request parameters */
-    readonly INVALID_REQUEST: "INVALID_REQUEST";
-    /** API returned an error */
-    readonly API_ERROR: "API_ERROR";
-    /** Request timed out */
-    readonly TIMEOUT: "TIMEOUT";
-    /** Database error */
-    readonly DATABASE_ERROR: "DATABASE_ERROR";
-    /** Prompt not found */
-    readonly PROMPT_NOT_FOUND: "PROMPT_NOT_FOUND";
-    /** Unknown/unexpected error */
-    readonly UNKNOWN: "UNKNOWN";
-};
-/**
- * Type for LLM error codes
- */
-export type LLMErrorCode = typeof LLM_ERROR_CODES[keyof typeof LLM_ERROR_CODES];
-/**
- * Structured error information for LLM API responses
- * Provides detailed error information for programmatic handling
- */
-export interface LLMError {
-    /** Error code for programmatic handling */
-    code: LLMErrorCode;
-    /** Human-readable error message */
-    message: string;
-    /** Whether this error is potentially retryable */
-    retryable: boolean;
-    /** Original error details (if applicable) */
-    details?: Record<string, unknown>;
-}
-/**
- * Generic LLM API response
- */
-export interface LLMResponse {
-    /** Whether the API call was successful */
-    success: boolean;
-    /** The generated text response from the LLM */
-    text?: string;
-    /**
-     * Error message if the call failed
-     * @deprecated Use error_info for structured error data
-     */
-    error?: string;
-    /** Structured error information (new in v2.0) */
-    error_info?: LLMError;
-    /** Raw response from the API */
-    raw_response?: unknown;
-    /** Base64 encoded image data (for image output functions) */
-    image_b64?: string;
-    /** MIME type of the generated image */
-    image_mime_type?: string;
-}
-/**
- * A single chunk from a streaming LLM response
- */
-export interface LLMStreamChunk {
-    /** The text content of this chunk */
-    text: string;
-    /** Whether this is the final chunk */
-    done: boolean;
-    /**
-     * Error message if streaming failed
-     * @deprecated Use error_info for structured error data
-     */
-    error?: string;
-    /** Structured error information if streaming failed */
-    error_info?: LLMError;
-}
-/**
- * Async iterator for streaming LLM responses
- *
- * @example
- * ```typescript
- * const stream = await hazo_llm_text_text_stream({ prompt: 'Hello' });
- *
- * for await (const chunk of stream) {
- *   if (chunk.error) {
- *     console.error(chunk.error);
- *     break;
- *   }
- *   process.stdout.write(chunk.text);
- *   if (chunk.done) break;
- * }
- * ```
- */
-export type LLMStreamResponse = AsyncGenerator<LLMStreamChunk, void, unknown>;
-/**
- * Parameters for hazo_llm_text_text (text input → text output)
- */
-export interface TextTextParams {
-    /** Static prompt text */
-    prompt: string;
-    /** Variables to substitute in the prompt text */
-    prompt_variables?: PromptVariables;
-    /** Area/category for dynamic prompt (optional) */
-    prompt_area?: string;
-    /** Key for dynamic prompt (optional) */
-    prompt_key?: string;
-}
-/**
- * Parameters for hazo_llm_image_text (image input → text output)
- */
-export interface ImageTextParams {
-    /** Prompt/instruction for analyzing the image */
-    prompt: string;
-    /** Base64 encoded image data */
-    image_b64: string;
-    /** MIME type of the image (e.g., "image/jpeg", "image/png") */
-    image_mime_type: string;
-    /** Variables to substitute in the prompt text */
-    prompt_variables?: PromptVariables;
-}
-/**
- * Parameters for hazo_llm_text_image (text input → image output)
- */
-export interface TextImageParams {
-    /** Text prompt describing the image to generate */
-    prompt: string;
-    /** Variables to substitute in the prompt text */
-    prompt_variables?: PromptVariables;
-}
-/**
- * Parameters for hazo_llm_image_image (image input → image output)
- */
-export interface ImageImageParams {
-    /** Prompt/instruction for transforming the image(s) */
-    prompt: string;
-    /** Base64 encoded input image data (for single image, use this OR images array) */
-    image_b64?: string;
-    /** MIME type of the input image (for single image) */
-    image_mime_type?: string;
-    /** Array of input images (for multiple images) */
-    images?: Base64Data[];
-    /** Variables to substitute in the prompt text */
-    prompt_variables?: PromptVariables;
-}
-/**
- * Parameters for hazo_llm_text_image_text (text → image → text)
- * Generates an image from prompt_image, then analyzes it with prompt_text
- */
-export interface TextImageTextParams {
-    /** Prompt for image generation (step 1) */
-    prompt_image: string;
-    /** Prompt for analyzing the generated image (step 2) */
-    prompt_text: string;
-    /** Variables to substitute in the image generation prompt */
-    prompt_image_variables?: PromptVariables;
-    /** Variables to substitute in the text analysis prompt */
-    prompt_text_variables?: PromptVariables;
-}
-/**
- * Base64 image data for chained operations
- */
-export interface ChainImage {
-    /** Base64 encoded image data */
-    image_b64: string;
-    /** MIME type of the image */
-    image_mime_type: string;
-}
-/**
- * Parameters for hazo_llm_image_image_text (images → image → text)
- * Chain multiple image transformations, then describe the final result
- *
- * Flow:
- * 1. Combine images[0] + images[1] using prompts[0] → result_1
- * 2. Combine result_1 + images[2] using prompts[1] → result_2
- * 3. Continue chaining through all images
- * 4. Analyze final result with description_prompt → text output
- *
- * Requirements:
- * - Minimum 2 images required
- * - Number of prompts = number of images - 1
- */
-export interface ImageImageTextParams {
-    /** Array of images to chain (minimum 2) */
-    images: ChainImage[];
-    /** Array of transformation prompts (length = images.length - 1) */
-    prompts: string[];
-    /** Final prompt for describing the last generated image */
-    description_prompt: string;
-    /** Variables to substitute in the description prompt */
-    description_prompt_variables?: PromptVariables;
-}
-/**
- * Gemini API text part
- */
-export interface GeminiTextPart {
-    text: string;
-}
-/**
- * Gemini API inline data part (for images)
- */
-export interface GeminiInlineDataPart {
-    inline_data: {
-        mime_type: string;
-        data: string;
-    };
-}
-/**
- * Gemini API part (either text or inline data)
- */
-export type GeminiPart = GeminiTextPart | GeminiInlineDataPart;
-/**
- * Gemini API content structure
- */
-export interface GeminiContent {
-    parts: GeminiPart[];
-}
-/**
- * Gemini API generation config in request format (camelCase for API)
- */
-export interface GeminiApiGenerationConfig {
-    temperature?: number;
-    maxOutputTokens?: number;
-    topP?: number;
-    topK?: number;
-    candidateCount?: number;
-    stopSequences?: string[];
-    responseMimeType?: string;
-}
-/**
- * Gemini API request body
- */
-export interface GeminiRequestBody {
-    contents: GeminiContent[];
-    generationConfig?: GeminiApiGenerationConfig;
-}
-/**
- * Gemini API response candidate
- */
-export interface GeminiCandidate {
-    content: {
-        parts: Array<{
-            text: string;
-        }>;
-        role: string;
-    };
-    finishReason: string;
-    index: number;
-}
-/**
- * Gemini API response structure
- */
-export interface GeminiApiResponse {
-    candidates?: GeminiCandidate[];
-    promptFeedback?: {
-        safetyRatings: Array<{
-            category: string;
-            probability: string;
-        }>;
-    };
-    error?: {
-        code: number;
-        message: string;
-        status: string;
-    };
-}
-/**
- * Initialized LLM API client instance
- */
-export interface LLMApiClient {
-    /** Configuration used to initialize the client */
-    config: LLMApiConfig;
-    /** Whether the database has been initialized */
-    db_initialized: boolean;
-    /** Text input → Text output */
-    hazo_llm_text_text: (params: TextTextParams, llm?: ProviderName) => Promise<LLMResponse>;
-    /** Image input → Text output (image analysis) */
-    hazo_llm_image_text: (params: ImageTextParams, llm?: ProviderName) => Promise<LLMResponse>;
-    /** Text input → Image output (image generation) */
-    hazo_llm_text_image: (params: TextImageParams, llm?: ProviderName) => Promise<LLMResponse>;
-    /** Image input → Image output (image transformation) */
-    hazo_llm_image_image: (params: ImageImageParams, llm?: ProviderName) => Promise<LLMResponse>;
-    /** Text → Image → Text (generate image then analyze it) */
-    hazo_llm_text_image_text: (params: TextImageTextParams, llm?: ProviderName) => Promise<LLMResponse>;
-    /** Images → Image → Text (chain image transformations then describe) */
-    hazo_llm_image_image_text: (params: ImageImageTextParams, llm?: ProviderName) => Promise<LLMResponse>;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/lib/llm_api/types.d.ts.map

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

package/dist/lib/llm_api/types.js

@@ -1,49 +0,0 @@
-/**
- * LLM API Types
- *
- * TypeScript interfaces and types for the LLM API module.
- * Includes configuration, function parameters, and response types.
- */
-// =============================================================================
-// LLM Error Types
-// =============================================================================
-/**
- * Error codes for LLM API errors
- * Use these codes for programmatic error handling
- *
- * @example
- * ```typescript
- * import { LLM_ERROR_CODES } from 'hazo_llm_api/server';
- *
- * if (response.error_info?.code === LLM_ERROR_CODES.RATE_LIMITED) {
- *   // Implement retry logic
- * }
- * ```
- */
-export const LLM_ERROR_CODES = {
-    /** Provider not found in registry */
-    PROVIDER_NOT_FOUND: 'PROVIDER_NOT_FOUND',
-    /** Provider is not enabled in configuration */
-    PROVIDER_NOT_ENABLED: 'PROVIDER_NOT_ENABLED',
-    /** Provider does not support the requested service type */
-    CAPABILITY_NOT_SUPPORTED: 'CAPABILITY_NOT_SUPPORTED',
-    /** API key is missing or invalid */
-    API_KEY_MISSING: 'API_KEY_MISSING',
-    /** Rate limit exceeded */
-    RATE_LIMITED: 'RATE_LIMITED',
-    /** Network error (connection failed, timeout, etc.) */
-    NETWORK_ERROR: 'NETWORK_ERROR',
-    /** Invalid request parameters */
-    INVALID_REQUEST: 'INVALID_REQUEST',
-    /** API returned an error */
-    API_ERROR: 'API_ERROR',
-    /** Request timed out */
-    TIMEOUT: 'TIMEOUT',
-    /** Database error */
-    DATABASE_ERROR: 'DATABASE_ERROR',
-    /** Prompt not found */
-    PROMPT_NOT_FOUND: 'PROMPT_NOT_FOUND',
-    /** Unknown/unexpected error */
-    UNKNOWN: 'UNKNOWN',
-};
-//# sourceMappingURL=types.js.map

package/dist/lib/llm_api/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/llm_api/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoSH,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,qCAAqC;IACrC,kBAAkB,EAAE,oBAAoB;IACxC,+CAA+C;IAC/C,oBAAoB,EAAE,sBAAsB;IAC5C,2DAA2D;IAC3D,wBAAwB,EAAE,0BAA0B;IACpD,oCAAoC;IACpC,eAAe,EAAE,iBAAiB;IAClC,0BAA0B;IAC1B,YAAY,EAAE,cAAc;IAC5B,uDAAuD;IACvD,aAAa,EAAE,eAAe;IAC9B,iCAAiC;IACjC,eAAe,EAAE,iBAAiB;IAClC,4BAA4B;IAC5B,SAAS,EAAE,WAAW;IACtB,wBAAwB;IACxB,OAAO,EAAE,SAAS;IAClB,qBAAqB;IACrB,cAAc,EAAE,gBAAgB;IAChC,uBAAuB;IACvB,gBAAgB,EAAE,kBAAkB;IACpC,+BAA+B;IAC/B,OAAO,EAAE,SAAS;CACV,CAAC"}

package/dist/lib/prompts/get_prompt.d.ts

@@ -1,50 +0,0 @@
-/**
- * Prompt Retrieval Module
- *
- * Functions to retrieve prompts from the prompts_library database table.
- * Searches by prompt_area and prompt_key to find the prompt_text.
- */
-import type { Database as SqlJsDatabase } from 'sql.js';
-import type { Logger, PromptRecord } from '../llm_api/types.js';
-/**
- * Retrieve a prompt from the database by prompt_area and prompt_key
- * @param db - Database instance
- * @param prompt_area - Area/category of the prompt
- * @param prompt_key - Key identifier for the prompt
- * @param logger - Logger instance
- * @returns The prompt record if found, null otherwise
- */
-export declare function get_prompt_by_area_and_key(db: SqlJsDatabase, prompt_area: string, prompt_key: string, logger: Logger): PromptRecord | null;
-/**
- * Retrieve the prompt text only by prompt_area and prompt_key
- * @param db - Database instance
- * @param prompt_area - Area/category of the prompt
- * @param prompt_key - Key identifier for the prompt
- * @param logger - Logger instance
- * @returns The prompt text if found, null otherwise
- */
-export declare function get_prompt_text(db: SqlJsDatabase, prompt_area: string, prompt_key: string, logger: Logger): string | null;
-/**
- * Get all prompts by prompt_area
- * @param db - Database instance
- * @param prompt_area - Area/category of the prompts
- * @param logger - Logger instance
- * @returns Array of prompt records
- */
-export declare function get_prompts_by_area(db: SqlJsDatabase, prompt_area: string, logger: Logger): PromptRecord[];
-/**
- * Get a prompt by its UUID
- * @param db - Database instance
- * @param uuid - UUID of the prompt
- * @param logger - Logger instance
- * @returns The prompt record if found, null otherwise
- */
-export declare function get_prompt_by_uuid(db: SqlJsDatabase, uuid: string, logger: Logger): PromptRecord | null;
-/**
- * Get all prompts from the library
- * @param db - Database instance
- * @param logger - Logger instance
- * @returns Array of all prompt records
- */
-export declare function get_all_prompts(db: SqlJsDatabase, logger: Logger): PromptRecord[];
-//# sourceMappingURL=get_prompt.d.ts.map

package/dist/lib/prompts/get_prompt.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"get_prompt.d.ts","sourceRoot":"","sources":["../../../src/lib/prompts/get_prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOhE;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,aAAa,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,YAAY,GAAG,IAAI,CAmDrB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,aAAa,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAmBf;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,aAAa,EACjB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,YAAY,EAAE,CA8ChB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,YAAY,GAAG,IAAI,CA8CrB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,aAAa,EACjB,MAAM,EAAE,MAAM,GACb,YAAY,EAAE,CA6ChB"}