volito 0.3.0 → 0.3.1

package/README.md

@@ -67,7 +67,7 @@ stills, contact sheets and PNG frames do not. WebM needs an ffmpeg built with li
 
 ## The packs
 
-<img src=".github/assets/packs.jpg" alt="96 graphics in 10 packs: a render from each of Essentials, Broadcast, Social, Data, 3D, Transitions, Annotate, Type, Backdrops and Promo" width="100%">
+<img src=".github/assets/packs.jpg" alt="107 graphics in 12 packs: a render from each of Essentials, Broadcast, Social, Data, 3D, Transitions, Annotate, Type, Backdrops, Promo, UI and Effects" width="100%">
 
 107 graphics in twelve packs. Every one takes any brand style and any aspect, and every part of it takes any move.
 
@@ -293,7 +293,7 @@ Cursor, Windsurf and other MCP clients:
 | `motion_review` | timing, 9:16 platform safe zones and a contact sheet per aspect, measured before rendering |
 | `motion_api` | the program API and the motion kit, for writing new graphics |
 
-Every tool takes an `item`, your own `code` or a `spec` file, plus `motion`, `mood`, `seed` and `speed`. A ready-made agent skill is in `skills/volito/SKILL.md` — `npx volito init` installs it for Claude Code, `npx skills add monarcpro/volito` for other agents, or copy it
+The preview, still, check, review, render and sound tools take an `item`, your own `code` or a `spec` file, plus `motion`, `mood`, `seed` and `speed`. A ready-made agent skill is in `skills/volito/SKILL.md` — `npx volito init` installs it for Claude Code, `npx skills add monarcpro/volito` for other agents, or copy it
 to `~/.claude/skills/volito/` for Claude Code.
 
 ## Node API

package/dist/browser.js

@@ -5060,8 +5060,8 @@ function facesFor(all, wants, cps) {
 }
 
 // src/browser/index.ts
-var VERSION = "0.3.0";
-var CDN_BASE = `https://cdn.jsdelivr.net/npm/${"volito"}@${"0.3.0"}/`;
+var VERSION = "0.3.1";
+var CDN_BASE = `https://cdn.jsdelivr.net/npm/${"volito"}@${"0.3.1"}/`;
 var registries = /* @__PURE__ */ new Map();
 function loadRegistry(base = CDN_BASE) {
   const url = new URL("dist/registry.json", base).href;

package/dist/mcp.js

@@ -116,9 +116,26 @@ var failure = (err) => ({ isError: true, content: [{ type: "text", text: String(
 var warnings = (w) => w.length ? `
 Warnings:
 ${w.map((x) => `- ${x}`).join("\n")}` : "";
+function mcpInstructions(packs) {
+  const total = packs.reduce((n, p) => n + p.entries.length, 0);
+  return [
+    "Volito renders brand-aware motion graphics to video files with alpha: lower thirds, titles, kinetic type, charts and maps, 3D, transitions, annotations, backgrounds, promos, UI micro-interactions and filter effects.",
+    "Find one with motion_list, read its props and parts with motion_info, look at it with motion_preview (a contact sheet image), measure its timing and 9:16 safe zones with motion_review, then motion_render to a file.",
+    packs.length ? `${total} graphics in ${packs.length} packs: ${packs.map((p) => `${p.id} (${p.entries.length})`).join(", ")}; motion_list says what each one is.` : "",
+    "Motion is open-ended: any part takes any move, ease, idle, emphasis or keyframes (motion_moves lists them) through `motion`, and `mood` + `seed` give a new choreography for every seed.",
+    'The preview, still, check, review, render and sound tools take an `item`, your own `code`, or a Graphic spec (`spec`: a .json file with "volito": 1, or a .volito bundle) that keeps the whole recipe; motion_validate checks a spec before rendering.',
+    "To make something no item covers, write a program against motion_api (it includes 3D scenes and world maps) and use the same tools with `code`.",
+    "Every render can carry sound Volito synthesises itself (motion_render with sound: true, or motion_sound for the track alone): a program's own sound($) cues, else the right pops, whooshes, ticks and hits read from its motion."
+  ].filter(Boolean).join(" ");
+}
 function createMcpServer(opts = {}) {
   const lib = () => library(opts.packs ?? []);
-  const server = new McpServer({ name: "volito", version: packageVersion() }, { instructions: "Volito renders brand-aware motion graphics (lower thirds, titles, CTAs, stats, lists, end cards\u2026) to video files with alpha. Find one with motion_list, read its props and parts with motion_info, look at it with motion_preview (a contact sheet image), then motion_render to a file. Motion is open-ended: any part takes any move, ease, idle, emphasis or keyframes (motion_moves lists them) through `motion`, and `mood` + `seed` give a new choreography for every seed. Packs: essentials, broadcast (lower thirds, tickers, score bugs), social (follow cards, notifications, chat), data (charts, maps, flight routes) and 3d (extruded logos and titles, card flips, globes). To make something no item covers, write a program against motion_api (it includes 3D scenes and world maps) and use the same tools with `code`. Every render can carry sound Volito synthesises itself (motion_render with sound: true, or motion_sound for the track alone): a program's own sound($) cues, else the right pops, whooshes, ticks and hits read from its motion." });
+  let packs = [];
+  try {
+    packs = lib().packs;
+  } catch {
+  }
+  const server = new McpServer({ name: "volito", version: packageVersion() }, { instructions: mcpInstructions(packs) });
   server.registerTool(
     "motion_list",
     { title: "List motion graphics", description: "The graphics in the packs: ref, overlay or full frame, default length, what it is.", inputSchema: { search: z.string().optional().describe("Words to match (e.g. 'name', 'subscribe', 'chart')."), category: z.enum(CATEGORIES).optional() } },
@@ -340,5 +357,6 @@ async function runMcpServer(opts = {}) {
 }
 export {
   createMcpServer,
+  mcpInstructions,
   runMcpServer
 };

package/dist/player.js

@@ -5015,8 +5015,8 @@ function facesFor(all, wants, cps) {
 }
 
 // src/browser/index.ts
-var VERSION = "0.3.0";
-var CDN_BASE = `https://cdn.jsdelivr.net/npm/${"volito"}@${"0.3.0"}/`;
+var VERSION = "0.3.1";
+var CDN_BASE = `https://cdn.jsdelivr.net/npm/${"volito"}@${"0.3.1"}/`;
 var registries = /* @__PURE__ */ new Map();
 function loadRegistry(base = CDN_BASE) {
   const url = new URL("dist/registry.json", base).href;