@wootsup/mcp 0.1.0-rc.1

package/dist/modules/apimapper/misc.js

@@ -0,0 +1,149 @@
+import { z } from "zod";
+import { formatResult, autoFormatTable, readOnly, creating } from "@getimo/mcp-toolkit";
+import { request, hintFor } from "./client.js";
+export function registerMiscTools(server) {
+    // ── apimapper_release_list ─────────────────────────────────────────
+    server.registerTool("apimapper_release_list", {
+        title: "List Available Releases",
+        description: "List API Mapper plugin releases available for download." +
+            "\n\nExample:\n  apimapper_release_list({})",
+        inputSchema: {
+            channel: z
+                .enum(["stable", "beta", "all"])
+                .default("stable")
+                .describe("Release channel filter"),
+            limit: z.number().min(1).max(50).default(10).describe("Max items (1-50)"),
+        },
+        annotations: readOnly(),
+    }, async ({ channel, limit }) => {
+        const params = new URLSearchParams({ channel, limit: String(limit) });
+        const r = await request(`/releases?${params.toString()}`);
+        if (!r.success) {
+            return formatResult({
+                error: r.error,
+                status: r.status,
+                errorCode: r.errorCode,
+                context: { channel, limit },
+                hint: hintFor(r.errorCode),
+            }, true);
+        }
+        const releases = Array.isArray(r.data?.releases) ? r.data.releases : [];
+        return autoFormatTable(releases.map((rel) => ({
+            version: rel.version,
+            channel: rel.channel,
+            date: rel.date,
+            notes: rel.notes_url || "—",
+        })), {
+            columns: [
+                { key: "version", label: "VERSION", width: 12 },
+                { key: "channel", label: "CHANNEL", width: 10 },
+                { key: "date", label: "DATE", width: 22 },
+                { key: "notes", label: "NOTES_URL", width: 50 },
+            ],
+            header: (n) => `${n} releases`,
+            footer: "Use apimapper_release_download to fetch a ZIP.",
+        });
+    });
+    // ── apimapper_release_download ─────────────────────────────────────
+    server.registerTool("apimapper_release_download", {
+        title: "Get Release Download URL",
+        description: "Request a signed download URL for a release ZIP. Read-only operation server-side " +
+            "(generates a temporary signed URL — no state change)." +
+            "\n\nExample:\n  apimapper_release_download({ version: '2.0.6' })",
+        inputSchema: {
+            version: z.string().describe('Release version (e.g., "2.0.7")'),
+            product: z.enum(["wordpress", "joomla"]).describe("Product variant"),
+        },
+        annotations: creating(),
+    }, async ({ version, product }) => {
+        const r = await request("/releases/download", {
+            method: "POST",
+            body: JSON.stringify({ version, product }),
+        });
+        if (!r.success) {
+            return formatResult({
+                error: r.error,
+                status: r.status,
+                errorCode: r.errorCode,
+                context: { version, product },
+                hint: hintFor(r.errorCode),
+            }, true);
+        }
+        if (!r.data?.download_url) {
+            return formatResult({
+                error: "no download URL returned",
+                status: r.status,
+                context: { version, product },
+                hint: "Server returned 200 but no download_url field. Verify version+product combination.",
+            }, true);
+        }
+        return formatResult({
+            download_url: r.data.download_url,
+            expires_at: r.data.expires_at,
+            version,
+            product,
+        }, false, { maxChars: 2000 });
+    });
+    // ── apimapper_brandfetch ───────────────────────────────────────────
+    server.registerTool("apimapper_brandfetch", {
+        title: "Brandfetch Logo Proxy",
+        description: "Fetch a brand's logo metadata via the Brandfetch proxy. Returns logo_svg, logo_png, logo_hex." +
+            "\n\nExample:\n  apimapper_brandfetch({ domain: 'pexels.com' })",
+        inputSchema: {
+            domain: z.string().describe('Domain (e.g., "calendly.com", "google.com")'),
+        },
+        annotations: readOnly(),
+    }, async ({ domain }) => {
+        const r = await request(`/brandfetch/${encodeURIComponent(domain)}`);
+        if (!r.success) {
+            return formatResult({ error: r.error, status: r.status, errorCode: r.errorCode, context: { domain }, hint: hintFor(r.errorCode) }, true);
+        }
+        return formatResult({
+            domain,
+            name: r.data?.name,
+            logo_hex: r.data?.logo_hex,
+            has_svg: Boolean(r.data?.logo_svg),
+            has_png: Boolean(r.data?.logo_png),
+            logo_svg_size: r.data?.logo_svg?.length ?? 0,
+        }, false, { maxChars: 2000 });
+    });
+    // ── apimapper_feedback_submit ──────────────────────────────────────
+    server.registerTool("apimapper_feedback_submit", {
+        title: "Submit Feedback",
+        description: "Submit user feedback (bug report, feature request, support question) to the API Mapper team. " +
+            "Returns submitted:true ONLY when server confirms; 200 + queued:false → structured error." +
+            "\n\nExample:\n  apimapper_feedback_submit({ category: 'bug', message: 'Schema detection misses nested array fields.' })",
+        inputSchema: {
+            type: z.enum(["bug", "feature", "support", "other"]).describe("Feedback type"),
+            subject: z.string().min(1).describe("Subject (short)"),
+            message: z.string().min(1).describe("Full message body"),
+            email: z.string().email().optional().describe("Reply email (optional)"),
+            attachments: z
+                .array(z.string().url())
+                .optional()
+                .describe("Optional attachment URLs (e.g., screenshots already uploaded elsewhere)"),
+        },
+        annotations: creating(),
+    }, async ({ type, subject, message, email, attachments }) => {
+        const r = await request("/feedback", { method: "POST", body: JSON.stringify({ type, subject, message, email, attachments }) }, { unwrapInnerSuccess: true });
+        if (!r.success) {
+            return formatResult({
+                error: r.error,
+                status: r.status,
+                errorCode: r.errorCode,
+                payloadFailed: r.payloadFailed,
+                context: { type, subject_len: subject.length },
+                hint: r.payloadFailed
+                    ? "Server accepted the request but did not queue. Reason in error field."
+                    : hintFor(r.errorCode),
+            }, true);
+        }
+        // unwrapInnerSuccess already caught success:false, so here queued is true.
+        return formatResult({
+            submitted: true,
+            queued: r.data?.queued ?? true,
+            ticket_id: r.data?.ticket_id,
+        }, false, { maxChars: 2000 });
+    });
+}
+//# sourceMappingURL=misc.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"misc.js","sourceRoot":"","sources":["../../../src/modules/apimapper/misc.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,sEAAsE;IACtE,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE,yDAAyD;YACtE,4CAA4C;QAC5C,WAAW,EAAE;YACX,OAAO,EAAE,CAAC;iBACP,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;iBAC/B,OAAO,CAAC,QAAQ,CAAC;iBACjB,QAAQ,CAAC,wBAAwB,CAAC;YACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC;SAC1E;QACD,WAAW,EAAE,QAAQ,EAAE;KACxB,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3B,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtE,MAAM,CAAC,GAAG,MAAM,OAAO,CACrB,aAAa,MAAM,CAAC,QAAQ,EAAE,EAAE,CACjC,CAAC;QACF,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,OAAO,EAAE,KAAK,EAAE;gBAC3B,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;aAC3B,EACD,IAAI,CACL,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,OAAO,eAAe,CACpB,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACrB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,GAAG,CAAC,SAAS,IAAI,GAAG;SAC5B,CAAC,CAA8B,EAChC;YACE,OAAO,EAAE;gBACP,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC/C,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC/C,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;gBACzC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE;aAChD;YACD,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW;YAC9B,MAAM,EAAE,gDAAgD;SACzD,CACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,sEAAsE;IACtE,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,mFAAmF;YACnF,uDAAuD;YACvD,kEAAkE;QACpE,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;YAC/D,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;SACrE;QACD,WAAW,EAAE,QAAQ,EAAE;KACxB,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,MAAM,OAAO,CAAiD,oBAAoB,EAAE;YAC5F,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;SAC3C,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,OAAO,EAAE,OAAO,EAAE;gBAC7B,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;aAC3B,EACD,IAAI,CACL,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC;YAC1B,OAAO,YAAY,CACjB;gBACE,KAAK,EAAE,0BAA0B;gBACjC,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE;gBAC7B,IAAI,EAAE,oFAAoF;aAC3F,EACD,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,YAAY,CACjB;YACE,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY;YACjC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU;YAC7B,OAAO;YACP,OAAO;SACR,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,uBAAuB;QAC9B,WAAW,EAAE,+FAA+F;YAC5G,gEAAgE;QAChE,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;SAC3E;QACD,WAAW,EAAE,QAAQ,EAAE;KACxB,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,MAAM,CAAC,GAAG,MAAM,OAAO,CACrB,eAAe,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAC5C,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,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAC7G,IAAI,CACL,CAAC;QACJ,CAAC;QACD,OAAO,YAAY,CACjB;YACE,MAAM;YACN,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI;YAClB,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ;YAC1B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC;YAClC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC;YAClC,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;SAC7C,EACD,KAAK,EACL,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,sEAAsE;IACtE,MAAM,CAAC,YAAY,CACjB,2BAA2B,EAC3B;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,+FAA+F;YAC/F,0FAA0F;YAC1F,yHAAyH;QAC3H,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;YAC9E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YACtD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YACxD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;YACvE,WAAW,EAAE,CAAC;iBACX,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC;iBACvB,QAAQ,EAAE;iBACV,QAAQ,CAAC,yEAAyE,CAAC;SACvF;QACD,WAAW,EAAE,QAAQ,EAAE;KACxB,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE;QACvD,MAAM,CAAC,GAAG,MAAM,OAAO,CACrB,WAAW,EACX,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,EAAE,EACxF,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAC7B,CAAC;QACF,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,aAAa,EAAE,CAAC,CAAC,aAAa;gBAC9B,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE;gBAC9C,IAAI,EAAE,CAAC,CAAC,aAAa;oBACnB,CAAC,CAAC,uEAAuE;oBACzE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;aACzB,EACD,IAAI,CACL,CAAC;QACJ,CAAC;QACD,2EAA2E;QAC3E,OAAO,YAAY,CACjB;YACE,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,IAAI,IAAI;YAC9B,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS;SAC7B,EACD,KAAK,EACL,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/modules/apimapper/node-schema.d.ts

@@ -0,0 +1,217 @@
+import { z } from "zod";
+export declare const sourceNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"source">;
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    data: z.ZodObject<{
+        connectionId: z.ZodString;
+        endpointId: z.ZodOptional<z.ZodString>;
+        templateFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        itemsPath: z.ZodOptional<z.ZodString>;
+        itemsShape: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export declare const localSourceNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"local-source">;
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    data: z.ZodObject<{
+        contentType: z.ZodString;
+        limit: z.ZodOptional<z.ZodNumber>;
+        filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export declare const filterNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"filter">;
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    data: z.ZodObject<{
+        conditions: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        logic: z.ZodOptional<z.ZodEnum<{
+            or: "or";
+            and: "and";
+        }>>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export declare const transformNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"transform">;
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    data: z.ZodObject<{
+        expression: z.ZodString;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export declare const mergeNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"merge">;
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    data: z.ZodObject<{
+        strategy: z.ZodEnum<{
+            concat: "concat";
+            join: "join";
+        }>;
+        joinKey: z.ZodOptional<z.ZodString>;
+        joinKeyRight: z.ZodOptional<z.ZodString>;
+        joinType: z.ZodOptional<z.ZodEnum<{
+            left: "left";
+            right: "right";
+            inner: "inner";
+            outer: "outer";
+        }>>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export declare const outputNodeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"output">;
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    data: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        slug: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"output-yootheme">;
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    data: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        slug: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"output-shortcode">;
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    data: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        slug: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+}, z.core.$strip>], "type">;
+export declare const nodeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"source">;
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    data: z.ZodObject<{
+        connectionId: z.ZodString;
+        endpointId: z.ZodOptional<z.ZodString>;
+        templateFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        itemsPath: z.ZodOptional<z.ZodString>;
+        itemsShape: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"local-source">;
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    data: z.ZodObject<{
+        contentType: z.ZodString;
+        limit: z.ZodOptional<z.ZodNumber>;
+        filters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"filter">;
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    data: z.ZodObject<{
+        conditions: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        logic: z.ZodOptional<z.ZodEnum<{
+            or: "or";
+            and: "and";
+        }>>;
+    }, z.core.$loose>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"transform">;
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    data: z.ZodObject<{
+        expression: z.ZodString;
+    }, z.core.$loose>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"merge">;
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    data: z.ZodObject<{
+        strategy: z.ZodEnum<{
+            concat: "concat";
+            join: "join";
+        }>;
+        joinKey: z.ZodOptional<z.ZodString>;
+        joinKeyRight: z.ZodOptional<z.ZodString>;
+        joinType: z.ZodOptional<z.ZodEnum<{
+            left: "left";
+            right: "right";
+            inner: "inner";
+            outer: "outer";
+        }>>;
+    }, z.core.$loose>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"output">;
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    data: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        slug: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"output-yootheme">;
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    data: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        slug: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"output-shortcode">;
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>;
+    data: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        slug: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+}, z.core.$strip>], "type">;
+export type FlowNode = z.infer<typeof nodeSchema>;

package/dist/modules/apimapper/node-schema.js

@@ -0,0 +1,218 @@
+// node-schema.ts — Discriminated-union schemas for flow nodes
+//
+// Closes R9 Round-1 A2 P0 #3 (audit 2026-05-18). Before this module the MCP
+// layer validated `nodes` as `z.array(z.record(z.string(), z.unknown()))` —
+// agents could pass `type:'end'` or `type:'append'` and only the PHP backend
+// would reject (after compile attempt). With the discriminated union the
+// rejection happens at the zod boundary with a clear error message.
+//
+// Ground truth (verified 2026-05-18 against PHP executors at
+// src/modules/core/src/Graph/Node/*Executor.php):
+//   • source           → connectionId       (SourceNodeExecutor.php:48)
+//   • local-source     → contentType        (LocalSourceNodeExecutor.php:42)
+//   • filter           → conditions, logic  (FilterNodeExecutor.php:45–61)
+//   • transform        → expression         (TransformNodeExecutor.php:39)
+//   • merge            → strategy ∈ SUPPORTED_STRATEGIES (MergeNodeExecutor.php:50)
+//   • output / output-yootheme / output-shortcode → terminal passthrough
+//                                             (FlowCompiler.php OUTPUT_NODE_TYPES)
+//
+// Design choices:
+//   1. Per-type schemas use `.passthrough()` on the inner data object so
+//      Admin-UI helper fields (e.g. _detected_shape, sourceContext,
+//      template_field_labels) round-trip untouched. Only the type-required
+//      fields are enforced.
+//   2. Position is required (React-Flow runtime needs it). All other shell
+//      fields (sourceHandle, targetHandle on edges) live elsewhere.
+//   3. Discriminated union on `type` gives the agent a clean error like
+//      `Invalid discriminator value. Expected 'source' | 'transform' | ...`.
+import { z } from "zod";
+/** React-Flow node position. */
+const positionSchema = z
+    .object({ x: z.number(), y: z.number() })
+    .describe("React-Flow canvas position");
+// ── source ───────────────────────────────────────────────────────────────
+export const sourceNodeSchema = z
+    .object({
+    id: z.string().describe("Unique node ID within the flow"),
+    type: z.literal("source"),
+    position: positionSchema,
+    data: z
+        .object({
+        connectionId: z
+            .string()
+            .min(1)
+            .describe("Connection ID from apimapper_connection_list"),
+        endpointId: z
+            .string()
+            .optional()
+            .describe("Endpoint within the connection (e.g. 'list', 'search')"),
+        templateFields: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe("Library-template field values (e.g. sheet_id, channel)"),
+        itemsPath: z
+            .string()
+            .optional()
+            .describe("JMESPath into response that points at the items array"),
+        itemsShape: z
+            .string()
+            .optional()
+            .describe("Shape hint ('array', 'object_values', 'headers_rows')"),
+    })
+        .passthrough()
+        .describe("Source-node payload"),
+})
+    .describe("API-source node (fetches from a Connection)");
+// ── local-source ─────────────────────────────────────────────────────────
+export const localSourceNodeSchema = z
+    .object({
+    id: z.string(),
+    type: z.literal("local-source"),
+    position: positionSchema,
+    data: z
+        .object({
+        contentType: z
+            .string()
+            .min(1)
+            .describe("Local content type (e.g. 'post', 'page', 'product')"),
+        limit: z.number().int().min(1).optional().describe("Max items to fetch"),
+        filters: z.record(z.string(), z.unknown()).optional().describe("Server-side filters"),
+    })
+        .passthrough()
+        .describe("Local-source payload (queries WP/Joomla DB directly)"),
+})
+    .describe("Local-source node (CMS-native content)");
+// ── filter ───────────────────────────────────────────────────────────────
+export const filterNodeSchema = z
+    .object({
+    id: z.string(),
+    type: z.literal("filter"),
+    position: positionSchema,
+    data: z
+        .object({
+        conditions: z
+            .array(z.record(z.string(), z.unknown()))
+            .describe("Array of filter conditions ({field, operator, value})"),
+        logic: z
+            .enum(["and", "or"])
+            .optional()
+            .describe("Combinator across conditions; defaults to 'and'"),
+    })
+        .passthrough()
+        .describe("Filter payload"),
+})
+    .describe("Filter node (drops items that fail conditions)");
+// ── transform ────────────────────────────────────────────────────────────
+export const transformNodeSchema = z
+    .object({
+    id: z.string(),
+    type: z.literal("transform"),
+    position: positionSchema,
+    data: z
+        .object({
+        expression: z
+            .string()
+            .min(1)
+            .describe("JMESPath expression. Example: '[*].{title: title, slug: slug}'. " +
+            "For per-item coalesce use '[*].coalesce_empty(c1, c2)'."),
+    })
+        .passthrough()
+        .describe("Transform payload"),
+})
+    .describe("Transform node (per-item JMESPath projection)");
+// ── merge ────────────────────────────────────────────────────────────────
+//
+// SUPPORTED_STRATEGIES is mirrored from
+// src/modules/core/src/Graph/Node/MergeNodeExecutor.php:50.
+// 'append' is a customer-UI alias normalized to 'concat' downstream — at the
+// MCP boundary we accept ONLY the canonical set so agents see the same names
+// the PHP executor enforces. (Normalization happens in normalizers.ts.)
+export const mergeNodeSchema = z
+    .object({
+    id: z.string(),
+    type: z.literal("merge"),
+    position: positionSchema,
+    data: z
+        .object({
+        strategy: z
+            .enum(["concat", "join"])
+            .describe("'concat' = stack items from both inputs; 'join' = relational join on key. " +
+            "Strategies 'append', 'chronological', etc. are NOT valid here."),
+        joinKey: z.string().optional().describe("Field on input-A (required if strategy='join')"),
+        joinKeyRight: z
+            .string()
+            .optional()
+            .describe("Field on input-B (defaults to joinKey when omitted)"),
+        joinType: z
+            .enum(["left", "right", "inner", "outer"])
+            .optional()
+            .describe("SQL-style join kind; defaults to 'left'"),
+    })
+        .passthrough()
+        .describe("Merge payload"),
+})
+    .describe("Merge node (combines two upstream inputs)");
+// ── output (terminal: output / output-yootheme / output-shortcode) ───────
+//
+// Mirrored from FlowCompiler.php OUTPUT_NODE_TYPES const.
+const outputDataSchema = z
+    .object({
+    name: z.string().optional().describe("Display name in the YOOtheme source dropdown"),
+    slug: z.string().optional().describe("URL-safe slug (auto-derived from name when omitted)"),
+})
+    .passthrough();
+export const outputNodeSchema = z
+    .discriminatedUnion("type", [
+    z.object({
+        id: z.string(),
+        type: z.literal("output"),
+        position: positionSchema,
+        data: outputDataSchema,
+    }),
+    z.object({
+        id: z.string(),
+        type: z.literal("output-yootheme"),
+        position: positionSchema,
+        data: outputDataSchema,
+    }),
+    z.object({
+        id: z.string(),
+        type: z.literal("output-shortcode"),
+        position: positionSchema,
+        data: outputDataSchema,
+    }),
+])
+    .describe("Output node (terminal: YOOtheme source, shortcode, or generic)");
+// ── union — the schema flows.ts/graph.ts consume ─────────────────────────
+//
+// NOTE: z.discriminatedUnion requires every member to be a plain ZodObject on
+// the discriminator path. Since outputNodeSchema is itself a discriminated
+// union, we inline its three members here rather than nest unions.
+export const nodeSchema = z
+    .discriminatedUnion("type", [
+    sourceNodeSchema,
+    localSourceNodeSchema,
+    filterNodeSchema,
+    transformNodeSchema,
+    mergeNodeSchema,
+    z.object({
+        id: z.string(),
+        type: z.literal("output"),
+        position: positionSchema,
+        data: outputDataSchema,
+    }),
+    z.object({
+        id: z.string(),
+        type: z.literal("output-yootheme"),
+        position: positionSchema,
+        data: outputDataSchema,
+    }),
+    z.object({
+        id: z.string(),
+        type: z.literal("output-shortcode"),
+        position: positionSchema,
+        data: outputDataSchema,
+    }),
+])
+    .describe("Flow node. Discriminator: `type` ∈ source | local-source | filter | transform | merge | output | output-yootheme | output-shortcode");
+//# sourceMappingURL=node-schema.js.map

package/dist/modules/apimapper/node-schema.js.map

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

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

@@ -0,0 +1,13 @@
+export type MergeStrategy = "concat" | "join";
+export declare function normalizeMergeStrategy(input: string): MergeStrategy;
+/**
+ * Strip leading/trailing slashes from a URL path to keep our encoded paths
+ * consistent regardless of how callers pass them.
+ */
+export declare function trimSlashes(s: string): string;
+/**
+ * Encode each segment of a path but preserve forward slashes. Used for
+ * routes whose param is `platform/type` (LocalSourceController) where the
+ * slash is structural, not a path separator.
+ */
+export declare function encodePathPreservingSlashes(s: string): string;

package/dist/modules/apimapper/normalizers.js

@@ -0,0 +1,37 @@
+// src/modules/apimapper/normalizers.ts — wire-format aliases + small helpers.
+//
+// Backend canonical merge strategies are "concat" and "join". The "append"
+// alias is a customer-facing UI label; the FlowCompiler ultimately persists
+// "concat". Centralised here so workflow tools + tests share one source.
+export function normalizeMergeStrategy(input) {
+    if (input === "append")
+        return "concat";
+    if (input === "concat" || input === "join")
+        return input;
+    // All current call sites validate input via zod enum upstream. This
+    // fallback exists only for direct programmatic callers that skipped
+    // the schema layer; surface a console.warn so the deviation is visible
+    // in operator logs.
+    // eslint-disable-next-line no-console
+    console.warn(`[apimapper-rest:normalizers] unknown merge strategy "${input}" — defaulting to "concat"`);
+    return "concat";
+}
+/**
+ * Strip leading/trailing slashes from a URL path to keep our encoded paths
+ * consistent regardless of how callers pass them.
+ */
+export function trimSlashes(s) {
+    return s.replace(/^\/+|\/+$/g, "");
+}
+/**
+ * Encode each segment of a path but preserve forward slashes. Used for
+ * routes whose param is `platform/type` (LocalSourceController) where the
+ * slash is structural, not a path separator.
+ */
+export function encodePathPreservingSlashes(s) {
+    return s
+        .split("/")
+        .map((seg) => encodeURIComponent(seg))
+        .join("/");
+}
+//# sourceMappingURL=normalizers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalizers.js","sourceRoot":"","sources":["../../../src/modules/apimapper/normalizers.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,yEAAyE;AAIzE,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACxC,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACzD,oEAAoE;IACpE,oEAAoE;IACpE,uEAAuE;IACvE,oBAAoB;IACpB,sCAAsC;IACtC,OAAO,CAAC,IAAI,CACV,wDAAwD,KAAK,4BAA4B,CAC1F,CAAC;IACF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,OAAO,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,CAAS;IACnD,OAAO,CAAC;SACL,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;SACrC,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}