@wootsup/mcp 0.1.0-rc.1

package/dist/modules/apimapper/graph-builder.js

@@ -0,0 +1,117 @@
+// src/modules/apimapper/graph-builder.ts — pure function: source-spec list +
+// merge spec → React-Flow {nodes, edges, viewport} that FlowCompiler accepts.
+//
+// Extracted from workflows.ts so the composition logic is unit-testable in
+// isolation and reusable from future tooling (Joomla parity, MCP composite
+// tools beyond setup_with_sources, etc.).
+import { normalizeMergeStrategy } from "./normalizers.js";
+/**
+ * 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 function buildFlowGraph(input) {
+    const { sources, merge, transform, output } = input;
+    if (sources.length === 0) {
+        throw new Error("buildFlowGraph: at least one source is required");
+    }
+    if (sources.length >= 2 && !merge) {
+        throw new Error("buildFlowGraph: merge spec is required when sources.length >= 2");
+    }
+    if (merge && (merge.strategy === "join") && !merge.joinKey) {
+        throw new Error("buildFlowGraph: merge.joinKey is required for strategy=join");
+    }
+    const nodes = [];
+    const edges = [];
+    const baseX = 100;
+    const colWidth = 280;
+    const rowHeight = 200;
+    // Sources column
+    sources.forEach((s, i) => {
+        nodes.push({
+            id: `source-${i + 1}`,
+            type: "source",
+            position: { x: baseX, y: 100 + i * rowHeight },
+            data: {
+                label: s.label || `Source ${i + 1}`,
+                connectionId: s.connection,
+                endpointId: s.endpoint,
+                templateFields: s.template_fields || {},
+                itemsPath: s.items_path,
+            },
+        });
+    });
+    let lastNodeId = sources.length === 1 ? "source-1" : "";
+    // Merge column (if applicable)
+    if (merge) {
+        const strategy = normalizeMergeStrategy(merge.strategy);
+        const mergeId = "merge-1";
+        nodes.push({
+            id: mergeId,
+            type: "merge",
+            position: {
+                x: baseX + colWidth,
+                y: 100 + Math.max(0, sources.length / 2) * rowHeight - 60,
+            },
+            data: {
+                label: `Merge: ${strategy === "concat" ? "Concat" : "Join"}`,
+                strategy,
+                joinKey: merge.joinKey || "",
+                joinKeyRight: merge.joinKeyRight,
+                joinType: merge.joinType,
+            },
+        });
+        sources.forEach((_s, i) => {
+            edges.push({
+                id: `e-source${i + 1}-merge`,
+                source: `source-${i + 1}`,
+                target: mergeId,
+                targetHandle: i === 0 ? "input-A" : "input-B",
+            });
+        });
+        lastNodeId = mergeId;
+    }
+    // Transform column
+    if (transform) {
+        const transformId = "transform-1";
+        nodes.push({
+            id: transformId,
+            type: "transform",
+            position: { x: baseX + 2 * colWidth, y: 200 },
+            data: {
+                label: "Transform",
+                expression: transform.expression ?? "[*]",
+            },
+        });
+        edges.push({
+            id: `e-${lastNodeId}-transform`,
+            source: lastNodeId,
+            target: transformId,
+        });
+        lastNodeId = transformId;
+    }
+    // Output column
+    const outputId = "output-1";
+    const outputType = output.type === "shortcode" ? "output-shortcode" : "output-yootheme";
+    nodes.push({
+        id: outputId,
+        type: outputType,
+        position: { x: baseX + 3 * colWidth, y: 200 },
+        data: {
+            label: output.name,
+            name: output.name,
+            slug: output.slug,
+        },
+    });
+    edges.push({
+        id: `e-${lastNodeId}-output`,
+        source: lastNodeId,
+        target: outputId,
+    });
+    return { nodes, edges, viewport: { x: 0, y: 0, zoom: 1 } };
+}
+//# sourceMappingURL=graph-builder.js.map

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

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

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

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGraphTools(server: McpServer): void;

package/dist/modules/apimapper/graph.js

@@ -0,0 +1,117 @@
+import { z } from "zod";
+import { formatResult, readOnly } from "@getimo/mcp-toolkit";
+import { request, hintFor } from "./client.js";
+import { nodeSchema } from "./node-schema.js";
+export function registerGraphTools(server) {
+    // ── apimapper_graph_preview ────────────────────────────────────────
+    server.registerTool("apimapper_graph_preview", {
+        title: "Graph Preview (Execute Pipeline)",
+        description: "Execute an ad-hoc graph (nodes + edges) and return rendered items at the target node. " +
+            "Used by the Admin-UI preview panel — does NOT require a saved Flow." +
+            "\n\nExample:\n  apimapper_graph_preview({ nodes: [{ id: 'src1', type: 'source' }], edges: [], target_node_id: 'src1' })",
+        inputSchema: {
+            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. ' +
+                'See apimapper_flow_create for full shape.'),
+            edges: z
+                .array(z.record(z.string(), z.unknown()))
+                .describe('Edge array. Each: {id, source, target, targetHandle?, sourceHandle?}. See apimapper_flow_create.'),
+            targetNodeId: z
+                .string()
+                .optional()
+                .describe("Compute preview up to this node and return its output (default: terminal output)"),
+            forceRefresh: z
+                .boolean()
+                .default(false)
+                .describe("Skip snapshot/cache; always live-fetch from upstream"),
+        },
+        annotations: readOnly(),
+    }, async ({ nodes, edges, targetNodeId, forceRefresh }) => {
+        const r = await request("/graph/preview", {
+            method: "POST",
+            body: JSON.stringify({ nodes, edges, targetNodeId, forceRefresh }),
+        });
+        if (!r.success) {
+            return formatResult({
+                error: r.error,
+                status: r.status,
+                errorCode: r.errorCode,
+                context: { node_count: nodes.length, edge_count: edges.length, targetNodeId, forceRefresh },
+                hint: hintFor(r.errorCode),
+            }, true);
+        }
+        const items = r.data?.items ?? r.data?.data ?? [];
+        const itemCount = Array.isArray(items) ? items.length : 0;
+        // Surface trace observability — total_ms + per-node cache hit/miss + fetch cost.
+        const trace = r.data?.trace;
+        const traceSummary = trace
+            ? {
+                total_ms: trace.total_ms,
+                step_count: Array.isArray(trace.steps) ? trace.steps.length : 0,
+                cache_hits: Array.isArray(trace.steps)
+                    ? trace.steps.filter((s) => s.cache_hit === true).length
+                    : 0,
+                cache_misses: Array.isArray(trace.steps)
+                    ? trace.steps.filter((s) => s.cache_hit === false).length
+                    : 0,
+                steps: Array.isArray(trace.steps) ? trace.steps : undefined,
+            }
+            : undefined;
+        return formatResult({
+            ok: true,
+            item_count: itemCount,
+            target_node: targetNodeId || "(terminal)",
+            force_refresh: forceRefresh,
+            items: Array.isArray(items) ? items.slice(0, 50) : items,
+            note: itemCount > 50 ? `Showing first 50 of ${itemCount} items.` : undefined,
+            trace_summary: traceSummary,
+        }, false, { maxChars: 6000 });
+    });
+    // ── apimapper_graph_validate ───────────────────────────────────────
+    server.registerTool("apimapper_graph_validate", {
+        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' }] })",
+        inputSchema: {
+            nodes: z
+                .array(nodeSchema)
+                .describe("Node array. Discriminator `type` ∈ source | local-source | filter | transform | merge | output | output-yootheme | output-shortcode. See apimapper_flow_create."),
+            edges: z
+                .array(z.record(z.string(), z.unknown()))
+                .describe("Edge array — see apimapper_flow_create for shape"),
+        },
+        annotations: readOnly(),
+    }, async ({ nodes, edges }) => {
+        const r = await request("/graph/validate", {
+            method: "POST",
+            body: JSON.stringify({ nodes, edges }),
+        });
+        if (!r.success) {
+            return formatResult({
+                error: r.error,
+                status: r.status,
+                errorCode: r.errorCode,
+                context: { node_count: nodes.length, edge_count: edges.length },
+                hint: hintFor(r.errorCode),
+            }, true);
+        }
+        const valid = r.data?.valid ?? true;
+        const errs = r.data?.errors || [];
+        const warns = r.data?.warnings || [];
+        return formatResult({
+            valid,
+            error_count: Array.isArray(errs) ? errs.length : 0,
+            warning_count: Array.isArray(warns) ? warns.length : 0,
+            errors: errs,
+            warnings: warns,
+        }, 
+        // Surface validation failure as isError=true so the agent halts
+        // instead of proceeding past a broken graph.
+        !valid, { maxChars: 4000 });
+    });
+}
+//# sourceMappingURL=graph.js.map

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

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

package/dist/modules/apimapper/index.d.ts

@@ -0,0 +1,2 @@
+import type { ModuleDefinition } from "@getimo/mcp-toolkit";
+export declare const apimapperRestModule: ModuleDefinition;

package/dist/modules/apimapper/index.js

@@ -0,0 +1,43 @@
+import { registerConnectionTools } from "./connections.js";
+import { registerCredentialTools } from "./credentials.js";
+import { registerFlowTools } from "./flows.js";
+import { registerGraphTools } from "./graph.js";
+import { registerLocalSourceTools } from "./local-sources.js";
+import { registerSchemaTools } from "./schema.js";
+import { registerLibraryTools } from "./library.js";
+import { registerCacheTools } from "./cache.js";
+import { registerSettingsTools } from "./settings.js";
+import { registerLicenseTools } from "./license.js";
+import { registerMiscTools } from "./misc.js";
+import { registerWorkflowTools } from "./workflows.js";
+import { registerSkillResources } from "./skill-resources.js";
+import { registerGetSkillTool } from "./get-skill.js";
+import { registerOnboardingTool } from "./onboarding.js";
+import { registerInspectTokenTool } from "./inspect.js";
+import { registerDiagnoseTool } from "./diagnose.js";
+export const apimapperRestModule = {
+    name: "apimapper-rest",
+    description: "API Mapper REST coverage — Full coverage of /wp-json/api-mapper/v1/* (connections, credentials, " +
+        "flows, graph, local-sources, schema, library, cache, settings, license, releases, " +
+        "brandfetch, feedback) plus composite workflows.",
+    register: (server) => {
+        registerConnectionTools(server);
+        registerCredentialTools(server);
+        registerFlowTools(server);
+        registerGraphTools(server);
+        registerLocalSourceTools(server);
+        registerSchemaTools(server);
+        registerLibraryTools(server);
+        registerCacheTools(server);
+        registerSettingsTools(server);
+        registerLicenseTools(server);
+        registerMiscTools(server);
+        registerWorkflowTools(server);
+        registerSkillResources(server);
+        registerGetSkillTool(server);
+        registerOnboardingTool(server);
+        registerInspectTokenTool(server);
+        registerDiagnoseTool(server);
+    },
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/apimapper/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,CAAC,MAAM,mBAAmB,GAAqB;IACnD,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,kGAAkG;QAClG,oFAAoF;QACpF,iDAAiD;IACnD,QAAQ,EAAE,CAAC,MAAiB,EAAE,EAAE;QAC9B,uBAAuB,CAAC,MAAM,CAAC,CAAC;QAChC,uBAAuB,CAAC,MAAM,CAAC,CAAC;QAChC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1B,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC3B,wBAAwB,CAAC,MAAM,CAAC,CAAC;QACjC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC5B,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC7B,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC3B,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC9B,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1B,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC9B,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAC/B,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC7B,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAC/B,wBAAwB,CAAC,MAAM,CAAC,CAAC;QACjC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;CACF,CAAC"}

package/dist/modules/apimapper/inspect.d.ts

@@ -0,0 +1,20 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type TokenPayload } from "../../auth/token.js";
+export interface InspectTokenDerived {
+    age_seconds: number;
+    expires_in_seconds?: number;
+    expired: boolean;
+    env: "live" | "test";
+}
+export interface InspectTokenResult {
+    valid: boolean;
+    payload?: TokenPayload;
+    error?: string;
+    derived?: InspectTokenDerived;
+}
+/**
+ * Decode + analyse a token, network-free. Always returns a result object;
+ * never throws.
+ */
+export declare function inspectToken(token: string): InspectTokenResult;
+export declare function registerInspectTokenTool(server: McpServer): void;

package/dist/modules/apimapper/inspect.js

@@ -0,0 +1,86 @@
+// src/modules/apimapper/inspect.ts — Phase 8.2 network-free token inspector.
+//
+// `apimapper_inspect_token(token)` decodes a pasted API Mapper token via the
+// existing `decodeToken()` helper, then layers derived diagnostics on top:
+//
+//   - `env` — "live" or "test", read from the token prefix.
+//   - `age_seconds` — seconds since `iat`.
+//   - `expires_in_seconds` — only if the token carries `exp`.
+//   - `expired` — boolean. Tokens WITHOUT `exp` are treated as non-expiring
+//     (never expired), matching the server-side KeyService behaviour.
+//
+// No HTTP is performed. No redaction is applied — the caller pasted the
+// token themselves, so surfacing every field back to them is fine.
+import { z } from "zod";
+import { formatResult, readOnly } from "@getimo/mcp-toolkit";
+import { decodeToken } from "../../auth/token.js";
+// Token prefix re-extracted here (independent of token.ts internals) — we
+// only need env classification, which is the second segment of `amk_<env>_*`.
+const TOKEN_ENV_RE = /^amk_(live|test)_/;
+/**
+ * Decode + analyse a token, network-free. Always returns a result object;
+ * never throws.
+ */
+export function inspectToken(token) {
+    if (typeof token !== "string" || token.length === 0) {
+        return { valid: false, error: "token is empty" };
+    }
+    const envMatch = TOKEN_ENV_RE.exec(token);
+    if (!envMatch) {
+        return {
+            valid: false,
+            error: "malformed: token must start with 'amk_live_' or 'amk_test_'",
+        };
+    }
+    const env = envMatch[1];
+    const payload = decodeToken(token);
+    if (!payload) {
+        return {
+            valid: false,
+            error: "malformed: token failed structural decode (invalid base64, unsupported version, or missing required fields)",
+        };
+    }
+    const nowSec = Math.floor(Date.now() / 1000);
+    const age_seconds = nowSec - payload.iat;
+    const derived = {
+        env,
+        age_seconds,
+        expired: false,
+    };
+    if (typeof payload.exp === "number") {
+        const expires_in_seconds = payload.exp - nowSec;
+        derived.expires_in_seconds = expires_in_seconds;
+        derived.expired = expires_in_seconds < 0;
+    }
+    return { valid: true, payload, derived };
+}
+// ── MCP tool registration ──────────────────────────────────────────────
+export function registerInspectTokenTool(server) {
+    server.registerTool("apimapper_inspect_token", {
+        title: "Inspect Token (Network-Free)",
+        description: "Decode an API Mapper token (amk_live_… or amk_test_…) WITHOUT calling the network. " +
+            "Returns the full payload (iss, kid, sub, scope, iat, exp, name) plus derived diagnostics " +
+            "(age_seconds, expires_in_seconds, expired, env). Use before profile creation to verify the " +
+            "user pasted a valid, unexpired token. Signature is NOT verified — server-side check on each request." +
+            "\n\nExample:\n  apimapper_inspect_token({ token: 'amk_live_eyJ2IjoxLC...XYZ.abc123' })",
+        inputSchema: {
+            token: z
+                .string()
+                .min(1)
+                .describe('Token string (e.g., "amk_live_eyJ2IjoxLC...XYZ.abc123"). Pasted by user.'),
+        },
+        annotations: readOnly(),
+    }, async ({ token }) => {
+        const result = inspectToken(token);
+        if (!result.valid) {
+            return formatResult({
+                valid: false,
+                error: result.error,
+                context: { token_length: token.length },
+                hint: "Verify the token starts with 'amk_live_' or 'amk_test_' and was copied complete (no truncation).",
+            }, true);
+        }
+        return formatResult(result, false, { maxChars: 3000 });
+    });
+}
+//# sourceMappingURL=inspect.js.map

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

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

package/dist/modules/apimapper/library.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerLibraryTools(server: McpServer): void;