@wootsup/mcp 0.1.0-rc.8 → 0.1.0

package/dist/modules/apimapper/flows-format.js

@@ -0,0 +1,318 @@
+// src/modules/apimapper/flows-format.ts — W3.1 structuredContent helpers
+//
+// rc.13 Welle 3 (2026-05-20) — extracted from flows.ts when the migration to
+// the toolkit's structuredContent builders pushed the tool-registration
+// module past the ~600-line review threshold (a LOW finding observed on the
+// library.ts migration; the same split was applied to connections-format.ts).
+// flows.ts keeps the lean tool-registration surface; the column constants,
+// row maps, detail/timeline builders and next-step strings live here.
+//
+//   - T1 (W3.2): flow_list carries explicit compactColumns + compactMap.
+//   - IA-7 (W3.7): a human-readable NAME column; the opaque `id` column the
+//     LLM still needs for follow-up calls is marked llmOnly (ASCII text only,
+//     excluded from the Rich Card UI payload).
+//   - IA-10 (W3.9): every migrated tool carries actionable next-step guidance
+//     in the LLM-readable text (table footer / detail "Next steps" group).
+import { detailResult, timelineResult, } from "@getimo/mcp-toolkit";
+import { buildFlowVisualization } from "./render/sidecar.js";
+// ── flow_list table shape ─────────────────────────────────────────────
+// IA-7: NAME is the human-readable label. ID is opaque but the LLM needs it
+// for follow-up calls (flow_get / flow_compile / flow_trace), so it stays in
+// the ASCII text — `llmOnly: true` keeps it out of the Rich Card UI payload.
+export const FLOW_TABLE_COLUMNS = [
+    // Width 36 accommodates 30+ char IDs (e.g. legacy template flows like
+    // flow_calendly_jla_229fcbce95b7 = 30 chars). Truncation produces orphan
+    // IDs that downstream tools fail to resolve via flow_get; +6 headroom
+    // matches the longest historical IDs.
+    { key: "id", label: "ID", width: 36, llmOnly: true },
+    { key: "name", label: "NAME", width: 32 },
+    { key: "source", label: "SRC", width: 10 },
+    { key: "nodes", label: "N", width: 4 },
+    { key: "compiled", label: "C", width: 3 },
+    { key: "types", label: "TYPES", width: 36 },
+];
+// T1 (W3.2): reduced column set for 21+ flows — id (llmOnly) + name + the
+// two fields that anchor identity at a glance (source + compiled state).
+// NODES count and TYPES are dropped at compact level to keep the row narrow.
+export const FLOW_COMPACT_COLUMNS = [
+    { key: "id", label: "ID", width: 36, llmOnly: true },
+    { key: "name", label: "NAME", width: 32 },
+    { key: "source", label: "SRC", width: 10 },
+    { key: "compiled", label: "C", width: 3 },
+];
+/**
+ * Derive `is_compiled` from REST shape: the backend returns `compiledAt`
+ * (ISO timestamp string or null) and a `compiled` array of artifacts.
+ * Either indicates the flow has been compiled. Shared between the row map
+ * and the in-memory `compiled` filter so display + filtering stay uniform.
+ */
+export function isFlowCompiled(f) {
+    if (typeof f.is_compiled === "boolean")
+        return f.is_compiled;
+    const raw = f;
+    if (typeof raw.compiledAt === "string" && raw.compiledAt.length > 0)
+        return true;
+    if (Array.isArray(raw.compiled) && raw.compiled.length > 0)
+        return true;
+    return false;
+}
+/** Standard row map: full Flow → table row. */
+export function mapFlowRow(f) {
+    const flow = f;
+    return {
+        id: String(flow.id ?? ""),
+        name: String(flow.name ?? ""),
+        source: flow.source || "—",
+        nodes: flow.node_count ?? "?",
+        compiled: isFlowCompiled(flow) ? "✓" : "✗",
+        types: (flow.node_types || []).join(","),
+    };
+}
+/** T1 compact row map: only the columns FLOW_COMPACT_COLUMNS renders. */
+export function compactFlowRow(f) {
+    const flow = f;
+    return {
+        id: String(flow.id ?? ""),
+        name: String(flow.name ?? ""),
+        source: flow.source || "—",
+        compiled: isFlowCompiled(flow) ? "✓" : "✗",
+    };
+}
+// IA-10: actionable next-step guidance, kept in the table footer so it is
+// VISIBLE in the LLM-readable text of the flow list.
+export const FLOW_LIST_NEXT_STEPS = "Next: apimapper_flow_get({ id }) for the full node/edge structure · " +
+    "apimapper_flow_compile({ id }) to publish to YOOtheme · " +
+    "apimapper_flow_trace({ id }) to inspect the last run.";
+/** Compact str-coerce: scalars → string, everything else → null. */
+function str(v) {
+    return typeof v === "string"
+        ? v
+        : typeof v === "number" || typeof v === "boolean"
+            ? String(v)
+            : null;
+}
+/**
+ * Build a structured detail view for one flow (flow_get).
+ *
+ * IA-7: technical IDs are copyable code entries. IA-10: a dedicated "Next
+ * steps" group carries the actionable follow-up calls. The W2 flow
+ * visualization (an ASCII diagram) is routed via `appendText` — it reaches
+ * the LLM-readable output but is intentionally kept OUT of the Rich Card
+ * groups payload, exactly as the toolkit documents `appendText` for
+ * technical detail that would clutter the visual display.
+ */
+export function buildFlowDetail(id, flow) {
+    const f = flow;
+    const overviewAll = [
+        { key: "id", label: "ID", value: str(f.id) ?? id, format: "code", copyable: true },
+        { key: "name", label: "Name", value: str(f.name) },
+        { key: "description", label: "Description", value: str(f.description) },
+        { key: "source", label: "Source", value: str(f.source) },
+    ];
+    const overview = overviewAll.filter((e) => e.value !== null);
+    // Structure fields are scalar-only; node/edge arrays flatten to counts.
+    const nodes = Array.isArray(f.nodes) ? f.nodes : [];
+    const edges = Array.isArray(f.edges) ? f.edges : [];
+    const nodeTypes = Array.isArray(f.node_types) ? f.node_types : [];
+    const structureAll = [
+        {
+            key: "node_count",
+            label: "Nodes",
+            value: typeof f.node_count === "number" ? f.node_count : nodes.length,
+        },
+        { key: "edge_count", label: "Edges", value: edges.length },
+        {
+            key: "node_types",
+            label: "Node types",
+            value: nodeTypes.length > 0 ? nodeTypes.join(", ") : null,
+        },
+        {
+            key: "is_compiled",
+            label: "Compiled",
+            value: isFlowCompiled(flow),
+            format: "boolean",
+        },
+        { key: "version", label: "Version", value: typeof f.version === "number" ? f.version : null },
+        { key: "updated_at", label: "Updated", value: str(f.updated_at), format: "date" },
+    ];
+    const structure = structureAll.filter((e) => e.value !== null);
+    const groups = [{ label: "Flow", entries: overview }];
+    if (structure.length > 0)
+        groups.push({ label: "Structure", entries: structure });
+    groups.push({
+        // IA-10 (W3.9): actionable next steps in a dedicated group — visible in
+        // the LLM-readable detail text.
+        label: "Next steps",
+        entries: [
+            {
+                key: "compile",
+                label: "Publish",
+                value: `apimapper_flow_compile({ id: '${id}' }) — compile + publish to the YOOtheme dropdown`,
+            },
+            {
+                key: "trace",
+                label: "Debug",
+                value: `apimapper_flow_trace({ id: '${id}' }) — inspect the last run's per-step timing`,
+            },
+            {
+                key: "update",
+                label: "Edit",
+                value: `apimapper_flow_update({ id: '${id}', patch: { … } }) — modify nodes/edges`,
+            },
+        ],
+    });
+    // W2 sidecar: render the flow diagram from the flow's own nodes + edges.
+    // buildFlowVisualization returns null when the ENV opt-out is set or the
+    // shape is not renderable — in that case no appendText is attached.
+    const viz = buildFlowVisualization({
+        nodes: f.nodes,
+        edges: f.edges,
+        id: str(f.id) ?? id,
+        name: str(f.name) ?? undefined,
+    });
+    // F-LS-07 (W3.1 Stage 2): live-smoke (2026-05-20) showed that callers
+    // needed a second tool call to inspect exact edge wiring + node data
+    // attributes (e.g. connectionId on a source). The Structure group carries
+    // only counts; this block surfaces the raw nodes+edges JSON behind a clear
+    // header so the LLM can read the wiring inline. `compiled` artifacts stay
+    // out of the appendText — they are large enough to blow the token cap and
+    // already reachable via apimapper_flow_compile.
+    const structureBlock = "Flow structure (JSON):\n" +
+        "```json\n" +
+        JSON.stringify({ nodes, edges }, null, 2) +
+        "\n```";
+    // F-LS-08b (W3.1 Stage 3): when the W2 sidecar produced a diagram, prepend
+    // a clear "pre-rendered" header so the LLM treats the ASCII block as a
+    // ready-to-show artifact and re-uses it directly rather than calling
+    // apimapper_render({type:'flow-diagram', ...}) again. Live-smoke
+    // (2026-05-20) showed callers re-rendering the same diagram. The header
+    // still leaves the apimapper_render door open for layout-variant requests.
+    const diagramHeader = viz
+        ? "[Pre-rendered ASCII flow-diagram below — re-use this directly. " +
+            "Call apimapper_render({ type: 'flow-diagram', data }) only if a " +
+            "different layout is needed.]\n\n"
+        : "";
+    const appendParts = [];
+    if (viz)
+        appendParts.push(diagramHeader + viz.diagram);
+    appendParts.push(structureBlock);
+    const appendText = appendParts.join("\n\n");
+    return detailResult({
+        title: str(f.name) ?? id,
+        subtitle: str(f.source) ?? undefined,
+        badge: isFlowCompiled(flow)
+            ? { text: "Compiled", variant: "success" }
+            : { text: "Draft", variant: "secondary" },
+        groups,
+        // The ASCII diagram + structure JSON are LLM-readable detail, not Rich
+        // Card content (the Rich Card payload mirrors the `groups`).
+        appendText,
+    });
+}
+/**
+ * Build a structured timeline view for a flow execution trace (flow_trace).
+ *
+ * The trace's per-step timing map naturally onto timeline events: each step
+ * becomes one event with its node id as the title, the item count + duration
+ * as the detail, and a relative `[step N]` time label (the trace carries no
+ * wall-clock per step, only durations). Shapes vary across backend versions,
+ * so every field read is defensive.
+ */
+export function buildFlowTraceTimeline(id, steps, totalMs) {
+    const num = (v) => typeof v === "number" && Number.isFinite(v) ? v : undefined;
+    const events = steps.map((raw, idx) => {
+        const s = raw && typeof raw === "object" ? raw : {};
+        const nodeId = str(s.node_id) ?? str(s.nodeId) ?? str(s.id) ?? str(s.node) ?? `step ${idx + 1}`;
+        const itemCount = num(s.item_count) ?? num(s.itemCount) ?? num(s.count);
+        const durationMs = num(s.duration_ms) ?? num(s.durationMs) ?? num(s.fetch_ms) ?? num(s.fetchMs) ?? num(s.ms);
+        const stepType = str(s.type) ?? str(s.node_type);
+        const detailParts = [];
+        if (itemCount !== undefined)
+            detailParts.push(`${itemCount} items`);
+        if (durationMs !== undefined)
+            detailParts.push(`${durationMs} ms`);
+        const stepError = str(s.error);
+        if (stepError)
+            detailParts.push(`error: ${stepError}`);
+        return {
+            id: `step-${idx}`,
+            time: `step ${idx + 1}`,
+            title: stepType ? `${nodeId} (${stepType})` : nodeId,
+            detail: detailParts.length > 0 ? detailParts.join(" · ") : undefined,
+            type: stepError ? "error" : "system",
+            source: nodeId,
+        };
+    });
+    const totalLabel = typeof totalMs === "number" ? ` · ${totalMs} ms total` : "";
+    return timelineResult({
+        title: `Trace: ${id} — ${steps.length} step${steps.length === 1 ? "" : "s"}${totalLabel}`,
+        events,
+    });
+}
+/**
+ * Build a structured detail view for a flow-import-bundle validation result
+ * (flow_import_validate). The REST result is a flat validation envelope
+ * ({valid, flowName, exportedFrom, connectionReferences}) — detailResult is
+ * the clean fit. Array fields flatten to a count + per-item entries (note 4).
+ * IA-10: a dedicated "Next steps" group carries the import/abort guidance.
+ */
+export function buildImportValidateDetail(opts) {
+    const refs = opts.connectionReferences;
+    const summary = [
+        { key: "valid", label: "Valid", value: opts.valid, format: "boolean" },
+        { key: "flow_name", label: "Flow name", value: opts.flowName ?? null },
+        {
+            key: "exported_from",
+            label: "Exported from",
+            value: opts.exportedFrom ?? null,
+        },
+    ];
+    // Array field → count + per-item label entries (detailResult is scalar-only).
+    const refEntries = [
+        { key: "ref_count", label: "Connection references", value: refs.length },
+        ...refs.map((ref, idx) => {
+            const r = ref && typeof ref === "object" ? ref : {};
+            const label = str(r.name) ?? str(r.id) ?? `reference ${idx + 1}`;
+            return {
+                key: `ref_${idx}`,
+                label: `  ${str(r.id) ?? idx + 1}`,
+                value: label,
+            };
+        }),
+    ];
+    const groups = [
+        { label: "Validation", entries: summary.filter((e) => e.value !== null) },
+        { label: "References", entries: refEntries },
+        {
+            label: "Next steps",
+            entries: opts.valid
+                ? [
+                    {
+                        key: "import",
+                        label: "Import",
+                        value: "apimapper_flow_import({ bundle }) — the bundle validated; safe to import",
+                    },
+                    {
+                        key: "credentials",
+                        label: "Re-link auth",
+                        value: "Auth-protected references need a credential on the target site — apimapper_credential_list({})",
+                    },
+                ]
+                : [
+                    {
+                        key: "fix",
+                        label: "Fix",
+                        value: "The bundle did not validate — review the missing connections / schema mismatches above before importing",
+                    },
+                ],
+        },
+    ];
+    return detailResult({
+        title: opts.flowName ? `Import bundle: ${opts.flowName}` : "Import bundle validation",
+        badge: opts.valid
+            ? { text: "Valid", variant: "success" }
+            : { text: "Invalid", variant: "destructive" },
+        groups,
+    });
+}
+//# sourceMappingURL=flows-format.js.map

package/dist/modules/apimapper/flows-format.js.map

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

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

@@ -1,2 +1,13 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerFlowTools(server: McpServer): void;
+import type { ToolRegistrar } from "./gateway/capturing-server.js";
+import { type McpServerWithElicitation } from "./elicitation.js";
+/**
+ * Register the flow CRUD + compile + detect-schema + trace + export/import
+ * tools.
+ *
+ * @param server      the tool registrar (essentials forward, rest captured).
+ * @param elicitation optional elicitation capability (the real McpServer, or
+ *   any `{ server: { elicitInput } }`). Supplied only by the host wiring in
+ *   index.ts. When omitted, `flow_compile` falls back to a structured error
+ *   on genuine flow ambiguity instead of prompting.
+ */
+export declare function registerFlowTools(server: ToolRegistrar, elicitation?: McpServerWithElicitation): void;