@wootsup/mcp 0.1.0 → 0.4.0

package/dist/modules/apimapper/graph.js

@@ -1,7 +1,28 @@
 import { z } from "zod";
 import { formatResult, errorResult, readOnly } from "@getimo/mcp-toolkit";
 import { request, hintFor } from "./client.js";
-import { nodeSchema, edgeSchema } from "./node-schema.js";
+import { restErrorResult } from "./tool-result.js";
+import { nodeSchema, edgeSchema, ensureEdgeIds, isOutputNode } from "./node-schema.js";
+/**
+ * F10 (2026-06-09): pick the flow's TERMINAL node id — the output-* node that
+ * the graph computes up to by default. Returns the id of the LAST output node
+ * in document order (a flow has exactly one terminal output; on the rare
+ * multi-output graph the last one authored wins, matching the FlowCompiler's
+ * findOutputNode tail-bias) or `undefined` when no output node exists. A loose
+ * `{ id?, type? }` shape is accepted so it works on both validated FlowNodes
+ * and raw hydrated wire objects.
+ */
+function terminalOutputNodeId(nodes) {
+    let found;
+    for (const n of nodes) {
+        if (isOutputNode(n)) {
+            const id = n.id;
+            if (typeof id === "string" && id !== "")
+                found = id;
+        }
+    }
+    return found;
+}
 import { buildFlowVisualization, SIDECAR_RESPONSE_MAX_CHARS, } from "./render/sidecar.js";
 /**
  * L-7 (W3F-5): hydrate `{nodes, edges}` from a saved flow when the
@@ -41,8 +62,15 @@ export function registerGraphTools(server) {
             "result without re-executing the pipeline. Use `forceRefresh: true` only after a " +
             "Connection/Credential mutation or when upstream API data is known to have changed. " +
             "Do NOT call repeatedly to 're-render' or 'double-check' the same graph — the second " +
-            "call returns the same payload as the first." +
-            "\n\nExample:\n  apimapper_graph_preview({ nodes: [{ id: 'src1', type: 'source' }], edges: [], target_node_id: 'src1' })",
+            "call returns the same payload as the first.\n\n" +
+            "**Merge join with 0 rows:** when a `merge` node (strategy `join`) yields 0 items while both " +
+            "its inputs had data, the response carries a `merge_diagnostics[<mergeNodeId>]` object " +
+            "(`reason: merge_no_match`) with the join keys and a sample of the non-matching key values " +
+            "from each side. Read it instead of guessing — the usual cause is a wrong/incomparable join " +
+            "key (e.g. string \"P-100\" vs number 42). Sample both sides with apimapper_connection_data, " +
+            "then fix the merge joinKey/joinKeyRight." +
+            "\n\nExample:\n  apimapper_graph_preview({ nodes: [{ id: 'src1', type: 'source', position: { x: 0, y: 0 }, data: { connectionId: 'con_abc123' } }], edges: [], target_node_id: 'src1' })" +
+            "\n  apimapper_graph_preview({ id: 'flow_Z2fLg70M84' })  // `id` is an alias for `flow_id`",
         inputSchema: {
             // L-7 (W3F-5): `flow_id` shortcut hydrates {nodes, edges} from
             // the saved flow server-side so the caller does not have to
@@ -52,7 +80,17 @@ export function registerGraphTools(server) {
                 .string()
                 .optional()
                 .describe("Saved flow ID. When set, {nodes, edges} are loaded from the flow before preview. " +
-                "Inline {nodes, edges} (if also provided) override the loaded values."),
+                "Inline {nodes, edges} (if also provided) override the loaded values. " +
+                "`id` is accepted as an alias (see below); `flow_id` wins when both are passed."),
+            // D (2026-06-04): `id` is an alias for `flow_id`. The AI repeatedly
+            // passed {id: "flow_…"} → "Invalid arguments". Mirror the dual-name
+            // ergonomics of apimapper_flow_full_recompile_publish. When both are
+            // present, explicit `flow_id` wins.
+            id: z
+                .string()
+                .optional()
+                .describe("Alias for `flow_id`. When `flow_id` is absent and `id` is present, `id` is used to " +
+                "hydrate {nodes, edges} from the saved flow. `flow_id` takes precedence when both are set."),
             nodes: z
                 .array(nodeSchema)
                 .optional()
@@ -67,28 +105,70 @@ export function registerGraphTools(server) {
             targetNodeId: z
                 .string()
                 .optional()
-                .describe("Compute preview up to this node and return its output (default: terminal output)"),
+                .describe("Compute preview up to this node and return its output. When omitted, defaults " +
+                "to the flow's terminal output node (the output-* node) so passing just a flow id " +
+                "previews the finished source. Snake_case alias: `target_node_id`."),
+            // F60 + F152: snake_case alias. graph_preview is one of the
+            // few tools with a camelCase wire contract; cold agents reflexively
+            // pass the snake_case form (every other tool uses it, and this tool's
+            // OWN example shows `target_node_id`). Accept both — `targetNodeId`
+            // (canonical) wins on conflict. The wire body keeps camelCase
+            // (whitelist-drift pins {nodes,edges,targetNodeId,forceRefresh}).
+            target_node_id: z
+                .string()
+                .optional()
+                .describe("Snake_case alias of `targetNodeId`. `targetNodeId` wins when both are set."),
+            // F10 (2026-06-09): accept a `limit` arg gracefully. The AI passes it
+            // reflexively (mirroring the *_list / *_query tools); rejecting it as an
+            // unknown key forced a confusing retry. The preview already caps the
+            // returned items at 50 server-side-of-the-tool; `limit` lets the caller
+            // ask for fewer. Clamped to [1, 50] — the upstream pipeline still
+            // executes fully; this only trims the items echoed back.
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .optional()
+                .describe("Max preview items to return (1-50, default 50). Caps only the echoed items list — " +
+                "the pipeline still executes in full. Accepted for ergonomic parity with the list/query tools."),
             forceRefresh: z
                 .boolean()
                 .default(false)
-                .describe("Skip snapshot/cache; always live-fetch from upstream"),
+                .describe("Skip snapshot/cache; always live-fetch from upstream. " +
+                "Snake_case alias: `force_refresh`."),
+            // F60 + F152: snake_case alias for `forceRefresh` — same
+            // ergonomics rationale as `target_node_id`. No default here so an
+            // absent value does not shadow the canonical `forceRefresh: false`
+            // default; the handler ORs the two (either truthy → refresh).
+            force_refresh: z
+                .boolean()
+                .optional()
+                .describe("Snake_case alias of `forceRefresh`. Either spelling being true forces a refresh."),
         },
         annotations: readOnly({ title: "Preview Graph", openWorld: true }),
-    }, async ({ flow_id, nodes, edges, targetNodeId, forceRefresh }) => {
-        // L-7 (W3F-5): hydrate from flow_id when inline arrays are absent.
+    }, async ({ flow_id, id, nodes, edges, targetNodeId, target_node_id, limit, forceRefresh, force_refresh }) => {
+        // F60 + F152: resolve the snake_case aliases. Canonical camelCase
+        // wins for the target node (explicit `targetNodeId` over the alias);
+        // `forceRefresh` is a boolean OR so either spelling being true refreshes.
+        const resolvedTargetNodeId = targetNodeId ?? target_node_id;
+        const resolvedForceRefresh = forceRefresh || force_refresh === true;
+        // D (2026-06-04): resolve the `id` alias — explicit `flow_id` (canonical)
+        // wins over `id` when both are present, mirroring
+        // apimapper_flow_full_recompile_publish.
+        const resolvedFlowId = flow_id ?? id;
+        // L-7 (W3F-5): hydrate from the flow id when inline arrays are absent.
         let resolvedNodes = nodes;
         let resolvedEdges = edges;
-        if (typeof flow_id === "string" &&
-            flow_id !== "" &&
+        if (typeof resolvedFlowId === "string" &&
+            resolvedFlowId !== "" &&
             (!Array.isArray(resolvedNodes) || resolvedNodes.length === 0)) {
-            const h = await hydrateGraphFromFlowId(flow_id);
+            const h = await hydrateGraphFromFlowId(resolvedFlowId);
             if ("error" in h) {
-                return errorResult({
-                    message: h.error,
-                    code: h.errorCode ?? (h.status ? String(h.status) : undefined),
-                    suggestion: hintFor("not_found"),
-                    details: { flow_id },
-                });
+                // Per-site nuance: the hydration failure (h.error always present)
+                // pins a fixed `not_found` suggestion regardless of the underlying
+                // error code, since a missing/empty flow is the only failure mode here.
+                return restErrorResult(h, { flow_id: resolvedFlowId }, { suggestion: hintFor("not_found") });
             }
             resolvedNodes = h.nodes;
             resolvedEdges = h.edges;
@@ -105,34 +185,62 @@ export function registerGraphTools(server) {
             resolvedEdges = [];
         }
         const localNodes = resolvedNodes;
-        const localEdges = resolvedEdges;
+        // F5 (2026-06-09): stamp a stable id on any id-less inline edge before
+        // POST so the backend graph engine accepts the graph (same fix as
+        // flow_create). Hydrated edges already carry ids; ensureEdgeIds is a
+        // no-op for them.
+        const localEdges = ensureEdgeIds(resolvedEdges);
+        // F10 (2026-06-09): when no explicit targetNodeId was given, default to
+        // the flow's terminal output node so passing just a flow id previews the
+        // finished source (instead of an ambiguous "(terminal)" the backend has
+        // to guess). An explicit targetNodeId always wins. Falls back to
+        // undefined (backend picks) when the graph carries no output node yet.
+        const effectiveTargetNodeId = resolvedTargetNodeId ?? terminalOutputNodeId(localNodes);
         // PHP success body: {preview, outputCount, executedNodes, nodeOutputCounts,
         // nodeOutputs}. There's no `trace` key. Audit: F-A2-11.
         const r = await request("/graph/preview", {
             method: "POST",
-            body: JSON.stringify({ nodes: localNodes, edges: localEdges, targetNodeId, forceRefresh }),
+            body: JSON.stringify({
+                nodes: localNodes,
+                edges: localEdges,
+                targetNodeId: effectiveTargetNodeId,
+                forceRefresh: resolvedForceRefresh,
+            }),
         });
         if (!r.success) {
-            return errorResult({
-                message: r.error ?? "graph preview failed",
-                code: r.errorCode ?? (r.status ? String(r.status) : undefined),
-                suggestion: hintFor(r.errorCode),
-                details: { node_count: localNodes.length, edge_count: localEdges.length, targetNodeId, forceRefresh },
-            });
+            return restErrorResult(r, { node_count: localNodes.length, edge_count: localEdges.length, targetNodeId: effectiveTargetNodeId, forceRefresh: resolvedForceRefresh }, { message: "graph preview failed" });
         }
         const items = Array.isArray(r.data?.preview) ? r.data.preview : [];
         const itemCount = items.length;
+        // A2: forward the merge-no-match diagnostic verbatim (PHP owns the
+        // {reason, message, joinKey, joinKeyRight, *_key_sample, …} contract).
+        // Additive: only present when PHP attached it (a 0-row join with
+        // non-empty inputs), so the happy-path envelope shape is unchanged.
+        const mergeDiagnostics = r.data?.mergeDiagnostics !== null &&
+            typeof r.data?.mergeDiagnostics === "object" &&
+            !Array.isArray(r.data?.mergeDiagnostics) &&
+            Object.keys(r.data.mergeDiagnostics).length > 0
+            ? r.data.mergeDiagnostics
+            : undefined;
+        // F10: honor `limit` (clamped at the schema to 1..50) when echoing items.
+        // The pipeline already executed in full; this only trims the echoed list.
+        const itemCap = typeof limit === "number" ? Math.min(limit, 50) : 50;
         return formatResult({
             ok: true,
             item_count: itemCount,
             output_count: r.data?.outputCount,
             executed_nodes: r.data?.executedNodes,
             node_output_counts: r.data?.nodeOutputCounts,
-            target_node: targetNodeId || "(terminal)",
-            force_refresh: forceRefresh,
-            ...(typeof flow_id === "string" && flow_id !== "" ? { flow_id } : {}),
-            items: items.slice(0, 50),
-            note: itemCount > 50 ? `Showing first 50 of ${itemCount} items.` : undefined,
+            target_node: effectiveTargetNodeId || "(terminal)",
+            force_refresh: resolvedForceRefresh,
+            ...(typeof resolvedFlowId === "string" && resolvedFlowId !== ""
+                ? { flow_id: resolvedFlowId }
+                : {}),
+            ...(mergeDiagnostics ? { merge_diagnostics: mergeDiagnostics } : {}),
+            items: items.slice(0, itemCap),
+            note: itemCount > itemCap
+                ? `Showing first ${itemCap} of ${itemCount} items.`
+                : undefined,
         }, false, { maxChars: 6000 });
     });
     // ── apimapper_graph_validate ───────────────────────────────────────
@@ -140,7 +248,7 @@ export function registerGraphTools(server) {
         title: "Graph Validate (Shape Check)",
         description: "Validate a graph's structure (cycles, disconnected nodes, missing outputs, type mismatches) " +
             "WITHOUT executing the pipeline. Fast — no upstream fetches." +
-            "\n\nExample:\n  apimapper_graph_validate({ nodes: [{ id: 'src1', type: 'source' }, { id: 'out1', type: 'output' }], edges: [{ source: 'src1', target: 'out1' }] })",
+            "\n\nExample:\n  apimapper_graph_validate({ nodes: [{ id: 'src1', type: 'source', position: { x: 0, y: 0 }, data: { connectionId: 'con_abc123' } }, { id: 'out1', type: 'output', position: { x: 320, y: 0 }, data: {} }], edges: [{ source: 'src1', target: 'out1' }] })",
         inputSchema: {
             // L-7 (W3F-5): symmetric with apimapper_graph_preview — pass
             // `flow_id` to validate a saved flow without re-sending the
@@ -168,12 +276,10 @@ export function registerGraphTools(server) {
             (!Array.isArray(resolvedNodes) || resolvedNodes.length === 0)) {
             const h = await hydrateGraphFromFlowId(flow_id);
             if ("error" in h) {
-                return errorResult({
-                    message: h.error,
-                    code: h.errorCode ?? (h.status ? String(h.status) : undefined),
-                    suggestion: hintFor("not_found"),
-                    details: { flow_id },
-                });
+                // Per-site nuance: the hydration failure (h.error always present)
+                // pins a fixed `not_found` suggestion regardless of the underlying
+                // error code, since a missing/empty flow is the only failure mode here.
+                return restErrorResult(h, { flow_id }, { suggestion: hintFor("not_found") });
             }
             resolvedNodes = h.nodes;
             resolvedEdges = h.edges;
@@ -190,7 +296,10 @@ export function registerGraphTools(server) {
             resolvedEdges = [];
         }
         const localNodes = resolvedNodes;
-        const localEdges = resolvedEdges;
+        // F5 (2026-06-09): stamp a stable id on any id-less inline edge before
+        // POST — same fix as flow_create / graph_preview. The validator reports
+        // edges by id, so an id-less edge surfaced confusing diagnostics.
+        const localEdges = ensureEdgeIds(resolvedEdges);
         // PHP success body: {valid:true, warnings:[], nodeCount, edgeCount}. On
         // invalid the errors are squashed to a single string via
         // HandlerResult::error() and surface as `r.error` here. Wave 1C may emit
@@ -203,16 +312,11 @@ export function registerGraphTools(server) {
             const structuredErrors = Array.isArray(r.errors)
                 ? r.errors
                 : undefined;
-            return errorResult({
-                message: r.error ?? "graph validate failed",
-                code: r.errorCode ?? (r.status ? String(r.status) : undefined),
-                suggestion: hintFor(r.errorCode),
-                details: {
-                    node_count: localNodes.length,
-                    edge_count: localEdges.length,
-                    ...(structuredErrors ? { errors: structuredErrors } : {}),
-                },
-            });
+            return restErrorResult(r, {
+                node_count: localNodes.length,
+                edge_count: localEdges.length,
+                ...(structuredErrors ? { errors: structuredErrors } : {}),
+            }, { message: "graph validate failed" });
         }
         const valid = r.data?.valid ?? true;
         const warns = r.data?.warnings || [];

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

@@ -1 +1 @@
-{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../../src/modules/apimapper/graph.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAiB1D,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;GAOG;AACH,KAAK,UAAU,sBAAsB,CAAC,MAAc;IAIlD,MAAM,CAAC,GAAG,MAAM,OAAO,CAAoB,UAAU,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnF,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACf,OAAO;YACL,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,QAAQ,MAAM,YAAY;YAC5C,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,SAAS,EAAE,CAAC,CAAC,SAAS;SACvB,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC;IAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAK,CAAC,KAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAK,CAAC,KAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,KAAK,EAAE,QAAQ,MAAM,eAAe;YACpC,SAAS,EAAE,YAAY;SACxB,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAqB;IACtD,sEAAsE;IACtE,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,kCAAkC;QACzC,WAAW,EACT,wFAAwF;YACxF,yEAAyE;YACzE,2FAA2F;YAC3F,kFAAkF;YAClF,qFAAqF;YACrF,sFAAsF;YACtF,6CAA6C;YAC7C,yHAAyH;QAC3H,WAAW,EAAE;YACX,+DAA+D;YAC/D,4DAA4D;YAC5D,6DAA6D;YAC7D,2DAA2D;YAC3D,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,mFAAmF;gBACjF,sEAAsE,CACzE;YACH,KAAK,EAAE,CAAC;iBACL,KAAK,CAAC,UAAU,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CACP,4DAA4D;gBAC1D,2HAA2H;gBAC3H,oFAAoF,CACvF;YACH,KAAK,EAAE,CAAC;iBACL,KAAK,CAAC,UAAU,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CACP,yEAAyE;gBACvE,qEAAqE,CACxE;YACH,YAAY,EAAE,CAAC;iBACZ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,kFAAkF,CAAC;YAC/F,YAAY,EAAE,CAAC;iBACZ,OAAO,EAAE;iBACT,OAAO,CAAC,KAAK,CAAC;iBACd,QAAQ,CAAC,sDAAsD,CAAC;SACpE;QACD,WAAW,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;KACnE,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE,EAAE;QAC9D,mEAAmE;QACnE,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,IACE,OAAO,OAAO,KAAK,QAAQ;YAC3B,OAAO,KAAK,EAAE;YACd,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,CAAC,EAC7D,CAAC;YACD,MAAM,CAAC,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;YAChD,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;gBACjB,OAAO,WAAW,CAAC;oBACjB,OAAO,EAAE,CAAC,CAAC,KAAK;oBAChB,IAAI,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC9D,UAAU,EAAE,OAAO,CAAC,WAAW,CAAC;oBAChC,OAAO,EAAE,EAAE,OAAO,EAAE;iBACrB,CAAC,CAAC;YACL,CAAC;YACD,aAAa,GAAG,CAAC,CAAC,KAA0C,CAAC;YAC7D,aAAa,GAAG,CAAC,CAAC,KAA0C,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChE,OAAO,WAAW,CAAC;gBACjB,OAAO,EAAE,qDAAqD;gBAC9D,IAAI,EAAE,aAAa;gBACnB,UAAU,EAAE,uEAAuE;gBACnF,OAAO,EAAE,EAAE;aACZ,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YAClC,aAAa,GAAG,EAAE,CAAC;QACrB,CAAC;QACD,MAAM,UAAU,GAAG,aAAa,CAAC;QACjC,MAAM,UAAU,GAAG,aAAa,CAAC;QACjC,4EAA4E;QAC5E,wDAAwD;QACxD,MAAM,CAAC,GAAG,MAAM,OAAO,CAMpB,gBAAgB,EAAE;YACnB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;SAC3F,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,WAAW,CAAC;gBACjB,OAAO,EAAE,CAAC,CAAC,KAAK,IAAI,sBAAsB;gBAC1C,IAAI,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC9D,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;gBAChC,OAAO,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE;aACtG,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC;QAC/B,OAAO,YAAY,CACjB;YACE,EAAE,EAAE,IAAI;YACR,UAAU,EAAE,SAAS;YACrB,YAAY,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW;YACjC,cAAc,EAAE,CAAC,CAAC,IAAI,EAAE,aAAa;YACrC,kBAAkB,EAAE,CAAC,CAAC,IAAI,EAAE,gBAAgB;YAC5C,WAAW,EAAE,YAAY,IAAI,YAAY;YACzC,aAAa,EAAE,YAAY;YAC3B,GAAG,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YACzB,IAAI,EAAE,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,uBAAuB,SAAS,SAAS,CAAC,CAAC,CAAC,SAAS;SAC7E,EACD,KAAK,EACL,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,sEAAsE;IACtE,MAAM,CAAC,YAAY,CACjB,0BAA0B,EAC1B;QACE,KAAK,EAAE,8BAA8B;QACrC,WAAW,EACT,8FAA8F;YAC9F,6DAA6D;YAC7D,oKAAoK;QACtK,WAAW,EAAE;YACX,6DAA6D;YAC7D,4DAA4D;YAC5D,gBAAgB;YAChB,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,qFAAqF,CACtF;YACH,KAAK,EAAE,CAAC;iBACL,KAAK,CAAC,UAAU,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CACP,0MAA0M,CAC3M;YACH,KAAK,EAAE,CAAC;iBACL,KAAK,CAAC,UAAU,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CAAC,4FAA4F,CAAC;SAC1G;QACD,WAAW,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;KACpE,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;QAClC,+DAA+D;QAC/D,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,IACE,OAAO,OAAO,KAAK,QAAQ;YAC3B,OAAO,KAAK,EAAE;YACd,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,CAAC,EAC7D,CAAC;YACD,MAAM,CAAC,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;YAChD,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;gBACjB,OAAO,WAAW,CAAC;oBACjB,OAAO,EAAE,CAAC,CAAC,KAAK;oBAChB,IAAI,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC9D,UAAU,EAAE,OAAO,CAAC,WAAW,CAAC;oBAChC,OAAO,EAAE,EAAE,OAAO,EAAE;iBACrB,CAAC,CAAC;YACL,CAAC;YACD,aAAa,GAAG,CAAC,CAAC,KAA0C,CAAC;YAC7D,aAAa,GAAG,CAAC,CAAC,KAA0C,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YAClC,OAAO,WAAW,CAAC;gBACjB,OAAO,EAAE,kDAAkD;gBAC3D,IAAI,EAAE,aAAa;gBACnB,UAAU,EAAE,uEAAuE;gBACnF,OAAO,EAAE,EAAE;aACZ,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YAClC,aAAa,GAAG,EAAE,CAAC;QACrB,CAAC;QACD,MAAM,UAAU,GAAG,aAAa,CAAC;QACjC,MAAM,UAAU,GAAG,aAAa,CAAC;QACjC,wEAAwE;QACxE,yDAAyD;QACzD,yEAAyE;QACzE,mEAAmE;QACnE,MAAM,CAAC,GAAG,MAAM,OAAO,CAOrB,iBAAiB,EACjB;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;SAC/D,CACF,CAAC;QACF,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACf,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAE,CAA4B,CAAC,MAAM,CAAC;gBAC1E,CAAC,CAAE,CAA4B,CAAC,MAAM;gBACtC,CAAC,CAAC,SAAS,CAAC;YACd,OAAO,WAAW,CAAC;gBACjB,OAAO,EAAE,CAAC,CAAC,KAAK,IAAI,uBAAuB;gBAC3C,IAAI,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC9D,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;gBAChC,OAAO,EAAE;oBACP,UAAU,EAAE,UAAU,CAAC,MAAM;oBAC7B,UAAU,EAAE,UAAU,CAAC,MAAM;oBAC7B,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC1D;aACF,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC;QACpC,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;QACrC,+DAA+D;QAC/D,8DAA8D;QAC9D,gEAAgE;QAChE,MAAM,GAAG,GAAG,sBAAsB,CAAC;YACjC,KAAK,EAAE,UAA+C;YACtD,KAAK,EAAE,UAA+C;YACtD,EAAE,EAAE,OAAO,IAAI,WAAW;YAC1B,IAAI,EAAE,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,OAAO,EAAE,CAAC,CAAC,CAAC,iBAAiB;SAC5F,CAAC,CAAC;QACH,OAAO,YAAY,CACjB;YACE,KAAK;YACL,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS;YAC7B,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS;YAC7B,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACtD,QAAQ,EAAE,KAAK;YACf,GAAG,CAAC,GAAG,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC;SACpC;QACD,gEAAgE;QAChE,6CAA6C;QAC7C,CAAC,KAAK;QACN,6DAA6D;QAC7D,EAAE,QAAQ,EAAE,0BAA0B,EAAE,CACzC,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../../src/modules/apimapper/graph.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEvF;;;;;;;;GAQG;AACH,SAAS,oBAAoB,CAAC,KAA6B;IACzD,IAAI,KAAyB,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,YAAY,CAAC,CAAuB,CAAC,EAAG,CAAC;YAC3C,MAAM,EAAE,GAAI,CAAsB,CAAC,EAAE,CAAC;YACtC,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,EAAE;gBAAE,KAAK,GAAG,EAAE,CAAC;QACtD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAiBD,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;GAOG;AACH,KAAK,UAAU,sBAAsB,CAAC,MAAc;IAIlD,MAAM,CAAC,GAAG,MAAM,OAAO,CAAoB,UAAU,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnF,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACf,OAAO;YACL,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,QAAQ,MAAM,YAAY;YAC5C,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,SAAS,EAAE,CAAC,CAAC,SAAS;SACvB,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC;IAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAK,CAAC,KAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAK,CAAC,KAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,KAAK,EAAE,QAAQ,MAAM,eAAe;YACpC,SAAS,EAAE,YAAY;SACxB,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAqB;IACtD,sEAAsE;IACtE,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,kCAAkC;QACzC,WAAW,EACT,wFAAwF;YACxF,yEAAyE;YACzE,2FAA2F;YAC3F,kFAAkF;YAClF,qFAAqF;YACrF,sFAAsF;YACtF,iDAAiD;YACjD,8FAA8F;YAC9F,wFAAwF;YACxF,4FAA4F;YAC5F,6FAA6F;YAC7F,8FAA8F;YAC9F,0CAA0C;YAC1C,yLAAyL;YACzL,2FAA2F;QAC7F,WAAW,EAAE;YACX,+DAA+D;YAC/D,4DAA4D;YAC5D,6DAA6D;YAC7D,2DAA2D;YAC3D,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,mFAAmF;gBACjF,uEAAuE;gBACvE,gFAAgF,CACnF;YACH,oEAAoE;YACpE,oEAAoE;YACpE,qEAAqE;YACrE,oCAAoC;YACpC,EAAE,EAAE,CAAC;iBACF,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,qFAAqF;gBACnF,2FAA2F,CAC9F;YACH,KAAK,EAAE,CAAC;iBACL,KAAK,CAAC,UAAU,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CACP,4DAA4D;gBAC1D,2HAA2H;gBAC3H,oFAAoF,CACvF;YACH,KAAK,EAAE,CAAC;iBACL,KAAK,CAAC,UAAU,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CACP,yEAAyE;gBACvE,qEAAqE,CACxE;YACH,YAAY,EAAE,CAAC;iBACZ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,gFAAgF;gBAC9E,mFAAmF;gBACnF,mEAAmE,CACtE;YACH,4DAA4D;YAC5D,oEAAoE;YACpE,sEAAsE;YACtE,oEAAoE;YACpE,8DAA8D;YAC9D,kEAAkE;YAClE,cAAc,EAAE,CAAC;iBACd,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,4EAA4E,CAAC;YACzF,sEAAsE;YACtE,yEAAyE;YACzE,qEAAqE;YACrE,wEAAwE;YACxE,kEAAkE;YAClE,yDAAyD;YACzD,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,EAAE;iBACV,QAAQ,CACP,oFAAoF;gBAClF,+FAA+F,CAClG;YACH,YAAY,EAAE,CAAC;iBACZ,OAAO,EAAE;iBACT,OAAO,CAAC,KAAK,CAAC;iBACd,QAAQ,CACP,wDAAwD;gBACtD,oCAAoC,CACvC;YACH,yDAAyD;YACzD,kEAAkE;YAClE,mEAAmE;YACnE,8DAA8D;YAC9D,aAAa,EAAE,CAAC;iBACb,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,kFAAkF,CAAC;SAChG;QACD,WAAW,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;KACnE,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,EAAE,EAAE;QACxG,kEAAkE;QAClE,qEAAqE;QACrE,0EAA0E;QAC1E,MAAM,oBAAoB,GAAG,YAAY,IAAI,cAAc,CAAC;QAC5D,MAAM,oBAAoB,GAAG,YAAY,IAAI,aAAa,KAAK,IAAI,CAAC;QACpE,0EAA0E;QAC1E,kDAAkD;QAClD,yCAAyC;QACzC,MAAM,cAAc,GAAG,OAAO,IAAI,EAAE,CAAC;QACrC,uEAAuE;QACvE,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,IACE,OAAO,cAAc,KAAK,QAAQ;YAClC,cAAc,KAAK,EAAE;YACrB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,CAAC,EAC7D,CAAC;YACD,MAAM,CAAC,GAAG,MAAM,sBAAsB,CAAC,cAAc,CAAC,CAAC;YACvD,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;gBACjB,kEAAkE;gBAClE,mEAAmE;gBACnE,wEAAwE;gBACxE,OAAO,eAAe,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAC/F,CAAC;YACD,aAAa,GAAG,CAAC,CAAC,KAA0C,CAAC;YAC7D,aAAa,GAAG,CAAC,CAAC,KAA0C,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChE,OAAO,WAAW,CAAC;gBACjB,OAAO,EAAE,qDAAqD;gBAC9D,IAAI,EAAE,aAAa;gBACnB,UAAU,EAAE,uEAAuE;gBACnF,OAAO,EAAE,EAAE;aACZ,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YAClC,aAAa,GAAG,EAAE,CAAC;QACrB,CAAC;QACD,MAAM,UAAU,GAAG,aAAa,CAAC;QACjC,uEAAuE;QACvE,kEAAkE;QAClE,qEAAqE;QACrE,kBAAkB;QAClB,MAAM,UAAU,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;QAChD,wEAAwE;QACxE,yEAAyE;QACzE,wEAAwE;QACxE,iEAAiE;QACjE,uEAAuE;QACvE,MAAM,qBAAqB,GACzB,oBAAoB,IAAI,oBAAoB,CAAC,UAAU,CAAC,CAAC;QAC3D,4EAA4E;QAC5E,wDAAwD;QACxD,MAAM,CAAC,GAAG,MAAM,OAAO,CAYpB,gBAAgB,EAAE;YACnB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,UAAU;gBACjB,KAAK,EAAE,UAAU;gBACjB,YAAY,EAAE,qBAAqB;gBACnC,YAAY,EAAE,oBAAoB;aACnC,CAAC;SACH,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,eAAe,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,qBAAqB,EAAE,YAAY,EAAE,oBAAoB,EAAE,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC;QAC5M,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC;QAC/B,mEAAmE;QACnE,uEAAuE;QACvE,iEAAiE;QACjE,oEAAoE;QACpE,MAAM,gBAAgB,GACpB,CAAC,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI;YACjC,OAAO,CAAC,CAAC,IAAI,EAAE,gBAAgB,KAAK,QAAQ;YAC5C,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,gBAAgB,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC;YAC7C,CAAC,CAAE,CAAC,CAAC,IAAI,CAAC,gBAA4C;YACtD,CAAC,CAAC,SAAS,CAAC;QAChB,0EAA0E;QAC1E,0EAA0E;QAC1E,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,OAAO,YAAY,CACjB;YACE,EAAE,EAAE,IAAI;YACR,UAAU,EAAE,SAAS;YACrB,YAAY,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW;YACjC,cAAc,EAAE,CAAC,CAAC,IAAI,EAAE,aAAa;YACrC,kBAAkB,EAAE,CAAC,CAAC,IAAI,EAAE,gBAAgB;YAC5C,WAAW,EAAE,qBAAqB,IAAI,YAAY;YAClD,aAAa,EAAE,oBAAoB;YACnC,GAAG,CAAC,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,KAAK,EAAE;gBAC7D,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE;gBAC7B,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC;YAC9B,IAAI,EACF,SAAS,GAAG,OAAO;gBACjB,CAAC,CAAC,iBAAiB,OAAO,OAAO,SAAS,SAAS;gBACnD,CAAC,CAAC,SAAS;SAChB,EACD,KAAK,EACL,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,sEAAsE;IACtE,MAAM,CAAC,YAAY,CACjB,0BAA0B,EAC1B;QACE,KAAK,EAAE,8BAA8B;QACrC,WAAW,EACT,8FAA8F;YAC9F,6DAA6D;YAC7D,0QAA0Q;QAC5Q,WAAW,EAAE;YACX,6DAA6D;YAC7D,4DAA4D;YAC5D,gBAAgB;YAChB,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,qFAAqF,CACtF;YACH,KAAK,EAAE,CAAC;iBACL,KAAK,CAAC,UAAU,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CACP,0MAA0M,CAC3M;YACH,KAAK,EAAE,CAAC;iBACL,KAAK,CAAC,UAAU,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CAAC,4FAA4F,CAAC;SAC1G;QACD,WAAW,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;KACpE,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;QAClC,+DAA+D;QAC/D,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,IACE,OAAO,OAAO,KAAK,QAAQ;YAC3B,OAAO,KAAK,EAAE;YACd,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,CAAC,EAC7D,CAAC;YACD,MAAM,CAAC,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;YAChD,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;gBACjB,kEAAkE;gBAClE,mEAAmE;gBACnE,wEAAwE;gBACxE,OAAO,eAAe,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAC/E,CAAC;YACD,aAAa,GAAG,CAAC,CAAC,KAA0C,CAAC;YAC7D,aAAa,GAAG,CAAC,CAAC,KAA0C,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YAClC,OAAO,WAAW,CAAC;gBACjB,OAAO,EAAE,kDAAkD;gBAC3D,IAAI,EAAE,aAAa;gBACnB,UAAU,EAAE,uEAAuE;gBACnF,OAAO,EAAE,EAAE;aACZ,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YAClC,aAAa,GAAG,EAAE,CAAC;QACrB,CAAC;QACD,MAAM,UAAU,GAAG,aAAa,CAAC;QACjC,uEAAuE;QACvE,wEAAwE;QACxE,kEAAkE;QAClE,MAAM,UAAU,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;QAChD,wEAAwE;QACxE,yDAAyD;QACzD,yEAAyE;QACzE,mEAAmE;QACnE,MAAM,CAAC,GAAG,MAAM,OAAO,CAOrB,iBAAiB,EACjB;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;SAC/D,CACF,CAAC;QACF,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACf,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAE,CAA4B,CAAC,MAAM,CAAC;gBAC1E,CAAC,CAAE,CAA4B,CAAC,MAAM;gBACtC,CAAC,CAAC,SAAS,CAAC;YACd,OAAO,eAAe,CAAC,CAAC,EAAE;gBACtB,UAAU,EAAE,UAAU,CAAC,MAAM;gBAC7B,UAAU,EAAE,UAAU,CAAC,MAAM;gBAC7B,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1D,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC;QACpC,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;QACrC,+DAA+D;QAC/D,8DAA8D;QAC9D,gEAAgE;QAChE,MAAM,GAAG,GAAG,sBAAsB,CAAC;YACjC,KAAK,EAAE,UAA+C;YACtD,KAAK,EAAE,UAA+C;YACtD,EAAE,EAAE,OAAO,IAAI,WAAW;YAC1B,IAAI,EAAE,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,OAAO,EAAE,CAAC,CAAC,CAAC,iBAAiB;SAC5F,CAAC,CAAC;QACH,OAAO,YAAY,CACjB;YACE,KAAK;YACL,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS;YAC7B,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS;YAC7B,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACtD,QAAQ,EAAE,KAAK;YACf,GAAG,CAAC,GAAG,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC;SACpC;QACD,gEAAgE;QAChE,6CAA6C;QAC7C,CAAC,KAAK;QACN,6DAA6D;QAC7D,EAAE,QAAQ,EAAE,0BAA0B,EAAE,CACzC,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/modules/apimapper/index.js

@@ -5,10 +5,12 @@ import { registerGraphTools } from "./graph.js";
 import { registerLocalSourceTools } from "./local-sources.js";
 import { registerSchemaTools } from "./schema.js";
 import { registerLibraryTools } from "./library.js";
+import { registerYoothemeBindingTools } from "./yootheme-binding.js";
 import { registerCacheTools } from "./cache.js";
 import { registerSettingsTools } from "./settings.js";
 import { registerLicenseTools } from "./license.js";
 import { registerMiscTools } from "./misc.js";
+import { registerJmespathTestTool } from "./jmespath-test.js";
 import { registerWorkflowTools } from "./workflows.js";
 import { registerSkillResources } from "./skill-resources.js";
 import { registerGetSkillTool } from "./get-skill.js";
@@ -18,6 +20,7 @@ import { registerDiagnoseTool } from "./diagnose.js";
 import { registerRenderTool } from "./render/index.js";
 import { CapturingServer } from "./gateway/capturing-server.js";
 import { registerAdvancedTool } from "./gateway/advanced-tool.js";
+import { registerAdvancedReadTool } from "./gateway/advanced-read-tool.js";
 import { toElicitationCapability } from "./elicitation.js";
 /**
  * Module-level cache of the advanced-tool registry captured during the most
@@ -52,29 +55,36 @@ export const apimapperRestModule = {
         // Route every tool registration through the CapturingServer: essentials
         // forward to the real server, the rest are captured for the gateway.
         const capturing = new CapturingServer(server);
-        // W3.6 — targeted elicitation. The 3 modules below have a disambiguation
-        // site that can prompt the user via the MCP elicitation channel. The
-        // toolkit's `elicitChoice` needs a `{ server: { elicitInput } }` whose
-        // `elicitInput` is typed with the toolkit's loose `ElicitInputParams`;
-        // the SDK's `McpServer.server.elicitInput` is the stricter discriminated
-        // form/url union, so `toElicitationCapability` is the typed adapter that
-        // bridges the two (single documented cast — see elicitation.ts). The
-        // capability is passed as the optional 2nd argument to ONLY these 3
-        // modules — the other 15 are untouched. When the argument is absent
-        // (host wiring without elicitation), each tool falls back to a structured
-        // `errorResult` on genuine ambiguity instead of prompting.
+        // W3.6 / chat-first decision (2026-06-15) — the native elicitation picker
+        // is now reserved for OAuth authorization ONLY. `oauth_authorize_begin`
+        // (credentials.ts) keeps the picker because explicit consent on WHICH
+        // credential to authorize is security-relevant; ordinary credential/flow
+        // disambiguation (connection_create, flow_compile) returns a structured
+        // candidate-list error so the assistant asks in plain chat instead.
+        // The toolkit's `elicitChoice` needs a `{ server: { elicitInput } }`
+        // whose `elicitInput` is typed with the toolkit's loose
+        // `ElicitInputParams`; the SDK's `McpServer.server.elicitInput` is the
+        // stricter discriminated form/url union, so `toElicitationCapability` is
+        // the typed adapter that bridges the two (single documented cast — see
+        // elicitation.ts). When the argument is absent (host wiring without
+        // elicitation), the OAuth path falls back to a structured `errorResult`
+        // on genuine ambiguity instead of prompting.
         const elicitation = toElicitationCapability(server);
-        registerConnectionTools(capturing, elicitation);
+        registerConnectionTools(capturing);
         registerCredentialTools(capturing, elicitation);
-        registerFlowTools(capturing, elicitation);
+        registerFlowTools(capturing);
         registerGraphTools(capturing);
         registerLocalSourceTools(capturing);
         registerSchemaTools(capturing);
         registerLibraryTools(capturing);
+        registerYoothemeBindingTools(capturing);
         registerCacheTools(capturing);
         registerSettingsTools(capturing);
         registerLicenseTools(capturing);
         registerMiscTools(capturing);
+        // P-B (JMESPath superpowers) — apimapper_jmespath_test. Not an essential,
+        // so the CapturingServer routes it into the apimapper_advanced gateway.
+        registerJmespathTestTool(capturing);
         registerWorkflowTools(capturing);
         // Skill resources are an MCP-spec protocol concept but Claude Desktop
         // (2026-05-19 rc-period) does not yet honour the `audience: ["assistant"]`
@@ -97,6 +107,10 @@ export const apimapperRestModule = {
         // Register the single gateway to every captured advanced tool.
         const advancedRegistry = capturing.getAdvancedRegistry();
         registerAdvancedTool(server, advancedRegistry);
+        // F200b — and the READ-ONLY sibling gateway, whitelisting just the
+        // side-effect-free advanced tools (readOnlyHint-derived). Lets a host
+        // call the read surface without write-confirmation prompts.
+        registerAdvancedReadTool(server, advancedRegistry);
         lastAdvancedRegistry = advancedRegistry;
     },
     getAdvancedRegistry: () => lastAdvancedRegistry,

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

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

package/dist/modules/apimapper/jmespath-test.d.ts

@@ -0,0 +1,4 @@
+import type { ToolRegistrar } from "./gateway/capturing-server.js";
+/** Test-only: clear the remembered sample hash so each test starts cold. */
+export declare function __resetJmespathSampleHashForTests(): void;
+export declare function registerJmespathTestTool(server: ToolRegistrar): void;

package/dist/modules/apimapper/jmespath-test.js

@@ -0,0 +1,152 @@
+// src/modules/apimapper/jmespath-test.ts — P-B (JMESPath superpowers for cold
+// agents).
+//
+// REST surface: POST /jmespath/test (WP REST + Joomla com_ajax `jmespathTest`).
+// Domain: a stateless dry-run of a JMESPath expression against sample rows,
+// evaluated server-side through the SAME JmesPathAdapter the Transform pipeline
+// uses — so custom primitives (date_weekday / date_iso_to_time / date_iso_to_date
+// / time_in_window / format_number / coalesce_empty / conditional) resolve
+// identically, and a failing expression returns the SAME teaching hints the
+// Transform / flow-write path adds (the arithmetic hint, the depth-split remedy).
+//
+// This is the iteration tool a cold agent reaches for BEFORE wiring an
+// expression into a Transform node: paste the expression + a couple of sample
+// rows, read {result, row_count}, refine, repeat. Pair it with
+// apimapper_get_skill({ topic: 'jmespath-cookbook' }) for copy-paste recipes.
+import { z } from "zod";
+import { createHash } from "node:crypto";
+import { formatResult, readOnly } from "@getimo/mcp-toolkit";
+import { request } from "./client.js";
+import { restErrorResult } from "./tool-result.js";
+/**
+ * F199 (Desktop-E2E #2 forensics, 2026-06-12) — module-internal hash of the
+ * LAST sample_rows the tool was called with. When a follow-up call re-sends
+ * byte-identical rows (the common "iterate the expression against the same
+ * data" loop), the response references the unchanged sample instead of the
+ * model re-reading the full echo. The hash is per-process (a single MCP server
+ * instance serves one conversation), reset only by the test hook below.
+ */
+let lastSampleRowsHash;
+/** Stable hash of the sample_rows payload (order-preserving JSON of the value). */
+function hashSampleRows(sampleRows) {
+    return createHash("sha256").update(JSON.stringify(sampleRows)).digest("hex");
+}
+/** Test-only: clear the remembered sample hash so each test starts cold. */
+export function __resetJmespathSampleHashForTests() {
+    lastSampleRowsHash = undefined;
+}
+/**
+ * F199: the dedup advisory emitted when the caller re-sent the SAME sample_rows
+ * as the immediately preceding call. It is a steering signal — the agent does
+ * not need to keep re-pasting (or re-reading) the unchanged rows.
+ */
+const SAMPLE_UNCHANGED_NOTE = "sample unchanged (same as previous call) — you re-sent identical sample_rows; " +
+    "no need to re-paste them, just send the new expression next time.";
+/**
+ * F159: the missing-rows advisory the tool emits when sample_rows were omitted
+ * for an expression that reads rows and the server didn't already supply one
+ * (older backend). Kept in sync with the PHP {@link JmespathTestHandler}.
+ */
+const MISSING_ROWS_NOTE = "no sample_rows supplied — the expression addresses rows, so the empty result " +
+    "is because there is no input to evaluate against, NOT because the expression is " +
+    "wrong. Supply rows via the `sample_rows` argument (grab real ones with " +
+    "apimapper_connection_data) and re-run.";
+/**
+ * True when the expression actually references the input data rather than
+ * being a self-contained LITERAL or empty. Mirrors
+ * {@link JmespathTestHandler::expressionAddressesRows} (PHP): the empty
+ * expression, the `@` identity, and a backtick/raw-string literal do NOT
+ * address rows; everything else does.
+ */
+function expressionAddressesRows(expression) {
+    const trimmed = expression.trim();
+    if (trimmed === "" || trimmed === "@")
+        return false;
+    const first = trimmed[0];
+    if (first === "`" || first === "'")
+        return false; // pure literal
+    return true;
+}
+export function registerJmespathTestTool(server) {
+    server.registerTool("apimapper_jmespath_test", {
+        title: "Test a JMESPath Expression",
+        description: "Dry-run a JMESPath expression against sample rows, evaluated server-side through the " +
+            "SAME engine as the Transform pipeline (custom primitives date_weekday / date_iso_to_time / " +
+            "date_iso_to_date / time_in_window / format_number / coalesce_empty / conditional all resolve). Returns " +
+            "{ result, row_count }; a malformed expression returns a 422 with the SAME teaching hint the " +
+            "Transform/flow-write path adds (arithmetic, depth-split). Iterate here BEFORE wiring an " +
+            "expression into a Transform node. The rows argument is `sample_rows` " +
+            "(NOT `data`). For copy-paste recipes call " +
+            "apimapper_get_skill({ topic: 'jmespath-cookbook' })." +
+            "\n\nExample:\n  apimapper_jmespath_test({ expression: \"[*].{name: name, price: format_number(price)}\", " +
+            "sample_rows: [{ name: 'Villa', price: 890000 }] })",
+        inputSchema: {
+            expression: z
+                .string()
+                .describe("The JMESPath expression to evaluate (e.g. \"[*].name\" or " +
+                "\"[?to_number(price) > `100`]\"). Empty string returns sample_rows unchanged."),
+            sample_rows: z
+                .union([z.array(z.unknown()), z.record(z.string(), z.unknown())])
+                .optional()
+                .describe("The data to evaluate against — either a LIST of row objects " +
+                "(`[{...}, {...}]`, item-level scope) or a single wrapper object " +
+                "(`{items: [...]}`, top-level scope). Omit to test a literal expression " +
+                "against an empty list. Use connection_data to grab real rows first."),
+        },
+        // Pure read — never mutates flows/connections/state. Server-side it
+        // evaluates against the supplied rows and returns the result.
+        annotations: readOnly({ title: "Test JMESPath Expression", openWorld: false }),
+    }, async ({ expression, sample_rows }) => {
+        const r = await request("/jmespath/test", {
+            method: "POST",
+            body: JSON.stringify({
+                expression,
+                // Default to an empty list so a body-less literal test still works
+                // and the server's row_count is deterministic.
+                sample_rows: sample_rows ?? [],
+            }),
+        });
+        if (!r.success) {
+            // The teaching message rides inside `error` (and `errorBody.error`);
+            // restErrorResult surfaces it as the result message verbatim so the
+            // agent reads the arithmetic / depth-split hint, not a bare 422.
+            return restErrorResult(r, { expression: expression.slice(0, 80) }, { message: "JMESPath test failed" });
+        }
+        // F159: prefer the server's note; otherwise synthesise the missing-rows
+        // advisory ourselves when the caller omitted/emptied sample_rows for a
+        // row-addressing expression (covers older backends that don't yet attach
+        // the note). Never annotate when rows WERE supplied (an empty result is
+        // then a real signal) or for trivial literal/empty expressions.
+        const rowsOmitted = sample_rows === undefined ||
+            (Array.isArray(sample_rows) && sample_rows.length === 0);
+        const note = r.data?.note ??
+            (rowsOmitted && expressionAddressesRows(expression) ? MISSING_ROWS_NOTE : undefined);
+        // F199: detect a re-sent identical sample_rows blob. Only meaningful when
+        // rows were actually supplied — an omitted/empty payload is the
+        // missing-rows case (handled above), not an echo to dedup. Update the
+        // remembered hash on every call that carries rows so the NEXT call can
+        // compare. The unchanged-note rides alongside any existing note rather
+        // than replacing it (the two are mutually exclusive in practice, but
+        // additive composition keeps both signals intact if they ever co-occur).
+        let sampleUnchanged;
+        if (!rowsOmitted) {
+            const hash = hashSampleRows(sample_rows);
+            if (lastSampleRowsHash !== undefined && hash === lastSampleRowsHash) {
+                sampleUnchanged = SAMPLE_UNCHANGED_NOTE;
+            }
+            lastSampleRowsHash = hash;
+        }
+        const payload = {
+            result: r.data?.result ?? null,
+            row_count: r.data?.row_count ?? 0,
+        };
+        if (note !== undefined) {
+            payload.note = note;
+        }
+        if (sampleUnchanged !== undefined) {
+            payload.sample_note = sampleUnchanged;
+        }
+        return formatResult(payload, false, { maxChars: 4000 });
+    });
+}
+//# sourceMappingURL=jmespath-test.js.map

package/dist/modules/apimapper/jmespath-test.js.map

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