@synthetic-ai/premiere-mcp 2.3.1 → 2.3.4

package/i18n/node.cjs

@@ -0,0 +1,124 @@
+/* synthetic-idiomas · core/node.cjs
+ *
+ * Lado Node (servers MCP): decide el idioma al arrancar y carga los diccionarios del producto.
+ *
+ * Orden para elegir el idioma (el primero que dé un idioma soportado gana):
+ *   1. Variable de entorno del producto (ej. PS_MCP_LANG), si el producto define una.
+ *   2. SYNTHETIC_LANG (vale para todos los productos).
+ *   3. settings.json del panel del producto:  <USER_DATA>/<carpeta del panel>/settings.json
+ *   4. settings.json compartido de Synthetic:  <USER_DATA>/com.synthetic/settings.json
+ *   5. Inglés.
+ *
+ * <USER_DATA> es la misma carpeta que devuelve CEP con SystemPath.USER_DATA:
+ *   Windows: %APPDATA%   ·   macOS: ~/Library/Application Support   ·   Linux (dev): ~/.config
+ *
+ * El idioma se lee UNA vez al arrancar: las descripciones de las tools se registran al inicio
+ * de la sesión MCP y los clientes no las vuelven a pedir. Cambiar el idioma en el panel se
+ * aplica al reiniciar el server (o la app cliente).
+ */
+'use strict';
+var fs = require('fs');
+var path = require('path');
+var os = require('os');
+var core = require('./i18n-core.cjs');
+
+var SHARED_FOLDER = 'com.synthetic';
+
+function userDataDir(env, platform) {
+  env = env || process.env;
+  platform = platform || process.platform;
+  if (platform === 'win32') return env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming');
+  if (platform === 'darwin') return path.join(os.homedir(), 'Library', 'Application Support');
+  return env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config');
+}
+
+function settingsPath(folder, env, platform) {
+  return path.join(userDataDir(env, platform), folder, 'settings.json');
+}
+
+function readJson(file) {
+  try { return JSON.parse(fs.readFileSync(file, 'utf8').replace(/^/, '')); } catch (e) { return null; }
+}
+
+/**
+ * @param {object} o
+ *   envVar:         variable propia del producto (ej. 'PS_MCP_LANG')
+ *   settingsFolder: carpeta del panel dentro de USER_DATA (ej. 'com.synthetic.photoshop-mcp.bridge')
+ * @returns {{ language: string, source: string }}
+ */
+function resolveLanguage(o) {
+  o = o || {};
+  var env = o.env || process.env;
+  var tries = [];
+  if (o.envVar) tries.push([env[o.envVar], 'env:' + o.envVar]);
+  tries.push([env.SYNTHETIC_LANG, 'env:SYNTHETIC_LANG']);
+  if (o.settingsFolder) {
+    var p = settingsPath(o.settingsFolder, env, o.platform);
+    var s = readJson(p);
+    tries.push([s && s.language, p]);
+  }
+  var shared = settingsPath(SHARED_FOLDER, env, o.platform);
+  var sh = readJson(shared);
+  tries.push([sh && sh.language, shared]);
+  for (var i = 0; i < tries.length; i++) {
+    var lang = core.normalizeLanguage(tries[i][0]);
+    if (lang) return { language: lang, source: tries[i][1] };
+  }
+  return { language: core.SOURCE, source: 'default' };
+}
+
+// Lee <dir>/<idioma>.json y <dir>/hashes/<idioma>.json para todos los idiomas soportados.
+function loadLocales(dir) {
+  var locales = {}, hashes = {};
+  core.CODES.forEach(function (code) {
+    var d = readJson(path.join(dir, code + '.json'));
+    if (d) locales[code] = d;
+    var h = readJson(path.join(dir, 'hashes', code + '.json'));
+    if (h) hashes[code] = h;
+  });
+  return { locales: locales, hashes: hashes };
+}
+
+/**
+ * Atajo para un server MCP:
+ *   const i18n = createServerI18n({ localesDir, envVar: 'PS_MCP_LANG', settingsFolder: '...' });
+ *   i18n.t('msg.license.missing')      // mensajes
+ *   i18n.localizeTools(tools)          // respuesta de tools/list
+ */
+function createServerI18n(o) {
+  var picked = resolveLanguage(o);
+  var data = loadLocales(o.localesDir);
+  var i18n = core.createI18n({ locales: data.locales, hashes: data.hashes, language: picked.language });
+  i18n.languageSource = picked.source;
+  // Idioma pedido (puede diferir de `language` si ese idioma todavía no tiene diccionario).
+  i18n.requestedLanguage = picked.language;
+  return i18n;
+}
+
+// Para servers hechos con McpServer del SDK oficial: envuelve la respuesta de tools/list.
+// Llamar DESPUÉS de registrar todas las tools y ANTES de server.connect().
+function patchMcpServerToolsList(mcpServer, i18n) {
+  if (!i18n || i18n.language === core.SOURCE) return false;
+  var inner = mcpServer && (mcpServer.server || mcpServer);
+  var handlers = inner && inner._requestHandlers;
+  if (!handlers || typeof handlers.get !== 'function') return false;
+  var original = handlers.get('tools/list');
+  if (typeof original !== 'function') return false;
+  handlers.set('tools/list', async function (request, extra) {
+    var result = await original(request, extra);
+    if (result && Array.isArray(result.tools)) return Object.assign({}, result, { tools: i18n.localizeTools(result.tools) });
+    return result;
+  });
+  return true;
+}
+
+module.exports = {
+  SHARED_FOLDER: SHARED_FOLDER,
+  userDataDir: userDataDir,
+  settingsPath: settingsPath,
+  resolveLanguage: resolveLanguage,
+  loadLocales: loadLocales,
+  createServerI18n: createServerI18n,
+  patchMcpServerToolsList: patchMcpServerToolsList,
+  core: core
+};

package/package.json

@@ -1,66 +1,68 @@
-{
-  "name": "@synthetic-ai/premiere-mcp",
-  "version": "2.3.1",
-  "description": "MCP server for controlling Adobe Premiere Pro via CEP/ExtendScript \u00e2\u20ac\u201d 437 tools for AI-driven video editing",
-  "main": "dist/index.js",
-  "type": "module",
-  "bin": {
-    "premiere-mcp": "dist/index.js"
-  },
-  "files": [
-    "dist/**/*.js",
-    "dist/**/*.d.ts",
-    "cep-plugin",
-    "scripts",
-    "README.md",
-    "LICENSE",
-    "CHANGELOG.md"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "start": "node dist/index.js",
-    "start:http": "node dist/http-server.js",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "install-cep": "bash scripts/install-cep.sh"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/matiasEltrece/premiere-pro-mcp.git"
-  },
-  "homepage": "https://synthetic.com.ar",
-  "bugs": {
-    "url": "https://synthetic.com.ar"
-  },
-  "author": "Synthetic",
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "adobe",
-    "premiere-pro",
-    "video-editing",
-    "ai",
-    "extendscript",
-    "cep",
-    "claude",
-    "windsurf",
-    "cursor",
-    "automation"
-  ],
-  "license": "MIT",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.1",
-    "zod": "^3.23.0"
-  },
-  "devDependencies": {
-    "@types/node": "^22.10.0",
-    "javascript-obfuscator": "^4.2.2",
-    "typescript": "^5.7.0",
-    "vitest": "^4.0.18"
-  }
+{
+  "name": "@synthetic-ai/premiere-mcp",
+  "version": "2.3.4",
+  "description": "MCP server for controlling Adobe Premiere Pro via CEP/ExtendScript \u00e2\u20ac\u201d 437 tools for AI-driven video editing",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "premiere-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "i18n",
+    "cep-plugin",
+    "scripts",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "start:http": "node dist/http-server.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "install-cep": "bash scripts/install-cep.sh",
+    "sync-i18n": "node scripts/sync-i18n.mjs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/matiasEltrece/premiere-pro-mcp.git"
+  },
+  "homepage": "https://synthetic.com.ar",
+  "bugs": {
+    "url": "https://synthetic.com.ar"
+  },
+  "author": "Synthetic",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "adobe",
+    "premiere-pro",
+    "video-editing",
+    "ai",
+    "extendscript",
+    "cep",
+    "claude",
+    "windsurf",
+    "cursor",
+    "automation"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "javascript-obfuscator": "^4.2.2",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  }
 }

package/scripts/package.mjs

@@ -5,6 +5,7 @@
  *   release/
  *     server/index.mjs        bundled + minified (+ obfuscated) MCP server
  *     server/package.json     minimal ESM marker
+ *     i18n/                   translations + i18n runtime (server loads ../i18n at runtime)
  *     MCPBridgeCEP.zxp        signed CEP plugin (obfuscated main.js, verbatim premiere.jsx, no .debug)
  *     install/                install scripts
  *     README.md  LICENSE
@@ -36,6 +37,22 @@ if (existsSync(REL)) rmSync(REL, { recursive: true, force: true });
 mkdirSync(join(REL, "server"), { recursive: true });
 console.log("✓ Cleaned release/");
 
+// ─── 1b. Translations (vendored by scripts/sync-i18n.mjs) ────────────────────
+// src/i18n.ts loads them at runtime from <module dir>/../i18n, which for the
+// bundle below (release/server/index.mjs) is release/i18n. Staged before the
+// bundle is validated so the server starts exactly as it will ship. The CEP
+// panel's own copy (cep-plugin/i18n-*.{cjs,js}, at the extension ROOT — not
+// cep-plugin/i18n/, see sync-i18n.mjs for why) rides along with the stage in
+// step 4.
+for (const p of [join(ROOT, "i18n", "node.cjs"), join(ROOT, "i18n", "locales", "en.json"), join(ROOT, "cep-plugin", "i18n-locales.js")]) {
+  if (!existsSync(p)) {
+    console.error(`✗ Missing ${p} — run: node scripts/sync-i18n.mjs`);
+    process.exit(1);
+  }
+}
+copyDirSync(join(ROOT, "i18n"), join(REL, "i18n"));
+console.log("✓ Copied i18n/ → release/i18n");
+
 // ─── 2. Compile TS, then bundle with esbuild (single minified ESM file) ──────
 console.log("⚙  tsc build...");
 execSync("npm run build", { cwd: ROOT, stdio: "pipe" });
@@ -195,8 +212,7 @@ for (const f of ["main.js"]) {
 console.log("✓ Shipped cep/premiere.jsx verbatim (no obfuscation — see comment above)");
 
 // ─── 5. Sign the staged plugin into a .zxp ───────────────────────────────────
-const ZXP = process.env.ZXP_SIGN_CMD ||
-  "C:\\Users\\Artear\\Documents\\CEP-Resources\\ZXPSignCMD\\4.1.3\\x64\\ZXPSignCmd.exe";
+const ZXP = process.env.ZXP_SIGN_CMD || "ZXPSignCmd";
 const certPath = process.env.ZXP_CERT_PATH || join(ROOT, ".cert", "self-signed.p12");
 const certPass = process.env.ZXP_CERT_PASSWORD || "synthetic";
 const zxpOut = join(REL, "MCPBridgeCEP.zxp");

package/scripts/sync-i18n.mjs

@@ -0,0 +1,117 @@
+/**
+ * Synthetic Premiere Pro MCP — sync translations from synthetic-idiomas
+ *
+ * The language dictionaries and the shared i18n runtime live in the central
+ * synthetic-idiomas repo. This script vendors the pieces each part needs:
+ *
+ *   i18n/                 MCP server (loaded at runtime from dist/ → ../i18n)
+ *     i18n-core.cjs  node.cjs  locales/<lang>.json  locales/hashes/<lang>.json
+ *   cep-plugin/            bridge panel — files at the extension ROOT, not a
+ *     i18n-core.cjs           subfolder: the in-panel hot-updater writes each
+ *     i18n-panel.cjs           manifest file via a flat path.join(extDir,
+ *     i18n-locales.js          f.name) with no mkdir step, so a panel already
+ *                              live making its first jump to this version
+ *                              would ENOENT on an "i18n/" subfolder that
+ *                              doesn't exist yet. Same bug found and fixed in
+ *                              Photoshop MCP's and AE MCP's panels
+ *                              (29/30-sep-2026). chat-plugin has no such
+ *                              updater (delivered only via a fresh .zxp
+ *                              install), so it's the one place a real i18n/
+ *                              subfolder is still safe.
+ *   chat-plugin/i18n/     AI Chat panel     ┐  i18n-core.cjs  panel.cjs
+ *                                           ┘  locales.js
+ *
+ * The copies are committed to this repo (CI, npm publish and the .zxp build
+ * don't have synthetic-idiomas next to them). Re-run after translations change:
+ *
+ *   node scripts/sync-i18n.mjs            (or: npm run sync-i18n)
+ *
+ * Source: $SYNTHETIC_IDIOMAS_DIR, else ../synthetic-idiomas next to this repo.
+ * In synthetic-idiomas, run `node tools/i18n.mjs build premiere-mcp` first so
+ * locales/en.json and dist/locales.js are current.
+ */
+import { existsSync, mkdirSync, copyFileSync, rmSync, readdirSync, statSync, readFileSync } from "fs";
+import { join, dirname, resolve } from "path";
+import { fileURLToPath } from "url";
+import { execSync } from "child_process";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(__dirname, "..");
+const PRODUCT = "premiere-mcp";
+const SRC = resolve(process.env.SYNTHETIC_IDIOMAS_DIR || join(ROOT, "..", "synthetic-idiomas"));
+
+const need = {
+  core: join(SRC, "core", "i18n-core.cjs"),
+  node: join(SRC, "core", "node.cjs"),
+  panel: join(SRC, "core", "panel.cjs"),
+  locales: join(SRC, PRODUCT, "locales"),
+  bundle: join(SRC, PRODUCT, "dist", "locales.js"),
+};
+const missing = Object.values(need).filter((p) => !existsSync(p));
+if (missing.length) {
+  console.error(`✗ synthetic-idiomas not found or incomplete at ${SRC}`);
+  for (const p of missing) console.error(`    missing: ${p}`);
+  console.error("  Clone it next to this repo, or set SYNTHETIC_IDIOMAS_DIR to its path.");
+  console.error(`  If only the locale files are missing, run there: node tools/i18n.mjs build ${PRODUCT}`);
+  process.exit(1);
+}
+if (!existsSync(join(need.locales, "en.json"))) {
+  console.error(`✗ ${join(need.locales, "en.json")} not found — run: node tools/i18n.mjs build ${PRODUCT}`);
+  process.exit(1);
+}
+
+// Each target is rebuilt from scratch so removed languages/keys don't linger.
+function resetDir(dir) {
+  rmSync(dir, { recursive: true, force: true });
+  mkdirSync(dir, { recursive: true });
+}
+
+function copyDirSync(src, dest) {
+  mkdirSync(dest, { recursive: true });
+  for (const entry of readdirSync(src)) {
+    const s = join(src, entry), d = join(dest, entry);
+    if (statSync(s).isDirectory()) copyDirSync(s, d);
+    else if (entry.endsWith(".json")) copyFileSync(s, d);
+  }
+}
+
+// ─── Server ──────────────────────────────────────────────────────────────────
+const serverDir = join(ROOT, "i18n");
+resetDir(serverDir);
+copyFileSync(need.core, join(serverDir, "i18n-core.cjs"));
+copyFileSync(need.node, join(serverDir, "node.cjs"));
+copyDirSync(need.locales, join(serverDir, "locales"));
+
+// ─── Bridge panel (cep-plugin) — files at the extension ROOT ────────────────
+// NOT resetDir(): that would rmSync the whole folder, wiping main.js/
+// index.html/CSXS/... since the dir is now cep-plugin/ itself, shared with
+// everything else the panel ships. Only remove the 3 files we own.
+{
+  const dir = join(ROOT, "cep-plugin");
+  for (const rel of ["i18n-core.cjs", "i18n-panel.cjs", "i18n-locales.js"]) {
+    rmSync(join(dir, rel), { force: true });
+  }
+  copyFileSync(need.core, join(dir, "i18n-core.cjs"));
+  copyFileSync(need.panel, join(dir, "i18n-panel.cjs"));
+  copyFileSync(need.bundle, join(dir, "i18n-locales.js"));
+}
+
+// ─── AI Chat panel (chat-plugin) — real i18n/ subfolder, safe here ──────────
+// (no in-panel hot-updater for this one -- see file header)
+{
+  const dir = join(ROOT, "chat-plugin", "i18n");
+  resetDir(dir);
+  copyFileSync(need.core, join(dir, "i18n-core.cjs"));
+  copyFileSync(need.panel, join(dir, "panel.cjs"));
+  copyFileSync(need.bundle, join(dir, "locales.js"));
+}
+
+// ─── Summary ─────────────────────────────────────────────────────────────────
+const langs = readdirSync(join(serverDir, "locales")).filter((f) => f.endsWith(".json")).map((f) => f.slice(0, -5)).sort();
+const enKeys = Object.keys(JSON.parse(readFileSync(join(serverDir, "locales", "en.json"), "utf-8"))).length;
+let rev = "";
+try { rev = execSync("git rev-parse --short HEAD", { cwd: SRC, stdio: ["ignore", "pipe", "ignore"] }).toString().trim(); } catch {}
+
+console.log(`✓ Synced i18n from ${SRC}${rev ? ` (@${rev})` : ""}`);
+console.log(`  languages: ${langs.join(", ")} · ${enKeys} English keys`);
+console.log("  → i18n/  cep-plugin/i18n-*.{cjs,js}  chat-plugin/i18n/");