@clipform/mcp-server 1.8.0 → 1.9.0

package/dist/resources.js

@@ -1,336 +0,0 @@
-import { getSessionContext } from "./lib/session-context.js";
-const WRITING_PRINCIPLES = `## Writing Principles
-
-- **Write for the ear.** Narration is spoken aloud. Short sentences. Natural rhythm.
-- **Research before writing.** Find 2-3 genuinely interesting facts per topic. Generic content doesn't hold attention.
-- **Conversational, not encyclopaedic.** "Here's what's wild about this..." not "The subject is characterized by..."
-- **Cut ruthlessly.** Every word must earn its place.
-- **Never reveal answers in narration.** The user picks from options - narration teases and builds intrigue.
-- **Don't read answer options aloud.** The viewer can see them on screen.
-
-## Narration Tips
-
-- Tease the topic, don't summarise it
-- Give one interesting fact that makes the user curious
-- 5-15 seconds per question narration
-- If TTS comes back too long, trim the copy and regenerate
-
-## Research
-
-Search for the specific subject, not generic terms ("komodo dragon habitat" not "reptile"). Cross-reference facts - quiz answers must be correct. Look for the surprising angle: what would make someone say "wait, really?"
-
-For timeless topics (history, geography, science), write from your own knowledge. For anything recent or uncertain, use web search or clipform_search_news. If neither is available, refuse rather than fabricate.`;
-const MEDIA_WORKFLOW = `## Media Workflow
-
-1. **clipform_generate_tts** - narration audio (returns word-level captions)
-2. **clipform_search_media** (kind: "image") - find 3 images per question
-3. **clipform_generate_video** - Ken Burns video from images + audio
-4. **clipform_upload_node_media** - attach video with captions (set show_captions: true)
-
-**Image selection:**
-- ONLY use URLs from clipform_search_media results
-- Search for the specific subject, not generic terms
-- Pick visually distinct images (different angles, colors, subjects)
-- Landscape images work best for pan effects
-
-**Slideshow defaults:**
-- 3 images per question, random_effects: true
-- transition: { type: "fade", duration: 1 }
-- Auto focal point detection, eased motion, and cinematic vignette are built in`;
-export function registerResources(server) {
-    server.registerResource("guide-quiz", "clipform://guides/quiz", {
-        description: "Craft knowledge for writing engaging quizzes - difficulty curves, question psychology, narration style, scoring",
-        mimeType: "text/markdown",
-    }, async () => ({
-        contents: [
-            {
-                uri: "clipform://guides/quiz",
-                mimeType: "text/markdown",
-                text: `# Quiz Writing Guide
-
-## Psychology
-
-Each question is a micro variable-reward event - the same dopamine loop that keeps people watching. Once someone answers 2-3 questions, sunk cost kicks in and they finish. Viewers mentally compete, then want to compare scores.
-
-**Target 50-60% correct.** Too easy = no challenge. Too hard = people feel stupid and won't share.
-
-## Difficulty Curve
-
-| Position | Difficulty | Purpose |
-|----------|-----------|---------|
-| Q1-Q2 | Easy (80%+ get right) | Build confidence and commitment |
-| Q3-Q5 | Medium | Peak engagement |
-| Q6-Q8 | Hard (include one "gotcha") | The "everyone gets this wrong" moment |
-| Q9-Q10 | One hard, one satisfying medium | End on a smart feeling, not defeat |
-
-## Question Design
-
-- **Myth-busters**: "Sushi means raw fish - True or False?" (False - it means seasoned rice)
-- **Sounds fake but true**: counterintuitive correct answers make people rewatch
-- **Common misconceptions**: "Capital of Australia?" (not Sydney - Canberra)
-- Under 12-15 words per question for mobile readability
-- Trigger gut reactions, not deep thinking
-
-## Wrong Answer Generation
-
-For numeric questions (population, speed, weight), scale the real answer by random multipliers (0.3x to 3x) rounded to the same magnitude. Makes wrong answers plausible but clearly different.
-
-## Narration Style
-
-You're a quiz master, not a question reader. Each question's narration should:
-
-1. **Tease** - set the scene, build intrigue ("This one catches everyone out")
-2. **Give context** - one interesting fact that makes the question richer
-3. **Pose the question** - "So here's the question..."
-
-**Don't say:**
-- "You either know it or you don't" (meaningless filler)
-- "This is a really hard one" on every question (loses impact)
-- "Welcome to my quiz" / "Hey guys" (wastes time, skip to Q1)
-
-${WRITING_PRINCIPLES}
-
-${MEDIA_WORKFLOW}`,
-            },
-        ],
-    }));
-    server.registerResource("guide-personality-quiz", "clipform://guides/personality-quiz", {
-        description: "Craft knowledge for building personality quizzes - category design, option weighting, outcome writing, no right/wrong answers",
-        mimeType: "text/markdown",
-    }, async () => ({
-        contents: [
-            {
-                uri: "clipform://guides/personality-quiz",
-                mimeType: "text/markdown",
-                text: `# Personality Quiz Guide
-
-## How it works
-
-Personality quizzes use **category-based scoring** (the \`scores\` field on options) instead of right/wrong scoring. Each option distributes points across outcome categories. The category with the highest total at the end determines the result.
-
-## Category Design
-
-- **3-5 categories** is the sweet spot. Fewer feels too binary, more feels random.
-- Categories should be **distinct but equally appealing**. Nobody wants to get the "bad" result.
-- Name them after the outcome, not the trait: "Explorer" not "Adventurous", "The Architect" not "Organised".
-
-## Option Weighting
-
-Each option scores into one or more categories:
-
-\`\`\`json
-{ "scores": { "Explorer": 3, "Homebody": 0, "Foodie": 1 } }
-\`\`\`
-
-Guidelines:
-- **Primary category**: 2-3 points (this is the option's "home" category)
-- **Secondary**: 1 point (slight lean towards another category)
-- **Unrelated**: 0 (omit or set to 0)
-- **Knockout**: -1 (use sparingly - strongly rules out a category)
-- Every option should score positively in at least one category
-- Avoid giving every option the same spread - it makes results feel random
-
-## Question Design
-
-- Questions should feel **personally revealing** but low-stakes: "Pick your ideal Saturday morning" not "What's your biggest weakness?"
-- Scenario-based questions work better than abstract preference questions
-- Each question should meaningfully differentiate between categories
-- Avoid questions where all options clearly map to one obvious personality
-
-## Outcome Screens
-
-Each category needs a \`scoring_results\` entry on the end screen:
-
-- **Title**: "You're a [Category]!" - celebratory, not clinical
-- **Message**: 2-3 sentences that feel like a personalised insight. Reference specific traits the quiz measured.
-- **Optional CTA**: link to relevant content, product, or next step
-
-## Narration Style
-
-Reflective and curious, not quizmaster-y:
-- "This one says a lot about you..."
-- "There's no wrong answer here - go with your gut"
-- "What does your choice reveal?"
-
-Do NOT say "let's see if you get this right" - there is no right answer.
-
-${WRITING_PRINCIPLES}
-
-${MEDIA_WORKFLOW}`,
-            },
-        ],
-    }));
-    server.registerResource("guide-interview", "clipform://guides/interview", {
-        description: "Craft knowledge for building interview and testimonial collection forms - warm-up pacing, open questions, consent, video responses",
-        mimeType: "text/markdown",
-    }, async () => ({
-        contents: [
-            {
-                uri: "clipform://guides/interview",
-                mimeType: "text/markdown",
-                text: `# Interview & Testimonial Guide
-
-## Purpose
-
-Collect responses from people - testimonials, case studies, journalist callouts, async video interviews, candidate screening. The common thread: you're asking someone to respond on camera or in their own words.
-
-## Structure
-
-1. **Warm-up question** - something easy and low-stakes to get them comfortable. "Tell us your name and what you do" or "What's your role?"
-2. **Core questions** - the real ask. Open-ended, one topic per question. Don't over-split - 2-3 core questions max.
-3. **Follow-up** (optional) - "Anything else you'd like to add?" catches things you didn't think to ask.
-4. **Contact collection** - first name + email minimum. Add phone/company if relevant.
-5. **Consent** - "I agree that my response may be used in [context]." Always include for testimonials and media.
-6. **End screen** - set expectations: "Thanks! We'll be in touch if we'd like to take things further."
-
-## Question Design
-
-- **Open-ended by default.** Use "open" type with text + audio + video response enabled. Let the respondent choose their format.
-- **One topic per question.** "Tell us about your experience AND what you'd change" is two questions.
-- **Prompt, don't interrogate.** "What surprised you most about working with us?" beats "Rate your satisfaction."
-- **Keep it short.** 3-5 questions total. Every extra question loses respondents.
-
-## Narration for Interviews
-
-Warmer and more personal than quiz narration. You're inviting someone to share, not testing them.
-
-- "We'd love to hear your story..."
-- "Take your time with this one - there's no wrong answer"
-- Keep narration under 10 seconds - the respondent's answer is the content, not yours
-
-## Settings
-
-- disable_back_navigation: false (let people review their answers)
-- show_step_counter: true (so they know how much is left)
-
-${WRITING_PRINCIPLES}
-
-${MEDIA_WORKFLOW}`,
-            },
-        ],
-    }));
-    server.registerResource("guide-survey", "clipform://guides/survey", {
-        description: "Craft knowledge for feedback surveys, NPS, and research forms - brevity, rating scales, respondent fatigue",
-        mimeType: "text/markdown",
-    }, async () => ({
-        contents: [
-            {
-                uri: "clipform://guides/survey",
-                mimeType: "text/markdown",
-                text: `# Survey & Feedback Guide
-
-## Purpose
-
-Collect structured feedback - NPS, customer satisfaction, product research, post-event feedback. The goal is clean, analysable data with minimal respondent fatigue.
-
-## Structure
-
-Surveys should be ruthlessly short. Every extra question costs you completions.
-
-1. **Key metric** - the one number you care about (NPS, satisfaction rating, likelihood to recommend). Put it first while attention is highest.
-2. **Follow-up** - one open-ended "why?" question. "What's the main reason for your score?" This is where the insight lives.
-3. **Specific questions** (optional) - 2-3 targeted choice questions on specific areas. Don't fish - only ask what you'll act on.
-4. **Contact** (optional) - only if you need to follow up. Many surveys are better anonymous.
-5. **End screen** - "Thanks for your feedback!" Keep it simple.
-
-## Question Design
-
-- **Choice questions for data, open questions for insight.** Don't use open-ended where a rating scale would do, and don't use ratings where you need to understand why.
-- **Balanced scales.** Equal positive and negative options. "Excellent / Good / Fair / Poor" not "Amazing / Great / Good / OK / Bad."
-- **No leading questions.** "How much did you enjoy...?" assumes they enjoyed it.
-- **5 questions max.** If you need more, you're running research, not a survey - split it up.
-
-## Narration for Surveys
-
-Optional - many surveys work fine as text only. If using narration:
-
-- Keep it brief (5-8 seconds). "We'd love your quick feedback on..."
-- Don't narrate every question - just the opener to set the tone
-- Friendly but efficient. Respect their time.
-
-## Settings
-
-- disable_back_navigation: false
-- show_step_counter: true (shows progress, reduces abandonment)
-
-${WRITING_PRINCIPLES}`,
-            },
-        ],
-    }));
-    server.registerResource("guide-funnel", "clipform://guides/funnel", {
-        description: "Craft knowledge for lead qualification funnels and product recommendation quizzes - branching logic, progressive profiling, conversion",
-        mimeType: "text/markdown",
-    }, async () => ({
-        contents: [
-            {
-                uri: "clipform://guides/funnel",
-                mimeType: "text/markdown",
-                text: `# Lead Qualification & Product Recommendation Guide
-
-## Purpose
-
-Route people to the right outcome based on their answers. Lead qualification scores and segments prospects. Product recommendation guides users to the right product. Both use branching logic to personalise the journey.
-
-## Structure
-
-1. **Hook question** - immediately relevant, low friction. "What are you looking for?" or "What best describes you?" This segments the user and determines the branch.
-2. **Qualifying questions** - 2-3 questions that narrow down the need. Each answer can branch to a different path.
-3. **Contact capture** - name, email, phone. Place AFTER qualifying questions so they've invested before you ask for details.
-4. **Outcome screen** - personalised end screen based on their answers. Use score_ranges or branching logic to show different messages.
-
-## Question Design
-
-- **Progressive profiling.** Start broad, get specific. Don't ask for budget on question 1.
-- **Every question must earn its place.** If the answer doesn't change the outcome or routing, cut the question.
-- **Choice questions, not open-ended.** You need structured data to route and score. Save open-ended for "anything else?"
-- **3-5 questions max.** Every extra step loses leads. The funnel is leaky by nature - keep it tight.
-
-## Branching Logic
-
-Use clipform_set_logic to route based on answers:
-
-- **Segment early.** Q1 answer determines which Q2 they see.
-- **Converge at capture.** All branches should reach the contact collection step.
-- **Different outcomes for different segments.** The end screen should feel personalised: "Based on your answers, we recommend..." not a generic "Thanks!"
-
-## Scoring for Product Recommendation
-
-- Assign scores to each option based on which product/outcome it points to
-- Use score_ranges on the end screen to show different recommendations
-- Example: score 0-3 = "Basic plan", 4-6 = "Pro plan", 7+ = "Enterprise - let's talk"
-
-## Narration for Funnels
-
-Short and action-oriented. You're guiding, not teaching.
-
-- "Let's find the right fit for you..."
-- "Just a couple of quick questions..."
-- Keep total narration under 30 seconds across the whole funnel
-
-## Settings
-
-- disable_back_navigation: true (prevent answer shopping that breaks scoring)
-- show_step_counter: false (funnels feel shorter without a counter)
-
-${WRITING_PRINCIPLES}`,
-            },
-        ],
-    }));
-    server.registerResource("context-session", "clipform://context/session", {
-        description: "Current session info: auth mode, workspace, plan tier, node limits, feature flags. Read this before planning content to know your constraints.",
-        mimeType: "text/markdown",
-        annotations: { audience: ["assistant"], priority: 1.0 },
-    }, async () => {
-        const text = await getSessionContext();
-        return {
-            contents: [
-                {
-                    uri: "clipform://context/session",
-                    mimeType: "text/markdown",
-                    text: text || "Session context unavailable - API may not be reachable.",
-                },
-            ],
-        };
-    });
-}
-//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

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

package/dist/server.d.ts

@@ -1,2 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function createServer(): McpServer;

package/dist/tools/add-node.d.ts

@@ -1,2 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerAddNodeTool(server: McpServer): void;

package/dist/tools/add-node.js

@@ -1,50 +0,0 @@
-import { z } from "zod";
-import { NodeSchema, NODE_TYPES_DESCRIPTION } from "../lib/schemas.js";
-import { callApi, errorResult, textResult } from "../lib/api-client.js";
-import { fetchAndFormatFormState } from "../lib/format-form.js";
-export function registerAddNodeTool(server) {
-    server.registerTool("clipform_add_node", {
-        title: "Add Node",
-        description: `Add a new node to an existing form. By default, the node is inserted before the end screen (appended to the end of the flow). Use after_node_id to insert at a specific position.
-
-${NODE_TYPES_DESCRIPTION}
-
-All type definitions and config schemas are derived from @vid-master/config (answer-types).`,
-        inputSchema: {
-            form_id: z.string().uuid().describe("The form UUID (returned by clipform_create_form, not the short share_id from the URL)"),
-            edit_token: z.string().optional().describe("The edit token. Required for anonymous (non-OAuth) sessions; omit when connected via an authenticated MCP client like claude.ai."),
-            question: NodeSchema.describe("The node to add"),
-            after_node_id: z
-                .string()
-                .optional()
-                .describe("Insert after this node ID. Omit to append before the end screen."),
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: true,
-        },
-    }, async ({ form_id, edit_token, question, after_node_id }) => {
-        const body = { question };
-        if (after_node_id)
-            body.after_node_id = after_node_id;
-        const result = await callApi(`/forms/${form_id}/nodes`, {
-            method: "POST",
-            body,
-            token: edit_token,
-        });
-        if (!result.ok) {
-            return errorResult(result.error);
-        }
-        const confirmMsg = [
-            `Node added successfully!`,
-            `Node ID: ${result.data.node_id}`,
-            `Type: ${question.type}`,
-            `Prompt: ${question.prompt}`,
-        ].join("\n");
-        const formState = await fetchAndFormatFormState(form_id, edit_token);
-        return textResult(formState ? `${confirmMsg}\n\n---\n\n${formState}` : confirmMsg);
-    });
-}
-//# sourceMappingURL=add-node.js.map

package/dist/tools/add-node.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"add-node.js","sourceRoot":"","sources":["../../src/tools/add-node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE;;EAEjB,sBAAsB;;4FAEoE;QACtF,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,uFAAuF,CAAC;YAC5H,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kIAAkI,CAAC;YAC9K,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YAChD,aAAa,EAAE,CAAC;iBACb,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,kEAAkE,CACnE;SACJ;QACD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,EAAE;QACzD,MAAM,IAAI,GAA4B,EAAE,QAAQ,EAAE,CAAC;QACnD,IAAI,aAAa;YAAE,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QAEtD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,OAAO,QAAQ,EAAE;YACtD,MAAM,EAAE,MAAM;YACd,IAAI;YACJ,KAAK,EAAE,UAAU;SAClB,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,UAAU,GAAG;YACjB,0BAA0B;YAC1B,YAAY,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;YACjC,SAAS,QAAQ,CAAC,IAAI,EAAE;YACxB,WAAW,QAAQ,CAAC,MAAM,EAAE;SAC7B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACrE,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,UAAU,cAAc,SAAS,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACrF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/attach-node-audio.d.ts

@@ -1,2 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerAttachNodeAudioTool(server: McpServer): void;

package/dist/tools/attach-node-audio.js

@@ -1,37 +0,0 @@
-import { z } from "zod";
-import { callApi, errorResult, textResult } from "../lib/api-client.js";
-export function registerAttachNodeAudioTool(server) {
-    server.registerTool("clipform_attach_audio", {
-        title: "Attach Audio to Node",
-        description: `Attach a sound effect or audio file to a node with existing media (stills only). The audio auto-plays once when a respondent reaches this node. Provide a public URL to the audio file (WAV, MP3, or OGG). The node must already have media uploaded (use clipform_upload_node_media first).`,
-        inputSchema: {
-            form_id: z.string().uuid().describe("The form UUID (returned by clipform_create_form, not the short share_id from the URL)"),
-            edit_token: z.string().optional().describe("The edit token. Required for anonymous (non-OAuth) sessions; omit when connected via an authenticated MCP client like claude.ai."),
-            node_id: z
-                .string()
-                .describe("The node ID (must already have media attached)"),
-            url: z
-                .string()
-                .url()
-                .describe("Public URL to the audio file (WAV, MP3, or OGG)"),
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true,
-        },
-    }, async ({ form_id, edit_token, node_id, url }) => {
-        const result = await callApi(`/forms/${form_id}/nodes/${node_id}/audio`, {
-            method: "PUT",
-            token: edit_token,
-            body: { url },
-        });
-        if (!result.ok) {
-            return errorResult(result.error);
-        }
-        return textResult(`Audio attached to node ${node_id}.\n` +
-            `Audio path: ${result.data.audio_storage_path}`);
-    });
-}
-//# sourceMappingURL=attach-node-audio.js.map

package/dist/tools/attach-node-audio.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"attach-node-audio.js","sourceRoot":"","sources":["../../src/tools/attach-node-audio.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAExE,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,8RAA8R;QAC3S,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,uFAAuF,CAAC;YAC5H,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kIAAkI,CAAC;YAC9K,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,CAAC,gDAAgD,CAAC;YAC7D,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,CAAC,iDAAiD,CAAC;SAC/D;QACD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE;QAC9C,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,UAAU,OAAO,UAAU,OAAO,QAAQ,EAC1C;YACE,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,EAAE,GAAG,EAAE;SACd,CACF,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,UAAU,CACf,0BAA0B,OAAO,KAAK;YACpC,eAAe,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAClD,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/check-render.d.ts

@@ -1,2 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerCheckRenderTool(server: McpServer): void;

package/dist/tools/check-render.js

@@ -1,47 +0,0 @@
-import { z } from "zod";
-import { errorResult, textResult } from "../lib/api-client.js";
-import { getJob, pruneJobs } from "../lib/render-jobs.js";
-export function registerCheckRenderTool(server) {
-    server.registerTool("clipform_check_render", {
-        title: "Check Render Status",
-        description: `Check the status of a render job started by clipform_generate_video, clipform_generate_slideshow, or clipform_render_composition.
-
-Returns the current status and, when complete, the output URL. If still rendering, wait ~30 seconds before checking again.`,
-        inputSchema: {
-            job_id: z.string().uuid().describe("The job ID returned by the render tool"),
-        },
-        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
-    }, async ({ job_id }) => {
-        pruneJobs();
-        const job = getJob(job_id);
-        if (!job) {
-            return errorResult(`No render job found with ID ${job_id}. Jobs expire after 30 minutes.`);
-        }
-        if (job.status === "rendering") {
-            const elapsed = Math.round((Date.now() - job.createdAt) / 1000);
-            return textResult([
-                `Status: rendering (${elapsed}s elapsed)`,
-                `Tool: ${job.tool}`,
-                ``,
-                `Still in progress. Check again in ~30 seconds.`,
-            ].join("\n"));
-        }
-        if (job.status === "failed") {
-            return errorResult(`Render failed: ${job.error}`);
-        }
-        const data = job.result;
-        return textResult([
-            `Status: complete`,
-            `Tool: ${job.tool}`,
-            ``,
-            ...(data.public_url ? [`Public URL: ${data.public_url}`] : []),
-            ...(data.storage_path ? [`Storage path: ${data.storage_path}`] : []),
-            ...(data.duration_seconds ? [`Duration: ${data.duration_seconds}s`] : []),
-            ...(data.outputPath ? [`Output: ${data.outputPath}`] : []),
-            ...(data.format ? [`Format: ${data.format}`] : []),
-            ``,
-            `Use clipform_upload_node_media with the public URL to attach this video to a node.`,
-        ].join("\n"));
-    });
-}
-//# sourceMappingURL=check-render.js.map

package/dist/tools/check-render.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"check-render.js","sourceRoot":"","sources":["../../src/tools/check-render.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE;;2HAEwG;QACrH,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;SAC7E;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KACxG,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,SAAS,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAE3B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,WAAW,CAAC,+BAA+B,MAAM,iCAAiC,CAAC,CAAC;QAC7F,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;YAChE,OAAO,UAAU,CACf;gBACE,sBAAsB,OAAO,YAAY;gBACzC,SAAS,GAAG,CAAC,IAAI,EAAE;gBACnB,EAAE;gBACF,gDAAgD;aACjD,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;QACJ,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,WAAW,CAAC,kBAAkB,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,IAAI,GAAG,GAAG,CAAC,MAAa,CAAC;QAC/B,OAAO,UAAU,CACf;YACE,kBAAkB;YAClB,SAAS,GAAG,CAAC,IAAI,EAAE;YACnB,EAAE;YACF,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAClD,EAAE;YACF,oFAAoF;SACrF,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/create-form.d.ts

@@ -1,2 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerCreateFormTool(server: McpServer): void;