fintecia 0.0.0-stage → 1.0.0

package/dist/glossary.js

@@ -0,0 +1,160 @@
+/**
+ * Field glossary for the Fintecia MCP tools.
+ *
+ * The agent cannot reliably deduce accounting-semantics fields (taxes vs
+ * prepaid ISR, IVA acreditable vs trasladado, preTaxIncome vs netIncome),
+ * so this dictionary documents them. It is served by the static
+ * `fintecia_glosario` tool — no auth, no backend round-trip — so the agent
+ * can load it during onboarding, in parallel with login + e-firma.
+ */
+export const FINANCIALS_GLOSSARY = [
+    // ── Principios ──
+    {
+        section: "principio",
+        key: "currency",
+        meaning: "Moneda de todos los montos. Hoy siempre MXN.",
+    },
+    {
+        section: "principio",
+        key: "money-object",
+        meaning: "Todo monto es un objeto { currency, amount }. El amount lleva el signo: " +
+            "un pasivo/proveedor negativo = anticipo (te deben), NO lo fuerces a positivo.",
+    },
+    {
+        section: "principio",
+        key: "agente-razona",
+        meaning: "Fintecia calcula y materializa. Nunca re-sumas transacciones crudas: lee " +
+            "los montos materializados.",
+    },
+    {
+        section: "principio",
+        key: "tipoPersona",
+        meaning: '"personal" = PF (Persona Física), "business" = PM (Persona Moral). Define ' +
+            "qué campos se exponen (isrRetenido y deducciones personales son de PF).",
+    },
+    // ── Summary ──
+    { section: "summary", key: "balances.assets", meaning: "Activo total (lo que tienes)." },
+    {
+        section: "summary",
+        key: "balances.liabilities",
+        meaning: "Pasivo total (lo que debes). Negativo = anticipo (te deben).",
+    },
+    { section: "summary", key: "periodNet.income", meaning: "Ingresos del periodo." },
+    {
+        section: "summary",
+        key: "periodNet.expenses",
+        meaning: "Gastos del periodo (costo + operación + financieros, SIN impuestos).",
+    },
+    {
+        section: "summary",
+        key: "periodNet.taxes",
+        meaning: "Impuestos a la utilidad: ISR causado + PTU. NO incluye ISR retenido.",
+    },
+    {
+        section: "summary",
+        key: "periodNet.isrRetenido",
+        meaning: "ISR retenido (activo prepagado, 'ISR a favor'). Solo PF; se omite para PM.",
+    },
+    {
+        section: "summary",
+        key: "periodNet.result",
+        meaning: "Utilidad neta = ingresos − gastos − impuestos.",
+    },
+    {
+        section: "summary",
+        key: "receivablesPayables.accountsReceivable",
+        meaning: "Cuentas por cobrar (clientes te deben).",
+    },
+    {
+        section: "summary",
+        key: "receivablesPayables.suppliers",
+        meaning: "Proveedores. Negativo = anticipo (te deben).",
+    },
+    {
+        section: "summary",
+        key: "receivablesPayables.diverseCreditors",
+        meaning: "Acreedores diversos (otras deudas).",
+    },
+    {
+        section: "summary",
+        key: "cash.total",
+        meaning: "Efectivo + bancos (caja contable derivada de los CFDI, no el saldo real del banco).",
+    },
+    {
+        section: "summary",
+        key: "iva.acreditable",
+        meaning: "IVA acreditable (activo: IVA que pagaste a proveedores).",
+    },
+    {
+        section: "summary",
+        key: "iva.trasladadoPorPagar",
+        meaning: "IVA trasladado por pagar (pasivo: IVA que cobraste a clientes).",
+    },
+    // ── Estado de resultados (NIF B-3) ──
+    { section: "incomeStatement", key: "grossProfit", meaning: "Utilidad bruta = ingresos − costo de ventas." },
+    {
+        section: "incomeStatement",
+        key: "operatingIncome",
+        meaning: "Utilidad de operación = utilidad bruta − gastos de operación.",
+    },
+    {
+        section: "incomeStatement",
+        key: "preTaxIncome",
+        meaning: "Utilidad antes de impuestos = utilidad de operación − gastos financieros.",
+    },
+    {
+        section: "incomeStatement",
+        key: "incomeTax.isr",
+        meaning: "ISR CAUSADO (provisión, 5501). No incluye el retenido.",
+    },
+    {
+        section: "incomeStatement",
+        key: "incomeTax.ptu",
+        meaning: "PTU (participación de los trabajadores).",
+    },
+    {
+        section: "incomeStatement",
+        key: "incomeTax.isrRetenido",
+        meaning: "ISR retenido (1109) = activo prepagado. Solo PF; 0 para PM.",
+    },
+    {
+        section: "incomeStatement",
+        key: "netIncome",
+        meaning: "Utilidad neta = preTaxIncome − ISR causado − PTU. Igual a periodNet.result.",
+    },
+    {
+        section: "incomeStatement",
+        key: "netReceived",
+        meaning: "Neto recibido en banco = ingresos − ISR retenido. Solo PF.",
+    },
+    {
+        section: "incomeStatement",
+        key: "regimeStatements",
+        meaning: "Un sub-estado de resultados por cada régimen fiscal del contribuyente " +
+            "(régimenFiscal + label legible). Con 2+ regímenes, cada uno viene separado.",
+    },
+    {
+        section: "incomeStatement",
+        key: "personalDeductionTotal",
+        meaning: "Deducciones personales (Art. 151, anuales). 0 en periodos mensuales.",
+    },
+    // ── Balance general (NIF B-6) ──
+    { section: "balanceSheet", key: "assets", meaning: "Activos: circulante + fijo + diferido." },
+    { section: "balanceSheet", key: "liabilities", meaning: "Pasivos: corto + largo plazo." },
+    {
+        section: "balanceSheet",
+        key: "equity",
+        meaning: "Capital contable. Incluye Resultado del Ejercicio (utilidad del periodo).",
+    },
+    {
+        section: "balanceSheet",
+        key: "currentAssets.isrAFavor",
+        meaning: "ISR a favor (activo prepagado, 1109). El retenido que te hicieron.",
+    },
+    {
+        section: "balanceSheet",
+        key: "currentLiabilities.ivaTrasladadoPorPagar",
+        meaning: "IVA trasladado por pagar (2103).",
+    },
+];
+//# sourceMappingURL=glossary.js.map

package/dist/glossary.js.map

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

package/dist/handlers.d.ts

@@ -0,0 +1,38 @@
+import { type FielProvider } from "./sat/fielProvider.js";
+import { type JobStore } from "./sat/jobs.js";
+import { type DownloadArtifactStore } from "./sat/artifacts.js";
+/**
+ * Tool handlers. Real implementations are wired here as they land (T1b+);
+ * un-implemented tools keep a stub that names the pending task.
+ *
+ * The e-firma NEVER leaves the machine: `cfdi_download` resolves the FIEL
+ * material locally through a `FielProvider` (`.cer` + `.key` + re-entered
+ * password) and only uploads the resulting CFDIs to Fintecia.
+ */
+export type ToolResult = {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+export type ToolHandler = (input: Record<string, unknown>) => Promise<ToolResult>;
+export interface HandlerDeps {
+    /** Local FIEL resolver. T1b wires the keychain; T2 ships the in-memory stub. */
+    fielProvider?: FielProvider;
+    /** Download job registry (in-memory in T2). */
+    jobStore?: JobStore;
+    /** Disk persistence for downloaded packages (retry without re-downloading). */
+    artifactStore?: DownloadArtifactStore;
+    /** Lists locally-registered e-firmas (RFC + keyring password status). */
+    listEfirmas?: () => Promise<Array<{
+        rfc: string;
+        hasPassword: boolean;
+    }>>;
+    /** Fintecia backend base URL for the upload endpoint (FINTECIA_API_URL). */
+    uploadBaseUrl?: string;
+    /** Resolves the current Firebase ID token (T3 wires the device-flow session). */
+    getAuthToken?: () => Promise<string | null>;
+    /** Injectable fetch for the upload client (tests). */
+    fetchFn?: typeof fetch;
+}
+export declare function createHandlers(deps?: HandlerDeps): Map<string, ToolHandler>;

package/dist/handlers.js

@@ -0,0 +1,302 @@
+import { PublicLookupClient, normalizeRfc } from "./public/lookup.js";
+import { buildExpresionImpresa, VerificationClient } from "./public/verify.js";
+import { validateDownloadArgs, } from "./sat/parse.js";
+import { UploadClient } from "./sat/upload.js";
+import { InMemoryFielProvider, } from "./sat/fielProvider.js";
+import { extractRazonSocial } from "./fiel/fiel.js";
+import { InMemoryJobStore } from "./sat/jobs.js";
+import { FileDownloadArtifactStore, buildRequestKey, } from "./sat/artifacts.js";
+import { ReadClient } from "./fin/read.js";
+function stub(name) {
+    return async () => ({
+        content: [
+            {
+                type: "text",
+                text: `[fintecia-mcp] "${name}" is defined but not yet implemented (T1–T8).`,
+            },
+        ],
+    });
+}
+function text(value) {
+    return { content: [{ type: "text", text: value }] };
+}
+function json(value) {
+    return { content: [{ type: "text", text: JSON.stringify(value, null, 2) }] };
+}
+export function createHandlers(deps = {}) {
+    const fielProvider = deps.fielProvider ?? new InMemoryFielProvider();
+    const jobStore = deps.jobStore ?? new InMemoryJobStore();
+    const publicClient = new PublicLookupClient({
+        baseUrl: deps.uploadBaseUrl ?? "",
+        getAuthToken: deps.getAuthToken ?? (async () => null),
+        fetchFn: deps.fetchFn,
+    });
+    const readClient = new ReadClient({
+        baseUrl: deps.uploadBaseUrl ?? "",
+        getAuthToken: deps.getAuthToken ?? (async () => null),
+        fetchFn: deps.fetchFn,
+    });
+    const handlers = new Map();
+    handlers.set("sat_efos_check", async (input) => {
+        const rfc = normalizeRfc(String(input.rfc ?? ""));
+        const { found, entry } = await publicClient.checkEfos(rfc);
+        if (!found || !entry) {
+            return text(`RFC ${rfc}: no aparece en el listado 69-B (operaciones presuntamente inexistentes).`);
+        }
+        const oficio = entry.oficio ? ` · oficio ${entry.oficio}` : "";
+        return text(`RFC ${entry.rfc}: ${entry.situacion.toUpperCase()}${oficio} — ${entry.nombre}.`);
+    });
+    handlers.set("sat_debts_check", async (input) => {
+        const rfc = normalizeRfc(String(input.rfc ?? ""));
+        const { found, entry } = await publicClient.checkDebts(rfc);
+        if (!found || !entry) {
+            return text(`RFC ${rfc}: no aparece en el listado art. 69 (créditos fiscales firmes).`);
+        }
+        return text(`RFC ${entry.rfc}: crédito fiscal firme (art. 69) — ${entry.nombre}.`);
+    });
+    handlers.set("cfdi_verify", async (input) => {
+        const uuid = String(input.uuid ?? "");
+        const emisorRfc = String(input.emisorRfc ?? "");
+        const receptorRfc = String(input.receptorRfc ?? "");
+        const total = Number(input.total);
+        if (!uuid || !emisorRfc || !receptorRfc || !Number.isFinite(total)) {
+            return text("cfdi_verify: se requieren uuid, emisorRfc, receptorRfc y total (o xmlBase64).");
+        }
+        const expresion = buildExpresionImpresa({ emisorRfc, receptorRfc, total, uuid });
+        const client = new VerificationClient(deps.fetchFn ?? fetch);
+        const result = await client.consulta(expresion);
+        const efos = result.validacionEfos
+            ? ` · ValidacionEFOS ${result.validacionEfos}`
+            : "";
+        return text(`CFDI ${uuid}: ${result.estado}${efos}${result.codigoEstatus ? ` · ${result.codigoEstatus}` : ""}.`);
+    });
+    handlers.set("cfdi_download", async (input) => {
+        const args = validateDownloadArgs(input);
+        // Gate BEFORE the (real, destructive) SAT download: without a loopback
+        // session the upload would fail anyway, and we must not burn a SAT
+        // DescargaMasiva request (and FIEL signing) on a request that can never
+        // complete.
+        const idToken = await (deps.getAuthToken?.() ?? Promise.resolve(null));
+        if (!idToken) {
+            throw new Error("Iniciá sesión primero (fintecia_login) antes de descargar CFDIs.");
+        }
+        const material = await fielProvider.load(args.rfc);
+        if (!material) {
+            throw new Error(`No hay e-firma local registrada para el RFC ${args.rfc}. ` +
+                `Conectá la e-firma primero (vinculación T1b).`);
+        }
+        const job = jobStore.create({
+            tipo: args.tipo,
+            desde: args.desde,
+            hasta: args.hasta,
+            rfc: args.rfc,
+        });
+        // Async by contract: fire the download+upload in the background, surface
+        // the job id immediately. Failures land on the job (not lost): the agent
+        // reads them via cfdi_download_status.
+        void runDownloadJob(job, material, args, { deps, jobStore }).catch((err) => {
+            jobStore.update(job.jobId, {
+                status: "failed",
+                error: err instanceof Error ? err.message : String(err),
+                finishedAt: new Date().toISOString(),
+            });
+        });
+        return json({
+            jobId: job.jobId,
+            status: "running",
+            tipo: args.tipo,
+            desde: args.desde,
+            hasta: args.hasta,
+            rfc: args.rfc,
+        });
+    });
+    handlers.set("cfdi_download_status", async (input) => {
+        const jobId = String(input.jobId ?? "");
+        const job = jobStore.get(jobId);
+        if (!job) {
+            throw new Error(`Job no encontrado: ${jobId}`);
+        }
+        return json(job);
+    });
+    handlers.set("cfdi_sync_status", async () => {
+        const last = jobStore.lastCompleted();
+        if (!last) {
+            return text("Sin descargas completadas en esta sesión.");
+        }
+        return json({
+            lastCompletedAt: last.finishedAt,
+            lastDownload: {
+                rfc: last.rfc,
+                tipo: last.tipo,
+                desde: last.desde,
+                hasta: last.hasta,
+                accepted: last.result?.accepted ?? 0,
+                rejected: last.result?.rejected ?? 0,
+                cfdiCount: last.result?.cfdiCount ?? 0,
+            },
+        });
+    });
+    handlers.set("fintecia_efirmas", async () => {
+        const efirmas = await (deps.listEfirmas?.() ?? Promise.resolve([]));
+        return json({ efirmas });
+    });
+    handlers.set("fintecia_financials", async (input) => {
+        const taxpayerRfc = String(input.taxpayerRfc ?? "");
+        return json(await readClient.read("/api/v1/mcp/financials", taxpayerRfc, {
+            ...(typeof input.hasta === "string"
+                ? { periodKey: input.hasta.slice(0, 7) }
+                : {}),
+        }));
+    });
+    handlers.set("fintecia_reconciliation", async (input) => {
+        const taxpayerRfc = String(input.taxpayerRfc ?? "");
+        return json(await readClient.read("/api/v1/mcp/reconciliation", taxpayerRfc));
+    });
+    handlers.set("fintecia_cfdi", async (input) => {
+        const taxpayerRfc = String(input.taxpayerRfc ?? "");
+        const { taxpayerRfc: _t, ...filters } = input;
+        return json(await readClient.read("/api/v1/mcp/cfdi", taxpayerRfc, filters));
+    });
+    handlers.set("fintecia_risk_report", async (input) => {
+        const taxpayerRfc = String(input.taxpayerRfc ?? "");
+        return json(await readClient.read("/api/v1/mcp/risk-report", taxpayerRfc));
+    });
+    handlers.set("fintecia_profile", async () => {
+        return json(await readClient.readRaw("/api/v1/mcp/profile"));
+    });
+    handlers.set("fintecia_tax_summary", async (input) => {
+        const taxpayerRfc = String(input.taxpayerRfc ?? "");
+        const periodKey = String(input.periodo ?? "");
+        return json(await readClient.read("/api/v1/mcp/tax-summary", taxpayerRfc, { periodKey }));
+    });
+    handlers.set("fintecia_transactions", async (input) => {
+        const taxpayerRfc = String(input.taxpayerRfc ?? "");
+        const { taxpayerRfc: _t, ...filters } = input;
+        return json(await readClient.read("/api/v1/mcp/transactions", taxpayerRfc, filters));
+    });
+    handlers.set("fintecia_risk_check", async (input) => {
+        const taxpayerRfc = String(input.taxpayerRfc ?? "");
+        return json(await readClient.read("/api/v1/mcp/risk-check", taxpayerRfc, {
+            rfc: String(input.rfc ?? ""),
+        }));
+    });
+    handlers.set("fintecia_deductibility", async (input) => {
+        const taxpayerRfc = String(input.taxpayerRfc ?? "");
+        return json(await readClient.read("/api/v1/mcp/deductibility", taxpayerRfc));
+    });
+    // Everything else keeps a stub until its task lands.
+    for (const name of []) {
+        if (!handlers.has(name))
+            handlers.set(name, stub(name));
+    }
+    return handlers;
+}
+/**
+ * Background download + upload orchestration. Lazy-imports the nodecfdi seam
+ * so jest (which loads handlers.ts) never pulls nodecfdi at runtime.
+ */
+async function runDownloadJob(job, material, args, ctx) {
+    const { deps, jobStore } = ctx;
+    const { DescargaClient } = await import("./sat/descarga.js");
+    // Ensure the taxpayer is linked in Fintecia before uploading (S3: "vincular
+    // cuenta↔taxpayer(RFC) [crear o unirse]"). The upload endpoint resolves the
+    // taxpayer by RFC and returns 404 when it doesn't exist. Idempotent (join or
+    // no-op when already linked); a failure here surfaces as a 404 on upload.
+    if (deps.uploadBaseUrl) {
+        const idToken = await (deps.getAuthToken?.() ?? Promise.resolve(null));
+        if (idToken) {
+            try {
+                await fetch(`${deps.uploadBaseUrl}/api/v1/mcp/taxpayer/link`, {
+                    method: "POST",
+                    headers: {
+                        "content-type": "application/json",
+                        authorization: `Bearer ${idToken}`,
+                    },
+                    body: JSON.stringify({
+                        rfc: args.rfc,
+                        razonSocial: extractRazonSocial(material.cer) ?? undefined,
+                    }),
+                });
+            }
+            catch {
+                // best-effort: the upload will surface the real error
+            }
+        }
+    }
+    const artifactStore = deps.artifactStore ?? new FileDownloadArtifactStore();
+    const requestKey = buildRequestKey(args.rfc, args.desde, args.hasta);
+    const tipos = args.tipo === "ambos" ? ["emitidos", "recibidos"] : [args.tipo];
+    const client = new DescargaClient({
+        onPhase: (phase) => jobStore.update(job.jobId, { phase }),
+    });
+    const all = [];
+    for (const tipo of tipos) {
+        // Retry without re-downloading: reuse packages persisted by a prior run
+        // whose upload failed (the SAT limits re-downloads, so they must survive).
+        const persisted = await artifactStore.load(requestKey, tipo);
+        if (persisted.length > 0) {
+            all.push(...persisted);
+            continue;
+        }
+        const zips = await client.descargar(material, { desde: args.desde, hasta: args.hasta }, tipo);
+        // Persist to disk BEFORE upload (L22): a failed upload must not lose the
+        // real SAT download.
+        for (let i = 0; i < zips.length; i++) {
+            await artifactStore.save(requestKey, tipo, i, zips[i]);
+        }
+        all.push(...zips);
+    }
+    // No packages → nothing to upload; complete the job as an empty result.
+    if (all.length === 0) {
+        jobStore.update(job.jobId, {
+            status: "completed",
+            phase: "upload",
+            finishedAt: new Date().toISOString(),
+            result: { accepted: 0, rejected: 0, cfdiCount: 0 },
+        });
+        return;
+    }
+    jobStore.update(job.jobId, { phase: "upload" });
+    const uploadResult = await uploadBatch(deps, args.rfc, all);
+    jobStore.update(job.jobId, {
+        status: "completed",
+        phase: "upload",
+        finishedAt: new Date().toISOString(),
+        result: {
+            accepted: uploadResult.accepted,
+            rejected: uploadResult.rejected.length,
+            cfdiCount: uploadResult.totalFiles,
+        },
+    });
+    // KEEP the downloaded packages on disk after upload. The upload "success"
+    // is too coarse a signal: the backend pipeline (accounting) runs
+    // asynchronously AFTER the upload and can still fail (e.g. 0 journal
+    // entries). Keeping the zip lets a retry re-upload without re-downloading
+    // from the SAT (which limits re-downloads). Cleanup is a later concern —
+    // data safety beats disk hygiene here.
+}
+async function uploadBatch(deps, taxpayerRfc, zips) {
+    if (!deps.uploadBaseUrl) {
+        throw new Error("uploadBaseUrl no configurado (definí FINTECIA_API_URL)");
+    }
+    const idToken = await (deps.getAuthToken?.() ?? Promise.resolve(null));
+    if (!idToken) {
+        throw new Error("No autenticado: falta el idToken (loopback / fintecia_login)");
+    }
+    const client = new UploadClient({
+        baseUrl: deps.uploadBaseUrl,
+        idToken,
+        fetchFn: deps.fetchFn,
+    });
+    let accepted = 0;
+    let totalFiles = 0;
+    const rejected = [];
+    for (const zip of zips) {
+        const result = await client.upload({ taxpayerRfc, zipBase64: zip });
+        accepted += result.accepted;
+        totalFiles += result.totalFiles ?? 0;
+        rejected.push(...result.rejected);
+    }
+    return { accepted, rejected, totalFiles };
+}
+//# sourceMappingURL=handlers.js.map

package/dist/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EACL,oBAAoB,GAIrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAwB,MAAM,iBAAiB,CAAC;AACrE,OAAO,EACL,oBAAoB,GAGrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAmC,MAAM,eAAe,CAAC;AAClF,OAAO,EACL,yBAAyB,EACzB,eAAe,GAEhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AA+B3C,SAAS,IAAI,CAAC,IAAY;IACxB,OAAO,KAAK,IAAI,EAAE,CAAC,CAAC;QAClB,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,mBAAmB,IAAI,+CAA+C;aAC7E;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,IAAI,CAAC,KAAa;IACzB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,SAAS,IAAI,CAAC,KAAc;IAC1B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAoB,EAAE;IACnD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,oBAAoB,EAAE,CAAC;IACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,gBAAgB,EAAE,CAAC;IAEzD,MAAM,YAAY,GAAG,IAAI,kBAAkB,CAAC;QAC1C,OAAO,EAAE,IAAI,CAAC,aAAa,IAAI,EAAE;QACjC,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC;QACrD,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC;QAChC,OAAO,EAAE,IAAI,CAAC,aAAa,IAAI,EAAE;QACjC,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC;QACrD,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAEhD,QAAQ,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC7C,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;QAClD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO,IAAI,CACT,OAAO,GAAG,2EAA2E,CACtF,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CACT,OAAO,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,GAAG,MAAM,MAAM,KAAK,CAAC,MAAM,GAAG,CACjF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,iBAAiB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9C,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;QAClD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC5D,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO,IAAI,CACT,OAAO,GAAG,gEAAgE,CAC3E,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CACT,OAAO,KAAK,CAAC,GAAG,sCAAsC,KAAK,CAAC,MAAM,GAAG,CACtE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACtC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAElC,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACnE,OAAO,IAAI,CACT,+EAA+E,CAChF,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,qBAAqB,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjF,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAEhD,MAAM,IAAI,GAAG,MAAM,CAAC,cAAc;YAChC,CAAC,CAAC,qBAAqB,MAAM,CAAC,cAAc,EAAE;YAC9C,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,IAAI,CACT,QAAQ,IAAI,KAAK,MAAM,CAAC,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CACpG,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC5C,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACzC,uEAAuE;QACvE,mEAAmE;QACnE,wEAAwE;QACxE,YAAY;QACZ,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,kEAAkE,CACnE,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CACb,+CAA+C,IAAI,CAAC,GAAG,IAAI;gBACzD,+CAA+C,CAClD,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC;YAC1B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAC;QACH,yEAAyE;QACzE,yEAAyE;QACzE,uCAAuC;QACvC,KAAK,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACzE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE;gBACzB,MAAM,EAAE,QAAQ;gBAChB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;gBACvD,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACrC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;YACV,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,sBAAsB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACnD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,kBAAkB,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,IAAI,CAAC;YACV,eAAe,EAAE,IAAI,CAAC,UAAU;YAChC,YAAY,EAAE;gBACZ,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,IAAI,CAAC;gBACpC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,IAAI,CAAC;gBACpC,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC;aACvC;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,kBAAkB,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,qBAAqB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAClD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QACpD,OAAO,IAAI,CACT,MAAM,UAAU,CAAC,IAAI,CAAC,wBAAwB,EAAE,WAAW,EAAE;YAC3D,GAAG,CAAC,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;gBACjC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;gBACxC,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,yBAAyB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACtD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,4BAA4B,EAAE,WAAW,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC;QAC9C,OAAO,IAAI,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,kBAAkB,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,sBAAsB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACnD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,yBAAyB,EAAE,WAAW,CAAC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,kBAAkB,EAAE,KAAK,IAAI,EAAE;QAC1C,OAAO,IAAI,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,sBAAsB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACnD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAC9C,OAAO,IAAI,CACT,MAAM,UAAU,CAAC,IAAI,CAAC,yBAAyB,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,CAC7E,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,uBAAuB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACpD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC;QAC9C,OAAO,IAAI,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,0BAA0B,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,qBAAqB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAClD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QACpD,OAAO,IAAI,CACT,MAAM,UAAU,CAAC,IAAI,CAAC,wBAAwB,EAAE,WAAW,EAAE;YAC3D,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;SAC7B,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,wBAAwB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACrD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,2BAA2B,EAAE,WAAW,CAAC,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,qDAAqD;IACrD,KAAK,MAAM,IAAI,IAAI,EAAc,EAAE,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,cAAc,CAC3B,GAAgB,EAChB,QAAsB,EACtB,IAAkB,EAClB,GAA8C;IAE9C,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC;IAC/B,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAE7D,4EAA4E;IAC5E,4EAA4E;IAC5E,6EAA6E;IAC7E,0EAA0E;IAC1E,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACvE,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,aAAa,2BAA2B,EAAE;oBAC5D,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACP,cAAc,EAAE,kBAAkB;wBAClC,aAAa,EAAE,UAAU,OAAO,EAAE;qBACnC;oBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,GAAG,EAAE,IAAI,CAAC,GAAG;wBACb,WAAW,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,SAAS;qBAC3D,CAAC;iBACH,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,sDAAsD;YACxD,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,yBAAyB,EAAE,CAAC;IAC5E,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAErE,MAAM,KAAK,GACT,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAElE,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QAChC,OAAO,EAAE,CAAC,KAAoB,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC;KACzE,CAAC,CAAC;IAEH,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,wEAAwE;QACxE,2EAA2E;QAC3E,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC7D,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,SAAS,CACjC,QAAQ,EACR,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EACxC,IAAI,CACL,CAAC;QACF,yEAAyE;QACzE,qBAAqB;QACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,wEAAwE;IACxE,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE;YACzB,MAAM,EAAE,WAAW;YACnB,KAAK,EAAE,QAAQ;YACf,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;SACnD,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAE5D,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE;QACzB,MAAM,EAAE,WAAW;QACnB,KAAK,EAAE,QAAQ;QACf,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,MAAM,EAAE;YACN,QAAQ,EAAE,YAAY,CAAC,QAAQ;YAC/B,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,MAAM;YACtC,SAAS,EAAE,YAAY,CAAC,UAAU;SACnC;KACF,CAAC,CAAC;IAEH,0EAA0E;IAC1E,iEAAiE;IACjE,qEAAqE;IACrE,0EAA0E;IAC1E,yEAAyE;IACzE,uCAAuC;AACzC,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,IAAiB,EACjB,WAAmB,EACnB,IAAc;IAEd,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACvE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;QAC9B,OAAO,EAAE,IAAI,CAAC,aAAa;QAC3B,OAAO;QACP,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAC;IAEH,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QACpE,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC;QAC5B,UAAU,IAAI,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAC5C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/server";
+import { serveStdio } from "@modelcontextprotocol/server/stdio";
+import { z } from "zod";
+import { TOOLS } from "./tools.js";
+import { createHandlers } from "./handlers.js";
+import { FINANCIALS_GLOSSARY } from "./glossary.js";
+import { TelemetryClient } from "./telemetry/client.js";
+import { SessionStore } from "./auth/session.js";
+import { FileFielStore } from "./fiel/store.js";
+import { startOnboardServer } from "./onboard/server.js";
+import { detectKeychain, fielKeychainKey } from "./keychain/keychain.js";
+import { KeychainFielProvider } from "./sat/keychainFielProvider.js";
+import { API_BASE_URL } from "./auth/firebaseConfig.js";
+/**
+ * Fintecia MCP server — local, read-only (+ local e-firma download).
+ *
+ * Auth is loopback OAuth: `fintecia_login` starts the local onboarding server
+ * (127.0.0.1), the user signs in with Google via the Firebase Web SDK, and the
+ * tokens land back in the in-process SessionStore. The upload handler reads the
+ * ID token from that store.
+ */
+function createServer() {
+    const server = new McpServer({ name: "fintecia-mcp", version: "0.1.0" });
+    const session = new SessionStore();
+    const fielStore = new FileFielStore();
+    const keychain = detectKeychain(process.platform);
+    const fielProvider = new KeychainFielProvider(fielStore, keychain);
+    const telemetry = new TelemetryClient({ baseUrl: API_BASE_URL });
+    let onboard = null;
+    const handlers = createHandlers({
+        fielProvider,
+        uploadBaseUrl: API_BASE_URL,
+        getAuthToken: async () => session.idToken,
+        listEfirmas: async () => {
+            const rfcs = await fielStore.list();
+            return Promise.all(rfcs.map(async (rfc) => ({
+                rfc,
+                hasPassword: (await keychain.get(fielKeychainKey(rfc))) !== null,
+            })));
+        },
+    });
+    const withTelemetry = (name, handler) => {
+        return async (input) => {
+            const start = Date.now();
+            try {
+                const result = await handler(input);
+                telemetry.emit("tool_called", {
+                    tool: name,
+                    outcome: "success",
+                    durationMs: Date.now() - start,
+                });
+                return result;
+            }
+            catch (err) {
+                telemetry.emit("tool_called", {
+                    tool: name,
+                    outcome: "error",
+                    durationMs: Date.now() - start,
+                });
+                throw err;
+            }
+        };
+    };
+    for (const tool of TOOLS) {
+        const handler = handlers.get(tool.name);
+        if (!handler)
+            continue;
+        server.registerTool(tool.name, {
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+            annotations: tool.annotations,
+        }, withTelemetry(tool.name, (input) => handler(input)));
+    }
+    // Auth trigger (loopback). Not part of TOOLS: it is the setup entrypoint,
+    // not a domain tool.
+    server.registerTool("fintecia_login", {
+        description: "Start the local onboarding page (loopback OAuth) so the user can sign " +
+            "in with Google and load their e-firma. Call this FIRST — the session " +
+            "is required by every authenticated tool. After the user finishes, call " +
+            "fintecia_efirmas to discover the registered e-firmas.",
+        inputSchema: z.object({}),
+        annotations: { readOnlyHint: true },
+    }, async () => {
+        telemetry.emit("login_started");
+        if (!onboard) {
+            onboard = await startOnboardServer(fielStore, session);
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Abrí esta URL en tu navegador para iniciar sesión con Google ` +
+                        `y conectar tu e-firma:\n\n${onboard.url}`,
+                },
+            ],
+        };
+    });
+    // Static field glossary — no auth, no backend round-trip. The agent can
+    // load it during onboarding (in parallel with login + e-firma) to learn
+    // the field semantics of fintecia_financials before it queries data.
+    server.registerTool("fintecia_glosario", {
+        description: "Field dictionary for the fintecia_* tools: what every field means " +
+            "(money objects, NIF B-3/B-6, taxes vs prepaid ISR, IVA in the balance). " +
+            "Static and auth-free — call it once to interpret fintecia_financials.",
+        inputSchema: z.object({}),
+        annotations: { readOnlyHint: true },
+    }, async () => ({
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({ glosario: FINANCIALS_GLOSSARY }, null, 2),
+            },
+        ],
+    }));
+    return server;
+}
+serveStdio(createServer, {
+    onerror: (error) => console.error("Fintecia MCP server error:", error),
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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