@viralspin/mcp 0.2.0 → 0.2.2

package/src/client.ts

@@ -1,119 +0,0 @@
-import fs from "fs";
-import path from "path";
-
-const API_URL = (process.env.VIRALSPIN_API_URL || "https://viralspinbackend.onrender.com").replace(/\/$/, "");
-// Python backend — Higgsfield, review-sessions, OAuth, narrative-render
-const PY_API_URL = (process.env.VIRALSPIN_PY_API_URL || "https://viralspin-api.onrender.com").replace(/\/$/, "");
-const API_KEY = process.env.VIRALSPIN_API_KEY || "";
-// OAuth token takes precedence over API key (set after "Sign in with ViralSpin" flow)
-const OAUTH_TOKEN = process.env.VIRALSPIN_OAUTH_TOKEN || "";
-
-if (!API_KEY && !OAUTH_TOKEN) {
-  process.stderr.write("[viralspin-mcp] Warning: Neither VIRALSPIN_API_KEY nor VIRALSPIN_OAUTH_TOKEN is set\n");
-}
-
-function headers(extra: Record<string, string> = {}): Record<string, string> {
-  // OAuth Bearer token (from "Sign in with ViralSpin" flow) takes priority
-  if (OAUTH_TOKEN) {
-    return { "Authorization": `Bearer ${OAUTH_TOKEN}`, ...extra };
-  }
-  // Legacy API key — retained for backward compatibility with personal installs
-  return { "X-API-Key": API_KEY, ...extra };
-}
-
-async function apiFetch<T>(endpoint: string, init: RequestInit = {}, base = API_URL): Promise<T> {
-  const url = `${base}${endpoint}`;
-  const resp = await fetch(url, {
-    ...init,
-    headers: { ...(init.headers as Record<string, string> ?? {}), ...headers() },
-  });
-  if (!resp.ok) {
-    const text = await resp.text().catch(() => "");
-    let detail = text;
-    try { detail = JSON.parse(text).detail ?? text; } catch {}
-    throw new Error(`API error ${resp.status}: ${detail}`);
-  }
-  return resp.json() as Promise<T>;
-}
-
-export function get<T>(endpoint: string): Promise<T> {
-  return apiFetch<T>(endpoint, { method: "GET" });
-}
-
-export function post<T>(endpoint: string, body: unknown): Promise<T> {
-  return apiFetch<T>(endpoint, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify(body),
-  });
-}
-
-/** Python backend helpers — for routes that live in viralspin-api (Higgsfield, OAuth, etc.) */
-export function pyGet<T>(endpoint: string): Promise<T> {
-  return apiFetch<T>(endpoint, { method: "GET" }, PY_API_URL);
-}
-
-export function pyPost<T>(endpoint: string, body: unknown): Promise<T> {
-  return apiFetch<T>(endpoint, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify(body),
-  }, PY_API_URL);
-}
-
-export function del<T>(endpoint: string, body?: unknown): Promise<T> {
-  return apiFetch<T>(endpoint, {
-    method: "DELETE",
-    headers: body ? { "Content-Type": "application/json" } : {},
-    body: body ? JSON.stringify(body) : undefined,
-  });
-}
-
-/** Upload one or more local files. Returns { url, storage_path } or { urls, storage_paths } */
-export async function uploadFiles(filePaths: string[]): Promise<{ urls: string[]; storage_paths: string[] }> {
-  // Use the native Web FormData + Blob (Node 18+). The npm 'form-data' package
-  // streams in a way native fetch can't serialize correctly, which previously
-  // caused Busboy on the backend to fail with "Failed to parse upload".
-  const form = new FormData();
-  const fieldName = filePaths.length === 1 ? "file" : "files";
-  for (const fp of filePaths) {
-    const buffer = await fs.promises.readFile(fp);
-    const ext = path.extname(fp).toLowerCase();
-    const mime =
-      ext === ".png" ? "image/png" :
-      ext === ".jpg" || ext === ".jpeg" ? "image/jpeg" :
-      ext === ".gif" ? "image/gif" :
-      ext === ".webp" ? "image/webp" :
-      ext === ".mp4" ? "video/mp4" :
-      ext === ".mov" ? "video/quicktime" :
-      ext === ".webm" ? "video/webm" :
-      "application/octet-stream";
-    const blob = new Blob([buffer], { type: mime });
-    form.append(fieldName, blob, path.basename(fp));
-  }
-
-  const authHeader: Record<string, string> = OAUTH_TOKEN
-    ? { "Authorization": `Bearer ${OAUTH_TOKEN}` }
-    : { "X-API-Key": API_KEY };
-  const resp = await fetch(`${API_URL}/v1/media/upload`, {
-    method: "POST",
-    // Don't set Content-Type manually — fetch will set it with the correct multipart boundary.
-    headers: authHeader,
-    body: form,
-  });
-  if (!resp.ok) {
-    const text = await resp.text().catch(() => "");
-    let detail = text;
-    try { detail = JSON.parse(text).detail ?? text; } catch {}
-    throw new Error(`Upload failed ${resp.status}: ${detail}`);
-  }
-  const data = await resp.json() as { url?: string; storage_path?: string; urls?: string[]; storage_paths?: string[] };
-  if (data.urls) return { urls: data.urls, storage_paths: data.storage_paths! };
-  return { urls: [data.url!], storage_paths: [data.storage_path!] };
-}
-
-/** Delete uploaded files from storage (cleanup after publish) */
-export async function deleteFiles(storagePaths: string[]): Promise<void> {
-  if (!storagePaths.length) return;
-  await del(`/v1/media/${storagePaths[0]}`, storagePaths.length > 1 ? { storage_paths: storagePaths } : undefined);
-}

package/src/index.ts

@@ -1,151 +0,0 @@
-#!/usr/bin/env node
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema,
-  ListPromptsRequestSchema,
-  GetPromptRequestSchema,
-} from "@modelcontextprotocol/sdk/types.js";
-
-import { listConnectionsTool } from "./tools/connections.js";
-import { publishNowTool, schedulePostTool, sendToDraftsTool } from "./tools/publish.js";
-import { publishCarouselAsVideoTool } from "./tools/carousel-video.js";
-import { createVideoAssemblyTool } from "./tools/video-assembly.js";
-import { startPhotoPickerTool } from "./tools/photo-picker.js";
-import { suggestClipsTool, swapClipTool, swapCaptionStyleTool } from "./tools/assembly-adjust.js";
-import { listPostsTool, cancelPostTool } from "./tools/posts.js";
-import { generateCaptionTool } from "./tools/captions.js";
-import { setKeywordLinkTool, listKeywordLinksTool, deleteKeywordLinkTool } from "./tools/engage.js";
-import { indexExplainerSourcesTool } from "./tools/explainer-index.js";
-import { createKineticTextTool } from "./tools/kinetic-text.js";
-import { createReviewLinkTool, checkReviewStatusTool } from "./tools/review.js";
-import { prepareProductAssetTool, assembleImageAdTool, publishToMetaTool } from "./tools/image-ads.js";
-
-const tools = [
-  listConnectionsTool,
-  publishNowTool,
-  schedulePostTool,
-  sendToDraftsTool,
-  publishCarouselAsVideoTool,
-  createVideoAssemblyTool,
-  startPhotoPickerTool,
-  suggestClipsTool,
-  swapClipTool,
-  swapCaptionStyleTool,
-  listPostsTool,
-  cancelPostTool,
-  generateCaptionTool,
-  setKeywordLinkTool,
-  listKeywordLinksTool,
-  deleteKeywordLinkTool,
-  indexExplainerSourcesTool,
-  createKineticTextTool,
-  createReviewLinkTool,
-  checkReviewStatusTool,
-  prepareProductAssetTool,
-  assembleImageAdTool,
-  publishToMetaTool,
-];
-
-// Shown to the user as the welcome / getting-started message. The agent fills in
-// <picker link> by calling start_photo_picker (per ONBOARDING below).
-const SAMPLE_COMMANDS = [
-  '1. Make a video:  "Turn my A-roll at C:/clips/talk.mp4 into a 9:16 short, using B-roll from C:/my-broll and my Google Photos."',
-  '2. Publish it:    "Publish that video to TikTok and Instagram with the caption: posting through the chaos."',
-].join("\n");
-
-const WELCOME = [
-  "Welcome to ViralSpin. I turn a talking-head A-roll into a polished vertical short —",
-  "B-roll cutaways matched to what you say, captions, a hook headline, and keyword pops —",
-  "then publish it to TikTok, Instagram, or YouTube. B-roll can be local files, a local",
-  "folder (auto-indexed), public URLs, and/or your Google Photos.",
-  "",
-  "Two commands to get you started:",
-  SAMPLE_COMMANDS,
-].join("\n");
-
-// Auto-injected into the agent's context when the server connects. Drives proactive onboarding.
-const INSTRUCTIONS = [
-  "ViralSpin assembles A-roll + B-roll into polished vertical shorts and publishes them to TikTok/Instagram/YouTube.",
-  "",
-  "ONBOARDING: The FIRST time you help the user with ViralSpin in a session, proactively onboard them:",
-  "(1) give the short intro below, (2) CALL start_photo_picker so they get a live Google Photos B-roll picker link, and",
-  "(3) show these two sample commands verbatim:",
-  SAMPLE_COMMANDS,
-  "",
-  "HOW B-ROLL WORKS: create_video_assembly accepts local file paths, a local FOLDER (auto-expanded and indexed),",
-  "public URLs, and Google Photos. For Google Photos: call start_photo_picker → it returns a browser link + sessionId;",
-  "the user picks in their browser (Google forbids listing albums programmatically), then call create_video_assembly",
-  "with google_picker_session set to that sessionId. Pass style_ref (a reference video) to auto-infer captions/hook/pace/aspect.",
-  "After rendering, publish with publish_now or schedule_post.",
-].join("\n");
-
-const server = new Server(
-  { name: "viralspin", version: "0.1.0" },
-  { capabilities: { tools: {}, prompts: {} }, instructions: INSTRUCTIONS }
-);
-
-server.setRequestHandler(ListPromptsRequestSchema, async () => ({
-  prompts: [
-    {
-      name: "getting_started",
-      description:
-        "Welcome + how to use ViralSpin: intro, a Google Photos B-roll picker link, and two sample commands.",
-    },
-  ],
-}));
-
-server.setRequestHandler(GetPromptRequestSchema, async (req) => {
-  if (req.params.name !== "getting_started") {
-    throw new Error(`Unknown prompt: ${req.params.name}`);
-  }
-  return {
-    messages: [
-      {
-        role: "user",
-        content: {
-          type: "text",
-          text:
-            WELCOME +
-            "\n\nNow call start_photo_picker and include the returned Google Photos picker link in your reply, " +
-            "so I can pick B-roll. Keep the two sample commands above in your reply.",
-        },
-      },
-    ],
-  };
-});
-
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-  tools: tools.map((t) => ({
-    name: t.name,
-    description: t.description,
-    inputSchema: t.inputSchema,
-  })),
-}));
-
-server.setRequestHandler(CallToolRequestSchema, async (req) => {
-  const tool = tools.find((t) => t.name === req.params.name);
-  if (!tool) {
-    return { content: [{ type: "text", text: `Unknown tool: ${req.params.name}` }], isError: true };
-  }
-
-  try {
-    const result = await tool.execute(req.params.arguments as never);
-    return { content: [{ type: "text", text: String(result) }] };
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    return { content: [{ type: "text", text: `Error: ${msg}` }], isError: true };
-  }
-});
-
-async function main() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  process.stderr.write("[viralspin-mcp] Server started\n");
-}
-
-main().catch((err) => {
-  process.stderr.write(`[viralspin-mcp] Fatal: ${err}\n`);
-  process.exit(1);
-});

package/src/tools/assembly-adjust.ts

@@ -1,110 +0,0 @@
-import { spawn } from "child_process";
-import path from "path";
-
-// Adjustment tools operate on the most recent create_video_assembly project (the engine keeps the
-// timeline + analyzed candidate pool + staged clips on disk), so suggesting is instant and swapping
-// just re-renders. Same engine dir as create_video_assembly.
-const ENGINE_DIR =
-  process.env.VIRALSPIN_ASSEMBLY_DIR || "E:/AI test/carissa bot/assembly-engine";
-
-function runEngine(args: string[]): Promise<string> {
-  return new Promise((resolve, reject) => {
-    const child = spawn(process.platform === "win32" ? "node.exe" : "node",
-      [path.join(ENGINE_DIR, "assemble.mjs"), ...args],
-      { cwd: ENGINE_DIR, env: { ...process.env } });
-    let stdout = "";
-    child.stdout.on("data", (d) => { stdout += d.toString(); });
-    child.stderr.on("data", (d) => process.stderr.write(d));
-    child.on("error", reject);
-    child.on("close", (code) => (code === 0 ? resolve(stdout) : reject(new Error(`engine exited ${code}. ${stdout.slice(-300)}`))));
-  });
-}
-
-export const suggestClipsTool = {
-  name: "suggest_clips",
-  description:
-    "Get ranked alternative B-roll for one cutaway in the most recently assembled video (from create_video_assembly). " +
-    "Returns options ranked by how well they fit that moment's transcript, each with a thumbnail image path you can open. " +
-    "Then call swap_clip to apply a choice. Instant — reuses the cached analysis, no re-render.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      cut: { type: "number", description: "Index of the cutaway to replace (0-based; from the cut list create_video_assembly returns)." },
-    },
-    required: ["cut"],
-  },
-  async execute(args: { cut: number }): Promise<string> {
-    const out = await runEngine(["--suggest", String(args.cut)]);
-    const m = out.match(/SUGGEST:(.+)/);
-    if (!m) throw new Error("no suggestions returned");
-    const d = JSON.parse(m[1]);
-    const lines = (d.options || []).map(
-      (o: { asset: string; kind: string; desc: string; thumb: string }, i: number) =>
-        `${i + 1}. ${o.asset} (${o.kind}) — ${o.desc || "no description"}\n   thumbnail: ${o.thumb}`
-    );
-    return [
-      `Cut #${d.cut} (currently: ${d.current})${d.beat ? ` · line: "${d.beat}"` : ""}`,
-      `Ranked alternatives:`,
-      ...lines,
-      ``,
-      `Apply one with: swap_clip(cut: ${d.cut}, asset: "<asset>").`,
-    ].join("\n");
-  },
-};
-
-export const swapClipTool = {
-  name: "swap_clip",
-  description:
-    "Replace one cutaway in the most recently assembled video with a chosen B-roll asset (from suggest_clips), then re-render. " +
-    "Returns the path to the updated MP4.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      cut: { type: "number", description: "Index of the cutaway to replace (0-based)." },
-      asset: { type: "string", description: "Asset filename from suggest_clips (e.g. \"v03.mp4\" or \"07.jpg\")." },
-    },
-    required: ["cut", "asset"],
-  },
-  async execute(args: { cut: number; asset: string }): Promise<string> {
-    const out = await runEngine(["--swap", String(args.cut), args.asset]);
-    const m = out.match(/RESULT:(.+)/);
-    if (!m) throw new Error(`swap failed. ${out.slice(-300)}`);
-    return `Swapped cut #${args.cut} → ${args.asset} and re-rendered.\nOutput: ${m[1].trim()}`;
-  },
-};
-
-export const swapCaptionStyleTool = {
-  name: "swap_caption_style",
-  description:
-    "Change the caption style of the most recently assembled video and re-render. " +
-    "Uses the cached edit data — much faster than a full re-assembly (no re-transcription, no B-roll re-analysis). " +
-    "Styles: default (bold white spring pop), hormozi (word-by-word yellow highlight), glow_neon (neon cyan pulse), " +
-    "minimalist (lowercase clean fade), whiteboard (left-to-right reveal).",
-  inputSchema: {
-    type: "object",
-    properties: {
-      caption_style: {
-        type: "string",
-        enum: ["default", "hormozi", "glow_neon", "minimalist", "whiteboard"],
-        description:
-          "Caption style to apply. " +
-          "default = bold white pop-in (universal). " +
-          "hormozi = word-by-word yellow highlight on black pill (high-energy talking-head). " +
-          "glow_neon = neon cyan pulsing text (dark aesthetic, music, gaming). " +
-          "minimalist = lowercase thin font fade-in (calm, educational). " +
-          "whiteboard = text revealed left-to-right (explainers, tutorials).",
-      },
-    },
-    required: ["caption_style"],
-  },
-  async execute(args: { caption_style: string }): Promise<string> {
-    const out = await runEngine(["--caption-style", args.caption_style, "--swap-caption-style"]);
-    const m = out.match(/RESULT:(.+)/);
-    if (!m) throw new Error(`caption style swap failed. ${out.slice(-300)}`);
-    return (
-      `Caption style changed to "${args.caption_style}" and re-rendered.\n` +
-      `Output: ${m[1].trim()}\n` +
-      `Publish with publish_now or schedule_post.`
-    );
-  },
-};

package/src/tools/captions.ts

@@ -1,32 +0,0 @@
-import { post } from "../client.js";
-
-interface CaptionResponse {
-  caption: string;
-  hashtags: string[];
-}
-
-export const generateCaptionTool = {
-  name: "generate_caption",
-  description: "Generate an AI caption and hashtags for a post on a specific platform.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      title: { type: "string", description: "Video or content title/description." },
-      platform: {
-        type: "string",
-        enum: ["tiktok", "instagram", "youtube"],
-        description: "Target platform.",
-      },
-    },
-    required: ["title", "platform"],
-  },
-
-  async execute(args: { title: string; platform: string }) {
-    const data = await post<CaptionResponse>("/v1/publish/generate-caption", {
-      video_title: args.title,
-      platform: args.platform,
-    });
-    const tags = data.hashtags.map((h) => `#${h.replace(/^#/, "")}`).join(" ");
-    return `Caption:\n${data.caption}\n\nHashtags:\n${tags}`;
-  },
-};

package/src/tools/carousel-video.ts

@@ -1,211 +0,0 @@
-/**
- * publish_carousel_as_video — convert image slides into a slideshow MP4 and publish.
- *
- * Solves two real platform constraints:
- *   1. TikTok rejects PHOTO carousels in MEDIA_UPLOAD (draft) mode — but accepts
- *      VIDEO drafts via the inbox endpoint. Converting first lets users send a
- *      slideshow to TikTok drafts and add trending music in-app before publishing.
- *   2. Neither TikTok nor Instagram allows attaching a custom audio file to a
- *      PHOTO carousel via API. Baking the audio into a video sidesteps that.
- *
- * Requires ffmpeg on PATH locally.
- */
-import fs from "fs";
-import path from "path";
-import os from "os";
-import { spawnSync } from "child_process";
-import { post, uploadFiles, deleteFiles } from "../client.js";
-
-const IMAGE_EXTS = new Set([".jpg", ".jpeg", ".png", ".gif", ".webp"]);
-
-function expandImagePaths(inputs: string[]): string[] {
-  const result: string[] = [];
-  for (const p of inputs) {
-    const stat = fs.statSync(p, { throwIfNoEntry: false });
-    if (!stat) throw new Error(`Path not found: ${p}`);
-    if (stat.isDirectory()) {
-      const files = fs.readdirSync(p)
-        .filter((f) => IMAGE_EXTS.has(path.extname(f).toLowerCase()))
-        .sort()
-        .map((f) => path.join(p, f));
-      result.push(...files);
-    } else if (IMAGE_EXTS.has(path.extname(p).toLowerCase())) {
-      result.push(p);
-    }
-  }
-  return result;
-}
-
-function ensureFfmpeg(): void {
-  const r = spawnSync("ffmpeg", ["-version"], { encoding: "utf8" });
-  if (r.error || r.status !== 0) {
-    throw new Error(
-      "ffmpeg is required for slideshow generation but was not found on PATH.\n" +
-      "Install instructions:\n" +
-      "  Windows : winget install Gyan.FFmpeg   (or download from https://ffmpeg.org/download.html)\n" +
-      "  macOS   : brew install ffmpeg\n" +
-      "  Linux   : sudo apt install ffmpeg\n" +
-      "After installing, restart Claude Code so the new PATH is picked up."
-    );
-  }
-}
-
-interface PublishResult {
-  post: { id: string; status: string; platform_post_ids: Record<string, string>; failed_reason?: string };
-}
-
-export const publishCarouselAsVideoTool = {
-  name: "publish_carousel_as_video",
-  description:
-    "Convert a folder of images into a 1080×1920 slideshow MP4 and publish it. " +
-    "Use this when (a) you want the carousel as a TikTok DRAFT (TikTok's API rejects PHOTO carousels for drafts but accepts VIDEO drafts so the user can add trending music in-app), " +
-    "or (b) you want to attach a specific MP3 to the carousel (TikTok/IG don't allow audio attachment to photo posts via API, but a video with baked-in audio works). " +
-    "Requires ffmpeg installed locally. Returns a single video post, not a carousel post.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      paths: {
-        type: "array",
-        items: { type: "string" },
-        description: "Folder containing slide images, or a list of image file paths. Files are sorted alphabetically — name them 01_, 02_, etc. for ordering.",
-      },
-      platforms: {
-        type: "array",
-        items: { type: "string", enum: ["tiktok", "instagram", "youtube"] },
-        description: "Platforms to publish to. Must be connected. For mode='draft', Instagram is not allowed (no IG drafts API).",
-      },
-      caption: { type: "string", description: "Post caption." },
-      hashtags: {
-        type: "array",
-        items: { type: "string" },
-        description: "Hashtags without # prefix.",
-      },
-      audio_path: {
-        type: "string",
-        description: "Optional. Local path to an MP3/WAV/M4A/AAC file to use as soundtrack. If omitted, the video has no audio (creator can add trending music in-app if mode='draft').",
-      },
-      duration_per_slide: {
-        type: "number",
-        description: "Optional. Seconds each slide is displayed. Defaults to 3.",
-      },
-      mode: {
-        type: "string",
-        enum: ["publish", "draft"],
-        description: "Optional. 'publish' (default) publishes immediately. 'draft' sends to TikTok inbox / YouTube as private — user finishes in mobile app.",
-      },
-    },
-    required: ["paths", "platforms", "caption"],
-  },
-
-  async execute(args: {
-    paths: string[];
-    platforms: string[];
-    caption: string;
-    hashtags?: string[];
-    audio_path?: string;
-    duration_per_slide?: number;
-    mode?: "publish" | "draft";
-  }) {
-    ensureFfmpeg();
-
-    const imagePaths = expandImagePaths(args.paths);
-    if (!imagePaths.length) throw new Error("No image files found in the provided paths.");
-
-    const mode = args.mode ?? "publish";
-    const duration = Math.max(0.5, args.duration_per_slide ?? 3);
-
-    if (mode === "draft" && args.platforms.includes("instagram")) {
-      throw new Error(
-        "Instagram does not support drafts via API. Remove 'instagram' from platforms or use mode='publish'."
-      );
-    }
-
-    if (args.audio_path && !fs.existsSync(args.audio_path)) {
-      throw new Error(`Audio file not found: ${args.audio_path}`);
-    }
-
-    // Build slideshow MP4 via ffmpeg concat demuxer.
-    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "viralspin-slideshow-"));
-    const concatFile = path.join(tmpDir, "concat.txt");
-    const outputPath = path.join(tmpDir, "slideshow.mp4");
-
-    // concat demuxer format: file '<path>'  +  duration N  per entry;
-    // last image must be re-listed without a duration so ffmpeg holds the final frame.
-    const escape = (p: string) => p.replace(/\\/g, "/").replace(/'/g, "'\\''");
-    const concatLines: string[] = [];
-    for (const img of imagePaths) {
-      concatLines.push(`file '${escape(img)}'`);
-      concatLines.push(`duration ${duration}`);
-    }
-    concatLines.push(`file '${escape(imagePaths[imagePaths.length - 1])}'`);
-    fs.writeFileSync(concatFile, concatLines.join("\n"));
-
-    const ffmpegArgs: string[] = [
-      "-y",
-      "-f", "concat",
-      "-safe", "0",
-      "-i", concatFile,
-    ];
-    if (args.audio_path) {
-      ffmpegArgs.push("-i", args.audio_path);
-    }
-    // Scale slides to fit 1080×1920 (TikTok/Reels native), pad edges black to preserve aspect.
-    ffmpegArgs.push(
-      "-vf", "scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2:black,format=yuv420p,fps=30",
-      "-c:v", "libx264",
-      "-preset", "fast",
-      "-crf", "23",
-      "-pix_fmt", "yuv420p",
-    );
-    if (args.audio_path) {
-      ffmpegArgs.push(
-        "-c:a", "aac",
-        "-b:a", "192k",
-        "-shortest",
-      );
-    } else {
-      ffmpegArgs.push("-an");
-    }
-    ffmpegArgs.push(outputPath);
-
-    const ffmpeg = spawnSync("ffmpeg", ffmpegArgs, { encoding: "utf8" });
-    if (ffmpeg.status !== 0) {
-      try { fs.unlinkSync(concatFile); fs.rmdirSync(tmpDir); } catch { /* ignore */ }
-      const stderr = (ffmpeg.stderr || "").split("\n").slice(-10).join("\n");
-      throw new Error(`ffmpeg failed (exit ${ffmpeg.status}):\n${stderr}`);
-    }
-
-    // Upload + publish.
-    let result: PublishResult;
-    let storagePaths: string[] = [];
-    try {
-      const upload = await uploadFiles([outputPath]);
-      storagePaths = upload.storage_paths;
-
-      result = await post<PublishResult>("/v1/publish/schedule", {
-        media_urls: upload.urls,
-        media_type: "video",
-        platforms: args.platforms,
-        caption: args.caption,
-        hashtags: args.hashtags ?? [],
-        publish_now: true,
-        mode,
-      });
-    } finally {
-      try { fs.unlinkSync(concatFile); fs.unlinkSync(outputPath); fs.rmdirSync(tmpDir); } catch { /* ignore */ }
-      if (storagePaths.length) await deleteFiles(storagePaths).catch(() => {});
-    }
-
-    const { status, platform_post_ids, failed_reason } = result.post;
-    const targets = Object.keys(platform_post_ids);
-    const totalSeconds = (imagePaths.length * duration).toFixed(1);
-    let summary = `Slideshow video built: ${imagePaths.length} images × ${duration}s = ${totalSeconds}s, 1080×1920, ${args.audio_path ? "with audio" : "silent"}.\nStatus: ${status}\n`;
-    if (targets.length) {
-      summary += mode === "draft"
-        ? `Sent to drafts on: ${targets.join(", ")}\nOpen the platform's mobile app to finish — add trending audio (if silent), adjust caption, then publish.`
-        : `Published to: ${targets.join(", ")}`;
-    }
-    if (failed_reason) summary += `\nErrors: ${failed_reason}`;
-    return summary.trim();
-  },
-};

package/src/tools/connections.ts

@@ -1,27 +0,0 @@
-import { get } from "../client.js";
-
-interface Connection {
-  id: string;
-  platform: string;
-  display_name: string;
-  username: string;
-  follower_count: number;
-  is_active: boolean;
-  connected_at: string;
-}
-
-export const listConnectionsTool = {
-  name: "list_connections",
-  description: "List your connected social media accounts (TikTok, Instagram, YouTube).",
-  inputSchema: { type: "object", properties: {}, required: [] },
-
-  async execute(_args: Record<string, unknown>) {
-    const connections = await get<Connection[]>("/v1/publish/connections");
-    if (!connections.length) {
-      return "No platforms connected yet. Visit https://www.viralspin.ai/spin/settings to connect your accounts.";
-    }
-    return connections
-      .map((c) => `${c.platform}: ${c.display_name} (${c.username}) — ${c.follower_count.toLocaleString()} followers`)
-      .join("\n");
-  },
-};