@planu/cli 0.24.0 → 0.26.0

package/dist/engine/ai-cost-estimator/core.js

@@ -0,0 +1,257 @@
+// engine/ai-cost-estimator/core.ts — Orchestrates AI cost estimation for specs.
+// Coordinates token-estimator + model-pricing to produce AiCostEstimateResult.
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { loadPricingConfig, getAllModels, calculateCost, calculateAgentTurns, isPricingStale, } from './model-pricing.js';
+import { buildTokenEstimate } from './token-estimator.js';
+// ---------------------------------------------------------------------------
+// Complexity thresholds
+// ---------------------------------------------------------------------------
+const LOW_COMPLEXITY_MAX_AC = 5;
+const MEDIUM_COMPLEXITY_MAX_AC = 12;
+/** Returns the confidence range percentage based on number of acceptance criteria. */
+function getConfidenceRangePct(acCount) {
+    if (acCount <= LOW_COMPLEXITY_MAX_AC) {
+        return 20;
+    }
+    if (acCount <= MEDIUM_COMPLEXITY_MAX_AC) {
+        return 30;
+    }
+    return 40;
+}
+/** Returns the complexity level label for a given AC count. */
+function getComplexityLevel(acCount) {
+    if (acCount <= LOW_COMPLEXITY_MAX_AC) {
+        return 'low';
+    }
+    if (acCount <= MEDIUM_COMPLEXITY_MAX_AC) {
+        return 'medium';
+    }
+    return 'high';
+}
+// ---------------------------------------------------------------------------
+// Spec content loading
+// ---------------------------------------------------------------------------
+/**
+ * Reads spec content from a sdd/specs directory.
+ * Tries to find the spec directory by matching specId prefix.
+ */
+async function loadSpecContent(specId) {
+    const specsRoot = 'docs/sdd/specs';
+    let entries;
+    try {
+        const { readdir } = await import('node:fs/promises');
+        entries = await readdir(specsRoot);
+    }
+    catch {
+        throw new Error(`Spec directory not found at "${specsRoot}". ` +
+            'Make sure you are running from the project root.');
+    }
+    // Find a directory matching the specId (e.g., "SPEC-069" matches "SPEC-069-ai-cost-estimator")
+    const specDirName = entries.find((e) => e.startsWith(specId));
+    if (!specDirName) {
+        throw new Error(`Spec "${specId}" not found in "${specsRoot}". ` +
+            `Available specs: ${entries.slice(0, 5).join(', ')}...`);
+    }
+    const specDir = join(specsRoot, specDirName);
+    const parts = [];
+    for (const filename of ['HU.md', 'FICHA-TECNICA.md']) {
+        try {
+            const content = await readFile(join(specDir, filename), 'utf-8');
+            parts.push(content);
+        }
+        catch {
+            // File not present — skip (not fatal)
+        }
+    }
+    if (parts.length === 0) {
+        throw new Error(`Spec "${specId}" has no HU.md or FICHA-TECNICA.md in "${specDir}". ` +
+            'Cannot estimate without spec content.');
+    }
+    return { content: parts.join('\n\n'), specDir };
+}
+/** Counts acceptance criteria (lines starting with "- [ ]" or "- [x]") in spec content. */
+function countAcceptanceCriteria(specContent) {
+    const matches = specContent.match(/^- \[[ xX]\]/gm);
+    return matches?.length ?? 0;
+}
+// ---------------------------------------------------------------------------
+// Usage calibration
+// ---------------------------------------------------------------------------
+/** Reads average tokens per call from usage.json if available. */
+async function readUsageAvgTokensPerCall() {
+    try {
+        const { readFile: rf } = await import('node:fs/promises');
+        const raw = await rf('data/global/usage.json', 'utf-8');
+        /* v8 ignore start */
+        const log = JSON.parse(raw);
+        if (log.events.length === 0) {
+            return undefined;
+        }
+        // Usage events don't track token counts — return undefined to use defaults
+        return undefined;
+        /* v8 ignore stop */
+    }
+    catch {
+        return undefined;
+    }
+}
+// ---------------------------------------------------------------------------
+// Recommendation logic
+// ---------------------------------------------------------------------------
+/** Selects the recommended model based on spec complexity. */
+function selectRecommendedModel(models, complexity) {
+    const preferencesByComplexity = {
+        low: [
+            'claude-haiku-3-5',
+            'gemini-2-5-pro',
+            'gpt-4-1',
+            'gpt-4o',
+            'claude-sonnet-4',
+            'claude-opus-4',
+        ],
+        medium: [
+            'claude-sonnet-4',
+            'gpt-4o',
+            'gpt-4-1',
+            'gemini-2-5-pro',
+            'claude-haiku-3-5',
+            'claude-opus-4',
+        ],
+        high: [
+            'claude-opus-4',
+            'claude-sonnet-4',
+            'gpt-4o',
+            'gpt-4-1',
+            'gemini-2-5-pro',
+            'claude-haiku-3-5',
+        ],
+    };
+    const preferences = preferencesByComplexity[complexity] ?? preferencesByComplexity.medium ?? [];
+    for (const modelId of preferences) {
+        const model = models.find((m) => m.id === modelId);
+        if (model) {
+            return model;
+        }
+    }
+    // Fallback: cheapest model
+    /* v8 ignore start */
+    const sorted = [...models].sort((a, b) => a.inputPricePerMillion - b.inputPricePerMillion);
+    const first = sorted[0];
+    if (!first) {
+        throw new Error('No models available in pricing config');
+    }
+    return first;
+    /* v8 ignore stop */
+}
+/** Builds a human-readable recommendation reason. */
+function buildRecommendationReason(model, complexity, savingsVsMostExpensive) {
+    const complexityLabel = { low: 'baja', medium: 'media', high: 'alta' }[complexity];
+    const baseReason = `Para complejidad ${complexityLabel}, **${model.displayName}** ofrece `;
+    if (complexity === 'low') {
+        return (baseReason +
+            `el mejor precio sin sacrificar calidad. ` +
+            `Ahorro estimado vs modelo más caro: $${savingsVsMostExpensive.toFixed(4)} USD.`);
+    }
+    if (complexity === 'medium') {
+        return (baseReason +
+            `el mejor balance calidad/precio. ` +
+            `Ahorro estimado vs modelo más caro: $${savingsVsMostExpensive.toFixed(4)} USD.`);
+    }
+    return (baseReason +
+        `máxima calidad para specs complejas. ` +
+        `El costo adicional se justifica por la reducción de iteraciones.`);
+}
+// ---------------------------------------------------------------------------
+// Markdown formatting
+// ---------------------------------------------------------------------------
+/** Formats the cost estimates as a markdown table. */
+function formatMarkdownTable(estimates, recommendedModelId, recommendationReason, staleWarning) {
+    const header = '| Modelo | Tokens Input | Tokens Output | Costo Estimado | Rango (±) | Agent Turns |\n' +
+        '|--------|-------------|---------------|----------------|-----------|-------------|';
+    const rows = estimates.map((est) => {
+        const marker = est.modelId === recommendedModelId ? ' ⭐' : '';
+        const cost = `$${est.estimatedCostUsd.toFixed(4)}`;
+        const range = `±${est.confidenceRangePct}%`;
+        return (`| ${est.displayName}${marker} | ${est.inputTokens.toLocaleString()} | ` +
+            `${est.outputTokens.toLocaleString()} | ${cost} | ${range} | ${est.agentTurns} |`);
+    });
+    const recommended = estimates.find((e) => e.modelId === recommendedModelId);
+    const recommendedName = recommended?.displayName ?? recommendedModelId;
+    const lines = [
+        '## Estimación de Costo por Modelo IA',
+        '',
+        header,
+        ...rows,
+        '',
+        `## Recomendación: ${recommendedName}`,
+        '',
+        recommendationReason,
+    ];
+    if (staleWarning) {
+        lines.push('', `> **Aviso**: ${staleWarning}`);
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Main orchestrator
+// ---------------------------------------------------------------------------
+/**
+ * Estimates the AI cost for implementing a spec.
+ * Reads the spec from docs/sdd/specs/, loads pricing from config JSON,
+ * and returns a full AiCostEstimateResult with per-model breakdown.
+ */
+export async function estimateAiCost(input) {
+    const { specId, projectPath } = input;
+    // 1. Load spec content
+    const { content: specContent } = await loadSpecContent(specId);
+    const acCount = countAcceptanceCriteria(specContent);
+    // 2. Load pricing config
+    const config = await loadPricingConfig();
+    const models = await getAllModels();
+    // 3. Build token estimate
+    const usageAvg = await readUsageAvgTokensPerCall();
+    const tokenEstimate = await buildTokenEstimate(specContent, 0, // No pre-existing LOC estimate — use AC-based fallback
+    acCount, projectPath, config, usageAvg);
+    // 4. Determine complexity + confidence
+    const complexity = getComplexityLevel(acCount);
+    const confidenceRangePct = getConfidenceRangePct(acCount);
+    // 5. Calculate per-model estimates
+    const estimates = models.map((model) => {
+        const estimatedCostUsd = calculateCost(model, tokenEstimate.inputTokens, tokenEstimate.outputTokens);
+        const agentTurns = calculateAgentTurns(model, tokenEstimate.locToGenerate);
+        return {
+            modelId: model.id,
+            displayName: model.displayName,
+            inputTokens: tokenEstimate.inputTokens,
+            outputTokens: tokenEstimate.outputTokens,
+            estimatedCostUsd,
+            confidenceRangePct,
+            agentTurns,
+        };
+    });
+    // 6. Determine recommendation
+    const recommendedModel = selectRecommendedModel(models, complexity);
+    // Calculate savings vs most expensive model
+    const maxCost = Math.max(...estimates.map((e) => e.estimatedCostUsd));
+    const recommendedEstimate = estimates.find((e) => e.modelId === recommendedModel.id);
+    const recommendedCost = recommendedEstimate?.estimatedCostUsd ?? 0;
+    const savingsVsExpensiveModel = Math.max(0, maxCost - recommendedCost);
+    const recommendationReason = buildRecommendationReason(recommendedModel, complexity, savingsVsExpensiveModel);
+    // 7. Check if pricing is stale
+    const staleWarning = isPricingStale(config.lastUpdated)
+        ? `Los precios del modelo pueden estar desactualizados (última actualización: ${config.lastUpdated}). ` +
+            'Verifica los precios actuales en la documentación de cada proveedor.'
+        : '';
+    // 8. Format markdown table
+    const markdownTable = formatMarkdownTable(estimates, recommendedModel.id, recommendationReason, staleWarning);
+    return {
+        specId,
+        estimates,
+        recommendedModelId: recommendedModel.id,
+        recommendationReason,
+        savingsVsExpensiveModel,
+        markdownTable,
+    };
+}
+//# sourceMappingURL=core.js.map

package/dist/engine/ai-cost-estimator/core.js.map

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

package/dist/engine/ai-cost-estimator/index.d.ts

@@ -0,0 +1,4 @@
+export { estimateAiCost } from './core.js';
+export { loadPricingConfig, clearPricingCache, getAllModels, findModel, calculateCost, calculateAgentTurns, isPricingStale, } from './model-pricing.js';
+export { detectProjectLanguage, estimateInputTokens, estimateOutputTokens, estimateLocFromAcCount, buildTokenEstimate, } from './token-estimator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/ai-cost-estimator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/ai-cost-estimator/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC"}

package/dist/engine/ai-cost-estimator/index.js

@@ -0,0 +1,5 @@
+// engine/ai-cost-estimator/index.ts — Barrel re-export for the ai-cost-estimator module.
+export { estimateAiCost } from './core.js';
+export { loadPricingConfig, clearPricingCache, getAllModels, findModel, calculateCost, calculateAgentTurns, isPricingStale, } from './model-pricing.js';
+export { detectProjectLanguage, estimateInputTokens, estimateOutputTokens, estimateLocFromAcCount, buildTokenEstimate, } from './token-estimator.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/ai-cost-estimator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/ai-cost-estimator/index.ts"],"names":[],"mappings":"AAAA,yFAAyF;AAEzF,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC"}

package/dist/engine/ai-cost-estimator/model-pricing.d.ts

@@ -0,0 +1,31 @@
+import type { AiModelConfig, AiModelPricingConfig } from '../../types/index.js';
+/**
+ * Loads the AI model pricing configuration from disk.
+ * Results are cached after the first load.
+ */
+export declare function loadPricingConfig(): Promise<AiModelPricingConfig>;
+/** Clears the in-memory cache (used in tests). */
+export declare function clearPricingCache(): void;
+/**
+ * Returns all configured AI models.
+ */
+export declare function getAllModels(): Promise<readonly AiModelConfig[]>;
+/**
+ * Finds a model by its ID. Returns null if not found.
+ */
+export declare function findModel(modelId: string): Promise<AiModelConfig | null>;
+/**
+ * Calculates the estimated cost in USD for a given model and token counts.
+ *
+ * Formula: (inputTokens / 1_000_000 × inputPrice) + (outputTokens / 1_000_000 × outputPrice)
+ */
+export declare function calculateCost(model: AiModelConfig, inputTokens: number, outputTokens: number): number;
+/**
+ * Returns the number of agent turns needed to generate the given LOC count.
+ */
+export declare function calculateAgentTurns(model: AiModelConfig, locToGenerate: number): number;
+/**
+ * Returns true if the pricing config is older than STALE_DAYS days.
+ */
+export declare function isPricingStale(lastUpdated: string): boolean;
+//# sourceMappingURL=model-pricing.d.ts.map

package/dist/engine/ai-cost-estimator/model-pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-pricing.d.ts","sourceRoot":"","sources":["../../../src/engine/ai-cost-estimator/model-pricing.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAkBhF;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAoBvE;AAED,kDAAkD;AAClD,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAMD;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAGtE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAG9E;AAMD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAKvF;AAQD;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAM3D"}

package/dist/engine/ai-cost-estimator/model-pricing.js

@@ -0,0 +1,96 @@
+// engine/ai-cost-estimator/model-pricing.ts — Loads AI model pricing from config JSON.
+// Provides model lookup, cost calculation, and pricing config access.
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Config loading
+// ---------------------------------------------------------------------------
+const CONFIG_FILENAME = 'ai-model-pricing.json';
+/** Resolve the path to the config file relative to this module. */
+function resolveConfigPath() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    return join(__dirname, '../../config', CONFIG_FILENAME);
+}
+/** Cache to avoid repeated disk reads within a process lifetime. */
+let cachedConfig = null;
+/**
+ * Loads the AI model pricing configuration from disk.
+ * Results are cached after the first load.
+ */
+export async function loadPricingConfig() {
+    if (cachedConfig !== null) {
+        return cachedConfig;
+    }
+    const configPath = resolveConfigPath();
+    try {
+        const raw = await readFile(configPath, 'utf-8');
+        cachedConfig = JSON.parse(raw);
+        return cachedConfig;
+        /* v8 ignore start */
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        throw new Error(`[Planu] Failed to load AI model pricing config from ${configPath}: ${reason}`, { cause: err });
+    }
+    /* v8 ignore stop */
+}
+/** Clears the in-memory cache (used in tests). */
+export function clearPricingCache() {
+    cachedConfig = null;
+}
+// ---------------------------------------------------------------------------
+// Model lookup
+// ---------------------------------------------------------------------------
+/**
+ * Returns all configured AI models.
+ */
+export async function getAllModels() {
+    const config = await loadPricingConfig();
+    return config.models;
+}
+/**
+ * Finds a model by its ID. Returns null if not found.
+ */
+export async function findModel(modelId) {
+    const models = await getAllModels();
+    return models.find((m) => m.id === modelId) ?? null;
+}
+// ---------------------------------------------------------------------------
+// Cost calculation
+// ---------------------------------------------------------------------------
+/**
+ * Calculates the estimated cost in USD for a given model and token counts.
+ *
+ * Formula: (inputTokens / 1_000_000 × inputPrice) + (outputTokens / 1_000_000 × outputPrice)
+ */
+export function calculateCost(model, inputTokens, outputTokens) {
+    const inputCost = (inputTokens / 1_000_000) * model.inputPricePerMillion;
+    const outputCost = (outputTokens / 1_000_000) * model.outputPricePerMillion;
+    return inputCost + outputCost;
+}
+/**
+ * Returns the number of agent turns needed to generate the given LOC count.
+ */
+export function calculateAgentTurns(model, locToGenerate) {
+    if (model.avgThroughputLOCPerTurn <= 0) {
+        return 1;
+    }
+    return Math.ceil(locToGenerate / model.avgThroughputLOCPerTurn);
+}
+// ---------------------------------------------------------------------------
+// Price staleness check
+// ---------------------------------------------------------------------------
+const STALE_DAYS = 30;
+/**
+ * Returns true if the pricing config is older than STALE_DAYS days.
+ */
+export function isPricingStale(lastUpdated) {
+    const updatedDate = new Date(lastUpdated);
+    const now = new Date();
+    const diffMs = now.getTime() - updatedDate.getTime();
+    const diffDays = diffMs / (1000 * 60 * 60 * 24);
+    return diffDays > STALE_DAYS;
+}
+//# sourceMappingURL=model-pricing.js.map

package/dist/engine/ai-cost-estimator/model-pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-pricing.js","sourceRoot":"","sources":["../../../src/engine/ai-cost-estimator/model-pricing.ts"],"names":[],"mappings":"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"}

package/dist/engine/ai-cost-estimator/token-estimator.d.ts

@@ -0,0 +1,37 @@
+import type { TokenEstimate, AiModelPricingConfig } from '../../types/index.js';
+/**
+ * Detects the primary programming language of a project by checking config files.
+ * Falls back to scanning source file extensions.
+ */
+export declare function detectProjectLanguage(projectPath: string): Promise<string>;
+/**
+ * Estimates input tokens for an AI agent session based on three components:
+ * 1. Spec content (HU.md + FICHA-TECNICA.md)
+ * 2. Codebase context (if projectPath is provided)
+ * 3. MCP tool definitions overhead (fixed constant)
+ */
+export declare function estimateInputTokens(specContent: string, projectPath: string | undefined, config: AiModelPricingConfig): Promise<{
+    inputTokens: number;
+    specContentTokens: number;
+    codebaseContextTokens: number;
+    toolDefinitionsTokens: number;
+}>;
+/**
+ * Estimates output tokens (code to be generated) for a spec.
+ *
+ * Priority:
+ * 1. Use LOC from existing estimate if available
+ * 2. Fallback: number of ACs × DEFAULT_LOC_PER_AC
+ * 3. Calibrate with usage.json average if available
+ */
+export declare function estimateOutputTokens(locToGenerate: number, language: string, config: AiModelPricingConfig, usageAvgTokensPerCall?: number): number;
+/**
+ * Estimates LOC to generate based on the number of acceptance criteria.
+ * Used as a fallback when no existing estimate is available.
+ */
+export declare function estimateLocFromAcCount(acCount: number): number;
+/**
+ * Produces a complete TokenEstimate for a spec.
+ */
+export declare function buildTokenEstimate(specContent: string, locToGenerate: number, acCount: number, projectPath: string | undefined, config: AiModelPricingConfig, usageAvgTokensPerCall?: number): Promise<TokenEstimate>;
+//# sourceMappingURL=token-estimator.d.ts.map

package/dist/engine/ai-cost-estimator/token-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.d.ts","sourceRoot":"","sources":["../../../src/engine/ai-cost-estimator/token-estimator.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AA4ChF;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAchF;AA0DD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC;IACT,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC,CAuBD;AAMD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,oBAAoB,EAC5B,qBAAqB,CAAC,EAAE,MAAM,GAC7B,MAAM,CAoBR;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9D;AAMD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,MAAM,EAAE,oBAAoB,EAC5B,qBAAqB,CAAC,EAAE,MAAM,GAC7B,OAAO,CAAC,aAAa,CAAC,CAwBxB"}