@clipform/mcp-server 4.3.1 → 4.4.0

package/README.md

@@ -60,7 +60,7 @@ Your MCP client lists these automatically on connect (via `tools/list`). Full re
 | Tool | Description |
 |------|-------------|
 | `clipform_create_form` | Create a new Clipform (interactive video-style form). |
-| `clipform_import_form` | Convert a public Google Form, Typeform, or Tally form into a new Clipform. |
+| `clipform_import_form` | Copies the questions from a public Google Form, Typeform, or Tally form into a new Clipform draft. |
 | `clipform_list_forms` | List forms in your workspace with optional filtering. |
 | `clipform_whoami` | Show the current identity: auth mode (api key, oauth, session, or anonymous), active workspace, and plan limits. |
 | `clipform_get_form` | Retrieve a form's details including all nodes in sequential order and their routing. |

package/dist/api-client.js

@@ -6,7 +6,7 @@ import {
   recoveryHint,
   structuredResult,
   textResult
-} from "./chunk-AEU5YBXM.js";
+} from "./chunk-K2JHO4A4.js";
 import "./chunk-BV3KA6HC.js";
 import "./chunk-PBQ5BQWD.js";
 import "./chunk-PZ5AY32C.js";

package/dist/{chunk-QIMA75T4.js → chunk-5JFU4OEI.js}

@@ -2,7 +2,7 @@ import {
   CURRENT_PLAN_VERSIONS,
   PLAN_LIMITS,
   callApi
-} from "./chunk-AEU5YBXM.js";
+} from "./chunk-K2JHO4A4.js";
 import {
   getMcpAuth
 } from "./chunk-BV3KA6HC.js";
@@ -123,4 +123,4 @@ export {
   getSessionContextWithAuth,
   getSessionContext
 };
-//# sourceMappingURL=chunk-QIMA75T4.js.map
+//# sourceMappingURL=chunk-5JFU4OEI.js.map

package/dist/{chunk-JY7OZS6P.js → chunk-E2T3UTF3.js}

@@ -29,7 +29,7 @@ import {
   union,
   unknown,
   url
-} from "./chunk-63CHR6UP.js";
+} from "./chunk-HWOV2WRK.js";
 import {
   GUIDE_TYPES,
   QUIZ_VARIANTS,
@@ -38,7 +38,7 @@ import {
   getGuideUri,
   guideFallbackText,
   registerResources
-} from "./chunk-4U4CLCYD.js";
+} from "./chunk-F4AFULRJ.js";
 import {
   ANON_PREVIEW_LINK_LABEL,
   ANON_PREVIEW_NOTICE,
@@ -50,11 +50,12 @@ import {
   capsFromToolsets,
   isPreviewViewerUrl,
   withAdoptedNotice
-} from "./chunk-QIMA75T4.js";
+} from "./chunk-5JFU4OEI.js";
 import {
   ACTIVE_NODE_TYPES,
   CONTACT_FIELDS,
   FEATURE_FLAGS,
+  FORM_TYPES_LIST,
   FORM_TYPE_ALIASES,
   MCP_ANON_PUBLISH_GATE,
   MCP_TOOL_SECURITY,
@@ -74,7 +75,7 @@ import {
   stripGatedConfigKeys,
   structuredResult,
   textResult
-} from "./chunk-AEU5YBXM.js";
+} from "./chunk-K2JHO4A4.js";
 import {
   getMcpAuth,
   runWithMcpAuth,
@@ -16080,7 +16081,20 @@ import { readFileSync } from "fs";
 import { dirname, join } from "path";
 import { fileURLToPath } from "url";
 
+// src/lib/job-copy.ts
+var ACTIVE_JOB_LABELS = FORM_TYPES_LIST.filter(
+  (t) => t.is_active
+).map((t) => t.label.toLowerCase());
+function joinJobs(labels, conjunction = "and") {
+  if (labels.length <= 2) return labels.join(` ${conjunction} `);
+  return `${labels.slice(0, -1).join(", ")}, ${conjunction} ${labels[labels.length - 1]}`;
+}
+var ACTIVE_JOBS_PHRASE = joinJobs(ACTIVE_JOB_LABELS);
+var IMPORT_FORM_LEAD = "Copies the questions from a public Google Form, Typeform, or Tally form into a new Clipform draft. The source form and its responses stay where they are.";
+var INSTRUCTIONS_LEAD = `Clipform builds interactive video-style forms that other people fill in, with their answers (video, audio, or text) stored for the owner to read back: ${ACTIVE_JOBS_PHRASE}. Drafting questions as text to review or paste is a chat task, not a Clipform build.`;
+
 // src/lib/onboarding-copy.ts
+var STARTERS = ACTIVE_JOB_LABELS.join(", ");
 var ONBOARDING_OFFER_CONTROL_VARIANT = "control";
 var ONBOARDING_OFFER_COPY = {
   // #4089 review: this cohort has already completed OAuth to connect - they
@@ -16089,12 +16103,12 @@ var ONBOARDING_OFFER_COPY = {
   // did and reads as broken. Acknowledge the connection instead, then offer
   // to build. (The anonymous/no-auth entry point is a different surface,
   // #4088 - not this cohort.)
-  [ONBOARDING_OFFER_CONTROL_VARIANT]: "When this is the start of a new conversation and the user has not yet said what they want to build, welcome them as someone who is now connected to Clipform and offer to build their first form together, then offer these starting points as plain text: lead-gen, feedback, quiz, or something else - ask which one fits, or invite them to describe what they need instead. If the user's first message already states what they want to build, even loosely, skip that offer entirely and go straight into the brief-driven flow below."
+  [ONBOARDING_OFFER_CONTROL_VARIANT]: `When this is the start of a new conversation and the user has not yet said what they want to build, welcome them as someone who is now connected to Clipform and offer to build their first form together, then offer these starting points as plain text: ${STARTERS}, or something else - ask which one fits, or invite them to describe what they need instead. If the user's first message already states what they want to build, even loosely, skip that offer entirely and go straight into the brief-driven flow below.`
 };
 function buildOnboardingOffer(variant = ONBOARDING_OFFER_CONTROL_VARIANT) {
   return ONBOARDING_OFFER_COPY[variant] ?? ONBOARDING_OFFER_COPY[ONBOARDING_OFFER_CONTROL_VARIANT];
 }
-var ONBOARDING_OFFER_TOOL_CUE = "If the user hasn't said what to build yet, offer to build their first form and suggest starting points: lead-gen, feedback, quiz, or something else.";
+var ONBOARDING_OFFER_TOOL_CUE = `If the user hasn't said what to build yet, offer to build their first form and suggest starting points: ${STARTERS}, or something else.`;
 
 // src/lib/config.ts
 var _endScreen = NODE_TYPES.end_screen.config_schema.properties;
@@ -16336,6 +16350,18 @@ var formIdTargetInput = external_exports.string().uuid().optional().describe(
   "The form this is for (from clipform_create_form) - a routing hint only, to pick the right workspace. The result still lands in the workspace library, not on a node. Required on an anonymous session, or this lands in a different workspace and clipform_attach_node_media will not find it."
 );
 
+// src/lib/links.ts
+var LINK_LABELS = {
+  preview: "Preview your form",
+  claim: "Sign up to keep this form (one-time link)",
+  share: "Share link",
+  edit: "Edit in Clipform",
+  responses: "View responses"
+};
+function mdLink(label, url2) {
+  return `[${label}](${url2})`;
+}
+
 // src/tools/create-form.ts
 function registerCreateFormTool(server) {
   server.registerTool(
@@ -16513,11 +16539,11 @@ Example: A form that asks a question, collects contact info, then finishes:
         `Node IDs (use directly with attach_node_media / update_node - no get_form round-trip needed):`,
         ...createdNodes.map((n) => `- [${n.type}] "${truncate2(n.prompt)}": ${n.id}`),
         ``,
-        isPreview ? `PREVIEW URL (draft - answers are not saved, only you can open this, not for respondents): ${data.viewer_url}` : `FORM URL (live - share this with respondents): ${data.viewer_url}`
+        isPreview ? `PREVIEW URL (draft - answers are not saved, only you can open this, not for respondents): ${mdLink(LINK_LABELS.preview, String(data.viewer_url))}` : `FORM URL (live - share this with respondents): ${mdLink(LINK_LABELS.share, String(data.viewer_url))}`
       ];
       if (formUrl) {
         lines.push(
-          isPreview ? `CLAIM URL (fallback - or open this one-time link to sign up in the browser): ${formUrl}` : `DASHBOARD URL (sign in to edit and manage): ${formUrl}`
+          isPreview ? `CLAIM URL (fallback - or open this one-time link to sign up in the browser): ${mdLink(LINK_LABELS.claim, formUrl)}` : `DASHBOARD URL (sign in to edit and manage): ${mdLink(LINK_LABELS.edit, formUrl)}`
         );
       }
       if (ignoredNotes.length > 0) lines.push(``, ...ignoredNotes);
@@ -16526,7 +16552,7 @@ Example: A form that asks a question, collects contact info, then finishes:
       lines.push(
         ``,
         isPreview ? `This form is a preview, not live. When the user says "publish it", call clipform_update_form (is_live: true); it prompts them to sign in. The PREVIEW URL never becomes public on its own.` : `The form is live and accessible at the FORM URL above. Edits and media attached AFTER this point are NOT visible to respondents until you re-send is_live: true via clipform_update_form - republishing is the expected final step of a build, never skip it after attaching media/narration.`,
-        formUrl ? `The URLs above are exact values; constructed or guessed URLs return 404. Use the ${firstUrlLabel} URL and ${secondUrlLabel} URL as shown.` : `The ${firstUrlLabel} URL above is an exact value; constructed or guessed URLs return 404.`,
+        formUrl ? `The URLs above are exact values; constructed or guessed URLs return 404. Use the ${firstUrlLabel} URL and ${secondUrlLabel} URL as shown, keeping each link's label rather than pasting the bare URL.` : `The ${firstUrlLabel} URL above is an exact value; constructed or guessed URLs return 404. Keep the link's label rather than pasting the bare URL.`,
         `Pass form_id on follow-up tools (get_form, add_node, attach_node_media, etc.).`
       );
       const anonNotice = isPreview ? anonPreviewNotice() : null;
@@ -16694,7 +16720,7 @@ function registerImportFormTool(server) {
     "clipform_import_form",
     {
       title: "Import Form",
-      description: `Convert a public Google Form, Typeform, or Tally form into a new Clipform. Supported URLs: Google Forms (docs.google.com or forms.gle - must be shared as "Anyone with the link"), Typeform (form.typeform.com/to/...), and Tally (tally.so - must be public). The source form must be publicly accessible; a private form's questions cannot be read. The new Clipform is created as a DRAFT - review it, then republish with clipform_update_form (is_live: true) once it's ready. Some question types don't map cleanly to a Clipform node and are skipped rather than guessed at; the result always reports exactly what was imported vs skipped, and why.`,
+      description: `${IMPORT_FORM_LEAD} Supported URLs: Google Forms (docs.google.com or forms.gle - must be shared as "Anyone with the link"), Typeform (form.typeform.com/to/...), and Tally (tally.so - must be public). The source form must be publicly accessible; a private form's questions cannot be read. The new Clipform is created as a DRAFT - review it, then republish with clipform_update_form (is_live: true) once it's ready. Some question types don't map cleanly to a Clipform node and are skipped rather than guessed at; the result always reports exactly what was imported vs skipped, and why.`,
       inputSchema: external_exports.object({
         workspace_id: workspaceIdInput,
         url: external_exports.string().url().describe("Public URL of the Google Form, Typeform, or Tally form to import")
@@ -17006,12 +17032,12 @@ function formatFormState(data) {
     lines.push(``, `Links (exact values - constructed or guessed URLs return 404):`);
     if (urls.viewer) {
       lines.push(
-        isPreviewViewerUrl(urls.viewer) ? `  ${ANON_PREVIEW_LINK_LABEL}: ${urls.viewer}` : `  Viewer (respondent view): ${urls.viewer}`
+        isPreviewViewerUrl(urls.viewer) ? `  ${ANON_PREVIEW_LINK_LABEL}: ${mdLink(LINK_LABELS.preview, urls.viewer)}` : `  Viewer (respondent view): ${mdLink(LINK_LABELS.share, urls.viewer)}`
       );
     }
-    if (urls.builder) lines.push(`  Builder: ${urls.builder}`);
+    if (urls.builder) lines.push(`  Builder: ${mdLink(LINK_LABELS.edit, urls.builder)}`);
     if (urls.summary) lines.push(`  Summary: ${urls.summary}`);
-    if (urls.responses) lines.push(`  Responses: ${urls.responses}`);
+    if (urls.responses) lines.push(`  Responses: ${mdLink(LINK_LABELS.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}`);
@@ -17256,8 +17282,8 @@ function registerUpdateFormTool(server) {
         if (viewerUrl) {
           resultText += `
 
-Your form is live at: ${viewerUrl}
-Share this URL with respondents. View responses any time with clipform_get_results (form_id: ${form_id})${responsesUrl ? `, or in the dashboard: ${responsesUrl}` : ""}`;
+Your form is live at: ${mdLink(LINK_LABELS.share, viewerUrl)}
+Share this URL with respondents. View responses any time with clipform_get_results (form_id: ${form_id})${responsesUrl ? `, or in the dashboard: ${mdLink(LINK_LABELS.responses, responsesUrl)}` : ""}`;
         }
       }
       const anonNotice = anonPreviewNotice();
@@ -20083,13 +20109,14 @@ var MCP_SERVER_CARD_IDENTITY = Object.freeze({
 });
 function buildInstructions(caps) {
   return [
+    INSTRUCTIONS_LEAD,
     buildOnboardingOffer(),
-    "Clipform builds interactive video-style forms. When the brief is clear, build the form directly; when it's vague, ask one or two short questions first.",
+    "When the brief is clear, build the form directly; when it's vague, ask one or two short questions first.",
     caps.media && "Prefer rich media: video over images over plain text.",
     caps.media ? "Before building, derive a register from the topic and audience (e.g. hype, playful, warm, considered, elegant, sombre); if the user states a mood explicitly, that wins. State the register once, then apply it to every rendering choice - narration tone, motion preset, music, pacing. Never mix registers in one form." : "Before building, derive a register from the topic and audience (e.g. hype, playful, warm, considered, elegant, sombre); if the user states a mood explicitly, that wins. State the register once, then apply it to every question, option, and end-screen line. Never mix registers in one form.",
     "At the start of a build, call clipform_get_workflow to load the recipe for the form type, and clipform_get_guide for craft detail.",
     "Every *_id argument is a UUID returned by the tools - not the short share_id from a form URL.",
-    "For an account-scoped request, call clipform_whoami first to confirm the active workspace and plan.",
+    "Use clipform_whoami when the request is about the account itself (the active workspace, plan, or limits); building a form does not need it first.",
     caps.media ? "Deleting a form moves it to the trash (restorable from the dashboard); deleting a node cannot be undone (a node deleted on a live form stays on the live form until you publish); removing media from a node only unlinks it, and the media asset stays in the library. Those tools ask the user to confirm before running." : "Deleting a form moves it to the trash (restorable from the dashboard); deleting a node cannot be undone (on a live form it stays on the live form until you publish). Those tools ask the user to confirm before running."
   ].filter((line) => typeof line === "string").join(" ");
 }
@@ -20263,4 +20290,4 @@ export {
   * MIT Licensed
   *)
 */
-//# sourceMappingURL=chunk-JY7OZS6P.js.map
+//# sourceMappingURL=chunk-E2T3UTF3.js.map