@nac3/forge-cli 0.2.0-alpha.9 → 0.2.1-alpha.60

package/dist/core/provider_models.js

@@ -0,0 +1,169 @@
+/**
+ * provider_models.ts -- listado de modelos por provider (PND-069).
+ *
+ * El panel de config necesita un selector de modelo por provider
+ * que NO dependa de listas hardcodeadas que driftean. Estrategia:
+ *
+ *   1. Con API key en el vault: consultar el endpoint de listado
+ *      del provider (Anthropic /v1/models, OpenAI /v1/models,
+ *      Google /v1beta/models). Cache en memoria 10 min.
+ *   2. Sin key o con el endpoint caido: lista estatica embebida
+ *      (los modelos estables conocidos a la fecha del build) con
+ *      flag `source: 'static'` para que la UI lo muestre.
+ *
+ * Las keys nunca viajan en query strings (headers siempre) ni se
+ * loguean. ASCII-only.
+ */
+import { getKey } from './provider_keys.js';
+import { vaultSlotForProvider } from './brain_config.js';
+/* Fallback estatico -- modelos estables al momento del build.
+ * Mantener corto: es solo para que el selector no quede vacio
+ * offline (la leccion de keys_setup PND-056/CR-D12). */
+const STATIC_MODELS = {
+    anthropic: [
+        { id: 'claude-opus-4-7', display_name: 'Claude Opus 4.7' },
+        { id: 'claude-sonnet-4-6', display_name: 'Claude Sonnet 4.6' },
+        { id: 'claude-haiku-4-5-20251001', display_name: 'Claude Haiku 4.5' },
+    ],
+    google_ai: [
+        { id: 'gemini-2.5-pro', display_name: 'Gemini 2.5 Pro' },
+        { id: 'gemini-2.5-flash', display_name: 'Gemini 2.5 Flash' },
+        { id: 'gemini-2.5-flash-lite', display_name: 'Gemini 2.5 Flash Lite' },
+    ],
+    openai: [
+        { id: 'gpt-4o', display_name: 'GPT-4o' },
+        { id: 'gpt-4o-mini', display_name: 'GPT-4o mini' },
+    ],
+    deepseek: [
+        { id: 'deepseek-chat', display_name: 'DeepSeek Chat' },
+        { id: 'deepseek-reasoner', display_name: 'DeepSeek Reasoner' },
+    ],
+    xai: [
+        { id: 'grok-3', display_name: 'Grok 3' },
+    ],
+    mistral: [
+        { id: 'mistral-large-latest', display_name: 'Mistral Large' },
+        { id: 'mistral-small-latest', display_name: 'Mistral Small' },
+    ],
+    cohere: [
+        { id: 'command-a-03-2025', display_name: 'Command A' },
+    ],
+};
+const CACHE_TTL_MS = 10 * 60 * 1000;
+const _cache = new Map();
+/** Test hook. */
+export function _resetProviderModelsCache() { _cache.clear(); }
+function staticResult(provider, error) {
+    const r = {
+        provider,
+        models: STATIC_MODELS[provider] ?? [],
+        source: 'static',
+    };
+    if (error)
+        r.error = error.slice(0, 120);
+    return r;
+}
+async function fetchJson(url, headers, fetchImpl, timeoutMs) {
+    const controller = new AbortController();
+    const t = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const r = await fetchImpl(url, { headers, signal: controller.signal });
+        if (!r.ok) {
+            let detail = '';
+            try {
+                detail = (await r.text()).slice(0, 80).replace(/\s+/g, ' ');
+            }
+            catch { /* ignore */ }
+            throw new Error('http ' + r.status + (detail ? ' ' + detail : ''));
+        }
+        return await r.json();
+    }
+    finally {
+        clearTimeout(t);
+    }
+}
+async function listAnthropic(key, fetchImpl, timeoutMs) {
+    const j = await fetchJson('https://api.anthropic.com/v1/models?limit=50', {
+        'x-api-key': key,
+        'anthropic-version': '2023-06-01',
+    }, fetchImpl, timeoutMs);
+    return (j.data ?? [])
+        .filter((m) => typeof m.id === 'string')
+        .map((m) => ({ id: m.id, display_name: m.display_name || m.id }));
+}
+async function listOpenAi(key, fetchImpl, timeoutMs) {
+    const j = await fetchJson('https://api.openai.com/v1/models', {
+        'authorization': 'Bearer ' + key,
+    }, fetchImpl, timeoutMs);
+    return (j.data ?? [])
+        .filter((m) => typeof m.id === 'string' && /^(gpt|o[0-9])/.test(m.id))
+        .map((m) => ({ id: m.id, display_name: m.id }));
+}
+async function listGoogle(key, fetchImpl, timeoutMs) {
+    const j = await fetchJson('https://generativelanguage.googleapis.com/v1beta/models?pageSize=100', {
+        'x-goog-api-key': key,
+    }, fetchImpl, timeoutMs);
+    return (j.models ?? [])
+        .filter((m) => typeof m.name === 'string'
+        && (m.supportedGenerationMethods ?? []).includes('generateContent'))
+        .map((m) => ({
+        id: m.name.replace(/^models\//, ''),
+        display_name: m.displayName || m.name.replace(/^models\//, ''),
+    }));
+}
+/**
+ * Lista los modelos disponibles para un provider. Nunca lanza:
+ * degrada a la lista estatica con `source: 'static'`.
+ */
+export async function listProviderModels(provider, opts = {}) {
+    /* yujin_managed: los modelos los decide el worker por plan/tier;
+     * el cliente no tiene key. La lista util es la del provider
+     * subyacente, que el worker no expone -- devolver vacio static
+     * y que la UI lo explique. */
+    if (provider === 'yujin_managed') {
+        return { provider, models: [], source: 'static' };
+    }
+    const cached = _cache.get(provider);
+    if (cached && Date.now() - cached.ts < CACHE_TTL_MS)
+        return cached.result;
+    let key = opts.api_key ?? null;
+    if (key === null && opts.api_key === undefined) {
+        try {
+            key = await getKey(vaultSlotForProvider(provider));
+        }
+        catch {
+            key = null;
+        }
+    }
+    if (!key)
+        return staticResult(provider);
+    const fetchImpl = opts.fetchImpl ?? fetch;
+    const timeoutMs = opts.timeoutMs ?? 4000;
+    try {
+        let models;
+        switch (provider) {
+            case 'anthropic':
+                models = await listAnthropic(key, fetchImpl, timeoutMs);
+                break;
+            case 'openai':
+                models = await listOpenAi(key, fetchImpl, timeoutMs);
+                break;
+            case 'google_ai':
+                models = await listGoogle(key, fetchImpl, timeoutMs);
+                break;
+            /* Providers sin endpoint de listado wireado todavia:
+             * fallback estatico sin error. */
+            default: return staticResult(provider);
+        }
+        if (models.length === 0)
+            return staticResult(provider, 'empty model list');
+        const result = { provider, models, source: 'live' };
+        _cache.set(provider, { ts: Date.now(), result });
+        return result;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return staticResult(provider, msg);
+    }
+}
+//# sourceMappingURL=provider_models.js.map

package/dist/core/provider_models.js.map

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

package/dist/core/reasoning_gate.d.ts

@@ -0,0 +1,72 @@
+/**
+ * reasoning_gate.ts -- pre-LLM tier classifier (alpha.55).
+ *
+ * Cheap, deterministic features computed without an LLM call.
+ * Returns a tier suggestion + confidence + signal list. When
+ * confidence > 0.85 the cost_router uses the result directly
+ * and skips the Gemini turn_classifier (saves ~400 ms + tokens).
+ * When confidence <= 0.85 the gate's verdict is "ambiguous" and
+ * the router asks turn_classifier for a second opinion.
+ *
+ * Signals scanned:
+ *   - Message length (long prompts skew toward frontier reasoning).
+ *   - Frontier keywords (design, architecture, implement,
+ *     refactor, code, write a function, etc -- multilingual).
+ *   - Eco keywords (open, show, list, abrime, muestrame -- short
+ *     NAC3-shaped commands).
+ *   - Verb hints recognised in the manifest (e.g. references to
+ *     pizarron/lector/voz/idioma map to eco).
+ *   - Attachment presence (frontier bias).
+ *   - Prior tier in the conversation history (sticky tier when
+ *     "continua / sigue" is the explicit follow-up).
+ *
+ * All keyword lists are normalised to lowercase + accent-stripped.
+ * Multi-language (es / en) since the user types in both.
+ *
+ * ASCII-only.
+ */
+import type { BrainTier } from '../nac3/verb_tier_map.js';
+export interface GateInput {
+    /** The new user message text. */
+    text: string;
+    /** How many attachments (files, voice notes, screenshots) came
+     *  with the turn. */
+    attachments?: number;
+    /** Up to ~3 recent turns to detect follow-ups ("sigue", "y ahora"). */
+    history?: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>;
+    /** Tier the previous turn ran on, when known. Used for sticky
+     *  follow-ups. */
+    previous_tier?: 'eco' | 'frontier';
+}
+export interface GateDecision {
+    /** Recommended tier when confidence is high. */
+    tier: 'eco' | 'frontier';
+    /** Confidence 0..1. > 0.85 means the router skips classifier. */
+    confidence: number;
+    /** Whether the router should escalate to turn_classifier. */
+    ambiguous: boolean;
+    /** Human-readable signals fired. Goes to brain_routing.jsonl. */
+    signals: string[];
+}
+/**
+ * Score the input and decide tier + confidence.
+ *
+ * Algorithm:
+ *   1. If a sticky follow-up phrase + previous_tier known ->
+ *      inherit previous tier with confidence 0.95.
+ *   2. Otherwise sum keyword hits. Each hit weighs 0.18 toward
+ *      its bucket.
+ *   3. Long messages (>= 200 chars) add 0.20 to frontier.
+ *      Very short (< 24 chars) add 0.10 to eco.
+ *   4. Each attachment adds 0.20 to frontier.
+ *   5. Tier = bucket with higher absolute score. Confidence =
+ *      min(0.99, |frontier - eco| + base 0.40).
+ *   6. If both buckets are < 0.20 (no strong signals)
+ *      confidence drops to 0.30 -> ambiguous.
+ */
+export declare function classifyGate(input: GateInput): GateDecision;
+export type { BrainTier };
+//# sourceMappingURL=reasoning_gate.d.ts.map

package/dist/core/reasoning_gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning_gate.d.ts","sourceRoot":"","sources":["../../src/core/reasoning_gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,WAAW,SAAS;IACxB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb;yBACqB;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE;sBACkB;IAClB,aAAa,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,IAAI,EAAE,KAAK,GAAG,UAAU,CAAC;IACzB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB,iEAAiE;IACjE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAmED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,CAyG3D;AAID,YAAY,EAAE,SAAS,EAAE,CAAC"}

package/dist/core/reasoning_gate.js

@@ -0,0 +1,205 @@
+/**
+ * reasoning_gate.ts -- pre-LLM tier classifier (alpha.55).
+ *
+ * Cheap, deterministic features computed without an LLM call.
+ * Returns a tier suggestion + confidence + signal list. When
+ * confidence > 0.85 the cost_router uses the result directly
+ * and skips the Gemini turn_classifier (saves ~400 ms + tokens).
+ * When confidence <= 0.85 the gate's verdict is "ambiguous" and
+ * the router asks turn_classifier for a second opinion.
+ *
+ * Signals scanned:
+ *   - Message length (long prompts skew toward frontier reasoning).
+ *   - Frontier keywords (design, architecture, implement,
+ *     refactor, code, write a function, etc -- multilingual).
+ *   - Eco keywords (open, show, list, abrime, muestrame -- short
+ *     NAC3-shaped commands).
+ *   - Verb hints recognised in the manifest (e.g. references to
+ *     pizarron/lector/voz/idioma map to eco).
+ *   - Attachment presence (frontier bias).
+ *   - Prior tier in the conversation history (sticky tier when
+ *     "continua / sigue" is the explicit follow-up).
+ *
+ * All keyword lists are normalised to lowercase + accent-stripped.
+ * Multi-language (es / en) since the user types in both.
+ *
+ * ASCII-only.
+ */
+/* Normalisation: lowercase + strip combining marks. ASCII-safe
+ * because the regex is plain unicode. */
+function norm(s) {
+    return s.normalize('NFD').replace(/[̀-ͯ]/g, '').toLowerCase();
+}
+/* Keywords that push toward frontier. Multilingual ES/EN. Each
+ *  match adds +0.18 to frontier score, capped by signal weight
+ *  in score(). */
+const FRONTIER_KEYWORDS = [
+    /* design + architecture */
+    'disena', 'disenar', 'diseno', 'diseno de',
+    'design', 'designing', 'architect', 'architecture',
+    'arquitectura', 'arquitecto',
+    /* implementation / code */
+    'implementa', 'implementar', 'implementation',
+    'refactoriza', 'refactor', 'refactoring',
+    'codifica', 'codigo', 'code this', 'write a function',
+    'fix this bug', 'arregla este bug', 'resuelve el problema',
+    /* reasoning / planning */
+    'estrategia', 'strategy', 'planifica',
+    'analiza la', 'analiza el', 'analyze',
+    /* writing tasks */
+    'redacta', 'escribe un', 'write a draft', 'compose',
+    /* multi-step / complex */
+    'paso a paso', 'step by step', 'descompon', 'breakdown',
+    /* PND-066 -- render de contenido: pedir el grafo / un diagrama
+     * / una vista grafica es trabajo multi-paso (poblar + armar la
+     * vista + despachar al panel), no un comando NAC3 trivial. */
+    'grafo', 'diagrama', 'modo grafico', 'visualizacion',
+];
+/* Keywords that push toward eco. Short NAC3-shaped commands. */
+const ECO_KEYWORDS = [
+    /* navigation / listing */
+    'abrime', 'abre ', 'abrir ', 'open ', 'show me', 'muestrame',
+    'mostrame', 'listame', 'list ', 'lista ',
+    /* read / pizarron */
+    'lee la', 'leeme la', 'leeme el', 'lee el',
+    'read this tab', 'leer pestania',
+    /* simple ops */
+    'cierra', 'close ',
+    'cambia el idioma', 'cambiar idioma', 'change language',
+    'activar voz', 'apaga voz', 'desactiva voz',
+    /* short greetings stay eco */
+    'hola', 'hello', 'hi ', 'thanks', 'gracias',
+    /* NAC3 verbs reference.
+     * PND-066 -- el keyword suelto 'pizarron' se reemplazo por
+     * frases compuestas de operacion simple: la mera mencion del
+     * pizarron NO implica comando trivial ("muestra el grafo en el
+     * pizarron" es render multi-paso; en la sesion Yuemail
+     * 2026-06-10 ese keyword mando a eco los dos turnos que pedian
+     * crear una tab con el grafo). Las ops simples siguen
+     * matcheando por estas frases + sus prefijos (abre/cierra/lee). */
+    'tab en el pizarron', 'pestania en el pizarron',
+    'pestana en el pizarron', 'tab del pizarron',
+    'lector', 'reader', 'microphone',
+];
+/* Phrases that mean "sigue lo anterior" -- inherit previous tier. */
+const STICKY_FOLLOWUPS = [
+    'sigue', 'continua', 'continuar', 'continue', 'go on',
+    'y ahora', 'y despues', 'and now', 'next step',
+];
+/**
+ * Score the input and decide tier + confidence.
+ *
+ * Algorithm:
+ *   1. If a sticky follow-up phrase + previous_tier known ->
+ *      inherit previous tier with confidence 0.95.
+ *   2. Otherwise sum keyword hits. Each hit weighs 0.18 toward
+ *      its bucket.
+ *   3. Long messages (>= 200 chars) add 0.20 to frontier.
+ *      Very short (< 24 chars) add 0.10 to eco.
+ *   4. Each attachment adds 0.20 to frontier.
+ *   5. Tier = bucket with higher absolute score. Confidence =
+ *      min(0.99, |frontier - eco| + base 0.40).
+ *   6. If both buckets are < 0.20 (no strong signals)
+ *      confidence drops to 0.30 -> ambiguous.
+ */
+export function classifyGate(input) {
+    const signals = [];
+    const text = typeof input.text === 'string' ? input.text : '';
+    const n = norm(text);
+    /* 1. sticky follow-up (explicit "sigue / continua" phrases) */
+    if (input.previous_tier) {
+        for (const phrase of STICKY_FOLLOWUPS) {
+            if (n.includes(phrase)) {
+                signals.push('sticky_followup[' + phrase + ']->' + input.previous_tier);
+                return {
+                    tier: input.previous_tier,
+                    confidence: 0.95,
+                    ambiguous: false,
+                    signals,
+                };
+            }
+        }
+    }
+    /* 1b. alpha.56 -- frontier inertia. The expensive case is a
+     *  user dropping out of a frontier conversation because their
+     *  follow-up was short ("medium, python playwright", "ok",
+     *  "yes"). Once you are in a frontier topic you stay there
+     *  unless the new message has a strong eco signal. We compute
+     *  eco signals first to gate the inertia.
+     *
+     *  This intentionally runs BEFORE the regular keyword scan so
+     *  we can short-circuit without computing frontier signals --
+     *  the eco scan is cheap. */
+    if (input.previous_tier === 'frontier') {
+        let ecoQuickScore = 0;
+        for (const kw of ECO_KEYWORDS) {
+            if (n.includes(kw)) {
+                ecoQuickScore += 0.25;
+            }
+        }
+        if (ecoQuickScore < 0.30) {
+            signals.push('frontier_inertia[prev=frontier, eco_score=' + ecoQuickScore.toFixed(2) + ']');
+            return {
+                tier: 'frontier',
+                confidence: 0.90,
+                ambiguous: false,
+                signals,
+            };
+        }
+        /* Otherwise fall through -- the user did signal eco intent
+         *  even within a frontier topic (e.g. "ok abrime esa tab"
+         *  inside a design session). */
+    }
+    let ecoScore = 0;
+    let frontierScore = 0;
+    /* 2. keyword hits */
+    for (const kw of ECO_KEYWORDS) {
+        if (n.includes(kw)) {
+            ecoScore += 0.25;
+            signals.push('eco_kw[' + kw.trim() + ']');
+        }
+    }
+    for (const kw of FRONTIER_KEYWORDS) {
+        if (n.includes(kw)) {
+            frontierScore += 0.25;
+            signals.push('frontier_kw[' + kw.trim() + ']');
+        }
+    }
+    /* 3. length */
+    if (text.length >= 200) {
+        frontierScore += 0.20;
+        signals.push('long_prompt[' + text.length + ']');
+    }
+    else if (text.length < 24 && text.length > 0) {
+        ecoScore += 0.10;
+        signals.push('short_prompt[' + text.length + ']');
+    }
+    /* 4. attachments */
+    const att = typeof input.attachments === 'number' && input.attachments > 0
+        ? input.attachments
+        : 0;
+    if (att > 0) {
+        frontierScore += 0.20 * att;
+        signals.push('attachments[' + att + ']');
+    }
+    /* 5. decide */
+    const ecoCapped = Math.min(ecoScore, 1.0);
+    const frontierCapped = Math.min(frontierScore, 1.0);
+    const tier = frontierCapped > ecoCapped ? 'frontier' : 'eco';
+    let confidence = 0.40 + Math.abs(frontierCapped - ecoCapped);
+    if (confidence > 0.99)
+        confidence = 0.99;
+    /* 6. weak signal -> ambiguous */
+    const maxScore = Math.max(ecoCapped, frontierCapped);
+    let ambiguous;
+    if (maxScore < 0.20) {
+        confidence = 0.30;
+        ambiguous = true;
+        signals.push('weak_signals');
+    }
+    else {
+        ambiguous = confidence <= 0.85;
+    }
+    return { tier, confidence, ambiguous, signals };
+}
+//# sourceMappingURL=reasoning_gate.js.map

package/dist/core/reasoning_gate.js.map

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

package/dist/core/shell_classifier.d.ts

@@ -0,0 +1,49 @@
+/**
+ * shell_classifier.ts -- categorize a shell command into one of
+ * four risk buckets (alpha.59d).
+ *
+ * Buckets:
+ *   destructive    -- modifies / removes user data, force-pushes,
+ *                     etc. Always requires approval.
+ *   elevation      -- sudo / gsudo / runas / su. Always approval.
+ *   network        -- curl/wget/npm-install/etc that touches the
+ *                     network. Pablo's rule: approve always.
+ *   safe           -- ls, cd, pwd, git status, etc. Auto-approves
+ *                     (subject to Danger Zone toggle in limits).
+ *
+ * The classifier is intentionally CONSERVATIVE: when in doubt it
+ * escalates to a higher-risk bucket. False positives cost the
+ * user an extra approval prompt; false negatives could execute
+ * unwanted changes silently.
+ *
+ * Pattern matching is regex-based + token-aware. It does NOT
+ * try to parse shell grammar perfectly -- it catches the obvious
+ * dangerous shapes (rm -rf /, force flags, sudo prefix, network
+ * binaries, etc).
+ *
+ * ASCII-only.
+ */
+export type ShellRiskBucket = 'destructive' | 'elevation' | 'network' | 'safe';
+export interface ShellClassification {
+    bucket: ShellRiskBucket;
+    reasons: string[];
+    requires_approval: boolean;
+}
+export declare function classifyShellCommand(command: string): ShellClassification;
+export declare const _patterns: {
+    DESTRUCTIVE_TOKENS: readonly {
+        pat: RegExp;
+        reason: string;
+    }[];
+    ELEVATION_TOKENS: readonly {
+        pat: RegExp;
+        reason: string;
+    }[];
+    NETWORK_TOKENS: readonly {
+        pat: RegExp;
+        reason: string;
+    }[];
+    SAFE_TOKENS: readonly RegExp[];
+    PIPE_TO_SHELL: RegExp;
+};
+//# sourceMappingURL=shell_classifier.d.ts.map

package/dist/core/shell_classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell_classifier.d.ts","sourceRoot":"","sources":["../../src/core/shell_classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;AAE/E,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAqFD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAqDzE;AAGD,eAAO,MAAM,SAAS;;aA1IyB,MAAM;gBAAU,MAAM;;;aAmCxB,MAAM;gBAAU,MAAM;;;aAUxB,MAAM;gBAAU,MAAM;;;;CA+FhE,CAAC"}