@clipform/mcp-server 2.6.0 → 2.10.2

package/dist/{chunk-44FHF2MF.js → chunk-NCWQ42GI.js}

@@ -6,7 +6,7 @@ import {
   getWorkflowText,
   objectType,
   registerPrompts
-} from "./chunk-WMLM53A3.js";
+} from "./chunk-4QF4KGPE.js";
 import {
   GUIDE_TYPES,
   QUIZ_VARIANTS,
@@ -14,10 +14,11 @@ import {
   getGuideUri,
   guideFallbackText,
   registerResources
-} from "./chunk-L3DIBX4G.js";
+} from "./chunk-UBJ7CZL2.js";
 import {
   ACTIVE_NODE_TYPES,
   CONTACT_FIELDS,
+  FEATURE_FLAGS,
   FORM_TYPE_ALIASES,
   KEN_BURNS_EFFECTS,
   KEN_BURNS_FIT_MODES,
@@ -35,7 +36,7 @@ import {
   resolveFormType,
   structuredResult,
   textResult
-} from "./chunk-YAI5LQPF.js";
+} from "./chunk-IL26A4IN.js";
 import {
   getMcpAuth,
   runWithMcpTool
@@ -17002,6 +17003,7 @@ var EXPOSED_COMPOSITIONS = exposedCompositionIds(
 );
 
 // src/lib/schemas.ts
+var CUSTOM_SCORES_GATED_KEYS = /* @__PURE__ */ new Set(["show_score", "score_ranges", "scoring_results"]);
 var ACTIVE_NODE_TYPES2 = ACTIVE_NODE_TYPES;
 var CONTACT_FIELD_IDS = CONTACT_FIELDS.map(
   (f) => f.id
@@ -17011,6 +17013,7 @@ function generateConfigSummary(configSchema, typeKey) {
   const parts = [];
   for (const [key, prop] of Object.entries(configSchema.properties)) {
     if (key === "content_media_type") continue;
+    if (!FEATURE_FLAGS.ENABLE_CUSTOM_SCORES && CUSTOM_SCORES_GATED_KEYS.has(key)) continue;
     if (prop.enum) {
       const vals = prop.enum.map((v) => `"${v}"`).join("|");
       let s = `${key} (${vals}`;
@@ -17094,8 +17097,11 @@ var CaptionSchema = external_exports.object({
 });
 var OptionSchema = external_exports.object({
   content: external_exports.string().describe("Option text"),
+  is_correct: external_exports.boolean().optional().describe("Mark this as the correct answer for a quiz (maps to score 1; other options score 0). Use this OR score, not both."),
   score: external_exports.number().optional().describe("Score value for this option (for scored quizzes). Use 1 for correct, 0 for wrong. Scored options automatically enable correct-answer marking (record_scores) on the node."),
-  scores: external_exports.record(external_exports.number()).optional().describe("Planned feature - category-based scores keyed by category name. Not yet editable in the dashboard.")
+  // `scores` (category-based) is gated behind custom_scores (planned, #767) -
+  // omitted from the schema while off so the MCP doesn't accept a not-live field.
+  ...FEATURE_FLAGS.ENABLE_CUSTOM_SCORES ? { scores: external_exports.record(external_exports.number()).optional().describe("Category-based scores keyed by category name (personality quizzes).") } : {}
 });
 var OPTIONS_DESCRIPTION = (() => {
   const hints = ["Answer options."];
@@ -17125,6 +17131,14 @@ function applyNodeDefaults(node) {
     const label = node.config?.button_text || buttonDefault;
     node.options = [{ content: label }];
   }
+  if (node.options) {
+    for (const o of node.options) {
+      if (o.score == null && typeof o.is_correct === "boolean") {
+        o.score = o.is_correct ? 1 : 0;
+      }
+      delete o.is_correct;
+    }
+  }
   const supportsRecordScores = def?.config_schema?.properties?.choice?.properties?.record_scores !== void 0;
   const hasScoredOptions = node.options?.some((o) => o.score != null || o.scores != null);
   if (supportsRecordScores && hasScoredOptions) {
@@ -17276,7 +17290,7 @@ Example: A form that asks a question, collects contact info, then finishes:
           body: { tags }
         });
       }
-      const truncate = (s, n = 60) => s.length > n ? `${s.slice(0, n - 1)}\u2026` : s;
+      const truncate2 = (s, n = 60) => s.length > n ? `${s.slice(0, n - 1)}\u2026` : s;
       const lines = [
         isPreview ? `Form created as a preview draft.` : `Form created and live.`,
         ``,
@@ -17284,7 +17298,7 @@ Example: A form that asks a question, collects contact info, then finishes:
         `Form ID: ${formId}`,
         ``,
         `Node IDs (use directly with attach_node_media / update_node - no get_form round-trip needed):`,
-        ...createdNodes.map((n) => `- [${n.type}] "${truncate(n.prompt)}": ${n.id}`),
+        ...createdNodes.map((n) => `- [${n.type}] "${truncate2(n.prompt)}": ${n.id}`),
         ``,
         isPreview ? `PREVIEW URL (draft - only you can open this, not yet visible to respondents): ${data.viewer_url}` : `FORM URL (live - share this with respondents): ${data.viewer_url}`
       ];
@@ -17489,7 +17503,9 @@ function registerListFormsTool(server) {
             share_id: external_exports.string(),
             is_live: external_exports.boolean(),
             has_unpublished_changes: external_exports.boolean(),
-            tags: external_exports.array(external_exports.object({ id: external_exports.string(), name: external_exports.string(), color: external_exports.string().nullable() }))
+            tags: external_exports.array(external_exports.object({ id: external_exports.string(), name: external_exports.string(), color: external_exports.string().nullable() })),
+            builder_url: external_exports.string().optional().describe("Dashboard Build tab for this form. Not present for an anonymous caller."),
+            viewer_url: external_exports.string().optional().describe("Live respondent link. Only present for a published (is_live) form, and not for an anonymous caller.")
           })
         ).describe("Matching forms (empty if none)"),
         next_cursor: external_exports.string().nullable().describe("Pass as cursor to fetch the next page, or null when no more")
@@ -17522,7 +17538,9 @@ function registerListFormsTool(server) {
           share_id: f.share_id,
           is_live: f.is_live,
           has_unpublished_changes: f.has_unpublished_changes,
-          tags: f.tags.map((t) => ({ id: t.id, name: t.name, color: t.color }))
+          tags: f.tags.map((t) => ({ id: t.id, name: t.name, color: t.color })),
+          ...f.builder_url ? { builder_url: f.builder_url } : {},
+          ...f.viewer_url ? { viewer_url: f.viewer_url } : {}
         })),
         next_cursor: data.next_cursor
       };
@@ -17534,7 +17552,8 @@ function registerListFormsTool(server) {
       for (const f of data.forms) {
         const status = f.is_live ? f.has_unpublished_changes ? "live, unpublished changes" : "live" : "draft";
         const tagStr = f.tags.length > 0 ? ` [${f.tags.map((t) => t.name).join(", ")}]` : "";
-        lines.push(`- ${f.title || "(untitled)"} (${status})${tagStr} \u2014 ${f.id}`);
+        const linkStr = f.builder_url ? ` \u2014 ${f.builder_url}` : "";
+        lines.push(`- ${f.title || "(untitled)"} (${status})${tagStr} \u2014 ${f.id}${linkStr}`);
       }
       if (data.next_cursor) {
         lines.push(
@@ -17570,6 +17589,26 @@ function projectConfig(nodeType, config2) {
   }
   return projected;
 }
+var FORM_URL_KEYS = [
+  "viewer",
+  "builder",
+  "summary",
+  "responses",
+  "analytics",
+  "share",
+  "embed",
+  "dynamic_link"
+];
+function projectUrls(data) {
+  const raw = data.urls;
+  if (!raw) return void 0;
+  const urls = {};
+  for (const key of FORM_URL_KEYS) {
+    const value = raw[key];
+    if (typeof value === "string") urls[key] = value;
+  }
+  return Object.keys(urls).length > 0 ? urls : void 0;
+}
 function getFormNodes(data) {
   return data.node ?? data.nodes ?? [];
 }
@@ -17596,11 +17635,13 @@ function projectNext(node, logicByNode) {
 }
 function projectFormState(data) {
   const { nodes, logicByNode } = orderNodesWithLogic(data);
+  const urls = projectUrls(data);
   return {
     form_id: String(data.form_id ?? ""),
     title: String(data.title ?? ""),
     is_live: Boolean(data.is_live),
     has_unpublished_changes: Boolean(data.has_unpublished_changes),
+    ...urls ? { urls } : {},
     nodes: nodes.map((q) => {
       const options = q.node_options ?? q.options;
       const config2 = projectConfig(q.type, q.config);
@@ -17629,6 +17670,18 @@ function formatFormState(data) {
       `Unpublished changes: yes - respondents still see the last published version. Send is_live:true via clipform_update_form to publish.`
     );
   }
+  const urls = projectUrls(data);
+  if (urls) {
+    lines.push(``, `Links (exact values - constructed or guessed URLs return 404):`);
+    if (urls.viewer) lines.push(`  Viewer (respondent view): ${urls.viewer}`);
+    if (urls.builder) lines.push(`  Builder: ${urls.builder}`);
+    if (urls.summary) lines.push(`  Summary: ${urls.summary}`);
+    if (urls.responses) lines.push(`  Responses: ${urls.responses}`);
+    if (urls.analytics) lines.push(`  Analytics: ${urls.analytics}`);
+    if (urls.share) lines.push(`  Share: ${urls.share}`);
+    if (urls.embed) lines.push(`  Embed: ${urls.embed}`);
+    if (urls.dynamic_link) lines.push(`  Dynamic link: ${urls.dynamic_link}`);
+  }
   lines.push(``, `Nodes (in order):`);
   for (let i = 0; i < nodes.length; i++) {
     const q = nodes[i];
@@ -17668,6 +17721,16 @@ function registerGetFormTool(server) {
         title: external_exports.string().describe("Form title"),
         is_live: external_exports.boolean().describe("Whether the form is published"),
         has_unpublished_changes: external_exports.boolean().describe("Live form has edits not yet republished"),
+        urls: external_exports.object({
+          viewer: external_exports.string().optional().describe("Live respondent link, or a scoped preview link for an anonymous caller's draft. Omitted for a non-anonymous caller's unpublished draft."),
+          builder: external_exports.string().optional().describe("Build tab - the node/canvas editor. Not present for an anonymous caller."),
+          summary: external_exports.string().optional().describe("Summary tab - form overview and key stats. Not present for an anonymous caller."),
+          responses: external_exports.string().optional().describe("Responses tab - individual submissions. Not present for an anonymous caller."),
+          analytics: external_exports.string().optional().describe("Analytics tab - views, starts, completion rate, drop-off per node. Not present for an anonymous caller."),
+          share: external_exports.string().optional().describe("Share tab - link, QR, social. Not present for an anonymous caller."),
+          embed: external_exports.string().optional().describe("Embed setup for websites. Not present for an anonymous caller."),
+          dynamic_link: external_exports.string().optional().describe("Dynamic/personalized link setup. Not present for an anonymous caller.")
+        }).optional().describe("Dashboard/viewer deeplinks for this form. An anonymous caller gets only 'viewer'."),
         nodes: external_exports.array(
           external_exports.object({
             id: external_exports.string(),
@@ -17999,7 +18062,8 @@ function registerGetResultsTool(server) {
               })
             ).optional().describe("Most recent open-text answers, capped at 20 - open questions only")
           })
-        ).describe("Nodes in form order. Contact/file/draw/camera/payment nodes carry only total_responses/total_views - no per-response detail.")
+        ).describe("Nodes in form order. Contact/file/draw/camera/payment nodes carry only total_responses/total_views - no per-response detail."),
+        results_url: external_exports.string().optional().describe("Dashboard Responses tab for this form. Not present for an anonymous caller.")
       },
       annotations: {
         readOnlyHint: true,
@@ -18017,13 +18081,13 @@ function registerGetResultsTool(server) {
       const nodes = (data.nodes || []).map(projectNode);
       const structured = {
         total_responses: data.total_responses,
-        nodes
+        nodes,
+        ...data.results_url ? { results_url: data.results_url } : {}
       };
       if (data.total_responses === 0) {
-        return structuredResult(
-          `This form has no responses yet (${nodes.length} node(s)).`,
-          structured
-        );
+        const lines2 = [`This form has no responses yet (${nodes.length} node(s)).`];
+        if (data.results_url) lines2.push(`View in the dashboard: ${data.results_url}`);
+        return structuredResult(lines2.join("\n"), structured);
       }
       const lines = [`${data.total_responses} total response(s) across ${nodes.length} node(s).`];
       const highlights = nodes.filter((n) => "options" in n || "recent_answers" in n).slice(0, 3);
@@ -18035,11 +18099,157 @@ function registerGetResultsTool(server) {
           lines.push(`- ${n.prompt}: ${n.recent_answers.length} recent open-text answer(s)`);
         }
       }
+      if (data.results_url) lines.push(`View in the dashboard: ${data.results_url}`);
       return structuredResult(lines.join("\n"), structured);
     }
   );
 }
 
+// src/tools/get-responses.ts
+var MAX_ANSWER_LENGTH = 300;
+var DEFAULT_LIMIT = 20;
+var MAX_LIMIT = 50;
+var REDACTED_TYPES = {
+  details: "[contact details - view in dashboard]",
+  contact: "[contact details - view in dashboard]",
+  file_upload: "[file upload - view in dashboard]",
+  payment: "[payment - view in dashboard]",
+  open: ""
+  // open is redacted ONLY when the answer is a recording (handled below)
+};
+function truncate(s, n = MAX_ANSWER_LENGTH) {
+  return s.length > n ? `${s.slice(0, n - 1)}\u2026` : s;
+}
+function looksLikeMediaReference(display) {
+  return /https?:\/\/|storage\/|\.(webm|mp4|mp3|wav|m4a|mov)\b/i.test(display);
+}
+function registerGetResponsesTool(server) {
+  server.registerTool(
+    "clipform_get_responses",
+    {
+      title: "List form responses",
+      description: "List a Clipform form's individual responses (submissions) with time filtering - complements clipform_get_results (aggregates). Answers questions like 'what came in during the last 24 hours', 'what's the longest answer', 'what did people say'. Text answers only: contact details, file uploads, payments, and audio/video answers are redacted to placeholders - point the user at the dashboard for those. Responses are sorted newest first unless sort: 'oldest'.",
+      inputSchema: {
+        form_id: external_exports.string().describe("Form UUID (from clipform_list_forms / clipform_create_form)"),
+        since: external_exports.string().datetime({ offset: true }).optional().describe("Only responses submitted at or after this ISO 8601 time (e.g. '2026-08-29T00:00:00Z')"),
+        until: external_exports.string().datetime({ offset: true }).optional().describe("Only responses submitted at or before this ISO 8601 time"),
+        query: external_exports.string().optional().describe("Only responses whose text answers contain this string (case-insensitive)"),
+        sort: external_exports.enum(["newest", "oldest"]).optional().describe("Order by submission time. Default: newest"),
+        limit: external_exports.number().int().min(1).max(MAX_LIMIT).optional().describe(`Max responses to return (default ${DEFAULT_LIMIT}, max ${MAX_LIMIT})`)
+      },
+      outputSchema: {
+        total_matching: external_exports.number().describe("Responses matching the filters (before the limit cap)"),
+        returned: external_exports.number().describe("Responses in this result"),
+        locked_over_plan_limit: external_exports.number().describe("Matching responses hidden by the plan's response limit"),
+        responses: external_exports.array(
+          external_exports.object({
+            submitted_at: external_exports.string().describe("ISO 8601 submission time"),
+            status: external_exports.string(),
+            answers: external_exports.array(
+              external_exports.object({
+                question: external_exports.string(),
+                type: external_exports.string(),
+                answer: external_exports.string().describe("Text answer, or a redaction placeholder")
+              })
+            )
+          })
+        ).describe("Matching responses, filtered/sorted/capped per the inputs")
+      },
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false
+      }
+    },
+    async ({ form_id, since, until, query, sort, limit }) => {
+      const [subsResult, formResult] = await Promise.all([
+        callApi(`/forms/${form_id}/submissions`),
+        callApi(`/forms/${form_id}`)
+      ]);
+      if (!subsResult.ok) {
+        return errorResult(`Could not fetch responses: ${subsResult.error}`);
+      }
+      const nodeById = /* @__PURE__ */ new Map();
+      if (formResult.ok) {
+        const nodes = formResult.data?.nodes ?? [];
+        for (const n of nodes) nodeById.set(n.id, n);
+      }
+      const rows = subsResult.data ?? [];
+      const sinceMs = since ? Date.parse(since) : null;
+      const untilMs = until ? Date.parse(until) : null;
+      const needle = query?.toLowerCase() ?? null;
+      let lockedCount = 0;
+      const projected = [];
+      for (const row of rows) {
+        if (row.locked) {
+          lockedCount++;
+          continue;
+        }
+        const submittedAt = row.completed_at ?? row.created_at;
+        if (!submittedAt) continue;
+        const ms = Date.parse(submittedAt);
+        if (sinceMs !== null && ms < sinceMs) continue;
+        if (untilMs !== null && ms > untilMs) continue;
+        const answers = [];
+        for (const [nodeId, resp] of Object.entries(row.node_responses ?? {})) {
+          const node = nodeById.get(nodeId);
+          const type = node?.type ?? (typeof resp?.type === "string" ? resp.type : "unknown");
+          const question = truncate(node?.prompt || type, 120);
+          const placeholder = REDACTED_TYPES[type];
+          if (placeholder) {
+            answers.push({ question, type, answer: placeholder });
+            continue;
+          }
+          const display = typeof resp?.display === "string" ? resp.display : "";
+          if (!display) continue;
+          if (looksLikeMediaReference(display)) {
+            answers.push({ question, type, answer: "[recording - view in dashboard]" });
+            continue;
+          }
+          answers.push({ question, type, answer: truncate(display) });
+        }
+        if (needle !== null) {
+          const haystack = answers.map((a) => a.answer.toLowerCase()).join("\n");
+          if (!haystack.includes(needle)) continue;
+        }
+        projected.push({
+          submitted_at: submittedAt,
+          submitted_ms: ms,
+          status: row.status ?? "unknown",
+          answers
+        });
+      }
+      projected.sort(
+        (a, b) => sort === "oldest" ? a.submitted_ms - b.submitted_ms : b.submitted_ms - a.submitted_ms
+      );
+      const totalMatching = projected.length;
+      const capped = projected.slice(0, limit ?? DEFAULT_LIMIT).map(({ submitted_ms: _ms, ...rest }) => rest);
+      const filterBits = [
+        since ? `since ${since}` : null,
+        until ? `until ${until}` : null,
+        query ? `matching "${query}"` : null
+      ].filter(Boolean);
+      const lines = [
+        `${totalMatching} response(s)${filterBits.length ? ` ${filterBits.join(", ")}` : ""}${lockedCount > 0 ? ` (+${lockedCount} over the plan's response limit - not shown; upgrade or view counts in clipform_get_results)` : ""}. Showing ${capped.length}, ${sort === "oldest" ? "oldest" : "newest"} first.`,
+        ``,
+        ...capped.flatMap((r) => [
+          `\u2014 ${r.submitted_at} [${r.status}]`,
+          ...r.answers.map((a) => `  ${a.question}: ${a.answer}`)
+        ]),
+        ``,
+        `Contact details, files, payments, and recordings are redacted here - the dashboard shows full response detail. For aggregate stats use clipform_get_results.`
+      ];
+      return structuredResult(lines.join("\n"), {
+        total_matching: totalMatching,
+        returned: capped.length,
+        locked_over_plan_limit: lockedCount,
+        responses: capped
+      });
+    }
+  );
+}
+
 // src/tools/whoami.ts
 function registerWhoamiTool(server) {
   server.registerTool(
@@ -18058,7 +18268,11 @@ function registerWhoamiTool(server) {
           node_limit: external_exports.number().nullable().describe("Max nodes per form, or null if unlimited"),
           form_limit: external_exports.number().nullable().describe("Max forms in the workspace, or null if unlimited")
         }).describe("Plan limits for the active workspace"),
-        workspaces: external_exports.array(external_exports.object({ id: external_exports.string(), name: external_exports.string() })).optional().describe("All workspaces in the caller's company - only present for session (dashboard) auth")
+        workspaces: external_exports.array(external_exports.object({ id: external_exports.string(), name: external_exports.string() })).optional().describe("All workspaces in the caller's company - only present for session (dashboard) auth"),
+        links: external_exports.object({
+          dashboard: external_exports.string().describe("Dashboard home for the active workspace."),
+          forms: external_exports.string().describe("Forms list for the active workspace.")
+        }).optional().describe("Workspace-level dashboard links - only present for a non-anonymous caller.")
       },
       annotations: {
         readOnlyHint: true,
@@ -18092,9 +18306,16 @@ function registerWhoamiTool(server) {
       if (Array.isArray(me.workspaces)) {
         structured.workspaces = me.workspaces.map((w) => ({ id: w.id, name: w.name }));
       }
+      if (me.links && typeof me.links.dashboard === "string" && typeof me.links.forms === "string") {
+        structured.links = { dashboard: me.links.dashboard, forms: me.links.forms };
+      }
       const workspaceLine = workspace ? `workspace '${workspace.name}'` : "no workspace (anonymous)";
-      const summary = `Auth: ${authMode}. ${workspaceLine}. Plan: ${plan.name}.`;
-      return structuredResult(summary, structured);
+      const lines = [`Auth: ${authMode}. ${workspaceLine}. Plan: ${plan.name}.`];
+      if (structured.links) {
+        const links = structured.links;
+        lines.push(`Dashboard: ${links.dashboard}`, `Forms list: ${links.forms}`);
+      }
+      return structuredResult(lines.join("\n"), structured);
     }
   );
 }
@@ -20309,7 +20530,9 @@ Optional args by type:
 - funnel: outcomes, criteria, needs_contact (true)
 - testimonial: use_case
 - application: role
-- booking: event_name, event_type`,
+- booking: event_name, event_type
+- intake: use_case, response_format (all)
+- lead-capture: use_case`,
       inputSchema: {
         type: external_exports.string().describe("Form type to get the build workflow for (accepts aliases like 'feedback' \u2192 survey)"),
         variant: external_exports.enum(QUIZ_VARIANTS).optional().describe("Quiz sub-variant. Only used when type is 'quiz'. Omit for a standard scored quiz."),
@@ -20412,6 +20635,7 @@ function createServer(options) {
   registerUpdateFormTool(server);
   registerDeleteFormTool(server);
   registerGetResultsTool(server);
+  registerGetResponsesTool(server);
   registerAddNodeTool(server);
   registerUpdateNodeTool(server);
   registerDeleteNodeTool(server);
@@ -20446,4 +20670,4 @@ export {
   RENDER_TIMING,
   createServer
 };
-//# sourceMappingURL=chunk-44FHF2MF.js.map
+//# sourceMappingURL=chunk-NCWQ42GI.js.map