@wootsup/mcp 0.3.0 → 0.4.0

package/dist/modules/apimapper/read-cache.js

@@ -143,19 +143,74 @@ export function setCached(method, url, data, opts) {
         storedAt: now,
     });
 }
+/**
+ * Cross-family invalidation map (A19, mcp-cold-readiness-audit 2026-06-10).
+ *
+ * Some mutations affect a DIFFERENT resource family than the path they POST
+ * to. The path-overlap matcher below only handles same-family + ancestor/
+ * descendant invalidation; it cannot know that completing an OAuth flow
+ * mutates credential STATUS. Each entry maps a mutation-path prefix to the
+ * extra read-family path(s) that must also be flushed.
+ *
+ * `/oauth` → `/credentials`: oauth_authorize_begin (and the consent callback)
+ * refresh a credential's token; without this, a cached GET /credentials keeps
+ * serving the pre-authorize "expired" status for the full TTL and the agent
+ * re-suggests a reconnect it already completed.
+ */
+const CROSS_FAMILY_INVALIDATION = [
+    { when: "/oauth", also: ["/credentials"] },
+];
 /**
  * Invalidate cache entries whose request path overlaps with the mutated
- * resource. Conservative — clears every entry whose key includes the
- * given path-substring. e.g. invalidateByPath('/flows') clears
- * `/flows`, `/flows?status=published`, `/flows/abc123`.
+ * resource — in BOTH directions. Conservative — clears every entry whose
+ * cached path contains the mutation path (descendants + query variants,
+ * e.g. invalidateByPath('/flows') clears `/flows`, `/flows?status=…`,
+ * `/flows/abc123`) AND every entry whose cached path is an ancestor of
+ * the mutation path (e.g. POST `/flows/abc/detect-schema` flushes the
+ * cached GET `/flows/abc` and `/flows`).
+ *
+ * The ancestor direction is load-bearing: 2026-06-09 Round-2 live repro —
+ * a sub-resource mutation (`/flows/{id}/detect-schema`) persisted the
+ * output schema, but the cached parent GET `/flows/{id}` kept serving the
+ * pre-schema flow for the full TTL, so binding_for_flow reported
+ * fields:[] while the data was already saved.
+ *
+ * A19: in addition, a mutation may invalidate a DIFFERENT resource family
+ * (see CROSS_FAMILY_INVALIDATION) — e.g. an /oauth mutation flushes the
+ * cached /credentials list.
  *
  * Called automatically from client.ts on POST/PUT/PATCH/DELETE.
  */
 export function invalidateByPath(path) {
     const needle = path.split("?")[0]; // strip query, match path only
     for (const key of store.keys()) {
-        if (key.includes(needle))
+        if (key.includes(needle)) {
             store.delete(key);
+            continue;
+        }
+        // Ancestor match: the cached entry's path-part (key format
+        // `METHOD::S|R::url`) is a path-segment prefix of the mutation path.
+        const keyPath = (key.split("::")[2] ?? "").split("?")[0];
+        if (keyPath !== "" && needle.startsWith(keyPath + "/")) {
+            store.delete(key);
+        }
+    }
+    // A19 — cross-family: a mutation under a mapped prefix also flushes the
+    // related read-family path(s). Each `also` entry is delegated back through
+    // the same descendant/query-variant matcher so `/credentials?…` variants go
+    // too. Guarded against self-recursion (an `also` path never re-matches its
+    // own `when`).
+    for (const rule of CROSS_FAMILY_INVALIDATION) {
+        if (needle.includes(rule.when)) {
+            for (const alsoPath of rule.also) {
+                const alsoNeedle = alsoPath.split("?")[0];
+                for (const key of store.keys()) {
+                    if (key.includes(alsoNeedle)) {
+                        store.delete(key);
+                    }
+                }
+            }
+        }
     }
 }
 /**

package/dist/modules/apimapper/read-cache.js.map

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

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

@@ -8,16 +8,16 @@ import { capRendered, hintFor, HARD_CAP, RESERVE } from "./token-cap.js";
 // the same affordance when a renderer's Zod schema rejects the payload.
 const RENDER_ERROR_HINTS = {
     table: "type:'table' expects an array of objects — fetch with " +
-        "apimapper_connection_data or apimapper_graph_preview.",
+        'apimapper_connection_data or apimapper_advanced({ tool: "apimapper_graph_preview" }).',
     "chart-bar": "type:'chart-bar' expects { labels: string[], values: number[] } of equal length.",
     "chart-line": "type:'chart-line' expects { labels: string[], values: number[] } of equal length.",
     "schema-diagram": "type:'schema-diagram' expects a schema profile with fields[] — " +
-        "fetch with apimapper_schema_profile.",
+        'fetch with apimapper_advanced({ tool: "apimapper_schema_profile" }).',
     "flow-diagram": "type:'flow-diagram' expects a flow object with nodes[]+edges[] — " +
-        "fetch with apimapper_flow_get.",
+        'fetch with apimapper_advanced({ tool: "apimapper_flow_get" }).',
     "json-tree": "type:'json-tree' accepts any JSON value — pass the fetched payload directly.",
     diff: "type:'diff' expects { old, new } — fetch both datasets first " +
-        "(e.g. two apimapper_schema_profile calls).",
+        '(e.g. two apimapper_advanced({ tool: "apimapper_schema_profile" }) calls).',
 };
 // MCP CallToolResult outer guard. DERIVED from token-cap.ts's HARD_CAP +
 // RESERVE so the relationship is compiler-enforced — bumping HARD_CAP in
@@ -62,7 +62,28 @@ export function registerRenderTool(server) {
             "Example:\n  apimapper_render({ type: 'flow-diagram', data: flowObject })",
         inputSchema: {
             type: z.enum(RENDER_TYPES).describe("Visualization type"),
-            data: z.unknown().describe("Data to render. Shape depends on type — see description."),
+            // MCP clients (and forwarding LLMs) frequently deliver `data` as a
+            // JSON *string* — the fetched payload gets serialised on the way in.
+            // Pre-parse a JSON string back into its value before the renderer's
+            // inner Zod schema runs, otherwise every renderer rejects the string
+            // ("table requires an array", etc.). A non-JSON string (e.g. a plain
+            // sentence) keeps its original value so it can still render as a
+            // primitive leaf. The inner schema stays z.unknown() — per-type
+            // validation lives in each renderer.
+            data: z
+                .preprocess((v) => {
+                if (typeof v !== "string")
+                    return v;
+                const trimmed = v.trim();
+                try {
+                    return JSON.parse(trimmed);
+                }
+                catch {
+                    return v;
+                }
+            }, z.unknown())
+                .describe("Data to render. Shape depends on type — see description. " +
+                "A JSON-encoded string is auto-parsed; a plain string renders as-is."),
             options: z.object({
                 title: z.string().max(200).optional()
                     .describe("Optional title shown above the visualization"),

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/apimapper/render/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAmB,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzE,qEAAqE;AACrE,wEAAwE;AACxE,8EAA8E;AAC9E,wEAAwE;AACxE,MAAM,kBAAkB,GAA+B;IACrD,KAAK,EACH,wDAAwD;QACxD,uDAAuD;IACzD,WAAW,EACT,kFAAkF;IACpF,YAAY,EACV,mFAAmF;IACrF,gBAAgB,EACd,iEAAiE;QACjE,sCAAsC;IACxC,cAAc,EACZ,mEAAmE;QACnE,gCAAgC;IAClC,WAAW,EACT,8EAA8E;IAChF,IAAI,EACF,+DAA+D;QAC/D,4CAA4C;CAC/C,CAAC;AAEF,yEAAyE;AACzE,yEAAyE;AACzE,sEAAsE;AACtE,0EAA0E;AAC1E,0EAA0E;AAC1E,uEAAuE;AACvE,4DAA4D;AAC5D,MAAM,qBAAqB,GAAG,QAAQ,GAAG,OAAO,GAAG,GAAG,CAAC;AAEvD,MAAM,UAAU,kBAAkB,CAAC,MAAqB;IACtD,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,aAAa;QACpB,WAAW;QACT,iEAAiE;QACjE,kEAAkE;QAClE,mEAAmE;QACnE,gEAAgE;QAChE,mEAAmE;QACnE,gEAAgE;QAChE,mDAAmD;QACnD,iEAAiE;YACjE,kEAAkE;YAClE,mEAAmE;YACnE,2CAA2C;YAC3C,kEAAkE;YAClE,6DAA6D;YAC7D,gEAAgE;YAChE,kEAAkE;YAClE,iCAAiC;YACjC,uEAAuE;YACvE,mCAAmC;YACnC,+DAA+D;YAC/D,qEAAqE;YACrE,sCAAsC;YACtC,gFAAgF;YAChF,kEAAkE;YAClE,2EAA2E;YAC3E,iEAAiE;YACjE,oEAAoE;YACpE,4DAA4D;YAC5D,oEAAoE;YACpE,0EAA0E;QAC5E,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;YACzD,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CACxB,0DAA0D,CAC3D;YACD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;gBAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;qBAClC,QAAQ,CAAC,8CAA8C,CAAC;gBAC3D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;qBAC9D,QAAQ,CAAC,gDAAgD,CAAC;gBAC7D,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;qBAC5C,QAAQ,CAAC,kDAAkD,CAAC;gBAC/D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;qBACxD,QAAQ,CAAC,qCAAqC,CAAC;gBAClD,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;qBAC/C,QAAQ,CAAC,8DAA8D,CAAC;aAC5E,CAAC,CAAC,QAAQ,EAAE;SACd;QACD,WAAW,EAAE,QAAQ,CAAC;YACpB,KAAK,EAAE,aAAa;YACpB,SAAS,EAAE,KAAK;SACjB,CAAC;KACH,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;QAChC,mEAAmE;QACnE,wEAAwE;QACxE,uEAAuE;QACvE,+DAA+D;QAC/D,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;YACzD,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YAChD,OAAO,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,qBAAqB,EAAE,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,mEAAmE;YACnE,oEAAoE;YACpE,2DAA2D;YAC3D,iFAAiF;YACjF,MAAM,GAAG,GACP,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YACvD,kEAAkE;YAClE,mEAAmE;YACnE,mEAAmE;YACnE,gCAAgC;YAChC,MAAM,OAAO,GACX,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACnD,mEAAmE;YACnE,gEAAgE;YAChE,kEAAkE;YAClE,YAAY;YACZ,OAAO,YAAY,CACjB,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,CAAC,IAAI,CAAC,EAAE,EACxD,IAAI,CACL,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/apimapper/render/index.ts"],"names":[],"mappings":"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"}

package/dist/modules/apimapper/resource-id.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Extract a Google Spreadsheet ID from a pasted URL, or return the input
+ * unchanged when it is already a bare ID (or an unrecognised value the
+ * backend should validate).
+ *
+ * Handles:
+ *  - bare ID:            1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms
+ *  - standard URL:       https://docs.google.com/spreadsheets/d/{ID}/edit
+ *  - URL with #gid hash: .../spreadsheets/d/{ID}/edit#gid=0
+ *  - /copy, /view, etc.: .../spreadsheets/d/{ID}/copy
+ */
+export declare function extractSpreadsheetId(input: string): string;
+export declare function normalizeResourceIdFields<T extends Record<string, unknown> | undefined>(fields: T): T;

package/dist/modules/apimapper/resource-id.js

@@ -0,0 +1,69 @@
+// src/modules/apimapper/resource-id.ts — server-bound resource-ID normalizers.
+//
+// A5 (2026-06-10): a cold-agent customer supplies ONLY a Google Drive / Sheets
+// URL (the only thing they have), but the worker template placeholder
+// {{spreadsheet_id}} needs the BARE id. The single URL→ID extractor used to
+// live in the React admin-UI (extractResourceId.ts) and never reached the
+// wire — so an MCP/REST caller pasting a URL produced a broken connection that
+// returned 0 rows with no debuggable signal. We normalize on the MCP→REST
+// boundary so the exact-as-given input works.
+//
+// Port of admin-ui/src/utils/extractResourceId.ts kept deliberately in
+// lockstep — same patterns, same "return input unchanged when nothing
+// matches" contract (the backend still validates).
+/**
+ * Extract a Google Spreadsheet ID from a pasted URL, or return the input
+ * unchanged when it is already a bare ID (or an unrecognised value the
+ * backend should validate).
+ *
+ * Handles:
+ *  - bare ID:            1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms
+ *  - standard URL:       https://docs.google.com/spreadsheets/d/{ID}/edit
+ *  - URL with #gid hash: .../spreadsheets/d/{ID}/edit#gid=0
+ *  - /copy, /view, etc.: .../spreadsheets/d/{ID}/copy
+ */
+export function extractSpreadsheetId(input) {
+    const trimmed = input.trim();
+    // Already a bare ID (alphanumeric + dash + underscore, 20+ chars).
+    if (/^[a-zA-Z0-9_-]{20,}$/.test(trimmed)) {
+        return trimmed;
+    }
+    const urlMatch = trimmed.match(/\/spreadsheets\/d\/([a-zA-Z0-9_-]+)/);
+    if (urlMatch?.[1]) {
+        return urlMatch[1];
+    }
+    // Unrecognised — return as-is, let the backend validate.
+    return trimmed;
+}
+/**
+ * Normalize the well-known resource-ID fields inside a template-field /
+ * extra-field map IN PLACE-safe fashion (returns a new object). Currently
+ * handles `spreadsheet_id` (Google Sheets); the table is the single place to
+ * extend for future URL-shaped resource IDs (drive_file_id, doc_id, ...).
+ *
+ * Only string values are touched; non-string values pass through verbatim so
+ * the wider string|number|boolean schema on connection_data.template_fields
+ * is preserved. Returns the input reference unchanged when there is nothing
+ * to normalize, so a default call stays byte-identical on the wire.
+ */
+const RESOURCE_ID_NORMALIZERS = {
+    spreadsheet_id: extractSpreadsheetId,
+};
+export function normalizeResourceIdFields(fields) {
+    if (!fields || typeof fields !== "object")
+        return fields;
+    let changed = false;
+    const out = { ...fields };
+    for (const [key, normalize] of Object.entries(RESOURCE_ID_NORMALIZERS)) {
+        const value = out[key];
+        if (typeof value === "string") {
+            const next = normalize(value);
+            if (next !== value) {
+                out[key] = next;
+                changed = true;
+            }
+        }
+    }
+    return (changed ? out : fields);
+}
+//# sourceMappingURL=resource-id.js.map

package/dist/modules/apimapper/resource-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-id.js","sourceRoot":"","sources":["../../../src/modules/apimapper/resource-id.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,+EAA+E;AAC/E,sEAAsE;AACtE,4EAA4E;AAC5E,0EAA0E;AAC1E,+EAA+E;AAC/E,0EAA0E;AAC1E,8CAA8C;AAC9C,EAAE;AACF,uEAAuE;AACvE,sEAAsE;AACtE,mDAAmD;AAEnD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,mEAAmE;IACnE,IAAI,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACtE,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClB,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,yDAAyD;IACzD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,uBAAuB,GAA0C;IACrE,cAAc,EAAE,oBAAoB;CACrC,CAAC;AAEF,MAAM,UAAU,yBAAyB,CAEvC,MAAS;IACT,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IACzD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,GAAG,GAA4B,EAAE,GAAG,MAAM,EAAE,CAAC;IACnD,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE,CAAC;QACvE,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;gBACnB,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;gBAChB,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAM,CAAC;AACvC,CAAC"}

package/dist/modules/apimapper/tool-result.d.ts

@@ -13,6 +13,15 @@ export interface RestErrorLike {
     errorCode?: ApiErrorCode | string;
     /** HTTP status, used as the `code` fallback when `errorCode` is absent. */
     status?: number;
+    /**
+     * F11 (2026-06-09): the parsed JSON body of a non-2xx response (the WP +
+     * Joomla platform paths thread it through as `errorBody`). When the server
+     * returns a STRUCTURED domain error — e.g. the 400 `invalid_content_type`
+     * payload `{error_code, valid_types, suggestion}` — we surface those fields
+     * VERBATIM instead of the coarse `errorCode`/`hintFor()` defaults. Absent for
+     * non-JSON errors and for the legacy paths that never set it.
+     */
+    errorBody?: Record<string, unknown>;
 }
 /** Per-site overrides for the canonical REST-error mapping. */
 export interface RestErrorOpts {
@@ -31,6 +40,17 @@ export interface RestErrorOpts {
      * `response.errorCode` is absent. Use only where a site pinned a domain code.
      */
     code?: string;
+    /**
+     * F6 (2026-06-09): opt-in scope-aware 403 handling. Set by tools whose 403
+     * means "your key lacks the required scope" rather than "your key is
+     * invalid" — e.g. the *_delete tools (delete needs admin scope; a valid
+     * read+write key still 403s). When true AND the response is a 403 (or the
+     * body signals insufficient scope), the suggestion becomes a scope-upgrade
+     * hint instead of the generic key-recovery walkthrough. A 401 always stays a
+     * genuine bad-key auth failure even under scopeAware. Leave unset everywhere
+     * else so non-delete tools keep the legacy auth hint byte-for-byte.
+     */
+    scopeAware?: boolean;
 }
 /**
  * Build the canonical structured error result for a failed REST request.

package/dist/modules/apimapper/tool-result.js

@@ -51,13 +51,75 @@ import { hintFor } from "./client.js";
  */
 export function restErrorResult(response, details, opts = {}) {
     const errorCode = response.errorCode;
+    const body = response.errorBody;
+    // F11: structured server-error passthrough. When the server attached a
+    // domain error_code (e.g. invalid_content_type), prefer it for `code`, lift
+    // its `suggestion` over the coarse hintFor(), and thread its `valid_types`
+    // (and any other primitive hint) into `details` so the agent can
+    // self-correct. Only engages when the body actually carries a string
+    // `error_code` — so a plain `{success:false, error}` body keeps the legacy
+    // path byte-for-byte.
+    const serverErrorCode = body && typeof body.error_code === "string" && body.error_code !== ""
+        ? body.error_code
+        : undefined;
+    const serverSuggestion = body && typeof body.suggestion === "string" && body.suggestion !== ""
+        ? body.suggestion
+        : undefined;
+    const serverValidTypes = body && Array.isArray(body.valid_types) ? body.valid_types : undefined;
+    // F6: scope-aware 403. A delete tool (scopeAware:true) that gets a 403 — or
+    // any body signalling insufficient scope — is missing the admin scope, not
+    // holding a bad key. A 401 is always a genuine bad-key failure regardless.
+    const bodyScopeSignal = body &&
+        ((typeof body.error_code === "string" && /scope/i.test(body.error_code)) ||
+            (typeof body.required_scope === "string" && body.required_scope !== ""));
+    const isScopeFailure = response.status !== 401 &&
+        (opts.scopeAware === true || bodyScopeSignal === true) &&
+        (response.status === 403 || bodyScopeSignal === true);
+    // F204 — distinguish an OWNERSHIP denial from a plain missing-admin-scope
+    // denial. `insufficient_scope_ownership` means the write-scope key tried to
+    // delete a flow it did NOT create; the remedy is "delete only your own flows,
+    // or use an admin key", not just "create an admin key".
+    const isOwnershipFailure = body && typeof body.error_code === "string" && body.error_code === "insufficient_scope_ownership";
+    const scopeSuggestion = isOwnershipFailure
+        ? "This write-scope key can only delete flows they created (the flow's owner " +
+            "kid must match the key's kid). This flow was created by a different key or " +
+            "via the dashboard, so it needs the admin scope. Use an admin-scope key " +
+            "(API Mapper → ⋮ menu → Settings → MCP Access → New API key, grant the admin " +
+            "scope, then re-run `npx -y @wootsup/mcp setup`), or delete it from the dashboard."
+        : isScopeFailure
+            ? "Your key lacks the admin scope required for delete/destructive operations. " +
+                "Create an admin-scope key (API Mapper → ⋮ menu → Settings → MCP Access → New API key, " +
+                "grant the admin scope) and re-run `npx -y @wootsup/mcp setup`, or perform the deletion " +
+                "from the dashboard."
+            : undefined;
+    // Suggestion precedence: explicit opts.suggestion → server suggestion (F11)
+    // → scope hint (F6) → coarse/message-driven hintFor(). The first three are
+    // intentional overrides; hintFor() is the legacy default. F83: pass the
+    // upstream `error` message so a JMESPath depth-limit 422 (which classifies to
+    // "unknown") routes to the two-transform-split remedy instead of the generic
+    // health hint. The depth detection only fires on the depth-limit wording, so
+    // every other message keeps the code-based hint byte-for-byte.
+    const suggestion = opts.suggestion ??
+        serverSuggestion ??
+        scopeSuggestion ??
+        hintFor(errorCode, response.error);
+    // Code precedence: server domain error_code (F11) → coarse errorCode →
+    // opts.code → status. The server code is the most specific, so it wins over
+    // the coarse classification (which is often just "unknown" for a 400).
+    const code = serverErrorCode ??
+        (errorCode !== undefined && errorCode !== ""
+            ? String(errorCode)
+            : opts.code ?? (response.status ? String(response.status) : undefined));
+    // Merge server hint fields (valid_types) into details so they reach the
+    // agent. Caller-supplied details win on key collision.
+    const mergedDetails = serverValidTypes !== undefined
+        ? { valid_types: serverValidTypes, ...(details ?? {}) }
+        : details;
     return errorResult({
         message: response.error ?? opts.message ?? "request failed",
-        code: errorCode !== undefined && errorCode !== ""
-            ? String(errorCode)
-            : opts.code ?? (response.status ? String(response.status) : undefined),
-        suggestion: opts.suggestion ?? hintFor(errorCode),
-        ...(details !== undefined ? { details } : {}),
+        code,
+        suggestion,
+        ...(mergedDetails !== undefined ? { details: mergedDetails } : {}),
     });
 }
 //# sourceMappingURL=tool-result.js.map

package/dist/modules/apimapper/tool-result.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-result.js","sourceRoot":"","sources":["../../../src/modules/apimapper/tool-result.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,EAAE;AACF,wEAAwE;AACxE,6DAA6D;AAC7D,EAAE;AACF,sBAAsB;AACtB,2BAA2B;AAC3B,mDAAmD;AACnD,wEAAwE;AACxE,0CAA0C;AAC1C,qCAAqC;AACrC,UAAU;AACV,MAAM;AACN,EAAE;AACF,yEAAyE;AACzE,kEAAkE;AAClE,EAAE;AACF,6DAA6D;AAC7D,0EAA0E;AAC1E,yDAAyD;AACzD,2EAA2E;AAC3E,EAAE;AACF,+CAA+C;AAC/C,+EAA+E;AAC/E,+EAA+E;AAC/E,8EAA8E;AAC9E,uDAAuD;AACvD,qEAAqE;AACrE,gFAAgF;AAChF,mEAAmE;AACnE,qDAAqD;AACrD,EAAE;AACF,sEAAsE;AACtE,qEAAqE;AACrE,0EAA0E;AAC1E,2EAA2E;AAC3E,4EAA4E;AAC5E,yCAAyC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,OAAO,EAAqB,MAAM,aAAa,CAAC;AAoCzD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAuB,EACvB,OAAiC,EACjC,OAAsB,EAAE;IAExB,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;IACrC,OAAO,WAAW,CAAC;QACjB,OAAO,EAAE,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,IAAI,gBAAgB;QAC3D,IAAI,EACF,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,EAAE;YACzC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;YACnB,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,UAAU,EACR,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,SAAqC,CAAC;QACnE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9C,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"tool-result.js","sourceRoot":"","sources":["../../../src/modules/apimapper/tool-result.ts"],"names":[],"mappings":"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"}

package/dist/modules/apimapper/toolslist-size.d.ts

@@ -1,4 +1,4 @@
-import { type CollectedTool } from "./gateway/test-support.js";
+import { type CollectedTool } from "./gateway/collect-module-tools.js";
 /**
  * The minimal `tools/list`-relevant slice of a registered tool: the fields the
  * MCP client receives and the LLM reads as part of the static catalog.
@@ -23,9 +23,9 @@ export interface ToolsListMeasurement {
 }
 /** The full Task-B result: the post-W3 and pre-W3-equivalent surfaces. */
 export interface ToolsListComparison {
-    /** Post-W3 `tools/list` — the 19 surface tools the server exposes today. */
+    /** Post-W3 `tools/list` — the 21 surface tools the server exposes today. */
     postW3: ToolsListMeasurement;
-    /** Pre-W3-equivalent `tools/list` — all 78 tools exposed flat (no gateway). */
+    /** Pre-W3-equivalent `tools/list` — all 79 tools exposed flat (no gateways). */
     preW3Flat: ToolsListMeasurement;
     /** Absolute byte reduction (preW3Flat.totalBytes − postW3.totalBytes). */
     bytesSaved: number;
@@ -39,18 +39,18 @@ export interface ToolsListComparison {
  */
 export declare function toCatalogEntry(name: string, tool: Pick<CollectedTool, "description" | "inputSchema" | "annotations">): ToolCatalogEntry;
 /**
- * Builds the full 79-tool catalog from the current build and measures the
+ * Builds the full 81-tool catalog from the current build and measures the
  * post-W3 vs pre-W3-equivalent `tools/list` payload sizes.
  *
  * Surface composition (verified against `gateway/essentials.ts` + `src/index.ts`,
  * pinned live in `gateway/gateway.test.ts` — A2):
- *   - module tools  : 15 essentials + `apimapper_advanced` = 16 (on the real
- *                     McpServer) + 60 advanced (gateway registry)            = 76
+ *   - module tools  : 16 essentials + `apimapper_advanced` + `apimapper_advanced_read`
+ *                     = 18 (on the real McpServer) + 60 advanced (gateway registry) = 78
  *   - top-level tools: rest_modules_status + use_profile + list_profiles      =  3
- *                                                                      total = 79
+ *                                                                      total = 81
  *
- * POST-W3 `tools/list` = the 16 module-real tools + the 3 top-level tools = 19.
- * PRE-W3 flat `tools/list` = the 18 non-gateway surface tools + the 60 advanced
- * tools = 78 (the `apimapper_advanced` gateway did not exist pre-W3).
+ * POST-W3 `tools/list` = the 18 module-real tools + the 3 top-level tools = 21.
+ * PRE-W3 flat `tools/list` = the 19 non-gateway surface tools + the 60 advanced
+ * tools = 79 (neither gateway existed pre-W3).
  */
 export declare function measureToolsList(): Promise<ToolsListComparison>;

package/dist/modules/apimapper/toolslist-size.js

@@ -7,15 +7,23 @@
 // Two figures, both derived from the CURRENT build (canonical counts asserted
 // live in gateway/gateway.test.ts — A2, 2026-06-03):
 //
-//   - POST-W3 `tools/list`        — the 19 surface tools the server now exposes
-//                                   (15 module essentials + `apimapper_advanced`
-//                                   + the 3 src/index.ts top-level tools).
+//   - POST-W3 `tools/list`        — the 21 surface tools the server now exposes
+//                                   (16 module essentials + `apimapper_advanced`
+//                                   + `apimapper_advanced_read` + the 3
+//                                   src/index.ts top-level tools).
 //   - PRE-W3-equivalent `tools/list` — what `tools/list` WOULD be if all 79
 //                                   tools were exposed flat (the pre-Gateway
-//                                   state): the 19 surface tools minus the
-//                                   gateway tool, plus the 60 advanced-registry
-//                                   tool configs — 78 flat tools. (Pre-W3 the
-//                                   `apimapper_advanced` gateway did not exist.)
+//                                   state): the 21 surface tools minus the TWO
+//                                   gateway tools, plus the 60 advanced-registry
+//                                   tool configs — 79 flat tools. (Pre-W3 neither
+//                                   gateway existed.)
+//                                   F115 (2026-06-11): apimapper_health promoted
+//                                   advanced→essential — surface 19→20, advanced
+//                                   60→59 then 60. F200b (2026-06-12):
+//                                   apimapper_advanced_read added as a 2nd
+//                                   module-real gateway — surface 20→21; the flat
+//                                   total stays 79 (a gateway is a routing entry,
+//                                   never a flat tool).
 //
 // Per-tool serialization mirrors what the MCP SDK puts on the wire for one
 // `tools/list` entry: `{ name, description, inputSchema, annotations }`, where
@@ -33,7 +41,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { loadModules } from "@getimo/mcp-toolkit";
 import { z } from "zod";
 import { apimapperRestModule } from "./index.js";
-import { collectModuleTools } from "./gateway/test-support.js";
+import { collectModuleTools } from "./gateway/collect-module-tools.js";
 import { registerListProfilesTool, registerUseProfileTool, } from "./use-profile.js";
 import { ProfileStore } from "../../auth/profiles.js";
 /**
@@ -137,19 +145,19 @@ function captureTopLevelTools() {
     return captured;
 }
 /**
- * Builds the full 79-tool catalog from the current build and measures the
+ * Builds the full 81-tool catalog from the current build and measures the
  * post-W3 vs pre-W3-equivalent `tools/list` payload sizes.
  *
  * Surface composition (verified against `gateway/essentials.ts` + `src/index.ts`,
  * pinned live in `gateway/gateway.test.ts` — A2):
- *   - module tools  : 15 essentials + `apimapper_advanced` = 16 (on the real
- *                     McpServer) + 60 advanced (gateway registry)            = 76
+ *   - module tools  : 16 essentials + `apimapper_advanced` + `apimapper_advanced_read`
+ *                     = 18 (on the real McpServer) + 60 advanced (gateway registry) = 78
  *   - top-level tools: rest_modules_status + use_profile + list_profiles      =  3
- *                                                                      total = 79
+ *                                                                      total = 81
  *
- * POST-W3 `tools/list` = the 16 module-real tools + the 3 top-level tools = 19.
- * PRE-W3 flat `tools/list` = the 18 non-gateway surface tools + the 60 advanced
- * tools = 78 (the `apimapper_advanced` gateway did not exist pre-W3).
+ * POST-W3 `tools/list` = the 18 module-real tools + the 3 top-level tools = 21.
+ * PRE-W3 flat `tools/list` = the 19 non-gateway surface tools + the 60 advanced
+ * tools = 79 (neither gateway existed pre-W3).
  */
 export async function measureToolsList() {
     const server = new McpServer({
@@ -175,9 +183,12 @@ export async function measureToolsList() {
     for (const [name, tool] of topLevelTools) {
         postEntries.push(toCatalogEntry(name, tool));
     }
-    // PRE-W3-equivalent flat surface: the post-W3 surface MINUS the gateway tool
-    // (it did not exist pre-W3) PLUS every advanced tool exposed flat.
-    const preEntries = postEntries.filter((e) => e.name !== "apimapper_advanced");
+    // PRE-W3-equivalent flat surface: the post-W3 surface MINUS the gateway tools
+    // (neither existed pre-W3) PLUS every advanced tool exposed flat. F200b added
+    // the apimapper_advanced_read gateway — it is a routing entry like
+    // apimapper_advanced, not a flat tool, so it is excluded from the pre-W3 flat
+    // catalog too (the flat surface still totals 79 real tools).
+    const preEntries = postEntries.filter((e) => e.name !== "apimapper_advanced" && e.name !== "apimapper_advanced_read");
     for (const [name, tool] of Object.entries(moduleTools)) {
         if (!advancedNames.has(name))
             continue; // only the advanced tools

package/dist/modules/apimapper/toolslist-size.js.map

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

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

@@ -32,6 +32,11 @@ export interface Connection {
     template_fields?: Record<string, unknown>;
     origin_hash?: string;
     origin_id?: string | null;
+    health?: {
+        status?: string | null;
+        message?: string | null;
+        [k: string]: unknown;
+    } | null;
 }
 export interface Credential {
     id: string;
@@ -95,6 +100,13 @@ export interface Flow {
     version?: number;
     updated_at?: string;
     created_at?: string;
+    created_by?: string | null;
+    last_execution?: {
+        at?: string;
+        output_count?: number;
+        step_count?: number;
+        had_error?: boolean;
+    };
 }
 export interface LibraryItem {
     id: string;
@@ -106,6 +118,7 @@ export interface LibraryItem {
     is_activated?: boolean;
     logo_svg?: string;
     logo_hex?: string;
+    featured?: boolean;
 }
 export interface NodeSnapshot {
     id: string;

package/dist/modules/apimapper/types.js

@@ -7,7 +7,7 @@
 //   - Credential wire format = snake_case (auth_type, auth_data, oauth_provider)
 //   - Graph wire format      = camelCase (targetNodeId, forceRefresh)
 //   - Library wire format    = snake_case (extra_fields, library_connection)
-//   - LocalSource wire fmt   = camelCase (contentType) with "platform/type" id ("wordpress/posts")
+//   - LocalSource wire fmt   = camelCase (contentType) with "platform/type" id ("wordpress/post")
 //
 // These types reflect the actual REST contract verified against the PHP controllers.
 // =============================================================================

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/modules/apimapper/types.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,EAAE;AACF,yEAAyE;AACzE,iGAAiG;AACjG,oFAAoF;AACpF,wEAAwE;AACxE,iFAAiF;AACjF,sEAAsE;AACtE,6EAA6E;AAC7E,mGAAmG;AACnG,EAAE;AACF,qFAAqF;AAmJrF,gFAAgF;AAChF,iEAAiE;AACjE,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,MAAM,CAAmB,KAAmB;IAC1D,OAAO,KAAwD,CAAC;AAClE,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/modules/apimapper/types.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,EAAE;AACF,yEAAyE;AACzE,iGAAiG;AACjG,oFAAoF;AACpF,wEAAwE;AACxE,iFAAiF;AACjF,sEAAsE;AACtE,6EAA6E;AAC7E,kGAAkG;AAClG,EAAE;AACF,qFAAqF;AA+KrF,gFAAgF;AAChF,iEAAiE;AACjE,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,MAAM,CAAmB,KAAmB;IAC1D,OAAO,KAAwD,CAAC;AAClE,CAAC"}

package/dist/modules/apimapper/whitelist-drift.js

@@ -123,7 +123,14 @@ export const TOOL_WIRE_MAP = {
     },
     apimapper_oauth_authorize_begin: {
         route: "POST /oauth/authorize",
-        bodyKeys: ["existing_credential_id", "scopes"],
+        bodyKeys: [
+            "existing_credential_id",
+            "scopes",
+            "oauth_config",
+            "client_id",
+            "client_secret",
+            "credential_name",
+        ],
         kind: "structured",
     },
     // ── Flows ──────────────────────────────────────────────────────────
@@ -209,6 +216,14 @@ export const TOOL_WIRE_MAP = {
         bodyKeys: ["version", "product"],
         kind: "structured",
     },
+    // P-B (JMESPath superpowers) — POST /jmespath/test sends the expression +
+    // the sample rows to evaluate against. Both are accepted by the WP
+    // JmespathTestController / Joomla JmespathTestAjaxHandler.
+    apimapper_jmespath_test: {
+        route: "POST /jmespath/test",
+        bodyKeys: ["expression", "sample_rows"],
+        kind: "structured",
+    },
 };
 /**
  * Resolve the committed fixture path. From this module