@wootsup/mcp 0.1.0-rc.9 → 0.3.0

package/dist/modules/apimapper/sites-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sites-tools.js","sourceRoot":"","sources":["../../../src/modules/apimapper/sites-tools.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,+EAA+E;AAC/E,iFAAiF;AACjF,mFAAmF;AACnF,4EAA4E;AAC5E,6EAA6E;AAC7E,4EAA4E;AAC5E,EAAE;AACF,iFAAiF;AACjF,8EAA8E;AAC9E,gFAAgF;AAChF,wBAAwB;AAGxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGvE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAmCtC,MAAM,UAAU,6BAA6B,CAC3C,MAAiC,EACjC,IAA2B;IAE3B,MAAM,SAAS,GAAG,MAAuB,CAAC;IAE1C,SAAS,CAAC,YAAY,CACpB,yBAAyB,EACzB;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,sEAAsE;YACtE,2DAA2D;YAC3D,oDAAoD;YACpD,8DAA8D;YAC9D,mDAAmD;YACnD,wCAAwC;YACxC,uBAAuB;YACvB,yFAAyF;QAC3F,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,0BAA0B,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;KAC/E,EACD,KAAK,IAAI,EAAE;QACT,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACtC,wEAAwE;QACxE,MAAM,UAAU,GAAG,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC;QAEtD,MAAM,QAAQ,GAAyB,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAChE,IAAI,EAAE,KAAK,CAAC,OAAO;YACnB,OAAO,EAAE,KAAK,CAAC,GAAG;YAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,OAAO,KAAK,UAAU;SACxC,CAAC,CAAC,CAAC;QAEJ,OAAO,YAAY,CACjB;YACE,aAAa,EAAE,QAAQ,CAAC,MAAM;YAC9B,cAAc,EAAE,UAAU;YAC1B,MAAM,EAAE,YAAY;YACpB,QAAQ;SACT,EACD,KAAK,EACL,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAYD;;;GAGG;AACH,KAAK,UAAU,yBAAyB,CACtC,MAAkB;IAElB,MAAM,CAAC,GAAG,MAAM,OAAO,CAAU,WAAW,CAAC,CAAC;IAC9C,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,uBAAuB,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAa;IACtC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,CAAC,GAAG,IAA+B,CAAC;IAC1C,MAAM,cAAc,GAAG,OAAO,CAAC,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,MAAM,QAAQ,GACZ,CAAC,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC;QAC9C,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC;QAC5C,EAAE,CAAC;IACL,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC;QACxC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;QAClE,CAAC,CAAC,EAAE,CAAC;IACP,IAAI,CAAC,cAAc,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,MAAiC,EACjC,IAAyB;IAEzB,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,IAAI,yBAAyB,CAAC;IAC9D,MAAM,SAAS,GAAG,MAAuB,CAAC;IAE1C,SAAS,CAAC,YAAY,CACpB,uBAAuB,EACvB;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACT,2EAA2E;YAC3E,yEAAyE;YACzE,qEAAqE;YACrE,uEAAuE;YACvE,yEAAyE;QAC3E,WAAW,EAAE;YACX,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CACP,8FAA8F,CAC/F;YACH,OAAO,EAAE,CAAC;iBACP,OAAO,EAAE;iBACT,OAAO,CAAC,KAAK,CAAC;iBACd,QAAQ,CACP,yFAAyF,CAC1F;SACJ;QACD,uEAAuE;QACvE,mEAAmE;QACnE,qDAAqD;QACrD,WAAW,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;KAC5E,EACD,KAAK,EAAE,IAAyC,EAAE,EAAE;QAClD,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,YAAY,CACjB;gBACE,KAAK,EAAE,SAAS,IAAI,2BAA2B;gBAC/C,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE;gBACvC,IAAI,EAAE,sDAAsD;aAC7D,EACD,IAAI,CACL,CAAC;QACJ,CAAC;QAED,qEAAqE;QACrE,IAAI,CAAC;YACH,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,OAAO,YAAY,CACjB;gBACE,KAAK,EAAE,4BAA4B,IAAI,MAAM,GAAG,EAAE;gBAClD,OAAO,EAAE,EAAE,IAAI,EAAE;gBACjB,IAAI,EAAE,4DAA4D;aACnE,EACD,IAAI,CACL,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,YAAY,CACjB;gBACE,SAAS,EAAE,IAAI;gBACf,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;gBAC9E,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,YAAY;gBACpB,QAAQ,EAAE;oBACR,0EAA0E;iBAC3E;aACF,EACD,KAAK,EACL,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;QACJ,CAAC;QAED,IAAI,QAAkC,CAAC;QACvC,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,OAAO,YAAY,CACjB;gBACE,+DAA+D;gBAC/D,gEAAgE;gBAChE,KAAK,EAAE,SAAS,IAAI,2CAA2C,GAAG,EAAE;gBACpE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;gBAC/D,IAAI,EACF,mEAAmE;oBACnE,0DAA0D;aAC7D,EACD,IAAI,CACL,CAAC;QACJ,CAAC;QAED,OAAO,YAAY,CACjB;YACE,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;YAC9E,MAAM,EAAE,YAAY;YACpB,QAAQ,EAAE;gBACR,cAAc,EAAE,QAAQ,CAAC,cAAc;gBACvC,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,YAAY,EAAE,QAAQ,CAAC,YAAY;gBACnC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;aAC5B;SACF,EACD,KAAK,EACL,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/modules/apimapper/skill-resources.d.ts

@@ -1,4 +1,4 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolRegistrar } from "./gateway/capturing-server.js";
 export declare const SKILL_RESOURCE_URIS: readonly ["skill://apimapper/getting-started", "skill://apimapper/oauth", "skill://apimapper/yootheme", "skill://apimapper/joomla", "skill://apimapper/troubleshooting"];
 export type SkillResourceUri = (typeof SKILL_RESOURCE_URIS)[number];
-export declare function registerSkillResources(server: McpServer, rootDir?: string): void;
+export declare function registerSkillResources(server: ToolRegistrar, rootDir?: string): void;

package/dist/modules/apimapper/skill-resources.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-resources.js","sourceRoot":"","sources":["../../../src/modules/apimapper/skill-resources.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,sEAAsE;AACtE,4EAA4E;AAC5E,6DAA6D;AAC7D,EAAE;AACF,6EAA6E;AAC7E,uEAAuE;AACvE,0EAA0E;AAC1E,EAAE;AACF,4CAA4C;AAC5C,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAC9E,gFAAgF;AAChF,6EAA6E;AAC7E,uCAAuC;AACvC,qFAAqF;AAGrF,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,mCAAmC;IACnC,yBAAyB;IACzB,4BAA4B;IAC5B,0BAA0B;IAC1B,mCAAmC;CAC3B,CAAC;AAYX,MAAM,SAAS,GAAwB;IACrC;QACE,GAAG,EAAE,mCAAmC;QACxC,IAAI,EAAE,2BAA2B;QACjC,KAAK,EAAE,8BAA8B;QACrC,WAAW,EACT,gGAAgG;QAClG,QAAQ,EAAE,UAAU;KACrB;IACD;QACE,GAAG,EAAE,yBAAyB;QAC9B,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,4BAA4B;QACnC,WAAW,EACT,+FAA+F;QACjG,QAAQ,EAAE,oBAAoB;KAC/B;IACD;QACE,GAAG,EAAE,4BAA4B;QACjC,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,uCAAuC;QAC9C,WAAW,EACT,iGAAiG;QACnG,QAAQ,EAAE,uBAAuB;KAClC;IACD;QACE,GAAG,EAAE,0BAA0B;QAC/B,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,2BAA2B;QAClC,WAAW,EAAE,2FAA2F;QACxG,QAAQ,EAAE,qBAAqB;KAChC;IACD;QACE,GAAG,EAAE,mCAAmC;QACxC,IAAI,EAAE,2BAA2B;QACjC,KAAK,EAAE,8BAA8B;QACrC,WAAW,EACT,mGAAmG;QACrG,QAAQ,EAAE,8BAA8B;KACzC;CACF,CAAC;AAEF,SAAS,iBAAiB;IACxB,2EAA2E;IAC3E,sEAAsE;IACtE,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,OAAgB;IACxE,MAAM,OAAO,GAAG,OAAO,IAAI,iBAAiB,EAAE,CAAC;IAE/C,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrE,MAAM,CAAC,gBAAgB,CACrB,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,GAAG,EACR;YACE,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,eAAe;YACzB,sEAAsE;YACtE,kEAAkE;YAClE,gEAAgE;YAChE,6DAA6D;YAC7D,WAAW,EAAE;gBACX,QAAQ,EAAE,CAAC,WAAW,CAAC;gBACvB,QAAQ,EAAE,GAAG;aACd;SACF,EACD,KAAK,EAAE,GAAQ,EAAE,EAAE;YACjB,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC5C,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;wBACnB,QAAQ,EAAE,eAAe;wBACzB,IAAI;qBACL;iBACF;aACF,CAAC;QACJ,CAAC,CACF,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"skill-resources.js","sourceRoot":"","sources":["../../../src/modules/apimapper/skill-resources.ts"],"names":[],"mappings":"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"}

package/dist/modules/apimapper/token-baseline.harness.d.ts

@@ -0,0 +1,91 @@
+/**
+ * A canned REST body — either a raw string sent as-is, or a JSON-serializable
+ * object/array that the harness stringifies. Narrowing to these three shapes
+ * keeps the `JSON.stringify` branch type-safe without falling back to `unknown`.
+ */
+export type CannedBody = string | Record<string, unknown> | unknown[];
+/** A single fetch result the responder hands back for one upstream URL. */
+export interface CannedResponse {
+    /** HTTP status. Defaults to 200 when omitted. */
+    status?: number;
+    /** Response body — an object/array is JSON-stringified; a string is sent as-is. */
+    body: CannedBody;
+}
+/** Maps an upstream request (URL + init) to a canned REST response. */
+export type FetchResponder = (url: string, init?: RequestInit) => CannedResponse;
+/** The shape every apimapper tool handler resolves to (MCP CallToolResult). */
+interface ToolCallResult {
+    content?: Array<{
+        type: string;
+        text?: string;
+    }>;
+    isError?: boolean;
+}
+/** A registered tool: its handler is what the harness invokes. */
+export interface RegisteredHarnessTool {
+    handler: (args: Record<string, unknown>, extra?: unknown) => Promise<ToolCallResult> | ToolCallResult;
+}
+/** Per-tool byte tally for one replayed call. */
+export interface SequenceEntry {
+    tool: string;
+    /**
+     * Total UTF-8 bytes of the result's `content[].text` blocks — the raw
+     * payload an MCP client receives. This is the historical token-baseline
+     * metric and the field the ≥40% goal is measured against.
+     */
+    bytes: number;
+    /**
+     * `bytes` minus the toolkit's embedded `<!-- structured-meta:… -->` base64
+     * marker(s). Some MCP hosts (the WootsUp Chat UI) strip this marker before
+     * the LLM sees the text; generic hosts (Claude Desktop / Cursor) do not.
+     * Reporting both keeps the post-W3 measurement honest about which figure a
+     * given host actually pays.
+     */
+    visibleBytes: number;
+}
+/** The full harness measurement. */
+export interface TokenBaselineResult {
+    sequence: SequenceEntry[];
+    /** Sum of `bytes` (raw text incl. structured-meta marker) across the run. */
+    totalBytes: number;
+    /** Sum of `visibleBytes` (marker stripped) across the run. */
+    totalVisibleBytes: number;
+}
+/**
+ * One step of the canonical sequence — the tool to invoke and the canned
+ * real-shape arguments to invoke it with.
+ */
+interface SequenceStep {
+    tool: string;
+    args: Record<string, unknown>;
+}
+/**
+ * The canonical 8-call walkthrough (the Maria mixed-feed flow): a fresh user
+ * discovers the install, activates a library template, inspects a connection,
+ * builds and validates a flow, then compiles it. Inputs are real-shape and
+ * fixed so the measurement is reproducible.
+ */
+export declare const CANONICAL_SEQUENCE: readonly SequenceStep[];
+/** The tool names the canonical sequence exercises, in call order. */
+export declare const CANONICAL_TOOLS: readonly string[];
+/**
+ * Canonical fetch responder — routes an upstream URL to its real-shape
+ * fixture. Anything unmatched returns an empty-success envelope, which is the
+ * benign default for the optional sub-calls inside `apimapper_onboarding`.
+ */
+export declare function canonicalFetchResponder(url: string): CannedResponse;
+/**
+ * Strip every embedded structured-meta marker from a text block. What remains
+ * is the human/LLM-readable text a marker-aware host (the WootsUp Chat UI)
+ * presents after extracting the marker into a Rich Card.
+ */
+export declare function stripStructuredMeta(text: string): string;
+/**
+ * Replay the canonical sequence and measure total token output.
+ *
+ * @param tools          the registered apimapper tools map (name → tool)
+ * @param fetchResponder maps each upstream URL to a canned REST response
+ * @returns per-tool byte tally + `totalBytes` across the whole sequence
+ */
+export declare function runTokenBaseline(tools: Record<string, RegisteredHarnessTool>, fetchResponder: FetchResponder): Promise<TokenBaselineResult>;
+export {};

package/dist/modules/apimapper/token-baseline.harness.js

@@ -0,0 +1,291 @@
+// token-baseline.harness.ts — W3.0.C
+//
+// Deterministic, offline token-output measurement for the canonical API
+// Mapper tool-call sequence. The SAME harness is re-run after Welle 3 ships;
+// the before/after delta is what proves the ≥40% token-reduction goal, so
+// consistency between runs matters more than the absolute number.
+//
+// How it works:
+//   1. The caller passes the registered apimapper tools map (the live
+//      `registerTool` config + handler for every tool) and a `fetchResponder`
+//      that maps an upstream URL to a canned real-shape REST response.
+//   2. `runTokenBaseline` installs the responder as `globalThis.fetch`,
+//      replays the 8-call canonical sequence against the real tool handlers
+//      with canned real-shape inputs, sums the UTF-8 byte length of every
+//      result's `content[].text` block, and restores `globalThis.fetch`.
+//   3. It returns `{ sequence: [{ tool, bytes }], totalBytes }`.
+//
+// No network, no child process — the tool handlers run in-process and the
+// REST layer is the supplied responder. Given the same tools map and the
+// same responder, the result is byte-for-byte identical (determinism is
+// pinned by token-baseline.test.ts).
+/**
+ * The canonical 8-call walkthrough (the Maria mixed-feed flow): a fresh user
+ * discovers the install, activates a library template, inspects a connection,
+ * builds and validates a flow, then compiles it. Inputs are real-shape and
+ * fixed so the measurement is reproducible.
+ */
+export const CANONICAL_SEQUENCE = [
+    { tool: "apimapper_onboarding", args: {} },
+    { tool: "apimapper_library_list", args: { limit: 25 } },
+    {
+        tool: "apimapper_library_activate",
+        args: { id: "pexels", extra_fields: { api_key: "demo-key" } },
+    },
+    { tool: "apimapper_connection_list", args: {} },
+    { tool: "apimapper_connection_data", args: { id: "con_pexels", limit: 10 } },
+    {
+        tool: "apimapper_flow_create",
+        args: {
+            name: "Maria Mixed Feed",
+            nodes: [
+                {
+                    id: "src1",
+                    type: "source",
+                    position: { x: 0, y: 0 },
+                    data: { connectionId: "con_pexels" },
+                },
+                {
+                    id: "out1",
+                    type: "output-yootheme",
+                    position: { x: 300, y: 0 },
+                    data: { name: "Mixed Feed" },
+                },
+            ],
+            edges: [{ id: "e1", source: "src1", target: "out1" }],
+        },
+    },
+    {
+        tool: "apimapper_graph_validate",
+        args: {
+            nodes: [
+                {
+                    id: "src1",
+                    type: "source",
+                    position: { x: 0, y: 0 },
+                    data: { connectionId: "con_pexels" },
+                },
+                {
+                    id: "out1",
+                    type: "output-yootheme",
+                    position: { x: 300, y: 0 },
+                    data: { name: "Mixed Feed" },
+                },
+            ],
+            edges: [{ id: "e1", source: "src1", target: "out1" }],
+        },
+    },
+    { tool: "apimapper_flow_compile", args: { id: "flow_maria01" } },
+];
+/** The tool names the canonical sequence exercises, in call order. */
+export const CANONICAL_TOOLS = CANONICAL_SEQUENCE.map((s) => s.tool);
+// ── Canonical real-shape REST fixtures ──────────────────────────────────
+//
+// One fixture per upstream endpoint the canonical sequence touches. Shapes
+// mirror the actual PHP wire responses (the same shapes the per-module test
+// files assert against). Keeping them here — alongside the sequence — means
+// the determinism test and the scripts/token-baseline.mjs runner measure the
+// exact same byte budget; the responder is a single source of truth.
+// `provider` mirrors the real library.test.ts fixtures — the library_list
+// handler reads it for the client-side provider filter, so shipping it keeps
+// the measured shape faithful to the live PHP wire response.
+const LIBRARY_ITEMS = [
+    {
+        id: "pexels",
+        name: "Pexels",
+        provider: "pexels",
+        category: "media",
+        description: "Free stock photos and videos via the Pexels REST API.",
+        auth_type: "apikey",
+        popular: true,
+    },
+    {
+        id: "google-sheets",
+        name: "Google Sheets",
+        provider: "google",
+        category: "productivity",
+        description: "Read rows from a Google Sheets spreadsheet.",
+        auth_type: "oauth2_authcode",
+        popular: true,
+    },
+    {
+        id: "instagram",
+        name: "Instagram Graph",
+        provider: "instagram",
+        category: "social",
+        description: "Fetch media from an Instagram Business account.",
+        auth_type: "oauth2_authcode",
+        popular: false,
+    },
+];
+const CONNECTIONS = [
+    {
+        id: "con_pexels",
+        name: "Pexels — Curated",
+        source_type: "pexels",
+        status: "active",
+        credential_id: "cred_pexels1",
+    },
+];
+const PEXELS_ROWS = Array.from({ length: 10 }, (_, i) => ({
+    id: 1000 + i,
+    title: `Curated photo ${i + 1}`,
+    photographer: `Photographer ${i + 1}`,
+    image: { url: `https://images.pexels.com/photos/${1000 + i}/photo.jpg` },
+    width: 1920,
+    height: 1280,
+}));
+const FLOW_OBJECT = {
+    id: "flow_maria01",
+    name: "Maria Mixed Feed",
+    node_count: 2,
+    is_compiled: false,
+};
+/**
+ * Canonical fetch responder — routes an upstream URL to its real-shape
+ * fixture. Anything unmatched returns an empty-success envelope, which is the
+ * benign default for the optional sub-calls inside `apimapper_onboarding`.
+ */
+export function canonicalFetchResponder(url) {
+    if (url.includes("/library/popular")) {
+        return { body: { connections: LIBRARY_ITEMS.filter((i) => i.popular) } };
+    }
+    if (url.includes("/library/featured")) {
+        return { body: { connections: LIBRARY_ITEMS.slice(0, 2) } };
+    }
+    if (url.includes("/library/categories")) {
+        return {
+            body: {
+                categories: [
+                    { id: "media", name: "Media", count: 4 },
+                    { id: "social", name: "Social", count: 3 },
+                ],
+            },
+        };
+    }
+    if (url.includes("/library/pexels/activate")) {
+        return {
+            body: {
+                success: true,
+                connection: { id: "con_pexels", name: "Pexels", source_type: "pexels" },
+                reused: false,
+            },
+        };
+    }
+    if (url.includes("/library")) {
+        return { body: { connections: LIBRARY_ITEMS, total: LIBRARY_ITEMS.length } };
+    }
+    if (url.includes("/connections/con_pexels/data")) {
+        // Real backend returns the connection as an OBJECT, not a bare id —
+        // mirrors the {data, connection:{…}} envelope the connections.test.ts
+        // fixtures assert against, so the byte measurement stays realistic.
+        return {
+            body: {
+                data: PEXELS_ROWS,
+                connection: {
+                    id: "con_pexels",
+                    name: "Pexels — Curated",
+                    source_type: "pexels",
+                },
+            },
+        };
+    }
+    if (url.includes("/connections")) {
+        return { body: { connections: CONNECTIONS } };
+    }
+    if (url.includes("/flows/flow_maria01/compile")) {
+        return { body: { compiled: {}, flowId: "flow_maria01" } };
+    }
+    if (url.includes("/flows")) {
+        return { body: { success: true, flow: FLOW_OBJECT } };
+    }
+    if (url.includes("/graph/validate")) {
+        return {
+            body: { valid: true, warnings: [], nodeCount: 2, edgeCount: 1 },
+        };
+    }
+    if (url.includes("/health")) {
+        return {
+            body: { plugin_version: "2.0.7", api_version: "v1", status: "ok" },
+        };
+    }
+    if (url.includes("/license")) {
+        return { body: { tier: "pro", status: "active" } };
+    }
+    // Benign default for any onboarding sub-call without a dedicated fixture.
+    return { body: {} };
+}
+/**
+ * Matches the toolkit's embedded structured-meta marker — a trailing
+ * `\n\n<!-- structured-meta:<base64> -->` block appended by the
+ * `tableResult` / `detailResult` / … builders so `_meta.ui` survives
+ * `@ai-sdk/mcp`'s conversion (see @getimo/mcp-toolkit `embedStructuredMeta`).
+ * The `[A-Za-z0-9+/=]*` body is base64; `g` strips every occurrence.
+ */
+const STRUCTURED_META_MARKER = /\n\n<!-- structured-meta:[A-Za-z0-9+/=]*? -->/g;
+/**
+ * Strip every embedded structured-meta marker from a text block. What remains
+ * is the human/LLM-readable text a marker-aware host (the WootsUp Chat UI)
+ * presents after extracting the marker into a Rich Card.
+ */
+export function stripStructuredMeta(text) {
+    return text.replace(STRUCTURED_META_MARKER, "");
+}
+/**
+ * Sum the UTF-8 byte length of every text block in a tool result — both the
+ * raw bytes (`bytes`) and the marker-stripped, LLM-visible bytes
+ * (`visibleBytes`). The raw figure is the token-baseline metric; the visible
+ * figure is what a marker-stripping host actually feeds the model.
+ */
+function resultBytes(result) {
+    const blocks = Array.isArray(result.content) ? result.content : [];
+    let bytes = 0;
+    let visibleBytes = 0;
+    for (const block of blocks) {
+        if (typeof block.text === "string") {
+            bytes += Buffer.byteLength(block.text, "utf8");
+            visibleBytes += Buffer.byteLength(stripStructuredMeta(block.text), "utf8");
+        }
+    }
+    return { bytes, visibleBytes };
+}
+/**
+ * Replay the canonical sequence and measure total token output.
+ *
+ * @param tools          the registered apimapper tools map (name → tool)
+ * @param fetchResponder maps each upstream URL to a canned REST response
+ * @returns per-tool byte tally + `totalBytes` across the whole sequence
+ */
+export async function runTokenBaseline(tools, fetchResponder) {
+    const originalFetch = globalThis.fetch;
+    globalThis.fetch = (async (input, init) => {
+        const url = String(input);
+        const canned = fetchResponder(url, init);
+        const body = typeof canned.body === "string"
+            ? canned.body
+            : JSON.stringify(canned.body);
+        return new Response(body, {
+            status: canned.status ?? 200,
+            headers: { "Content-Type": "application/json" },
+        });
+    });
+    try {
+        const sequence = [];
+        for (const step of CANONICAL_SEQUENCE) {
+            const tool = tools[step.tool];
+            if (!tool) {
+                throw new Error(`token-baseline: tool "${step.tool}" is not registered`);
+            }
+            const result = await tool.handler(step.args);
+            const { bytes, visibleBytes } = resultBytes(result);
+            sequence.push({ tool: step.tool, bytes, visibleBytes });
+        }
+        const totalBytes = sequence.reduce((sum, e) => sum + e.bytes, 0);
+        const totalVisibleBytes = sequence.reduce((sum, e) => sum + e.visibleBytes, 0);
+        return { sequence, totalBytes, totalVisibleBytes };
+    }
+    finally {
+        globalThis.fetch = originalFetch;
+    }
+}
+//# sourceMappingURL=token-baseline.harness.js.map

package/dist/modules/apimapper/token-baseline.harness.js.map

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

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

@@ -0,0 +1,46 @@
+import type { StructuredCallToolResult } from "@getimo/mcp-toolkit";
+import { type ApiErrorCode } from "./client.js";
+/**
+ * The minimal slice of a response this helper reads. `ExtApiResponse` (the
+ * shared client return type) is a structural superset, and the graph
+ * hydration object `{ error, status?, errorCode? }` also satisfies it, so
+ * both can flow through `restErrorResult` without a cast.
+ */
+export interface RestErrorLike {
+    /** Human-readable error from the upstream response, if any. */
+    error?: string;
+    /** Coarse error classification used for the recovery hint + code fallback. */
+    errorCode?: ApiErrorCode | string;
+    /** HTTP status, used as the `code` fallback when `errorCode` is absent. */
+    status?: number;
+}
+/** Per-site overrides for the canonical REST-error mapping. */
+export interface RestErrorOpts {
+    /**
+     * Fallback message when `response.error` is absent. Mirrors the per-tool
+     * `r.error ?? "<fallback>"` string each site used inline.
+     */
+    message?: string;
+    /**
+     * Bespoke suggestion that overrides the default `hintFor(response.errorCode)`.
+     * Use only where a site intentionally pinned a tool-specific recovery hint.
+     */
+    suggestion?: string;
+    /**
+     * Bespoke `code` fallback that overrides the default `String(status)` when
+     * `response.errorCode` is absent. Use only where a site pinned a domain code.
+     */
+    code?: string;
+}
+/**
+ * Build the canonical structured error result for a failed REST request.
+ *
+ * Behaviour-preserving replacement for the 67× inline
+ * `errorResult({ message: r.error ?? …, code: …, suggestion: hintFor(…), details })`
+ * block. See the file header for the exact mapping and the opts contract.
+ *
+ * @param response the failed response (`!response.success` already checked by the caller)
+ * @param details  the structured `details` payload (typically the echoed input params)
+ * @param opts     per-site overrides — see {@link RestErrorOpts}
+ */
+export declare function restErrorResult(response: RestErrorLike, details?: Record<string, unknown>, opts?: RestErrorOpts): StructuredCallToolResult;

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

@@ -0,0 +1,63 @@
+// src/modules/apimapper/tool-result.ts — shared REST-error result builder.
+//
+// A1 (Wave-B audit, 2026-06-03): ~67 tool handlers across the apimapper
+// modules hand-wrote the IDENTICAL post-request error block:
+//
+//   if (!r.success) {
+//     return errorResult({
+//       message: r.error ?? "<per-tool fallback>",
+//       code: r.errorCode ?? (r.status ? String(r.status) : undefined),
+//       suggestion: hintFor(r.errorCode),
+//       details: { ...inputParams },
+//     });
+//   }
+//
+// `restErrorResult(r, details?, opts?)` collapses that block to a single
+// call while preserving the output BYTE-FOR-BYTE. The mapping is:
+//
+//   message    → r.error ?? opts.message ?? "request failed"
+//   code       → r.errorCode ?? (r.status ? String(r.status) : undefined)
+//   suggestion → opts.suggestion ?? hintFor(r.errorCode)
+//   details    → details (passed through verbatim; computed by the caller)
+//
+// Per-site nuance is preserved through `opts`:
+//   - opts.message    : the per-tool fallback string when `r.error` is absent.
+//   - opts.suggestion : a bespoke suggestion that overrides hintFor() (used by
+//                       the few sites that want a tool-specific recovery hint
+//                       regardless of the error code).
+//   - opts.code       : a bespoke `code` fallback that overrides the
+//                       `r.status`-derived default when `r.errorCode` is absent
+//                       (used by sites that pin a domain code like
+//                       "credential_lookup_failed").
+//
+// Sites whose error is NOT a `!response.success` REST failure (e.g. a
+// post-success "entity not found" semantic check, or a `bad_request`
+// validation guard with a hardcoded message/code/suggestion) deliberately
+// stay on the raw `errorResult({...})` form — they are documented per-site
+// and must NOT be funnelled through this helper, because their message/code
+// do not derive from the response shape.
+import { errorResult } from "@getimo/mcp-toolkit";
+import { hintFor } from "./client.js";
+/**
+ * Build the canonical structured error result for a failed REST request.
+ *
+ * Behaviour-preserving replacement for the 67× inline
+ * `errorResult({ message: r.error ?? …, code: …, suggestion: hintFor(…), details })`
+ * block. See the file header for the exact mapping and the opts contract.
+ *
+ * @param response the failed response (`!response.success` already checked by the caller)
+ * @param details  the structured `details` payload (typically the echoed input params)
+ * @param opts     per-site overrides — see {@link RestErrorOpts}
+ */
+export function restErrorResult(response, details, opts = {}) {
+    const errorCode = response.errorCode;
+    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 } : {}),
+    });
+}
+//# sourceMappingURL=tool-result.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,56 @@
+import { type CollectedTool } from "./gateway/test-support.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.
+ */
+export interface ToolCatalogEntry {
+    name: string;
+    description?: string;
+    inputSchema?: unknown;
+    annotations?: Record<string, unknown>;
+}
+/** One side of the measurement: its tool count and total serialized bytes. */
+export interface ToolsListMeasurement {
+    /** Number of tools in this `tools/list` surface. */
+    toolCount: number;
+    /** Sum of `Buffer.byteLength(JSON.stringify(entry))` across all tools. */
+    totalBytes: number;
+    /** Per-tool byte tally, sorted by name, for the breakdown table. */
+    perTool: Array<{
+        name: string;
+        bytes: number;
+    }>;
+}
+/** 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. */
+    postW3: ToolsListMeasurement;
+    /** Pre-W3-equivalent `tools/list` — all 78 tools exposed flat (no gateway). */
+    preW3Flat: ToolsListMeasurement;
+    /** Absolute byte reduction (preW3Flat.totalBytes − postW3.totalBytes). */
+    bytesSaved: number;
+    /** Reduction as a fraction of the pre-W3-equivalent total (0..1). */
+    fractionSaved: number;
+}
+/**
+ * Projects one tool to its `tools/list` JSON-Schema-bearing catalog entry.
+ * The `inputSchema` is JSON-Schema-projected the same way the SDK and the
+ * gateway's discovery mode do, so the byte count reflects the real wire shape.
+ */
+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
+ * 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
+ *   - top-level tools: rest_modules_status + use_profile + list_profiles      =  3
+ *                                                                      total = 79
+ *
+ * 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).
+ */
+export declare function measureToolsList(): Promise<ToolsListComparison>;