@olo-studio/studio-mcp 1.0.0 → 1.0.1

package/README.md

@@ -1,4 +1,4 @@
-# `@olomni/studio-mcp`
+# `@olo-studio/studio-mcp`
 
 Local-first MCP server and CLI for **Olomni Studio** — compile `olomni.studio.scene.v1` scenes offline, generate 9:16 video scripts, render deterministic `.mp4` / `.webm` / alpha / chroma videos via headless Chrome (`window.OloStudioBridge.exportSceneBuffer`), and publish `<olo-presence>` 3D brand mascot embeds.
 
@@ -11,7 +11,7 @@ Add to Claude Desktop, Cursor, Windsurf, or any MCP-compatible host:
   "mcpServers": {
     "olomni-studio": {
       "command": "npx",
-      "args": ["-y", "@olomni/studio-mcp"],
+      "args": ["-y", "@olo-studio/studio-mcp"],
       "env": {
         "OLO_STUDIO_API_KEY": "olo_pat_your_token_here"
       }

package/bin/olo-studio-mcp.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * @olomni/studio-mcp CLI & Stdio MCP Server Entrypoint
+ * @olo-studio/studio-mcp CLI & Stdio MCP Server Entrypoint
  * Usage:
  *   olo-studio-mcp [serve]           Start JSON-RPC 2.0 stdio MCP server
  *   olo-studio-mcp compile [opts]    Compile SceneSpec v1 JSON offline
@@ -8,12 +8,17 @@
  *   olo-studio-mcp inspect-glb <src> Inspect .glb header & JSON chunk
  *   olo-studio-mcp --help            Show help
  */
+import fs from 'node:fs'
 import fsp from 'node:fs/promises'
 import path from 'node:path'
 import { compileSceneSpec } from '../src/compiler.js'
 import { inspectGlb, renderVideoWithBrowser } from '../src/renderer.js'
 import { startStdioServer } from '../src/server.js'
 
+const PKG_VERSION = JSON.parse(
+  fs.readFileSync(new URL('../package.json', import.meta.url), 'utf8'),
+).version
+
 function parseFlags(argv) {
   const flags = {}
   const positional = []
@@ -38,7 +43,7 @@ function parseFlags(argv) {
 }
 
 function printHelp() {
-  console.log(`@olomni/studio-mcp v1.0.0 — Local-First MCP Server & CLI for Olomni Studio
+  console.log(`@olo-studio/studio-mcp v${PKG_VERSION} — Local-First MCP Server & CLI for Olomni Studio
 
 Usage:
   olo-studio-mcp [serve]
@@ -47,7 +52,7 @@ Usage:
   olo-studio-mcp compile [--script "..."] [--file scene.json] [--title "..."] [--out out.json]
       Compile and validate an olomni.studio.scene.v1 SceneSpec without a browser.
 
-  olo-studio-mcp render [--script "..."] [--file scene.json] [--out out.mp4] [--format mp4|webm|alpha|chroma] [--glb path-or-url]
+  olo-studio-mcp render [--script "..."] [--file scene.json] [--out out.mp4] [--format mp4|webm|alpha|chroma] [--fps 24|30|60] [--quality fast|social|studio] [--glb path-or-url]
       Render a deterministic 3D video via headless Chrome + OloStudioBridge.
 
   olo-studio-mcp inspect-glb <path-or-url>
@@ -113,6 +118,8 @@ async function main() {
       sceneSpec: input,
       format: flags.format ? String(flags.format) : 'mp4',
       outputPath: flags.out ? String(flags.out) : './olo-render.mp4',
+      ...(flags.fps !== undefined ? { fps: Number(flags.fps) } : {}),
+      ...(flags.quality ? { quality: String(flags.quality) } : {}),
       ...(isUrl ? { glbUrl: glbArg } : glbArg ? { glbPath: glbArg } : {}),
       ...(flags.studioUrl ? { studioUrl: String(flags.studioUrl) } : {}),
     })

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@olo-studio/studio-mcp",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Local-first MCP server and CLI for Olomni Studio 3D video rendering, SceneSpec v1 compilation, AI scripting, and <olo-presence> embeds.",
   "type": "module",
   "main": "./src/server.js",
+  "scripts": {
+    "prepack": "node -e \"const fs=require('fs'),p='../../public/studio/engine/director.js';if(fs.existsSync(p))fs.copyFileSync(p,'./src/director.js')\""
+  },
   "exports": {
     ".": "./src/server.js",
     "./compiler": "./src/compiler.js",
@@ -32,7 +35,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/olomni/olomni-studio-mcp.git",
+    "url": "git+https://github.com/faustodariopenamondragon-web/OlomniAI.git",
     "directory": "packages/studio-mcp"
   },
   "engines": {

package/src/compiler.js

@@ -4,6 +4,7 @@
  */
 import fs from 'node:fs'
 import path from 'node:path'
+import vm from 'node:vm'
 import { createRequire } from 'node:module'
 import { fileURLToPath } from 'node:url'
 
@@ -205,18 +206,55 @@ export function findPublicStudioDir(overrideDir) {
   return null
 }
 
+function loadUmdModule(filePath) {
+  try {
+    const mod = require(filePath)
+    if (mod && (typeof mod.compileSceneFromScript === 'function' || typeof mod.compileScene === 'function')) {
+      return mod
+    }
+  } catch {
+    // Package "type": "module" prevents require() on .js CJS/UMD files in Node 20
+  }
+
+  // Node 22+ require(esm) returns {} for UMD scripts under "type": "module"; evaluate as CJS cleanly.
+  const code = fs.readFileSync(filePath, 'utf8')
+  const mod = { exports: {} }
+  const fn = vm.compileFunction(
+    code,
+    ['module', 'exports', 'require', '__filename', '__dirname'],
+    { filename: filePath },
+  )
+  fn(mod, mod.exports, require, filePath, path.dirname(filePath))
+  const exported = mod.exports
+  if (exported && (typeof exported.compileSceneFromScript === 'function' || typeof exported.compileScene === 'function')) {
+    return exported
+  }
+  return null
+}
+
 export function loadDirector(overridePublicDir) {
   if (cachedDirector) return cachedDirector
+  const candidates = []
   const publicDir = findPublicStudioDir(overridePublicDir)
-  if (!publicDir) return null
-  const directorPath = path.join(publicDir, 'studio', 'engine', 'director.js')
-  if (!fs.existsSync(directorPath)) return null
-  try {
-    cachedDirector = require(directorPath)
-    return cachedDirector
-  } catch {
-    return null
+  if (publicDir) {
+    candidates.push(path.join(publicDir, 'studio', 'engine', 'director.js'))
+  }
+  // Bundled copy for external npx installs outside the repository
+  candidates.push(path.join(__dirname, 'director.js'))
+
+  for (const directorPath of candidates) {
+    if (!fs.existsSync(directorPath)) continue
+    try {
+      const loaded = loadUmdModule(directorPath)
+      if (loaded) {
+        cachedDirector = loaded
+        return cachedDirector
+      }
+    } catch {
+      // try next candidate
+    }
   }
+  return null
 }
 
 function fnv1aHex(str) {
@@ -434,10 +472,14 @@ function parseCsvLine(line) {
   return cells
 }
 
-export function parseBatchInput({ specs, csv }) {
+export function parseBatchInput({ specs, csv, defaults = {} }) {
+  const cleanDefaults = Object.fromEntries(
+    Object.entries(defaults || {}).filter(([, v]) => v !== undefined),
+  )
+
   if (Array.isArray(specs) && specs.length > 0) {
     return specs.map((item, idx) => {
-      const compiled = compileSceneSpec(item)
+      const compiled = compileSceneSpec({ ...cleanDefaults, ...item })
       return {
         index: idx,
         outputName: item.outputName || item.fileName || `variant-${idx + 1}-${compiled.sceneHash}`,
@@ -461,6 +503,7 @@ export function parseBatchInput({ specs, csv }) {
         }
       })
       const compiled = compileSceneSpec({
+        ...cleanDefaults,
         title: record.title || `Variant ${idx + 1}`,
         script: record.script || record.hook || record.text || '',
         wear: record.wear,
@@ -468,11 +511,15 @@ export function parseBatchInput({ specs, csv }) {
         finish: record.finish,
         scenario: record.scenario,
         vibe: record.vibe,
-        voice: record.voice,
-        voiceId: record.voiceid || record.voice_id,
+        voice: record.voice ?? cleanDefaults.voice,
+        voiceId: record.voiceid || record.voice_id || cleanDefaults.voiceId,
         emotion: record.emotion,
         stateOverride: record.state || record.stateoverride,
-        captions: record.captions !== undefined ? record.captions !== 'false' && record.captions !== '0' : true,
+        captions: record.captions !== undefined
+          ? record.captions !== 'false' && record.captions !== '0'
+          : (cleanDefaults.captions !== undefined ? cleanDefaults.captions : true),
+        pipPath: record.pippath || record.pip_path || cleanDefaults.pipPath,
+        pipUrl: record.pipurl || record.pip_url || cleanDefaults.pipUrl,
         category: record.category || record.language || 'Show 9:16',
       })
       const safeName = (record.outputname || record.output_name || record.id || `variant-${idx + 1}-${compiled.sceneHash}`)