@impractical-ai/motion 0.1.16 → 0.1.18

package/dist/chunk-M6427SHW.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+import {
+  external_exports
+} from "./chunk-QQ6NYC74.js";
+import {
+  invoke
+} from "./chunk-FTSZCIMV.js";
+
+// src/mcp/template-source.ts
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve, sep } from "node:path";
+var SLUG = /^[a-z0-9][a-z0-9-]{0,119}$/;
+async function fetchTemplate(slug, call) {
+  if (!SLUG.test(slug)) throw new Error(`"${slug}" isn't a template slug (lowercase letters, digits and dashes)`);
+  return call("atelier-library", { action: "film-source", slug });
+}
+var readingOrder = (paths) => [...paths].sort((a, b) => rank(a) - rank(b) || a.localeCompare(b));
+var rank = (path) => path === "direction.ts" ? 0 : path === "App.tsx" ? 1 : path.startsWith("kit/") ? 3 : 2;
+var templateSourceTool = {
+  name: "template_source",
+  title: "Read a template\u2019s code",
+  description: "The source of a template from the Impractical template library (by its slug, as the Studio or a prompt names it): direction.ts (its choreography: timing, eases, camera, transitions), App.tsx (its set and components) and the rest of its files. Call it whenever someone gives you a template to work from, and study how it is built and moves before you plan. Adapt its structure and motion to the new video; never copy its content.",
+  inputSchema: {
+    slug: external_exports.string().describe('The template\u2019s slug, e.g. "framer-cms-list-replica".')
+  },
+  // read-only library browsing: admitted (unmetered) as the library's other lookups are
+  admitAs: "atelier_study",
+  handler: async (args, ctx) => {
+    const source = await fetchTemplate(String(args.slug ?? ""), ctx.invoke);
+    const paths = readingOrder(Object.keys(source.files));
+    const kits = paths.filter((p) => p.startsWith("kit/"));
+    const shown = paths.filter((p) => !p.startsWith("kit/"));
+    return {
+      text: `TEMPLATE ${args.slug}: ${paths.length} file(s). Read direction.ts first (how it moves), then App.tsx (what it shows).` + (kits.length ? ` Kits it uses (install_kits provides them): ${kits.join(", ")}.` : "") + "\n\n" + shown.map((p) => `=== ${p} ===
+${source.files[p]}`).join("\n\n")
+    };
+  }
+};
+function rankTemplates(items, query) {
+  const films = items.filter((item) => item.kind === "film");
+  const words = query.toLowerCase().split(/[^a-z0-9]+/).filter((word) => word.length > 1);
+  if (!words.length) return films;
+  const score = (item) => {
+    const name = `${item.title} ${item.slug}`.toLowerCase();
+    const about = `${item.creator ?? ""} ${item.description ?? ""}`.toLowerCase();
+    return words.reduce((sum, word) => sum + (name.includes(word) ? 3 : 0) + (about.includes(word) ? 1 : 0), 0);
+  };
+  return films.map((item) => ({ item, score: score(item) })).filter((x) => x.score > 0).sort((a, b) => b.score - a.score).map((x) => x.item);
+}
+var templateSearchTool = {
+  name: "template_search",
+  title: "Find a template",
+  description: 'Search the Impractical template library (the Studio\u2019s templates: complete films, many of them replicas of real launch films such as Notion Mail, Attio or Framer) by name or words, and get each match\u2019s slug. Use it when someone mentions a template, a film in the library, or "the X one", then read the one they mean with template_source. Leave the query empty to list them all.',
+  inputSchema: {
+    query: external_exports.string().max(200).optional().describe('Words from the template\u2019s name or what it shows, e.g. "notion mail" or "attio sequences".')
+  },
+  // read-only library browsing: admitted (unmetered) as the library's other lookups are
+  admitAs: "atelier_study",
+  handler: async (args, ctx) => {
+    const { items } = await ctx.invoke("atelier-library", { action: "catalog" });
+    const query = String(args.query ?? "");
+    const found = rankTemplates(items ?? [], query).slice(0, 25);
+    if (!found.length) {
+      return { text: `No template matches "${query}". Call template_search with no query to see them all.` };
+    }
+    const lines = found.map(
+      (item) => `- ${item.slug}: ${item.title}${item.durationSeconds ? ` (${Math.round(item.durationSeconds)}s)` : ""}` + (item.description ? ` \u2014 ${item.description.slice(0, 200)}` : "")
+    );
+    return {
+      text: `${found.length} template(s)${query ? ` for "${query}"` : ""}, best match first:
+${lines.join("\n")}
+
+Read the one meant with template_source({ slug }).`
+    };
+  }
+};
+async function templateSourceCommand(slug, dir) {
+  if (!slug || !dir) throw new Error("Usage: impractical template-source <slug> --dir <folder>");
+  const source = await fetchTemplate(slug, invoke);
+  const root = resolve(dir);
+  const written = [];
+  for (const path of readingOrder(Object.keys(source.files))) {
+    const target = resolve(root, path);
+    if (!target.startsWith(root + sep)) continue;
+    mkdirSync(dirname(target), { recursive: true });
+    writeFileSync(target, source.files[path]);
+    written.push(path);
+  }
+  return written.join("\n");
+}
+
+export {
+  templateSourceTool,
+  rankTemplates,
+  templateSearchTool,
+  templateSourceCommand
+};