@wootsup/mcp 0.1.0-rc.8 → 0.1.0

package/dist/modules/apimapper/render/schemas.d.ts

@@ -0,0 +1,23 @@
+export declare const RENDER_TYPES: readonly ["table", "chart-bar", "chart-line", "schema-diagram", "flow-diagram", "json-tree", "diff"];
+export type RenderType = (typeof RENDER_TYPES)[number];
+export interface RenderOptions {
+    title?: string;
+    max_rows?: number;
+    columns?: string[];
+    depth?: number;
+    mask_secrets?: boolean;
+}
+/**
+ * Routes a render request to its type-specific renderer.
+ *
+ * Each renderer owns its own Zod validation of the `data` payload — this
+ * dispatcher passes the raw payload through unchanged. The MCP tool boundary
+ * has already validated `type` against RENDER_TYPES.
+ *
+ * All 7 RenderType members are wired. `options` is threaded to every
+ * renderer that consumes it (table/schema-diagram/json-tree/chart-bar/
+ * chart-line/diff); flow-diagram has no per-type options and ignores it.
+ * The `default` branch's `never` assignment is a compile-time guarantee
+ * that no enum member is left unhandled.
+ */
+export declare function dispatchRenderer(type: RenderType, data: unknown, options: RenderOptions): string;

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

@@ -0,0 +1,56 @@
+// render/schemas.ts — dispatcher + per-type validation entrypoint
+import { renderFlowDiagram } from "./renderers/flow-diagram.js";
+import { renderTable } from "./renderers/table.js";
+import { renderSchemaDiagram } from "./renderers/schema-diagram.js";
+import { renderJsonTree } from "./renderers/json-tree.js";
+import { renderChartBar } from "./renderers/chart-bar.js";
+import { renderChartLine } from "./renderers/chart-line.js";
+import { renderDiff } from "./renderers/diff.js";
+export const RENDER_TYPES = [
+    "table",
+    "chart-bar",
+    "chart-line",
+    "schema-diagram",
+    "flow-diagram",
+    "json-tree",
+    "diff",
+];
+/**
+ * Routes a render request to its type-specific renderer.
+ *
+ * Each renderer owns its own Zod validation of the `data` payload — this
+ * dispatcher passes the raw payload through unchanged. The MCP tool boundary
+ * has already validated `type` against RENDER_TYPES.
+ *
+ * All 7 RenderType members are wired. `options` is threaded to every
+ * renderer that consumes it (table/schema-diagram/json-tree/chart-bar/
+ * chart-line/diff); flow-diagram has no per-type options and ignores it.
+ * The `default` branch's `never` assignment is a compile-time guarantee
+ * that no enum member is left unhandled.
+ */
+export function dispatchRenderer(type, data, options) {
+    switch (type) {
+        case "flow-diagram":
+            return renderFlowDiagram(data);
+        case "table":
+            return renderTable(data, options);
+        case "schema-diagram":
+            return renderSchemaDiagram(data, options);
+        case "json-tree":
+            return renderJsonTree(data, options);
+        case "chart-bar":
+            return renderChartBar(data, options);
+        case "chart-line":
+            return renderChartLine(data, options);
+        case "diff":
+            return renderDiff(data, options);
+        default: {
+            // Exhaustiveness check: this `never` assignment compiles only when
+            // every RenderType enum member has a matching case above. Adding a
+            // new viz-type without wiring it here becomes a compile error.
+            const _exhaustive = type;
+            throw new Error(`Renderer not implemented for type: ${String(_exhaustive)}`);
+        }
+    }
+}
+//# sourceMappingURL=schemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../src/modules/apimapper/render/schemas.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,OAAO;IACP,WAAW;IACX,YAAY;IACZ,gBAAgB;IAChB,cAAc;IACd,WAAW;IACX,MAAM;CACE,CAAC;AAYX;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAgB,EAChB,IAAa,EACb,OAAsB;IAEtB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,cAAc;YACjB,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACjC,KAAK,OAAO;YACV,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACpC,KAAK,gBAAgB;YACnB,OAAO,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,KAAK,WAAW;YACd,OAAO,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvC,KAAK,WAAW;YACd,OAAO,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvC,KAAK,YAAY;YACf,OAAO,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACxC,KAAK,MAAM;YACT,OAAO,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnC,OAAO,CAAC,CAAC,CAAC;YACR,mEAAmE;YACnE,mEAAmE;YACnE,+DAA+D;YAC/D,MAAM,WAAW,GAAU,IAAI,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,sCAAsC,MAAM,CAAC,WAAW,CAAC,EAAE,CAC5D,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/modules/apimapper/render/secret-masking.d.ts

@@ -0,0 +1,5 @@
+/**
+ * True when `name` exactly equals a known secret-bearing field name,
+ * compared case-insensitively. Partial / substring matches return false.
+ */
+export declare function isSecretFieldName(name: string): boolean;

package/dist/modules/apimapper/render/secret-masking.js

@@ -0,0 +1,51 @@
+// secret-masking.ts — allowlist of sensitive field names for the diff renderer.
+//
+// The diff renderer masks a changed value as `***` when the last path segment
+// of its key is a known secret-bearing field. Matching is EXACT (the whole
+// segment must equal an allowlist entry, case-insensitively) — never a
+// substring test. A substring rule would over-mask innocent fields such as
+// "api_key_name" or "username", hiding information the user needs to see.
+//
+// SCOPE — masking is intentionally limited to the `diff` renderer.
+// `apimapper_render` is a PURE DISPLAY function: the calling LLM already
+// holds (and passed in) every byte of `data`, so masking cannot be a
+// containment boundary — it cannot hide anything the caller does not
+// already have. It is purely defense-in-depth: a focused before/after diff
+// is the output most likely to be pasted into a chat log or ticket, so
+// blanking changed secret values there reduces accidental exposure.
+// `table` / `json-tree` / `schema-diagram` deliberately do NOT mask — they
+// render whatever the caller chose to pass, verbatim, with no value
+// rewriting. Adding masking there would silently corrupt legitimate data
+// the caller explicitly asked to see.
+/** Field names whose values are masked in diff output (lower-case canonical). */
+const SECRET_ALLOWLIST = new Set([
+    "password",
+    "secret",
+    "token",
+    "api_key",
+    "apikey",
+    "credential",
+    "credentials",
+    "auth_data",
+    "bearer_token",
+    "refresh_token",
+    "access_token",
+    "client_secret",
+    "private_key",
+    "pat",
+    "personal_access_token",
+    "session_token",
+    "webhook_secret",
+    "consumer_secret",
+    "signing_key",
+    "oauth_token",
+    "service_account",
+]);
+/**
+ * True when `name` exactly equals a known secret-bearing field name,
+ * compared case-insensitively. Partial / substring matches return false.
+ */
+export function isSecretFieldName(name) {
+    return SECRET_ALLOWLIST.has(name.toLowerCase());
+}
+//# sourceMappingURL=secret-masking.js.map

package/dist/modules/apimapper/render/secret-masking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret-masking.js","sourceRoot":"","sources":["../../../../src/modules/apimapper/render/secret-masking.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,8EAA8E;AAC9E,2EAA2E;AAC3E,uEAAuE;AACvE,2EAA2E;AAC3E,0EAA0E;AAC1E,EAAE;AACF,mEAAmE;AACnE,yEAAyE;AACzE,qEAAqE;AACrE,qEAAqE;AACrE,2EAA2E;AAC3E,uEAAuE;AACvE,oEAAoE;AACpE,2EAA2E;AAC3E,oEAAoE;AACpE,yEAAyE;AACzE,sCAAsC;AAEtC,iFAAiF;AACjF,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC;IACpD,UAAU;IACV,QAAQ;IACR,OAAO;IACP,SAAS;IACT,QAAQ;IACR,YAAY;IACZ,aAAa;IACb,WAAW;IACX,cAAc;IACd,eAAe;IACf,cAAc;IACd,eAAe;IACf,aAAa;IACb,KAAK;IACL,uBAAuB;IACvB,eAAe;IACf,gBAAgB;IAChB,iBAAiB;IACjB,aAAa;IACb,aAAa;IACb,iBAAiB;CAClB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AAClD,CAAC"}

package/dist/modules/apimapper/render/sidecar.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `maxChars` for a mutation-tool response that carries a flow-visualization
+ * sidecar (flow_create / flow_update / graph_validate). The diagram is
+ * char-capped at DIAGRAM_PREVIEW_CAP (6000); JSON pretty-print escaping
+ * inflates it (\n → \\n), so this leaves headroom for the core response
+ * fields plus the escaped diagram — formatResult therefore never slices
+ * the JSON envelope mid-token. Shared by all three sidecar call-sites so
+ * the budget stays defined in exactly one place.
+ */
+export declare const SIDECAR_RESPONSE_MAX_CHARS = 16000;
+export interface FlowVisualization {
+    diagram: string;
+    /** Instruction to the LLM to render `diagram` for the user. */
+    display_hint: string;
+}
+export declare function buildFlowVisualization(flowLike: {
+    nodes?: unknown;
+    edges?: unknown;
+    id?: string;
+    name?: string;
+}): FlowVisualization | null;

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

@@ -0,0 +1,66 @@
+// render/sidecar.ts — buildFlowVisualization helper.
+//
+// Wraps renderFlowDiagram (Stage 1) with three safety layers so a flow
+// visualization can be attached to mutation-tool responses without
+// ever risking the host tool:
+//
+//   1. ENV opt-out — APIMAPPER_AUTO_VISUALIZE_FLOWS="false" disables
+//      the sidecar entirely. Default ON (any other value, or unset).
+//   2. Defensive shape-gate + try/catch — nodes/edges must both be
+//      arrays, and any renderer throw (e.g. Zod .min(1) on empty
+//      nodes) is swallowed to null. The sidecar is additive: a render
+//      failure must never break flow_create / flow_update /
+//      graph_validate.
+//   3. Diagram char-cap — the diagram string is bounded BEFORE it
+//      enters the response JSON. formatResult truncates the serialized
+//      JSON with a character-blind slice(); an unbounded diagram could
+//      push the envelope past maxChars and get cut mid-token, which
+//      would corrupt the WHOLE response (core fields included). Capping
+//      the diagram here keeps the JSON envelope always parseable.
+import { renderFlowDiagram } from "./renderers/flow-diagram.js";
+import { capRendered } from "./token-cap.js";
+// Sidecar diagram preview cap. Deliberately far below the 25KB
+// apimapper_render hard-cap: the sidecar is an inline *preview* attached
+// to a mutation response, not the full render. 6000 chars still shows a
+// useful ~50-node diagram; flows beyond that should call apimapper_render
+// with type:"flow-diagram" for the complete picture. Bounding the diagram
+// here guarantees the response JSON stays under the handler maxChars
+// ceiling and therefore always survives JSON.parse downstream.
+const DIAGRAM_PREVIEW_CAP = 6000;
+/**
+ * `maxChars` for a mutation-tool response that carries a flow-visualization
+ * sidecar (flow_create / flow_update / graph_validate). The diagram is
+ * char-capped at DIAGRAM_PREVIEW_CAP (6000); JSON pretty-print escaping
+ * inflates it (\n → \\n), so this leaves headroom for the core response
+ * fields plus the escaped diagram — formatResult therefore never slices
+ * the JSON envelope mid-token. Shared by all three sidecar call-sites so
+ * the budget stays defined in exactly one place.
+ */
+export const SIDECAR_RESPONSE_MAX_CHARS = 16_000;
+/**
+ * Constant `display_hint` attached to every flow-visualization sidecar.
+ * The `_visualization.diagram` string is a ready-to-show ASCII diagram;
+ * this hint tells the LLM to surface it to the user rather than treat it
+ * as opaque internal data.
+ */
+const FLOW_DISPLAY_HINT = "Show this flow diagram to the user.";
+export function buildFlowVisualization(flowLike) {
+    // ENV opt-out — explicit "false" only. Unset / any other value = ON.
+    if (process.env.APIMAPPER_AUTO_VISUALIZE_FLOWS === "false")
+        return null;
+    // Defensive: only render when nodes AND edges are both arrays.
+    if (!Array.isArray(flowLike.nodes) || !Array.isArray(flowLike.edges)) {
+        return null;
+    }
+    try {
+        // capRendered truncates at a line boundary (never mid-line) and
+        // appends a clear "call apimapper_render for the full diagram" hint.
+        const diagram = capRendered(renderFlowDiagram(flowLike), "Call apimapper_render with type:\"flow-diagram\" for the full diagram.", DIAGRAM_PREVIEW_CAP);
+        return { diagram, display_hint: FLOW_DISPLAY_HINT };
+    }
+    catch {
+        // Never break the host mutation tool because of the sidecar.
+        return null;
+    }
+}
+//# sourceMappingURL=sidecar.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar.js","sourceRoot":"","sources":["../../../../src/modules/apimapper/render/sidecar.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,EAAE;AACF,uEAAuE;AACvE,mEAAmE;AACnE,8BAA8B;AAC9B,EAAE;AACF,qEAAqE;AACrE,qEAAqE;AACrE,mEAAmE;AACnE,iEAAiE;AACjE,sEAAsE;AACtE,4DAA4D;AAC5D,uBAAuB;AACvB,kEAAkE;AAClE,uEAAuE;AACvE,uEAAuE;AACvE,oEAAoE;AACpE,wEAAwE;AACxE,kEAAkE;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,+DAA+D;AAC/D,yEAAyE;AACzE,wEAAwE;AACxE,0EAA0E;AAC1E,0EAA0E;AAC1E,qEAAqE;AACrE,+DAA+D;AAC/D,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG,qCAAqC,CAAC;AAQhE,MAAM,UAAU,sBAAsB,CAAC,QAKtC;IACC,qEAAqE;IACrE,IAAI,OAAO,CAAC,GAAG,CAAC,8BAA8B,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACxE,+DAA+D;IAC/D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,gEAAgE;QAChE,qEAAqE;QACrE,MAAM,OAAO,GAAG,WAAW,CACzB,iBAAiB,CAAC,QAAQ,CAAC,EAC3B,wEAAwE,EACxE,mBAAmB,CACpB,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,6DAA6D;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/modules/apimapper/render/token-cap.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Hard byte budget for `apimapper_render` output. Exported so the tool
+ * handler's `formatResult` maxChars can be derived from it (see
+ * render/index.ts) rather than hand-copied — keeping the two in lock-step
+ * is then compiler-enforced.
+ */
+export declare const HARD_CAP = 25000;
+/**
+ * Truncation-footer slack reserved below `limit` so the appended
+ * "⚠ Output truncated…" footer always fits. Exported alongside HARD_CAP
+ * for the same derive-don't-duplicate reason.
+ */
+export declare const RESERVE = 500;
+/**
+ * Truncate `text` to `limit` bytes at a line boundary (never mid-line) and
+ * append a footer with a type-specific `hint`. Small text passes through
+ * unchanged. `limit` defaults to the 25KB render hard-cap; the sidecar
+ * passes a smaller preview limit.
+ */
+export declare function capRendered(text: string, hint: string, limit?: number): string;
+export declare function hintFor(type: string): string;

package/dist/modules/apimapper/render/token-cap.js

@@ -0,0 +1,57 @@
+// render/token-cap.ts — byte-bounded, line-aligned output truncation.
+//
+// Two consumers share the same line-boundary truncation logic:
+//   - apimapper_render — hard 25KB cap on full rendered output.
+//   - the flow-visualization sidecar — a much smaller preview cap so the
+//     diagram never grows large enough to push a mutation-tool response
+//     JSON past its maxChars (which would otherwise be sliced mid-token
+//     by formatResult and corrupt the whole envelope).
+/**
+ * Hard byte budget for `apimapper_render` output. Exported so the tool
+ * handler's `formatResult` maxChars can be derived from it (see
+ * render/index.ts) rather than hand-copied — keeping the two in lock-step
+ * is then compiler-enforced.
+ */
+export const HARD_CAP = 25_000;
+/**
+ * Truncation-footer slack reserved below `limit` so the appended
+ * "⚠ Output truncated…" footer always fits. Exported alongside HARD_CAP
+ * for the same derive-don't-duplicate reason.
+ */
+export const RESERVE = 500;
+/**
+ * Truncate `text` to `limit` bytes at a line boundary (never mid-line) and
+ * append a footer with a type-specific `hint`. Small text passes through
+ * unchanged. `limit` defaults to the 25KB render hard-cap; the sidecar
+ * passes a smaller preview limit.
+ */
+export function capRendered(text, hint, limit = HARD_CAP) {
+    if (Buffer.byteLength(text, "utf8") <= limit)
+        return text;
+    const lines = text.split("\n");
+    const kept = [];
+    let bytes = 0;
+    for (const line of lines) {
+        const lineBytes = Buffer.byteLength(line + "\n", "utf8");
+        if (bytes + lineBytes > limit - RESERVE)
+            break;
+        kept.push(line);
+        bytes += lineBytes;
+    }
+    // Footer KB figure is derived from `limit` so the message stays accurate
+    // for any cap (25KB render, smaller sidecar preview).
+    const kb = Math.round(limit / 1000);
+    return (kept.join("\n") +
+        `\n\n⚠ Output truncated to ${kb}KB. ${hint}\n` +
+        "Reduce data via options.max_rows or filter input upstream.");
+}
+export function hintFor(type) {
+    switch (type) {
+        case "table": return "Use options.max_rows to limit rows.";
+        case "json-tree": return "Use options.depth to reduce nesting.";
+        case "diff": return "Filter datasets to relevant fields first.";
+        case "flow-diagram": return "Flow has many nodes — consider splitting.";
+        default: return "Reduce input size.";
+    }
+}
+//# sourceMappingURL=token-cap.js.map

package/dist/modules/apimapper/render/token-cap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-cap.js","sourceRoot":"","sources":["../../../../src/modules/apimapper/render/token-cap.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,+DAA+D;AAC/D,gEAAgE;AAChE,yEAAyE;AACzE,wEAAwE;AACxE,wEAAwE;AACxE,uDAAuD;AACvD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC;AAC/B;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,IAAY,EACZ,QAAgB,QAAQ;IAExB,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC;IAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;QACzD,IAAI,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO;YAAE,MAAM;QAC/C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,KAAK,IAAI,SAAS,CAAC;IACrB,CAAC;IACD,yEAAyE;IACzE,sDAAsD;IACtD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACpC,OAAO,CACL,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QACf,6BAA6B,EAAE,OAAO,IAAI,IAAI;QAC9C,4DAA4D,CAC7D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO,CAAC,CAAQ,OAAO,qCAAqC,CAAC;QAClE,KAAK,WAAW,CAAC,CAAI,OAAO,sCAAsC,CAAC;QACnE,KAAK,MAAM,CAAC,CAAS,OAAO,2CAA2C,CAAC;QACxE,KAAK,cAAc,CAAC,CAAC,OAAO,2CAA2C,CAAC;QACxE,OAAO,CAAC,CAAa,OAAO,oBAAoB,CAAC;IACnD,CAAC;AACH,CAAC"}

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

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

package/dist/modules/apimapper/schema.js

@@ -1,6 +1,50 @@
 import { z } from "zod";
-import { formatResult, autoFormatTable, readOnly } from "@getimo/mcp-toolkit";
+import { formatResult, tableResult, errorResult, readOnly, } from "@getimo/mcp-toolkit";
 import { request, hintFor } from "./client.js";
+// ── node_snapshot_list table shape ────────────────────────────────────
+const NODE_SNAPSHOT_COLUMNS = [
+    { key: "flow_id", label: "FLOW", width: 24 },
+    { key: "node_id", label: "NODE", width: 24 },
+    { key: "fetched_at", label: "FETCHED", width: 22 },
+    { key: "ttl_seconds", label: "TTL", width: 6 },
+    { key: "is_stale", label: "STALE", width: 5 },
+    { key: "payload_bytes", label: "BYTES", width: 8 },
+];
+// W1.19 (F-33): defense-in-depth aggregate byte budget on top of the row-cap.
+// Even at limit:50, a misbehaving source could return 50 fat snapshots that
+// blow past the LLM context budget. Cap aggregate payload at 2MB total.
+const SNAPSHOT_AGGREGATE_BYTES_CAP = 2 * 1024 * 1024;
+/**
+ * F-33: cap aggregate snapshot payload by byte-budget. Returns kept rows
+ * + truncation metadata. Defense-in-depth on top of the limit:50 row cap.
+ *
+ * Walks items in input order, summing JSON-serialised payload bytes; stops
+ * before adding any row whose payload would push the running total past
+ * `maxBytes`. Rows after the cutoff are reported as truncated but not
+ * returned.
+ */
+function capByAggregateBytes(items, maxBytes) {
+    let runningBytes = 0;
+    const kept = [];
+    for (const item of items) {
+        let payloadBytes = 0;
+        try {
+            payloadBytes = JSON.stringify(item.payload ?? {}).length;
+        }
+        catch {
+            payloadBytes = 0;
+        }
+        if (runningBytes + payloadBytes > maxBytes)
+            break;
+        runningBytes += payloadBytes;
+        kept.push(item);
+    }
+    return {
+        kept,
+        truncatedCount: items.length - kept.length,
+        aggregateBytes: runningBytes,
+    };
+}
 export function registerSchemaTools(server) {
     // ── apimapper_schema_profile ───────────────────────────────────────
     // F-A5-03: Real PHP contract is `{nodes, edges, target_node_id, flow_id?}`.
@@ -28,7 +72,7 @@ export function registerSchemaTools(server) {
                 .optional()
                 .describe("Optional flow id — enables NodeSnapshotRepository writes for hydrate path."),
         },
-        annotations: readOnly(),
+        annotations: readOnly({ title: "Profile Source Schema", openWorld: true }),
     }, async ({ nodes, edges, target_node_id, flow_id }) => {
         const body = { nodes, edges, target_node_id };
         if (flow_id)
@@ -38,13 +82,16 @@ export function registerSchemaTools(server) {
             body: JSON.stringify(body),
         });
         if (!r.success) {
-            return formatResult({
-                error: r.error,
-                status: r.status,
-                errorCode: r.errorCode,
-                context: { target_node_id, flow_id, node_count: Array.isArray(nodes) ? nodes.length : 0 },
-                hint: hintFor(r.errorCode),
-            }, true);
+            return errorResult({
+                message: r.error ?? "schema profile failed",
+                code: r.errorCode ?? (r.status ? String(r.status) : undefined),
+                suggestion: hintFor(r.errorCode),
+                details: {
+                    target_node_id,
+                    flow_id,
+                    node_count: Array.isArray(nodes) ? nodes.length : 0,
+                },
+            });
         }
         const merged = r.data?.merged ?? {};
         const fields = Array.isArray(merged.fields) ? merged.fields : [];
@@ -68,26 +115,56 @@ export function registerSchemaTools(server) {
             "\n\nExample:\n  apimapper_node_snapshot_list({ flow_id: 'flow_Z2fLg70M84' })",
         inputSchema: {
             flow_id: z.string().describe("Flow ID (required). Use apimapper_flow_list to find."),
-            limit: z.number().min(1).max(500).default(50).describe("Max items (1-500)"),
+            // W1.19 (F-33): row-cap lowered from max(500) → max(50). Old cap
+            // allowed up to ~2MB token spend per call. The handler also enforces
+            // an aggregate-bytes cap (SNAPSHOT_AGGREGATE_BYTES_CAP = 2MB) as
+            // defense-in-depth.
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .default(20)
+                .describe("Max items (1-50). Capped at 50 to keep aggregate snapshot payload within 2MB. Default 20."),
         },
-        annotations: readOnly(),
+        annotations: readOnly({ title: "List Node Snapshots", openWorld: true }),
     }, async ({ flow_id, limit }) => {
         const params = new URLSearchParams();
         params.set("flow_id", flow_id);
         params.set("limit", String(limit));
         const r = await request(`/node-snapshots?${params.toString()}`);
         if (!r.success) {
-            return formatResult({
-                error: r.error,
-                status: r.status,
-                errorCode: r.errorCode,
-                context: { flow_id, limit },
-                hint: hintFor(r.errorCode),
-            }, true);
+            return errorResult({
+                message: r.error ?? "node snapshot list failed",
+                code: r.errorCode ?? (r.status ? String(r.status) : undefined),
+                suggestion: hintFor(r.errorCode),
+                details: { flow_id, limit },
+            });
         }
         const items = Array.isArray(r.data?.snapshots) ? r.data.snapshots : [];
-        const truncated = Boolean(r.data?.truncated);
-        return autoFormatTable(items.map((s) => {
+        const serverTruncated = Boolean(r.data?.truncated);
+        // W1.19 (F-33): apply aggregate-bytes defense before rendering.
+        const { kept, truncatedCount: aggregateTruncatedCount, aggregateBytes, } = capByAggregateBytes(items, SNAPSHOT_AGGREGATE_BYTES_CAP);
+        const footerParts = [];
+        if (aggregateTruncatedCount > 0) {
+            footerParts.push(`Aggregate payload truncated at ${SNAPSHOT_AGGREGATE_BYTES_CAP} bytes ` +
+                `(${aggregateBytes} kept, ${aggregateTruncatedCount} dropped). ` +
+                `Lower limit or filter to specific node_id for full payloads.`);
+        }
+        if (serverTruncated) {
+            footerParts.push(`Result truncated at the server cap (limit=${limit}). More snapshots may exist.`);
+        }
+        // W1.19 (F-33): also render the aggregate-cap notice in the header so
+        // it survives table-row truncation in compact rendering mode. Footers
+        // are appended at the end of the rendered output and may be cut off
+        // when many rows are returned.
+        const headerSuffix = aggregateTruncatedCount > 0
+            ? ` (aggregate cap: ${aggregateTruncatedCount} dropped at ${SNAPSHOT_AGGREGATE_BYTES_CAP} bytes)`
+            : "";
+        // W3.1 — tableResult: ASCII table for the LLM + typed DataTable payload
+        // for the Rich Card. The F-33 aggregate-bytes cap + the header/footer
+        // truncation notices are preserved.
+        return tableResult(kept.map((s) => {
             let payloadBytes = 0;
             try {
                 payloadBytes = JSON.stringify(s.payload ?? {}).length;
@@ -104,18 +181,9 @@ export function registerSchemaTools(server) {
                 payload_bytes: payloadBytes,
             };
         }), {
-            columns: [
-                { key: "flow_id", label: "FLOW", width: 24 },
-                { key: "node_id", label: "NODE", width: 24 },
-                { key: "fetched_at", label: "FETCHED", width: 22 },
-                { key: "ttl_seconds", label: "TTL", width: 6 },
-                { key: "is_stale", label: "STALE", width: 5 },
-                { key: "payload_bytes", label: "BYTES", width: 8 },
-            ],
-            header: (n) => `${n} snapshots`,
-            footer: truncated
-                ? `Result truncated at the server cap (limit=${limit}). More snapshots may exist.`
-                : undefined,
+            columns: NODE_SNAPSHOT_COLUMNS,
+            header: (n) => `${n} snapshots${headerSuffix}`,
+            footer: footerParts.length > 0 ? footerParts.join(" ") : undefined,
         });
     });
 }

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

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

package/dist/modules/apimapper/settings-format.d.ts

@@ -0,0 +1,23 @@
+import { type TableColumn } from "@getimo/mcp-toolkit";
+export declare const HEALTH_WARNINGS_COLUMNS: TableColumn[];
+export declare const HEALTH_WARNINGS_NEXT_STEPS: string;
+/** health_warnings_list row map: warning item → table row. */
+export declare function mapHealthWarningRow(w: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Build a structured detail view for settings_get.
+ *
+ * The settings dict is a flat scalar map (cache_ttl, debug_mode, log_level,
+ * …) — each key becomes a detail entry. The active license tier is the
+ * badge; the canonical SETTABLE_KEYS list + next-step calls go into an
+ * IA-10 "Next steps" group so the LLM reads the affordance in the text.
+ */
+export declare function buildSettingsDetail(tier: string | undefined, settings: Record<string, unknown>, settableKeys: readonly string[]): import("@getimo/mcp-toolkit").StructuredCallToolResult;
+/**
+ * Build a structured detail view for features_get.
+ *
+ * The feature dict mixes booleans (jmespath: true) and numeric limits
+ * (max_connections: -1) — each key becomes a detail entry. The active tier
+ * is the badge; a single IA-10 "Next steps" group points at the license
+ * tools for upgrading a gated feature.
+ */
+export declare function buildFeaturesDetail(tier: string | undefined, features: Record<string, unknown>): import("@getimo/mcp-toolkit").StructuredCallToolResult;