@wootsup/mcp 0.1.0-rc.1

package/dist/modules/apimapper/flows.js

@@ -0,0 +1,372 @@
+import { z } from "zod";
+import { formatResult, autoFormatTable, readOnly, creating, mutating, destructive, } from "@getimo/mcp-toolkit";
+import { request, hintFor } from "./client.js";
+import { nodeSchema } from "./node-schema.js";
+export function registerFlowTools(server) {
+    // ── apimapper_flow_list ────────────────────────────────────────────
+    server.registerTool("apimapper_flow_list", {
+        title: "List Flows",
+        description: "List all API Mapper flows. Use apimapper_flow_get for full structure." +
+            "\n\nExample:\n  apimapper_flow_list({ limit: 25 })",
+        inputSchema: {
+            source: z
+                .enum(["user", "demo", "library", "devtools", "all"])
+                .default("all")
+                .describe("Filter by origin"),
+            compiled: z.enum(["any", "yes", "no"]).default("any").describe("Filter by compile status"),
+            limit: z.number().min(1).max(500).default(100).describe("Max items (1-500)"),
+        },
+        annotations: readOnly(),
+    }, async ({ source, compiled, limit }) => {
+        const r = await request("/flows");
+        if (!r.success) {
+            return formatResult({
+                error: r.error,
+                status: r.status,
+                errorCode: r.errorCode,
+                context: { source, compiled, limit },
+                hint: hintFor(r.errorCode),
+            }, true);
+        }
+        let items = Array.isArray(r.data?.flows) ? r.data.flows : [];
+        // Derive `is_compiled` from REST shape: backend returns `compiledAt`
+        // (ISO timestamp string or null) and a `compiled` array of artifacts.
+        // Either indicates the flow has been compiled. Normalising here keeps
+        // downstream filtering + display logic uniform regardless of platform.
+        const isCompiledOf = (f) => {
+            if (typeof f.is_compiled === "boolean")
+                return f.is_compiled;
+            const raw = f;
+            if (typeof raw.compiledAt === "string" && raw.compiledAt.length > 0)
+                return true;
+            if (Array.isArray(raw.compiled) && raw.compiled.length > 0)
+                return true;
+            return false;
+        };
+        if (source !== "all")
+            items = items.filter((f) => f.source === source);
+        if (compiled === "yes")
+            items = items.filter((f) => isCompiledOf(f));
+        if (compiled === "no")
+            items = items.filter((f) => !isCompiledOf(f));
+        items = items.slice(0, limit);
+        return autoFormatTable(items.map((f) => ({
+            id: f.id,
+            name: f.name,
+            source: f.source || "—",
+            nodes: f.node_count ?? "?",
+            compiled: isCompiledOf(f) ? "✓" : "✗",
+            types: (f.node_types || []).join(","),
+        })), {
+            columns: [
+                // Width 36 accommodates 30+ char IDs (e.g. legacy template
+                // flows like flow_calendly_jla_229fcbce95b7 = 30 chars).
+                // Truncation produces orphan IDs that downstream tools fail
+                // to resolve via flow_get. The +6 headroom matches the
+                // longest historical IDs without bloating the table.
+                { key: "id", label: "ID", width: 36 },
+                { key: "name", label: "NAME", width: 32 },
+                { key: "source", label: "SRC", width: 10 },
+                { key: "nodes", label: "N", width: 4 },
+                { key: "compiled", label: "C", width: 3 },
+                { key: "types", label: "TYPES", width: 36 },
+            ],
+            header: (n) => `${n} flows`,
+            footer: "Use apimapper_flow_get <id> for full structure.",
+        });
+    });
+    // ── apimapper_flow_get ─────────────────────────────────────────────
+    server.registerTool("apimapper_flow_get", {
+        title: "Get Flow",
+        description: "Fetch full flow definition (nodes, edges, viewport, compiled artifact)." +
+            "\n\nExample:\n  apimapper_flow_get({ id: 'flow_Z2fLg70M84' })",
+        inputSchema: {
+            id: z.string().describe('Flow ID (e.g., "flow_aCfOEpwCtVZnPFwPOwO61"). Use apimapper_flow_list.'),
+        },
+        annotations: readOnly(),
+    }, async ({ id }) => {
+        const r = await request(`/flows/${encodeURIComponent(id)}`);
+        if (!r.success) {
+            return formatResult({ error: r.error, status: r.status, errorCode: r.errorCode, context: { id }, hint: hintFor(r.errorCode) }, true);
+        }
+        if (!r.data || (typeof r.data === "object" && Object.keys(r.data).length === 0)) {
+            return formatResult({ error: "flow not found", status: r.status, context: { id }, hint: hintFor("not_found") }, true);
+        }
+        return formatResult(r.data, false, { maxChars: 8000 });
+    });
+    // ── apimapper_flow_create ──────────────────────────────────────────
+    server.registerTool("apimapper_flow_create", {
+        title: "Create Flow",
+        description: "Create a new flow with full nodes + edges JSON. " +
+            "For declarative multi-source flow creation use apimapper_flow_setup_with_sources instead." +
+            "\n\nExample:\n  apimapper_flow_create({ name: 'My Pexels Gallery', nodes: [{ id: 'src1', type: 'source' }, { id: 'out1', type: 'output' }], edges: [{ source: 'src1', target: 'out1' }] })",
+        inputSchema: {
+            name: z.string().min(1).describe('Flow name (appears in YOOtheme dropdown)'),
+            description: z.string().optional().describe("Optional description"),
+            nodes: z
+                .array(nodeSchema)
+                .min(1)
+                .describe('Node array. Each: {id, type, position:{x,y}, data:{...}}. ' +
+                'Discriminator `type` ∈ source | local-source | filter | transform | merge | output | output-yootheme | output-shortcode. ' +
+                'Per-type required data fields: ' +
+                'source.connectionId, local-source.contentType, filter.conditions, ' +
+                'transform.expression, merge.strategy ∈ {concat, join}.'),
+            edges: z
+                .array(z.record(z.string(), z.unknown()))
+                .describe('Edge array. Each: {id, source, target, targetHandle?, sourceHandle?}. ' +
+                'For merge: targetHandle="input-A" (first input) or "input-B" (second).'),
+            viewport: z
+                .object({ x: z.number(), y: z.number(), zoom: z.number() })
+                .optional()
+                .describe('React-Flow viewport (e.g., {"x":0,"y":0,"zoom":1})'),
+        },
+        annotations: creating(),
+    }, async (input) => {
+        const r = await request("/flows", {
+            method: "POST",
+            body: JSON.stringify(input),
+        });
+        if (!r.success) {
+            return formatResult({
+                error: r.error,
+                status: r.status,
+                errorCode: r.errorCode,
+                context: { name: input.name, node_count: input.nodes.length },
+                hint: hintFor(r.errorCode),
+            }, true);
+        }
+        return formatResult({
+            created: true,
+            id: r.data?.id,
+            name: r.data?.name,
+            node_count: r.data?.node_count,
+            is_compiled: r.data?.is_compiled ?? false,
+            next: "Call apimapper_flow_compile to publish to YOOtheme.",
+        }, false, { maxChars: 2000 });
+    });
+    // ── apimapper_flow_update ──────────────────────────────────────────
+    server.registerTool("apimapper_flow_update", {
+        title: "Update Flow",
+        description: "Update flow fields. Use to modify nodes/edges (e.g., toggle merge.strategy, change joinKey). " +
+            "After update, call apimapper_flow_compile." +
+            "\n\nExample:\n  apimapper_flow_update({ id: 'flow_Z2fLg70M84', name: 'My Pexels Gallery (v2)' })",
+        inputSchema: {
+            id: z.string().describe("Flow ID. Use apimapper_flow_list to find."),
+            patch: z
+                .record(z.string(), z.unknown())
+                .describe('Fields to patch (e.g., {"nodes":[...updated nodes...]} or {"name":"Renamed"})'),
+        },
+        annotations: mutating(),
+    }, async ({ id, patch }) => {
+        const r = await request(`/flows/${encodeURIComponent(id)}`, {
+            method: "PUT",
+            body: JSON.stringify(patch),
+        });
+        if (!r.success) {
+            return formatResult({ error: r.error, status: r.status, errorCode: r.errorCode, context: { id }, hint: hintFor(r.errorCode) }, true);
+        }
+        return formatResult({
+            updated: true,
+            id: r.data?.id,
+            name: r.data?.name,
+            version: r.data?.version,
+            is_compiled: r.data?.is_compiled,
+            next: r.data?.is_compiled ? "Compile likely invalidated — call apimapper_flow_compile." : undefined,
+        }, false, { maxChars: 2000 });
+    });
+    // ── apimapper_flow_delete ──────────────────────────────────────────
+    server.registerTool("apimapper_flow_delete", {
+        title: "Delete Flow",
+        description: "Permanently delete a flow. If published, it disappears from YOOtheme. " +
+            "Preview-mode (confirm:false) fetches metadata first." +
+            "\n\nExample:\n  apimapper_flow_delete({ id: 'flow_Z2fLg70M84', confirm: false })",
+        inputSchema: {
+            id: z.string().describe("Flow ID. Use apimapper_flow_list to find."),
+            confirm: z
+                .boolean()
+                .default(false)
+                .describe("Must be true to execute. On confirm:false, returns a preview."),
+        },
+        annotations: destructive(),
+    }, async ({ id, confirm }) => {
+        if (!confirm) {
+            const preview = await request(`/flows/${encodeURIComponent(id)}`);
+            return formatResult({
+                preview: true,
+                warning: "DESTRUCTIVE — Flow delete cannot be undone. Sources disappear from YOOtheme.",
+                target: preview.success && preview.data
+                    ? {
+                        id: preview.data.id,
+                        name: preview.data.name,
+                        node_count: preview.data.node_count,
+                        is_compiled: preview.data.is_compiled,
+                        node_types: preview.data.node_types,
+                    }
+                    : { id, note: "could not preview — id may not exist" },
+                instruction: "Ask user to confirm, then call again with confirm: true.",
+            });
+        }
+        const r = await request(`/flows/${encodeURIComponent(id)}`, { method: "DELETE" });
+        if (!r.success) {
+            return formatResult({ error: r.error, status: r.status, errorCode: r.errorCode, context: { id }, hint: hintFor(r.errorCode) }, true);
+        }
+        return formatResult({ deleted: true, id }, false, { maxChars: 1500 });
+    });
+    // ── apimapper_flow_compile ─────────────────────────────────────────
+    server.registerTool("apimapper_flow_compile", {
+        title: "Compile Flow",
+        description: "Compile flow into executable pipeline (validation + topo sort + step generation + schema). " +
+            "Required before flow appears in YOOtheme." +
+            "\n\nExample:\n  apimapper_flow_compile({ id: 'flow_Z2fLg70M84' })",
+        inputSchema: {
+            id: z.string().describe("Flow ID. Use apimapper_flow_list to find."),
+        },
+        annotations: mutating(),
+    }, async ({ id }) => {
+        const r = await request(`/flows/${encodeURIComponent(id)}/compile`, { method: "POST" });
+        if (!r.success) {
+            return formatResult({ error: r.error, status: r.status, errorCode: r.errorCode, context: { id }, hint: hintFor(r.errorCode) }, true);
+        }
+        const dataObj = r.data && typeof r.data === "object" ? r.data : {};
+        const flow = dataObj.flow ?? dataObj;
+        const errors = Array.isArray(dataObj.errors) ? dataObj.errors : [];
+        if (errors.length > 0 || (flow && flow.is_compiled === false)) {
+            return formatResult({
+                error: "compile failed",
+                status: r.status,
+                context: { id, errors },
+                hint: "Review the errors[] — most likely missing connection, missing joinKey, or invalid JMESPath. Use apimapper_flow_get to inspect node data.",
+            }, true);
+        }
+        return formatResult({
+            compiled: true,
+            id: flow?.id ?? id,
+            version: flow?.version,
+            node_count: flow?.node_count,
+            next: "Source now appears in YOOtheme dropdown. Use apimapper_graph_preview to test items.",
+        }, false, { maxChars: 2500 });
+    });
+    // ── apimapper_flow_detect_schema ───────────────────────────────────
+    server.registerTool("apimapper_flow_detect_schema", {
+        title: "Detect Flow Schema",
+        description: "Re-detect/refresh the output schema by sampling the upstream API. " +
+            "Use after upstream endpoint changes to surface new fields in the YOOtheme Builder." +
+            "\n\nExample:\n  apimapper_flow_detect_schema({ id: 'flow_Z2fLg70M84' })",
+        inputSchema: {
+            id: z.string().describe("Flow ID. Use apimapper_flow_list to find."),
+        },
+        annotations: mutating(),
+    }, async ({ id }) => {
+        const r = await request(`/flows/${encodeURIComponent(id)}/detect-schema`, { method: "POST" });
+        if (!r.success) {
+            return formatResult({ error: r.error, status: r.status, errorCode: r.errorCode, context: { id }, hint: hintFor(r.errorCode) }, true);
+        }
+        const fields = Array.isArray(r.data?.fields) ? r.data.fields : [];
+        return formatResult({
+            detected: true,
+            id,
+            field_count: fields.length,
+            fields: fields.slice(0, 50),
+            output_schema: r.data?.output_schema,
+        }, false, { maxChars: 6000 });
+    });
+    // ── apimapper_flow_trace ───────────────────────────────────────────
+    server.registerTool("apimapper_flow_trace", {
+        title: "Get Flow Execution Trace",
+        description: "Fetch the execution trace from the last run (timing per step, item counts, errors). " +
+            "Useful for debugging slow flows or incorrect outputs." +
+            "\n\nExample:\n  apimapper_flow_trace({ id: 'flow_Z2fLg70M84' })",
+        inputSchema: {
+            id: z.string().describe("Flow ID. Use apimapper_flow_list to find."),
+        },
+        annotations: readOnly(),
+    }, async ({ id }) => {
+        const r = await request(`/flows/${encodeURIComponent(id)}/trace`);
+        if (!r.success) {
+            return formatResult({ error: r.error, status: r.status, errorCode: r.errorCode, context: { id }, hint: hintFor(r.errorCode) }, true);
+        }
+        const steps = Array.isArray(r.data?.steps) ? r.data.steps : [];
+        return formatResult({
+            id,
+            total_ms: r.data?.total_ms,
+            step_count: steps.length,
+            steps: steps.slice(0, 50),
+        }, false, { maxChars: 6000 });
+    });
+    // ── apimapper_flow_export ──────────────────────────────────────────
+    server.registerTool("apimapper_flow_export", {
+        title: "Export Flow",
+        description: "Export a flow as a portable JSON bundle (incl. connection refs)." +
+            "\n\nExample:\n  apimapper_flow_export({ id: 'flow_Z2fLg70M84' })",
+        inputSchema: {
+            id: z.string().describe("Flow ID. Use apimapper_flow_list to find."),
+        },
+        annotations: readOnly(),
+    }, async ({ id }) => {
+        const r = await request(`/flows/${encodeURIComponent(id)}/export`);
+        if (!r.success) {
+            return formatResult({ error: r.error, status: r.status, errorCode: r.errorCode, context: { id }, hint: hintFor(r.errorCode) }, true);
+        }
+        return formatResult(r.data ?? {}, false, { maxChars: 12000 });
+    });
+    // ── apimapper_flow_import_validate ─────────────────────────────────
+    server.registerTool("apimapper_flow_import_validate", {
+        title: "Validate Flow Import Bundle",
+        description: "Validate a flow JSON bundle before importing. Reports missing connections, schema " +
+            "incompatibilities, and unresolved references." +
+            "\n\nExample:\n  apimapper_flow_import_validate({ bundle: { schema_version: 1, data: { flow: { name: 'Imported Flow' } } } })",
+        inputSchema: {
+            bundle: z
+                .record(z.string(), z.unknown())
+                .describe("Flow bundle JSON (from apimapper_flow_export or external source)"),
+        },
+        annotations: readOnly(),
+    }, async ({ bundle }) => {
+        const r = await request("/flows/import/validate", { method: "POST", body: JSON.stringify(bundle) });
+        if (!r.success) {
+            return formatResult({ error: r.error, status: r.status, errorCode: r.errorCode, context: {}, hint: hintFor(r.errorCode) }, true);
+        }
+        return formatResult({
+            valid: r.data?.valid ?? true,
+            issues: r.data?.issues || [],
+            warnings: r.data?.warnings || [],
+        }, false, { maxChars: 4000 });
+    });
+    // ── apimapper_flow_import ──────────────────────────────────────────
+    server.registerTool("apimapper_flow_import", {
+        title: "Import Flow Bundle",
+        description: "Import a flow JSON bundle. Always validate first with apimapper_flow_import_validate. " +
+            "Rename works via `bundle.data.flow.name`; pass `rename_to` and the tool inserts it correctly." +
+            "\n\nExample:\n  apimapper_flow_import({ bundle: { schema_version: 1, data: { flow: { name: 'Imported Flow' } } }, rename_to: 'My Imported Flow' })",
+        inputSchema: {
+            bundle: z
+                .record(z.string(), z.unknown())
+                .describe("Flow bundle JSON (from apimapper_flow_export or external source)"),
+            rename_to: z.string().optional().describe("Optional override for imported flow name"),
+        },
+        annotations: creating(),
+    }, async ({ bundle, rename_to }) => {
+        // Server reads `$exportData = $data['data'] ?? $data` and then
+        // `$exportData['flow']['name']`. Mutate bundle accordingly.
+        let body = bundle;
+        if (rename_to) {
+            const cloned = JSON.parse(JSON.stringify(bundle));
+            const exportData = (cloned.data && typeof cloned.data === "object" ? cloned.data : cloned);
+            const flow = (exportData.flow && typeof exportData.flow === "object" ? exportData.flow : {});
+            flow.name = rename_to;
+            exportData.flow = flow;
+            if (cloned.data)
+                cloned.data = exportData;
+            body = cloned;
+        }
+        const r = await request("/flows/import", {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+        if (!r.success) {
+            return formatResult({ error: r.error, status: r.status, errorCode: r.errorCode, context: { rename_to }, hint: hintFor(r.errorCode) }, true);
+        }
+        return formatResult({ imported: true, id: r.data?.id, name: r.data?.name }, false, { maxChars: 2000 });
+    });
+}
+//# sourceMappingURL=flows.js.map

package/dist/modules/apimapper/flows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flows.js","sourceRoot":"","sources":["../../../src/modules/apimapper/flows.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,sEAAsE;IACtE,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,uEAAuE;YACpF,oDAAoD;QACpD,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;iBACpD,OAAO,CAAC,KAAK,CAAC;iBACd,QAAQ,CAAC,kBAAkB,CAAC;YAC/B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YAC1F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;SAC7E;QACD,WAAW,EAAE,QAAQ,EAAE;KACxB,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;QACpC,MAAM,CAAC,GAAG,MAAM,OAAO,CAAoB,QAAQ,CAAC,CAAC;QACrD,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,YAAY,CACjB;gBACE,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;gBACpC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;aAC3B,EACD,IAAI,CACL,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,qEAAqE;QACrE,sEAAsE;QACtE,sEAAsE;QACtE,uEAAuE;QACvE,MAAM,YAAY,GAAG,CAAC,CAAO,EAAW,EAAE;YACxC,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,SAAS;gBAAE,OAAO,CAAC,CAAC,WAAW,CAAC;YAC7D,MAAM,GAAG,GAAG,CAA8D,CAAC;YAC3E,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;YACjF,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;YACxE,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;QACF,IAAI,MAAM,KAAK,KAAK;YAAE,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QACvE,IAAI,QAAQ,KAAK,KAAK;YAAE,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,IAAI,QAAQ,KAAK,IAAI;YAAE,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC9B,OAAO,eAAe,CACpB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,GAAG;YACvB,KAAK,EAAE,CAAC,CAAC,UAAU,IAAI,GAAG;YAC1B,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;YACrC,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;SACtC,CAAC,CAA8B,EAChC;YACE,OAAO,EAAE;gBACP,2DAA2D;gBAC3D,yDAAyD;gBACzD,4DAA4D;gBAC5D,uDAAuD;gBACvD,qDAAqD;gBACrD,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;gBACrC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;gBACzC,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC1C,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE;gBACtC,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE;gBACzC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;aAC5C;YACD,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ;YAC3B,MAAM,EAAE,iDAAiD;SAC1D,CACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,sEAAsE;IACtE,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,yEAAyE;YACtF,+DAA+D;QAC/D,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wEAAwE,CAAC;SAClG;QACD,WAAW,EAAE,QAAQ,EAAE;KACxB,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACf,MAAM,CAAC,GAAG,MAAM,OAAO,CAAO,UAAU,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,YAAY,CACjB,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EACzG,IAAI,CACL,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YAChF,OAAO,YAAY,CACjB,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,EAC1F,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC,CACF,CAAC;IAEF,sEAAsE;IACtE,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,kDAAkD;YAClD,2FAA2F;YAC3F,4LAA4L;QAC9L,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0CAA0C,CAAC;YAC5E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YACnE,KAAK,EAAE,CAAC;iBACL,KAAK,CAAC,UAAU,CAAC;iBACjB,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CACP,4DAA4D;gBAC1D,2HAA2H;gBAC3H,iCAAiC;gBACjC,oEAAoE;gBACpE,wDAAwD,CAC3D;YACH,KAAK,EAAE,CAAC;iBACL,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;iBACxC,QAAQ,CACP,wEAAwE;gBACtE,wEAAwE,CAC3E;YACH,QAAQ,EAAE,CAAC;iBACR,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;iBAC1D,QAAQ,EAAE;iBACV,QAAQ,CAAC,oDAAoD,CAAC;SAClE;QACD,WAAW,EAAE,QAAQ,EAAE;KACxB,EACD,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,CAAC,GAAG,MAAM,OAAO,CAAO,QAAQ,EAAE;YACtC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SAC5B,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,YAAY,CACjB;gBACE,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE;gBAC7D,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;aAC3B,EACD,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,YAAY,CACjB;YACE,OAAO,EAAE,IAAI;YACb,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE;YACd,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI;YAClB,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU;YAC9B,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,IAAI,KAAK;YACzC,IAAI,EAAE,qDAAqD;SAC5D,EACD,KAAK,EACL,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,sEAAsE;IACtE,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,+FAA+F;YAC/F,4CAA4C;YAC5C,kGAAkG;QACpG,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YACpE,KAAK,EAAE,CAAC;iBACL,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;iBAC/B,QAAQ,CACP,+EAA+E,CAChF;SACJ;QACD,WAAW,EAAE,QAAQ,EAAE;KACxB,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QACtB,MAAM,CAAC,GAAG,MAAM,OAAO,CAAO,UAAU,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE;YAChE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SAC5B,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,YAAY,CACjB,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EACzG,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,YAAY,CACjB;YACE,OAAO,EAAE,IAAI;YACb,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE;YACd,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI;YAClB,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO;YACxB,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW;YAChC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,2DAA2D,CAAC,CAAC,CAAC,SAAS;SACpG,EACD,KAAK,EACL,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,sEAAsE;IACtE,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EACT,wEAAwE;YACxE,sDAAsD;YACtD,kFAAkF;QACpF,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YACpE,OAAO,EAAE,CAAC;iBACP,OAAO,EAAE;iBACT,OAAO,CAAC,KAAK,CAAC;iBACd,QAAQ,CAAC,+DAA+D,CAAC;SAC7E;QACD,WAAW,EAAE,WAAW,EAAE;KAC3B,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACxB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,MAAM,OAAO,CAAO,UAAU,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACxE,OAAO,YAAY,CAAC;gBAClB,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,8EAA8E;gBACvF,MAAM,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI;oBACrC,CAAC,CAAC;wBACE,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE;wBACnB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI;wBACvB,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU;wBACnC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW;wBACrC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU;qBACpC;oBACH,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,sCAAsC,EAAE;gBACxD,WAAW,EAAE,0DAA0D;aACxE,CAAC,CAAC;QACL,CAAC;QACD,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,UAAU,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClF,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,YAAY,CACjB,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EACzG,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC,CACF,CAAC;IAEF,sEAAsE;IACtE,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,6FAA6F;YAC7F,2CAA2C;YAC3C,mEAAmE;QACrE,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;SACrE;QACD,WAAW,EAAE,QAAQ,EAAE;KACxB,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACf,MAAM,CAAC,GAAG,MAAM,OAAO,CACrB,UAAU,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAC1C,EAAE,MAAM,EAAE,MAAM,EAAE,CACnB,CAAC;QACF,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,YAAY,CACjB,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EACzG,IAAI,CACL,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,IAAgC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChG,MAAM,IAAI,GAAI,OAAO,CAAC,IAAyB,IAAK,OAA2B,CAAC;QAChF,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,KAAK,KAAK,CAAC,EAAE,CAAC;YAC9D,OAAO,YAAY,CACjB;gBACE,KAAK,EAAE,gBAAgB;gBACvB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,OAAO,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE;gBACvB,IAAI,EAAE,0IAA0I;aACjJ,EACD,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,YAAY,CACjB;YACE,QAAQ,EAAE,IAAI;YACd,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE;YAClB,OAAO,EAAE,IAAI,EAAE,OAAO;YACtB,UAAU,EAAE,IAAI,EAAE,UAAU;YAC5B,IAAI,EAAE,qFAAqF;SAC5F,EACD,KAAK,EACL,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,sEAAsE;IACtE,MAAM,CAAC,YAAY,CACjB,8BAA8B,EAC9B;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,oEAAoE;YACpE,oFAAoF;YACpF,yEAAyE;QAC3E,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;SACrE;QACD,WAAW,EAAE,QAAQ,EAAE;KACxB,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACf,MAAM,CAAC,GAAG,MAAM,OAAO,CACrB,UAAU,kBAAkB,CAAC,EAAE,CAAC,gBAAgB,EAChD,EAAE,MAAM,EAAE,MAAM,EAAE,CACnB,CAAC;QACF,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,YAAY,CACjB,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EACzG,IAAI,CACL,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,OAAO,YAAY,CACjB;YACE,QAAQ,EAAE,IAAI;YACd,EAAE;YACF,WAAW,EAAE,MAAM,CAAC,MAAM;YAC1B,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YAC3B,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE,aAAa;SACrC,EACD,KAAK,EACL,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,sEAAsE;IACtE,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,sFAAsF;YACtF,uDAAuD;YACvD,iEAAiE;QACnE,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;SACrE;QACD,WAAW,EAAE,QAAQ,EAAE;KACxB,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACf,MAAM,CAAC,GAAG,MAAM,OAAO,CACrB,UAAU,kBAAkB,CAAC,EAAE,CAAC,QAAQ,CACzC,CAAC;QACF,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,YAAY,CACjB,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EACzG,IAAI,CACL,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,YAAY,CACjB;YACE,EAAE;YACF,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ;YAC1B,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SAC1B,EACD,KAAK,EACL,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,sEAAsE;IACtE,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,kEAAkE;YAC/E,kEAAkE;QAClE,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;SACrE;QACD,WAAW,EAAE,QAAQ,EAAE;KACxB,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACf,MAAM,CAAC,GAAG,MAAM,OAAO,CACrB,UAAU,kBAAkB,CAAC,EAAE,CAAC,SAAS,CAC1C,CAAC;QACF,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,YAAY,CACjB,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EACzG,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,YAAY,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC,CACF,CAAC;IAEF,sEAAsE;IACtE,MAAM,CAAC,YAAY,CACjB,gCAAgC,EAChC;QACE,KAAK,EAAE,6BAA6B;QACpC,WAAW,EACT,oFAAoF;YACpF,+CAA+C;YAC/C,8HAA8H;QAChI,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;iBAC/B,QAAQ,CAAC,kEAAkE,CAAC;SAChF;QACD,WAAW,EAAE,QAAQ,EAAE;KACxB,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,MAAM,CAAC,GAAG,MAAM,OAAO,CACrB,wBAAwB,EACxB,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CACjD,CAAC;QACF,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,YAAY,CACjB,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EACrG,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,YAAY,CACjB;YACE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI;YAC5B,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE;YAC5B,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE;SACjC,EACD,KAAK,EACL,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,sEAAsE;IACtE,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,wFAAwF;YACxF,+FAA+F;YAC/F,oJAAoJ;QACtJ,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;iBAC/B,QAAQ,CAAC,kEAAkE,CAAC;YAC/E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;SACtF;QACD,WAAW,EAAE,QAAQ,EAAE;KACxB,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE;QAC9B,+DAA+D;QAC/D,4DAA4D;QAC5D,IAAI,IAAI,GAAG,MAAM,CAAC;QAClB,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAA4B,CAAC;YAC7E,MAAM,UAAU,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAGxF,CAAC;YACF,MAAM,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAG1F,CAAC;YACF,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;YACtB,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC;YACvB,IAAI,MAAM,CAAC,IAAI;gBAAE,MAAM,CAAC,IAAI,GAAG,UAAU,CAAC;YAC1C,IAAI,GAAG,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,CAAC,GAAG,MAAM,OAAO,CAAO,eAAe,EAAE;YAC7C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,YAAY,CACjB,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAChH,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,YAAY,CACjB,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EACtD,KAAK,EACL,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/modules/apimapper/get-skill.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const SKILL_TOPICS: readonly ["getting-started", "oauth", "yootheme", "joomla", "troubleshooting"];
+export type SkillTopic = (typeof SKILL_TOPICS)[number];
+export declare function registerGetSkillTool(server: McpServer, rootDir?: string): void;

package/dist/modules/apimapper/get-skill.js

@@ -0,0 +1,88 @@
+// src/modules/apimapper/get-skill.ts — Phase 7.4.
+//
+// apimapper_get_skill: returns the markdown content of one of the 5 bundled
+// skill docs. Sibling to skill://apimapper/<topic> resources (Phase 7.3) for
+// clients that prefer tool-call discovery over resource discovery.
+import { z } from "zod";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join, resolve } from "node:path";
+import { readOnly } from "@getimo/mcp-toolkit";
+export const SKILL_TOPICS = [
+    "getting-started",
+    "oauth",
+    "yootheme",
+    "joomla",
+    "troubleshooting",
+];
+const TOPIC_TO_FILE = {
+    "getting-started": "SKILL.md",
+    oauth: "reference/oauth.md",
+    yootheme: "reference/yootheme.md",
+    joomla: "reference/joomla.md",
+    troubleshooting: "reference/troubleshooting.md",
+};
+function defaultSkillsRoot() {
+    // <pkg-root>/src/modules/apimapper/get-skill.ts → up three.
+    const here = dirname(fileURLToPath(import.meta.url));
+    return resolve(here, "..", "..", "..");
+}
+export function registerGetSkillTool(server, rootDir) {
+    const baseDir = rootDir ?? defaultSkillsRoot();
+    server.registerTool("apimapper_get_skill", {
+        title: "Get Skill Doc",
+        description: "Returns the markdown content of a bundled API Mapper skill doc. " +
+            `Topics: ${SKILL_TOPICS.join(", ")}. Sibling to skill://apimapper/<topic> resources.` +
+            "\n\nExample:\n  apimapper_get_skill({ topic: 'getting-started' })",
+        inputSchema: {
+            topic: z
+                .enum(SKILL_TOPICS)
+                .describe(`Which doc to fetch — one of: ${SKILL_TOPICS.join(", ")}`),
+        },
+        annotations: readOnly(),
+    }, async ({ topic }) => {
+        // Defensive runtime check — zod already validates at the MCP layer, but
+        // a direct unit-test invocation can bypass validation, and we want to
+        // produce a helpful structured error rather than crash on undefined.
+        if (!SKILL_TOPICS.includes(topic)) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `Unknown topic "${String(topic)}". ` +
+                            `Valid topics: ${SKILL_TOPICS.join(", ")}.`,
+                    },
+                ],
+            };
+        }
+        const filePath = join(baseDir, "skills", "apimapper", TOPIC_TO_FILE[topic]);
+        let text;
+        try {
+            text = readFileSync(filePath, "utf8");
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to read skill doc for topic "${topic}": ${message}. ` +
+                            `Hint: ensure skills/ is bundled with the MCP package. ` +
+                            `Valid topics: ${SKILL_TOPICS.join(", ")}.`,
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=get-skill.js.map

package/dist/modules/apimapper/get-skill.js.map

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

package/dist/modules/apimapper/graph-builder.d.ts

@@ -0,0 +1,47 @@
+import type { FlowNode, FlowEdge } from "./types.js";
+export interface SourceSpec {
+    connection: string;
+    endpoint?: string;
+    template_fields?: Record<string, string>;
+    items_path?: string;
+    label?: string;
+}
+export interface MergeSpec {
+    strategy: "join" | "concat" | "append";
+    joinKey?: string;
+    joinKeyRight?: string;
+    joinType?: "left" | "inner";
+}
+export interface TransformSpec {
+    expression?: string;
+}
+export interface OutputSpec {
+    type?: "yootheme" | "shortcode";
+    name: string;
+    slug?: string;
+}
+export interface BuildFlowGraphInput {
+    sources: SourceSpec[];
+    merge?: MergeSpec;
+    transform?: TransformSpec;
+    output: OutputSpec;
+}
+export interface BuildFlowGraphResult {
+    nodes: FlowNode[];
+    edges: FlowEdge[];
+    viewport: {
+        x: number;
+        y: number;
+        zoom: number;
+    };
+}
+/**
+ * Build a complete React-Flow graph from declarative source/merge/transform
+ * /output specs. Layout is deterministic (left-to-right columns).
+ *
+ * Throws `Error` for invalid combinations the FlowCompiler would reject:
+ *   - sources.length === 0
+ *   - sources.length >= 2 without `merge`
+ *   - merge.strategy === "join" without `joinKey`
+ */
+export declare function buildFlowGraph(input: BuildFlowGraphInput): BuildFlowGraphResult;