@wootsup/mcp 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -5,13 +5,20 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project follows [Semantic Versioning](https://semver.org/).
 
-## [0.3.0] `Latest` - 2026-06-08
+## [0.4.0] `Latest` - 2026-06-21
+
+### Added
+
+- **Proxy mode: the server now connects through your site's plugin-served MCP endpoint. New setups use it automatically; existing installs keep working unchanged.**
+- **Smoother client setup: tool-catalog export and a Connect to Claude handoff.**
+
+## [0.3.0] - 2026-06-08
 
 ### Added
 
 - **Library-first workflow: creating a custom connection for an API a curated library template already covers now returns a 409 that steers you to activate the template instead. Override with acknowledge_no_library:true for genuinely uncovered endpoints.**
-- **New tool apimapper_yootheme_binding_for_flow — inspect the exact YOOtheme binding a published flow exposes.**
-- **New tool apimapper_connection_recover — repair stuck or corrupted connections.**
+- **New tool apimapper_yootheme_binding_for_flow: inspect the exact YOOtheme binding a published flow exposes.**
+- **New tool apimapper_connection_recover: repair stuck or corrupted connections.**
 - **JMESPath date primitives (date_weekday, date_iso_to_time, date_iso_to_date, time_in_window) plus a depth-overflow guard for deeply nested expressions.**
 - **Connection reads now explain why they returned 0 items instead of failing silently.**
 - **MCP keys can be minted from a permission level (read / write / admin) with additive scopes.**
@@ -20,8 +27,9 @@ and this project follows [Semantic Versioning](https://semver.org/).
 
 ### Changed
 
-- **library_activate is resource-aware: it never silently mutates a healthy existing connection — reuse, heal, or fork is explicit (force_new + reused/mutated/healed semantics).**
+- **library_activate is resource-aware: it never silently mutates a healthy existing connection: reuse, heal, or fork is explicit (force_new + reused/mutated/healed semantics).**
 - **Recompile/publish auto-fix is on by default.**
+- **Version history note: the public npm line goes 0.1.0 → 0.3.0. The intermediate 0.2.0 / 0.2.1 bumps were internal build/test cuts and were never published to npm (npm registry: 0.1.0-rc.1…rc.12, rc.13-w3.0, rc.13-w3.1, 0.1.0, 0.3.0), so there is no 0.2.x release to upgrade from: 0.3.0 is the direct successor to 0.1.0.**
 
 ### Fixed
 
@@ -137,7 +145,8 @@ and this project follows [Semantic Versioning](https://semver.org/).
 - **Fixed** - Bug fixes
 - **Security** - Security updates
 
-[0.3.0]: https://github.com/wootsup/api-mapper/compare/v0.1.0...HEAD
+[0.4.0]: https://github.com/wootsup/api-mapper/compare/v0.3.0...HEAD
+[0.3.0]: https://github.com/wootsup/api-mapper/compare/v0.1.0...v0.3.0
 [0.1.0]: https://github.com/wootsup/api-mapper/compare/v0.1.0-rc.13-w3.1...v0.1.0
 [0.1.0-rc.13-w3.1]: https://github.com/wootsup/api-mapper/compare/v0.1.0-rc.13-w3.0...v0.1.0-rc.13-w3.1
 [0.1.0-rc.13-w3.0]: https://github.com/wootsup/api-mapper/compare/v0.1.0-rc.12...v0.1.0-rc.13-w3.0

package/dist/catalog/build-catalog.d.ts

@@ -0,0 +1,31 @@
+import { type ModuleStatus } from "@getimo/mcp-toolkit";
+/**
+ * Convert a captured tool inputSchema to JSON Schema. collectModuleTools yields a
+ * RAW Zod shape for advanced tools (entry.config.inputSchema) but a constructed Zod
+ * OBJECT for essentials (server._registeredTools[name].inputSchema, SDK mcp.js:611).
+ * Branch on the Zod-4 internal marker `_zod`. Native z.toJSONSchema (zod 4.4.3).
+ */
+export declare function toJsonSchema(inputSchema: unknown): object;
+/**
+ * Fail loud if module registration degraded. `loadModules` is graceful by
+ * design — when a module's `register()` throws it logs and records
+ * `{ status: "error" }` but RETURNS normally, so a registration failure would
+ * otherwise yield an empty/partial catalog that still resolves successfully.
+ * The catalog is a release artifact (SSOT for a future PHP MCP surface), so a
+ * silently-degraded export is worse than a hard failure — mirror the repo's
+ * fail-loud discipline (encryption golden-master, deploy key-survival).
+ */
+export declare function assertModulesLoaded(statuses: ModuleStatus[]): void;
+export interface CatalogTool {
+    name: string;
+    description: string;
+    jsonSchema: object;
+    annotations: Record<string, unknown>;
+    tier: "essential" | "advanced";
+}
+export interface Catalog {
+    version: string;
+    generatedFrom: "zod";
+    tools: CatalogTool[];
+}
+export declare function buildCatalog(): Promise<Catalog>;

package/dist/catalog/build-catalog.js

@@ -0,0 +1,68 @@
+// packages/apimapper-mcp/src/catalog/build-catalog.ts
+import { z } from "zod";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { loadModules } from "@getimo/mcp-toolkit";
+import { apimapperRestModule } from "../modules/apimapper/index.js";
+import { collectModuleTools } from "../modules/apimapper/gateway/collect-module-tools.js";
+/**
+ * Convert a captured tool inputSchema to JSON Schema. collectModuleTools yields a
+ * RAW Zod shape for advanced tools (entry.config.inputSchema) but a constructed Zod
+ * OBJECT for essentials (server._registeredTools[name].inputSchema, SDK mcp.js:611).
+ * Branch on the Zod-4 internal marker `_zod`. Native z.toJSONSchema (zod 4.4.3).
+ */
+export function toJsonSchema(inputSchema) {
+    try {
+        if (inputSchema && typeof inputSchema === "object") {
+            const isZodObject = "_zod" in inputSchema;
+            const schema = isZodObject
+                ? inputSchema
+                : z.object(inputSchema);
+            return z.toJSONSchema(schema);
+        }
+    }
+    catch {
+        /* malformed/unsupported shape → safe fallback */
+    }
+    return { type: "object" };
+}
+/**
+ * Fail loud if module registration degraded. `loadModules` is graceful by
+ * design — when a module's `register()` throws it logs and records
+ * `{ status: "error" }` but RETURNS normally, so a registration failure would
+ * otherwise yield an empty/partial catalog that still resolves successfully.
+ * The catalog is a release artifact (SSOT for a future PHP MCP surface), so a
+ * silently-degraded export is worse than a hard failure — mirror the repo's
+ * fail-loud discipline (encryption golden-master, deploy key-survival).
+ */
+export function assertModulesLoaded(statuses) {
+    const failed = statuses.filter((s) => s.status === "error");
+    if (failed.length) {
+        const detail = failed
+            .map((f) => `${f.name}: ${f.error ?? "unknown error"}`)
+            .join(", ");
+        throw new Error(`buildCatalog: module registration failed: ${detail}`);
+    }
+}
+export async function buildCatalog() {
+    const server = new McpServer({ name: "API Mapper MCP", version: "0.0.0" });
+    const statuses = await loadModules(server, [apimapperRestModule]);
+    assertModulesLoaded(statuses);
+    const collected = collectModuleTools(server, apimapperRestModule); // 78 module tools
+    const advancedKeys = new Set(apimapperRestModule.getAdvancedRegistry()?.keys() ?? []);
+    const tools = Object.entries(collected).map(([name, t]) => ({
+        name,
+        description: t.description ?? "",
+        jsonSchema: toJsonSchema(t.inputSchema),
+        annotations: t.annotations ?? {},
+        tier: advancedKeys.has(name) ? "advanced" : "essential",
+    }));
+    if (tools.length === 0) {
+        throw new Error("buildCatalog produced 0 tools — registration likely failed");
+    }
+    return {
+        version: process.env.npm_package_version ?? "0.0.0",
+        generatedFrom: "zod",
+        tools,
+    };
+}
+//# sourceMappingURL=build-catalog.js.map

package/dist/catalog/build-catalog.js.map

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

package/dist/index.js

@@ -1,10 +1,15 @@
 #!/usr/bin/env node
 // @customgraph/mcp-adapter-apimapper-rest — API Mapper REST MCP Server
-// Full coverage of /wp-json/api-mapper/v1/* — 79 registered tools (15 module
-// essentials + the apimapper_advanced gateway + 60 advanced-registry tools + 3
-// top-level tools registered below). Only 19 are first-class in tools/list; the
-// 60 advanced tools route through apimapper_advanced to stay under Cursor's ~40
-// surface cap. Canonical counts are asserted in gateway/gateway.test.ts (A2).
+// Full coverage of /wp-json/api-mapper/v1/* — 81 registered tools (16 module
+// essentials + the apimapper_advanced gateway + the apimapper_advanced_read
+// gateway + 60 advanced-registry tools + 3 top-level tools registered below).
+// Only 21 are first-class in tools/list; the 60 advanced tools route through
+// the gateways to stay under Cursor's ~40 surface cap. Canonical counts are
+// asserted in gateway/gateway.test.ts (A2).
+// F115 (2026-06-11): apimapper_health promoted advanced→essential (15→16
+// essentials, 60→59 advanced, surface 19→20, total then 79).
+// F200b (2026-06-12): apimapper_advanced_read read-only gateway added
+// (module-real 17→18, surface 20→21, total 80→81).
 //
 // Auth: API Mapper MCP-key (amk_live_...) generated via the API Mapper
 // admin UI → Settings → MCP Access. The legacy WordPress Application
@@ -70,6 +75,7 @@ import { registerUseProfileTool, registerListProfilesTool, } from "./modules/api
 import { registerSitesUseProfileTool, registerSitesListProfilesTool, } from "./modules/apimapper/sites-tools.js";
 import { getSitesRegistry, getActiveSiteId, setActiveSite, } from "./modules/apimapper/client.js";
 import { shouldShowInteractiveHint, buildInteractiveHint } from "./cli-hint.js";
+import { setMcpClient } from "./modules/apimapper/mcp-client-identity.js";
 // Single source of truth for the package version (F-41 / W1.23).
 // Reads ../package.json at runtime so we never drift between the manifest
 // version (used by npm + DXT) and what we advertise to MCP clients.
@@ -156,6 +162,16 @@ server.registerTool("apimapper_rest_modules_status", {
     }, false, { maxChars: 2000 });
 });
 async function main() {
+    // Proxy mode: forward stdio 1:1 to the plugin-served PHP MCP endpoint and stop
+    // here — the fat catalog below is bypassed entirely. Default (fat) is unchanged.
+    // The dynamic import is gated on the env so the fat path never loads the proxy
+    // module (and the SDK client transport it pulls in) — keeps fat-mode startup
+    // lean and avoids loading proxy code (incl. under test) when it can't apply.
+    if (process.env.APIMAPPER_MODE === "proxy") {
+        const { maybeRunProxy } = await import("./proxy/bridge.js");
+        if (await maybeRunProxy(process.env))
+            return;
+    }
     moduleStatuses = await loadModules(server, [apimapperRestModule]);
     // Profile tools for apimapper_use_profile / apimapper_list_profiles.
     //
@@ -231,6 +247,22 @@ async function main() {
         throw err;
     });
     await connectStdio(server);
+    // Q1 (2026-06-14): capture the connected AI client's identity for the
+    // X-MCP-Client header. The SDK only knows the client name+version AFTER the
+    // handshake completes, so this read must follow connectStdio(). Stashed in a
+    // module-scoped slot (mcp-client-identity.ts) that the outbound REST
+    // chokepoint (client.ts performFetch) reads per request. Empty/missing
+    // clientInfo → null → no header attached.
+    //
+    // Defensive: `server.server` / `getClientVersion` are SDK internals; guard
+    // against a transport/SDK shape that doesn't expose them so a missing client
+    // identity degrades to "no header" and NEVER crashes server startup.
+    try {
+        setMcpClient(server.server?.getClientVersion?.());
+    }
+    catch {
+        setMcpClient(undefined);
+    }
     const ok = moduleStatuses.filter((m) => m.status === "ok").length;
     console.error(`[apimapper-rest] MCP Server v${PKG_VERSION} running — ${ok}/${moduleStatuses.length} modules loaded`);
 }

package/dist/index.js.map

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

package/dist/modules/apimapper/auto-layout.d.ts

@@ -0,0 +1,21 @@
+/** Minimal node shape the layout needs; every other field is preserved. */
+interface LayoutNode {
+    id: string;
+    type?: string;
+    position?: {
+        x: number;
+        y: number;
+    };
+}
+interface LayoutEdge {
+    source: string;
+    target: string;
+}
+/**
+ * Re-position every node into a clean layered grid derived from the edges.
+ * Returns a NEW array; each node keeps its id/type/data and gets a fresh
+ * `position`. Pure + deterministic (same graph → same positions). An empty
+ * `nodes` array is returned untouched.
+ */
+export declare function autoLayoutNodes<T extends LayoutNode>(nodes: T[], edges: ReadonlyArray<LayoutEdge>): T[];
+export {};

package/dist/modules/apimapper/auto-layout.js

@@ -0,0 +1,54 @@
+// auto-layout.ts — deterministic layered left-to-right layout for AI-authored
+// flow graphs (Task X).
+//
+// Why: when the AI builds/edits a flow it should not have to compute pixel
+// positions, and the customer wants the canvas tidy after every AI touch — no
+// overlaps, logical source→…→output flow. This re-flows positions from the
+// graph's topology so every AI write lands clean.
+//
+// IMPORTANT scope: this runs ONLY on the MCP (AI) flow-write path
+// (flow_create / flow_update). It is deliberately NOT in the generic backend
+// save, so a human's manual node positions (persisted by the admin-ui autosave,
+// Task W) are never clobbered — only the AI tidies.
+//
+// Layout: topological layers become columns (left→right); nodes within a layer
+// stack vertically. Orphan / cycle members (never reached) get their own
+// trailing column so they stay visible and non-overlapping — the exact same
+// "unreachable as a trailing layer" treatment the flow-diagram renderer uses.
+import { topoLayers } from "./render/dag.js";
+// Pitch must exceed the admin-ui BaseNode card box (min-w-[220px]
+// max-w-[300px]) so programmatically-placed nodes never crowd — identical to
+// the graph-builder constants (300 max card + 100 gutter; stacked-card height +
+// gutter).
+const BASE_X = 100;
+const BASE_Y = 100;
+const COL_WIDTH = 400;
+const ROW_HEIGHT = 240;
+/**
+ * Re-position every node into a clean layered grid derived from the edges.
+ * Returns a NEW array; each node keeps its id/type/data and gets a fresh
+ * `position`. Pure + deterministic (same graph → same positions). An empty
+ * `nodes` array is returned untouched.
+ */
+export function autoLayoutNodes(nodes, edges) {
+    if (nodes.length === 0)
+        return nodes;
+    const { layers, unreachable } = topoLayers(nodes.map((n) => ({ id: n.id, type: n.type })), edges.map((e) => ({ source: e.source, target: e.target })));
+    // Orphans + cycle members trail in their own column so they remain visible
+    // (this is exactly the node the AI must be able to see to tidy — Task W).
+    const columns = unreachable.length > 0 ? [...layers, unreachable] : layers;
+    const positionById = new Map();
+    columns.forEach((column, colIndex) => {
+        column.forEach((id, rowIndex) => {
+            positionById.set(id, {
+                x: BASE_X + colIndex * COL_WIDTH,
+                y: BASE_Y + rowIndex * ROW_HEIGHT,
+            });
+        });
+    });
+    return nodes.map((node) => {
+        const position = positionById.get(node.id);
+        return position ? { ...node, position } : node;
+    });
+}
+//# sourceMappingURL=auto-layout.js.map

package/dist/modules/apimapper/auto-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-layout.js","sourceRoot":"","sources":["../../../src/modules/apimapper/auto-layout.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wBAAwB;AACxB,EAAE;AACF,2EAA2E;AAC3E,8EAA8E;AAC9E,2EAA2E;AAC3E,kDAAkD;AAClD,EAAE;AACF,kEAAkE;AAClE,6EAA6E;AAC7E,gFAAgF;AAChF,oDAAoD;AACpD,EAAE;AACF,+EAA+E;AAC/E,yEAAyE;AACzE,4EAA4E;AAC5E,8EAA8E;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAc7C,kEAAkE;AAClE,6EAA6E;AAC7E,gFAAgF;AAChF,WAAW;AACX,MAAM,MAAM,GAAG,GAAG,CAAC;AACnB,MAAM,MAAM,GAAG,GAAG,CAAC;AACnB,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAU,EACV,KAAgC;IAEhC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAErC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,UAAU,CACxC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAC9C,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAC3D,CAAC;IAEF,2EAA2E;IAC3E,0EAA0E;IAC1E,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAE3E,MAAM,YAAY,GAAG,IAAI,GAAG,EAAoC,CAAC;IACjE,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;QACnC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE;YAC9B,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE;gBACnB,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;gBAChC,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU;aAClC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3C,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -46,7 +46,7 @@ export declare function sanitizeErrorString(s: string): string;
  * The underlying toolkit `ApiResponse` only carries `{success, data?, error?}`.
  * We wrap each call so we capture the HTTP code via `fetch` and merge.
  */
-export type ApiErrorCode = "auth" | "not_found" | "conflict" | "rate_limit" | "server" | "network" | "unknown";
+export type ApiErrorCode = "auth" | "not_found" | "conflict" | "rate_limit" | "server" | "network" | "credential_expired" | "tier_limit_reached" | "unknown";
 export interface ExtApiResponse<T = unknown> extends ApiResponse<T> {
     status?: number;
     errorCode?: ApiErrorCode;
@@ -181,11 +181,61 @@ export declare function __resetPlatformResolutionForTests(): void;
  */
 export declare function request<T = unknown>(path: string, init?: RequestInit, opts?: RequestOpts): Promise<ExtApiResponse<T>>;
 /**
- * Map an `errorCode` to a focused hint string for the caller.
- * Falls back to the generic health-tool hint.
+ * Optional second argument to {@link hintFor}, used to route a hint more
+ * precisely than the coarse `ApiErrorCode` alone allows. Both fields are
+ * optional and every legacy `hintFor(code)` call keeps its exact prior
+ * output (back-compat), so the ~12 call sites need not change.
+ *
+ * Welle 2 (F112 + F113, 2026-06-11):
+ *   - `message`: the upstream error string. Lets the `unknown` branch route
+ *      a config/validation/argument error to a "fix the field / fix the flow
+ *      shape / detect schema" hint instead of the catch-all HEALTH_HINT
+ *      (which sends the agent on a connectivity probe that always passes).
+ *      It is also the channel for the F83 JMESPath depth-limit detection
+ *      (see {@link DEPTH_SPLIT_HINT}).
+ *   - `origin`: WHERE a 401/403 came from. `classify()` maps every 401/403
+ *      to `'auth'`, but a 401/403 raised by a *connection* / *credential*
+ *      fetch is an EXPIRED UPSTREAM token, not a broken MCP key. With
+ *      `origin: 'connection' | 'credential'` the auth branch steers to
+ *      re-authorising the upstream credential (`oauth_authorize_begin`)
+ *      rather than rotating the still-valid MCP bearer key.
  */
-export declare function hintFor(code?: ApiErrorCode): string;
+export interface HintContext {
+    /** The upstream error message, used for message-pattern routing of `unknown`. */
+    message?: string;
+    /**
+     * The origin of an auth (401/403) failure. `connection` / `credential`
+     * mean an expired upstream token; `mcp_transport` (or omitted) means the
+     * MCP bearer key itself.
+     */
+    origin?: "connection" | "credential" | "mcp_transport";
+}
+export declare const DEPTH_SPLIT_HINT: string;
+/**
+ * Map an `errorCode` (and optional {@link HintContext}) to a focused hint
+ * string for the caller. Falls back to the generic health-tool hint only for
+ * genuinely connectivity-shaped failures.
+ *
+ * The second argument is a UNION: a bare `string` is treated as
+ * `{ message }` so the ~12 legacy call sites that pass the upstream error
+ * string verbatim (`hintFor(code, r.error)`) keep working unchanged, while
+ * the richer `{ message, origin }` form drives F112/F113 routing. Omit it to
+ * keep the legacy code-only behaviour byte-for-byte.
+ */
+export declare function hintFor(code?: ApiErrorCode, context?: string | HintContext): string;
 export declare const HEALTH_HINT = "Use apimapper_health to check connectivity and auth.";
+/**
+ * Recovery hint for an auth failure on the MCP transport itself (the bearer
+ * key is wrong/revoked/expired). Kept verbatim for the legacy `hintFor('auth')`
+ * contract.
+ */
+export declare const MCP_KEY_AUTH_HINT: string;
+/**
+ * F113 — recovery hint for an EXPIRED UPSTREAM credential surfaced as a
+ * connection/credential 401/403. The fix is to re-authorise the credential in
+ * place (preserving the refresh_token), NOT to rotate the MCP key.
+ */
+export declare const CREDENTIAL_EXPIRED_HINT: string;
 export declare function authConfigured(): boolean;
 export declare const api: {
     request: <T>(path: string, init?: RequestInit, _retryCount?: number, responseSchema?: import("zod").ZodType<T>) => Promise<ApiResponse<T>>;

package/dist/modules/apimapper/client.js

@@ -25,6 +25,7 @@
 import { createHttpClient } from "@getimo/mcp-toolkit";
 import { Agent, setGlobalDispatcher } from "undici";
 import { sanitizeSecrets } from "./credential-sanitizer.js";
+import { getMcpClient } from "./mcp-client-identity.js";
 import { getCached, setCached, isCacheableRequest, invalidateByPath, clearCache, } from "./read-cache.js";
 import { WordPressPlatform, JoomlaPlatform, isPlatformResponseError, isJoomlaUnsupportedPathError } from "../../platform/index.js";
 import { loadSitesRegistry } from "../../sites/loader.js";
@@ -207,10 +208,19 @@ async function performFetch(cfg) {
     const { url, headers, init, opts, parseResponse, preferMessageKey = true, attachErrorBody = false, textSuccessFalseGuard = false, } = cfg;
     let status;
     const timeoutMs = resolveTimeout(opts);
+    // Q1 (2026-06-14): performFetch is the ONE outbound chokepoint shared by the
+    // WP, Joomla, and absolute request paths. Attaching X-MCP-Client here means
+    // every REST call carries the connected AI client's identity (set once
+    // post-handshake in index.ts) without touching three caller header builders.
+    // Null when no client info → header omitted entirely.
+    const mcpClient = getMcpClient();
     try {
         const res = await fetch(url, {
             ...init,
-            headers,
+            headers: {
+                ...headers,
+                ...(mcpClient ? { "X-MCP-Client": mcpClient } : {}),
+            },
             signal: AbortSignal.timeout(timeoutMs),
         });
         status = res.status;
@@ -855,33 +865,154 @@ async function rawAbsoluteRequest(url, init, opts) {
     });
 }
 /**
- * Map an `errorCode` to a focused hint string for the caller.
- * Falls back to the generic health-tool hint.
+ * F83 (2026-06-10, C3 cold-agent): the JMESPath depth-limit failure surfaced
+ * on the flow-write path. The PHP backend emits it as a 422 with one of two
+ * frozen wordings:
+ *   - FlowHandler::validateJmesPathDepth → "N JMESPath expression(s) exceeded
+ *     the depth limit of M"
+ *   - TransformException → "JMESPath expression too deeply nested (N levels).
+ *     Maximum: M"
+ * Neither carries a body-level `error_code`/`suggestion`, so `classify(422)`
+ * lands on "unknown" and the bare-code hint is HEALTH_HINT — the WRONG remedy
+ * (a cold agent literally got "Use apimapper_health to check connectivity").
+ * The actual cure is the two-transform split: a pipe `|` resets the depth
+ * counter. We detect the depth-limit message text (not the coarse code) so the
+ * remedy fires regardless of how the wire status classifies. This is the
+ * canonical depth remedy — the PHP `TransformException::expressionTooDeepWithRemedy`
+ * superset emits the same intent; the MCP-side detection here covers the
+ * write-path 422s that arrive without a body-level error_code.
  */
-export function hintFor(code) {
+const DEPTH_LIMIT_MESSAGE_RE = /depth limit|too deeply nested/i;
+export const DEPTH_SPLIT_HINT = "JMESPath depth limit hit. This is NOT a connectivity problem — do not run " +
+    "apimapper_health. Multi-stage reshape? Pass `transform` as an ARRAY of stages " +
+    "— each stage gets its own depth budget. SPLIT the over-nested expression into " +
+    "TWO Transform nodes piped together: a pipe `|` resets the depth counter, so " +
+    "each half stays under the cap of 10. Move the inner projection/merge into a " +
+    "first Transform, then do the per-row shaping in a second Transform reading its " +
+    "output. Iterate each half risk-free with apimapper_jmespath_test before " +
+    "wiring, and read the copy-paste recipes via " +
+    "apimapper_get_skill({ topic: 'jmespath-cookbook' }) → \"Two-Transform split\".";
+/**
+ * Map an `errorCode` (and optional {@link HintContext}) to a focused hint
+ * string for the caller. Falls back to the generic health-tool hint only for
+ * genuinely connectivity-shaped failures.
+ *
+ * The second argument is a UNION: a bare `string` is treated as
+ * `{ message }` so the ~12 legacy call sites that pass the upstream error
+ * string verbatim (`hintFor(code, r.error)`) keep working unchanged, while
+ * the richer `{ message, origin }` form drives F112/F113 routing. Omit it to
+ * keep the legacy code-only behaviour byte-for-byte.
+ */
+export function hintFor(code, context) {
+    // Normalise the union: a bare string IS the upstream message.
+    const ctx = typeof context === "string" ? { message: context } : context;
+    // F83: message-driven depth-limit detection wins over the coarse code, so a
+    // 422 that classify()s to "unknown" still gets the split remedy.
+    if (ctx?.message && DEPTH_LIMIT_MESSAGE_RE.test(ctx.message)) {
+        return DEPTH_SPLIT_HINT;
+    }
     switch (code) {
         case "auth":
-            return ("Auth failed (HTTP 401/403). Your MCP key (APIMAPPER_TOKEN) is " +
-                "invalid, revoked, or expired. Recovery steps: " +
-                "(1) Open API Mapper → ⋮ menu → Settings → MCP Access. " +
-                "(2) Revoke the old key if you suspect it was leaked. " +
-                "(3) Click 'New API key' and copy the value. " +
-                "(4) Re-run `npx -y @wootsup/mcp setup` and paste the new key — " +
-                "the wizard rewrites your AI client config in place. " +
-                "(5) Restart your AI client (Claude Desktop / Cursor / etc.).");
+            // F113: separate upstream-credential auth from MCP-transport auth.
+            // A 401/403 carried back from a connection/credential fetch is an
+            // EXPIRED UPSTREAM token — re-authorise it in place; do NOT send the
+            // agent to rotate the (valid) MCP key + re-run the setup wizard.
+            if (ctx?.origin === "connection" || ctx?.origin === "credential") {
+                return CREDENTIAL_EXPIRED_HINT;
+            }
+            return MCP_KEY_AUTH_HINT;
         case "not_found":
             return "Resource not found. Use the matching `*_list` tool to find a valid id.";
         case "rate_limit":
-            return "Rate-limited. Retry after a few seconds; consider apimapper_cache_invalidate to reduce churn.";
+            // F59 (2026-06-10): a 429 is often recoverable WITHOUT waiting — many
+            // providers have a same-schema MIRROR connection (same template, a
+            // different upstream serving identical data). Point the agent there.
+            return ("Rate-limited (HTTP 429). Retry after a few seconds, and raise " +
+                "cache_ttl / use apimapper_cache_invalidate to reduce churn. If the " +
+                "throttle persists, run apimapper_connection_list and look for a " +
+                "same-schema / mirror connection (same library template or a " +
+                "duplicate pointing at an alternative upstream) that serves the same " +
+                "data — bind the flow to that mirror instead of the throttled source.");
+        case "credential_expired":
+            // A11: re-authorize the EXISTING credential in place; never delete +
+            // recreate (that drops the OAuth refresh token).
+            return ("An OAuth credential expired. Re-authorize it IN PLACE with " +
+                "apimapper_oauth_authorize_begin({ credential_id }), open the returned " +
+                "authorize_url, complete consent, then retry. Keep the same credential " +
+                "— recreating it from scratch drops the refresh token. Use " +
+                "apimapper_credential_list to find the credential_id.");
+        case "tier_limit_reached":
+            // A12: the plan's connection / auth-method limit is hit.
+            return ("Your plan's limit was reached (connections or auth methods). " +
+                "Upgrade the license to raise the limit, or free a slot by deleting an " +
+                "unused connection (apimapper_connection_list to review). Check the " +
+                "current tier + limits with apimapper_license_status.");
         case "server":
             return "Upstream server error. Try again, then run apimapper_health and check WP error logs.";
         case "network":
             return "Network/timeout error. Verify APIMAPPER_WP_BASE is reachable from this host.";
         default:
-            return HEALTH_HINT;
+            // F112: an `unknown`/config error must NOT blanket-route to the
+            // connectivity probe. Route on the message shape when we have one.
+            return routeUnknownHint(ctx?.message);
+    }
+}
+/**
+ * F112 — message-pattern router for the `unknown` (config/validation) branch.
+ * Returns a hint that points at the ACTUAL fix (fill a field, repair the flow
+ * shape, detect a schema) instead of the catch-all HEALTH_HINT. Only a
+ * genuinely connectivity-shaped message (or no message at all) keeps the
+ * health hint.
+ */
+function routeUnknownHint(message) {
+    if (!message)
+        return HEALTH_HINT;
+    const m = message.toLowerCase();
+    // Connectivity-shaped failures keep pointing at apimapper_health.
+    if (/econnrefused|enotfound|etimedout|fetch failed|network|timeout|unreachable|connection refused/.test(m)) {
+        return HEALTH_HINT;
+    }
+    // Empty/stale schema → detect the schema.
+    if (/schema (is )?empty|no schema|empty schema|run detect|detect[- ]schema/.test(m)) {
+        return "The source schema is empty — run apimapper_flow_detect_schema (or apimapper_flow_full_recompile_publish) to populate it before binding fields.";
+    }
+    // Flow-SHAPE errors (wiring / nodes / edges) → inspect the flow graph.
+    if (/no (target|source|output) node|target node|source node|\bedges?\b|\bnode\b|connect|wiring|no nodes/.test(m)) {
+        return "The flow shape is incomplete (missing node, edge, or target). Run apimapper_flow_get to inspect the graph, then fix the node/edge wiring with apimapper_flow_update.";
+    }
+    // Missing-field / configure errors → supply the field.
+    if (/missing required field|missing field|please configure|required field|is required|required:/.test(m)) {
+        return "A required argument is missing — supply the named field(s) and call the tool again. Check the tool's input schema for the exact key(s).";
     }
+    // Default: still a config error, not a connectivity one — keep the agent
+    // out of the health probe and tell it to recheck its arguments.
+    return "Check the tool arguments against its input schema and retry; this is a request/config error, not a connectivity problem.";
 }
 export const HEALTH_HINT = "Use apimapper_health to check connectivity and auth.";
+/**
+ * Recovery hint for an auth failure on the MCP transport itself (the bearer
+ * key is wrong/revoked/expired). Kept verbatim for the legacy `hintFor('auth')`
+ * contract.
+ */
+export const MCP_KEY_AUTH_HINT = "Auth failed (HTTP 401/403). Your MCP key (APIMAPPER_TOKEN) is " +
+    "invalid, revoked, or expired. Recovery steps: " +
+    "(1) Open API Mapper → ⋮ menu → Settings → MCP Access. " +
+    "(2) Revoke the old key if you suspect it was leaked. " +
+    "(3) Click 'New API key' and copy the value. " +
+    "(4) Re-run `npx -y @wootsup/mcp setup` and paste the new key — " +
+    "the wizard rewrites your AI client config in place. " +
+    "(5) Restart your AI client (Claude Desktop / Cursor / etc.).";
+/**
+ * F113 — recovery hint for an EXPIRED UPSTREAM credential surfaced as a
+ * connection/credential 401/403. The fix is to re-authorise the credential in
+ * place (preserving the refresh_token), NOT to rotate the MCP key.
+ */
+export const CREDENTIAL_EXPIRED_HINT = "The upstream API rejected the request (HTTP 401/403) because the " +
+    "connection's credential has expired or was revoked — this is the " +
+    "external service's token, NOT your MCP key. Re-authorise it: call " +
+    "apimapper_oauth_authorize_begin with the connection's credential_id to " +
+    "get a fresh consent URL (this preserves the refresh_token). Do NOT " +
+    "rotate your MCP key for this error.";
 export function authConfigured() {
     // Bearer token (amk_live_…) is sufficient on its own; legacy App-Password
     // auth still requires both user + password.