@synthetic-ai/premiere-mcp 2.3.5 → 3.0.0

package/LICENSE

@@ -1,21 +1,5 @@
-MIT License
-
-Copyright (c) 2025 Premiere Pro MCP Contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Copyright (c) 2026 Synthetic. All rights reserved.
+
+This package contains only a small launcher. The Synthetic MCP software it starts is NOT part of this package: it is downloaded from synthetic.com.ar
+and can only be used with a valid Synthetic license (https://synthetic.com.ar). Using the launcher does not grant any right to the downloaded software
+beyond what your license gives you.

package/README.md

@@ -1,242 +1,10 @@
-# Premiere Pro MCP
-
-**Control Adobe Premiere Pro with natural language through Claude (or any MCP-compatible LLM).**
-
-[![Premiere Pro 2026](https://img.shields.io/badge/Premiere%20Pro-2026-blueviolet)](https://www.adobe.com/products/premiere.html)
-[![MCP](https://img.shields.io/badge/MCP-compatible-green)](https://modelcontextprotocol.io)
-[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
-
----
-
-## What it does
-
-```
-You: "Apply a cinematic look to all clips on V1, ducking the music
-      when there's voice, and export to YouTube 1080p."
-
-Claude: ✓ Applied Lumetri (-15K temperature, +10 contrast) to 4 clips
-        ✓ Added voiceover ducking on A2 (-12dB during A1 voice)
-        ✓ Queued H.264 1080p export to ~/Videos/final.mp4
-```
-
-437 tools exposed via MCP to drive Premiere Pro 2026 from any LLM agent.
-Tested in runtime against PP 2026.2.2 on Spanish-localized Windows install.
-
----
-
-## Highlights
-
-- **Locale-resilient**: works on Premiere Pro in Spanish, German, French, etc.
-  (most competitors hardcode English component names and silently fail)
-- **Honest errors**: when a Premiere host API genuinely doesn't expose
-  something (PP 2026 has known limitations), you get a clear error with
-  the recommended workaround — not a silent no-op
-- **Battle-tested**: 137 tools validated in live runtime against PP 2026 with
-  detailed bug fixes (see [CHANGELOG.md](CHANGELOG.md))
-- **AI-first**: built for LLM-driven workflows. Pair it with Whisper for
-  speech-to-text, ComfyUI for thumbnails, FFmpeg for analysis — chain MCPs
-
----
-
-## Quick start
-
-### 1. Install the CEP plugin
-
-Copy `cep-plugin/` to your Adobe CEP extensions folder:
-
-- **Windows**: `%APPDATA%\Adobe\CEP\extensions\MCPBridgeCEP\`
-- **macOS**: `~/Library/Application Support/Adobe/CEP/extensions/MCPBridgeCEP/`
-
-Enable CEP debugging:
-```powershell
-# Windows
-reg add HKCU\Software\Adobe\CSXS.11 /v PlayerDebugMode /t REG_SZ /d 1 /f
-```
-
-### 2. Build the MCP server
-
-```bash
-cd premiere-pro-mcp
-npm install
-npm run build
-```
-
-### 3. Register with Claude Desktop
-
-Add to `%APPDATA%\Claude\claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "premiere-pro": {
-      "command": "node",
-      "args": ["C:/path/to/premiere-pro-mcp/dist/index.js"]
-    }
-  }
-}
-```
-
-### 4. Open Premiere Pro
-
-- Launch Premiere Pro 2026
-- `Window > Extensions > MCPBridgeCEP` (the bridge panel)
-- Click "Start Bridge"
-
-### 5. Talk to Claude
-
-```
-"Show me the active sequence structure."
-"Add a 1-second fade-in to the audio clip on A2."
-"Apply Cross Dissolve at every cut on V1, 0.5 seconds each."
-```
-
----
-
-## What works (validated runtime, PP 2026 es-ES)
-
-### Project & Inspection
-- Full project / sequence / clip overviews
-- Bins, markers, metadata (XMP), color labels
-- Effect properties with all values, keyframes, source media details
-- Find/search project items, list sequences
-
-### Timeline editing
-- Add/remove/move/duplicate clips, split, trim
-- Set in/out points, playhead, work area
-- Selection by name/range/color, invert, deselect
-- Enable/disable clips, link/unlink
-
-### Transform & Motion
-- Position, scale, rotation, opacity (locale-resilient)
-- Anchor point, blend mode
-- Position/scale keyframes via `add_keyframe`
-
-### Color
-- Lumetri full parameter control: exposure, contrast, highlights/shadows,
-  whites/blacks, temperature/tint, saturation, vibrance, sharpen, vignette,
-  faded film
-- LUTs apply
-- Copy/paste color grade across clips
-- ⚠️ See limitations: applying Lumetri *for the first time* requires manual UI
-
-### Audio
-- Per-clip volume, fade in/out (locale-resilient)
-- Volume/panning keyframes
-- Audio FX pipeline: Compressor, EQ, De-Esser, De-Hum, De-Reverb, Limiter,
-  Noise Reduction
-- Voiceover ducking
-- Normalize, detect clipping
-
-### Effects & Transitions
-- 60+ video effects (Gaussian/Directional Blur, Sharpen, Warp Stabilizer,
-  Noise Reduction, Mirror, Spherize, Corner Pin, Lens Distortion, etc.)
-- Transitions with locale-aware name lookup (Cross Dissolve works on any
-  language install)
-- Batch apply across cuts
-
-### Captions
-- Import SRT files as caption tracks
-- Pipeline integration: Whisper-transcribe → SRT → MCP creates captions
-
-### Export
-- Single sequence + batch export via Adobe Media Encoder
-- Match Source presets, YouTube/Vimeo/Twitter/Facebook presets
-- Encode arbitrary files via AME
-- AAF, OMF, FCPXML export
-
-### Multicam
-- Create multicam sequences, switch angles, flatten
-
-### Markers
-- Add/update/delete on sequence or clip
-- Color labels, comments, in/out range
-- Import/export CSV
-
----
-
-## Known limitations (PP 2026 host)
-
-These are not bugs in this MCP — they're verified limitations of Premiere Pro
-2026's ExtendScript/QE-DOM surface. Each tool returns a clear actionable error
-with the recommended workaround.
-
-| Feature | Status | Workaround |
-|---------|--------|------------|
-| `capture_frame` programmatic | ❌ `qeSeq.exportFramePNG` reports success but never writes file | UI: File > Export > Media > Single Frame |
-| `set_track_volume` | ❌ Audio track DOM no longer exposes `.components` or `.volume`; QE has no `setVolume` | Use `add_audio_keyframes` per-clip, or Audio Track Mixer |
-| `speed_change` programmatic | ❌ `qeClip.setSpeed` signature changed in PP 2026 (rejects all known forms) | UI: Clip > Speed/Duration, or change duration with `trim_clip` |
-| Apply Lumetri for the first time | ❌ `addVideoEffect` reports success but doesn't add component | Apply Lumetri manually once; afterwards all 28 setters work perfectly |
-| LUFS integrated measurement | ❌ Not scriptable | Export and measure with ffmpeg-loudnorm |
-| Native PP Speech-to-Text | ❌ Adobe AI STT not exposed | Use Whisper + `create_caption_track` (works great) |
-| Adobe Libraries MOGRT | ❌ Adobe Libraries not scriptable | Use local `.mogrt` files via `import_mogrt` |
-| Dynamic Link with AE | ❌ `import_ae_comps` not implemented | Render from AE and import as video |
-| Async export completion | ⚠️ AME runs async, no callback | Poll `get_render_queue_status` |
-
----
-
-## Architecture
-
-```
-┌─────────────┐         ┌──────────────┐         ┌─────────────┐
-│   Claude    │         │   Node.js    │         │  Premiere   │
-│  (or LLM)   │◄───────►│  MCP server  │◄───────►│   Pro CEP   │
-└─────────────┘  stdio  └──────────────┘  files  │   plugin    │
-                                                  │   (panel)   │
-                                                  └─────────────┘
-                                                        │
-                                                        ▼
-                                                  ┌──────────────┐
-                                                  │ ExtendScript │
-                                                  │  DOM + QE    │
-                                                  └──────────────┘
-```
-
-The bridge automatically prepends locale-resilient helpers to every script:
-
-```javascript
-__findIntrinsic(clip, "motion" | "opacity" | "volume" | "lumetri" | "timeRemap")
-// tries matchName ("AE.ADBE Motion") first — locale-INDEPENDENT —
-// then localized displayName ("Movimiento", "Bewegung", "Mouvement", etc.)
-
-__findProp(component, ["Position", "Posición", "Position", "Position"])
-// also descends one level into nested groups (needed for Lumetri's
-// grouped parameters like Exposure inside Basic Correction)
-
-__readMaybe(obj, "isMuted", false)
-// reads members that are property in some PP versions, method in others
-
-__findTransition(name, "video")
-// resolves transition names across locales:
-// "Cross Dissolve" matches "Disolvencia cruzada" / "Fondu enchaîné"
-```
-
----
-
-## Development
-
-```bash
-npm run dev      # Watch mode
-npm run build    # Build dist/
-npx tsc --noEmit # Type-check only
-```
-
-When adding a tool, prefer:
-- `__findIntrinsic` / `__findComponent` over hardcoded `displayName === "Motion"`
-- `__readMaybe` for any `isSomething()` / `isSomething` property
-- Pass `.ticks` strings (not Time objects) to `insertClip`/`setInPoint`/etc.
-
----
-
-## Credits
-
-Built on top of work from
-[`AdobePremiereProMCP`](https://github.com/bdenney99/AdobePremiereProMCP)
-with extensive fixes for PP 2026 compatibility, locale resilience, and
-runtime-validated behavior. See [CHANGELOG.md](CHANGELOG.md) for the full
-fix log.
-
----
-
-## License
-
-MIT
+# @synthetic-ai/premiere-mcp
+
+Synthetic MCP launcher. Set your license in your MCP client's configuration and keep using `npx -y @synthetic-ai/premiere-mcp`:
+
+```json
+{ "mcpServers": { "premiere-mcp": { "command": "npx", "args": ["-y", "@synthetic-ai/premiere-mcp"], "env": { "PREMIERE_PRO_MCP_LICENSE": "<your license key>" } } } }
+```
+
+On start it checks your license with synthetic.com.ar, downloads the current server (verified with a sha256) and runs it. Without a connection it runs the last
+downloaded copy. Your key is in https://synthetic.com.ar/dashboard.

package/launcher.mjs

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+// Synthetic MCP launcher — ZERO dependencies (Node >= 18). This is the only thing that goes on npm; the real server is downloaded with the
+// customer's license from synthetic.com.ar, verified (sha256), cached under ~/.synthetic/mcp/<product>/ and run. See docs/MCP_DISTRIBUTION_PLAN.md.
+//
+//   1. reads the license from the product's environment variable (the same one the customer already has in their MCP config)
+//   2. asks POST /api/v1/mcp/bundle for the current version; the server validates the license and registers the device
+//   3. downloads the bundle (short-lived signed URL), checks its sha256, unpacks it atomically
+//   4. runs `node server.mjs` with the same stdio, so the MCP client talks to the real server
+//   Offline / server down: runs the last cached version. Invalid or revoked license: it does NOT run, and says why.
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import zlib from "node:zlib";
+import crypto from "node:crypto";
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+export const DEFAULTS = {
+  product: "premiere-mcp",          // set per package by the publisher
+  licenseEnv: "PREMIERE_PRO_MCP_LICENSE",
+  api: process.env.SYNTHETIC_API_URL || "https://synthetic.com.ar", // the override is for tests against a local/dev site
+};
+
+const say = (m) => process.stderr.write(`[synthetic] ${m}\n`);
+
+/** ~/.synthetic/device-id: the SAME file the servers and panels use, so launcher + server + panel count as one device. */
+function deviceId(home) {
+  const dir = path.join(home, ".synthetic"), file = path.join(dir, "device-id");
+  try { const v = fs.readFileSync(file, "utf8").trim(); if (v) return v; } catch { /* first run */ }
+  const id = crypto.randomUUID();
+  try { fs.mkdirSync(dir, { recursive: true }); fs.writeFileSync(file, id, "utf8"); } catch { /* read-only home: the id just won't persist */ }
+  return id;
+}
+
+/** Unpacks a container {files:{path:{enc,data}}} into dir. Refuses any path that would escape it. */
+export function unpackContainer(buf, dir) {
+  const json = JSON.parse(zlib.gunzipSync(buf).toString("utf8"));
+  const root = path.resolve(dir);
+  for (const [rel, f] of Object.entries(json.files)) {
+    const target = path.resolve(root, rel);
+    if (target !== root && !target.startsWith(root + path.sep)) throw new Error(`ruta no permitida en el paquete: ${rel}`);
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    fs.writeFileSync(target, f.enc === "b64" ? Buffer.from(f.data, "base64") : f.data, f.enc === "b64" ? undefined : "utf8");
+  }
+  return json;
+}
+
+const readJson = (p) => { try { return JSON.parse(fs.readFileSync(p, "utf8")); } catch { return null; } };
+/** The file to run inside an unpacked bundle: launch.json says (AE keeps dist/server.mjs); older bundles have server.mjs at the root. */
+export const entryOf = (dir) => readJson(path.join(dir, "launch.json"))?.entry || "server.mjs";
+
+/** Makes sure a runnable server is in the cache and returns its folder. Throws {kind:"license"|"network"|"other"}. */
+export async function ensureBundle(opts = {}) {
+  const o = { ...DEFAULTS, home: os.homedir(), env: process.env, fetchImpl: globalThis.fetch, ...opts };
+  const license = (o.env[o.licenseEnv] ?? "").trim();
+  if (!license) throw Object.assign(new Error(`Falta la licencia: configurá ${o.licenseEnv} en tu cliente MCP (tu clave está en synthetic.com.ar/dashboard).`), { kind: "license" });
+  const cacheDir = path.join(o.home, ".synthetic", "mcp", o.product);
+  const current = readJson(path.join(cacheDir, "current.json")); // {version, sha256}
+  const have = current && fs.existsSync(path.join(cacheDir, current.version, entryOf(path.join(cacheDir, current.version)))) ? current : null;
+
+  let answer;
+  try {
+    const res = await o.fetchImpl(`${o.api}/api/v1/mcp/bundle`, {
+      method: "POST", headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ product: o.product, licenseKey: license, machineId: deviceId(o.home), deviceLabel: `${os.hostname()} (${process.platform})`, have: have?.version ?? null }),
+      signal: AbortSignal.timeout(15_000),
+    });
+    const body = await res.json().catch(() => ({}));
+    if (res.status === 401 || res.status === 403) throw Object.assign(new Error(body.error || "Licencia no válida."), { kind: "license" });
+    if (!res.ok) throw Object.assign(new Error(`El servidor respondió ${res.status}`), { kind: "network" });
+    answer = body;
+  } catch (e) {
+    if (e.kind === "license") throw e;
+    if (have) { say(`Sin conexión con synthetic.com.ar: uso la versión ${have.version} guardada.`); return { dir: path.join(cacheDir, have.version), version: have.version, offline: true }; }
+    throw Object.assign(new Error(`No pude conectar con synthetic.com.ar para descargar el servidor (${e.message}).`), { kind: "network" });
+  }
+
+  if (answer.upToDate && have) return { dir: path.join(cacheDir, have.version), version: have.version };
+  if (!answer.url || !answer.sha256 || !answer.version) throw Object.assign(new Error("Respuesta inesperada del servidor."), { kind: "other" });
+
+  const dl = await o.fetchImpl(answer.url, { signal: AbortSignal.timeout(60_000) });
+  if (!dl.ok) throw Object.assign(new Error(`No pude descargar el servidor (${dl.status}).`), { kind: "network" });
+  const buf = Buffer.from(await dl.arrayBuffer());
+  const got = crypto.createHash("sha256").update(buf).digest("hex");
+  if (got !== answer.sha256) throw Object.assign(new Error("El archivo descargado no coincide con su firma (sha256): no se ejecuta."), { kind: "other" });
+
+  const finalDir = path.join(cacheDir, answer.version), tmp = `${finalDir}.tmp-${process.pid}`;
+  fs.rmSync(tmp, { recursive: true, force: true });
+  fs.mkdirSync(tmp, { recursive: true });
+  unpackContainer(buf, tmp);
+  fs.rmSync(finalDir, { recursive: true, force: true });
+  fs.renameSync(tmp, finalDir);
+  fs.writeFileSync(path.join(cacheDir, "current.json"), JSON.stringify({ version: answer.version, sha256: answer.sha256 }));
+  for (const d of fs.readdirSync(cacheDir)) { // keep this version and the previous one only
+    if (d !== answer.version && d !== have?.version && fs.statSync(path.join(cacheDir, d)).isDirectory()) fs.rmSync(path.join(cacheDir, d), { recursive: true, force: true });
+  }
+  return { dir: finalDir, version: answer.version, downloaded: true };
+}
+
+export async function main(opts = {}) {
+  let r;
+  try { r = await ensureBundle(opts); }
+  // No process.exit() here: on Windows it can abort with a native crash code while the download's socket is still closing.
+  // Setting exitCode lets Node leave on its own once the connection is released.
+  catch (e) { say(e.message); process.exitCode = e.kind === "license" ? 2 : 1; return; }
+  const child = spawn(process.execPath, [path.join(r.dir, entryOf(r.dir)), ...process.argv.slice(2)], { stdio: "inherit", env: process.env });
+  for (const sig of ["SIGINT", "SIGTERM"]) process.on(sig, () => child.kill(sig));
+  child.on("exit", (code, signal) => process.exit(code ?? (signal ? 1 : 0)));
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) await main();

package/package.json

@@ -1,68 +1,24 @@
 {
   "name": "@synthetic-ai/premiere-mcp",
-  "version": "2.3.5",
-  "description": "MCP server for controlling Adobe Premiere Pro via CEP/ExtendScript — 437 tools for AI-driven video editing",
-  "main": "dist/index.js",
+  "version": "3.0.0",
+  "description": "Launcher for the Synthetic premiere-mcp MCP server. Requires a license from https://synthetic.com.ar",
   "type": "module",
   "bin": {
-    "premiere-mcp": "dist/index.js"
+    "premiere-mcp": "launcher.mjs"
   },
   "files": [
-    "dist/**/*.js",
-    "dist/**/*.d.ts",
-    "i18n",
-    "cep-plugin",
-    "scripts",
+    "launcher.mjs",
     "README.md",
-    "LICENSE",
-    "CHANGELOG.md"
+    "LICENSE"
   ],
-  "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/SyntheticArtOk/premiere-pro-mcp.git"
+  "engines": {
+    "node": ">=18"
   },
+  "license": "SEE LICENSE IN LICENSE",
   "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"
-  }
+    "synthetic"
+  ]
 }

package/CHANGELOG.md

@@ -1,180 +0,0 @@
-# Changelog
-
-## [v2.3.4] — The "Reload panel" button no longer reloads in place
-
-v2.3.3's `stopBridge()`-before-`location.reload()` fix wasn't enough —
-confirmed live, twice, on a clean install + full Premiere Pro restart, that
-`location.reload()` doesn't reliably re-run `init()` in this CEP host. Root
-cause found: each reload leaks the old page's `CEPHtmlEngine` subprocesses
-instead of terminating them — 37 orphaned processes were found accumulated
-from repeated testing today, versus ~6 for one cleanly opened panel. Rather
-than keep guessing at ways to make an in-place reload work, the ⟳ button no
-longer calls `location.reload()` at all — it stops the bridge and tells the
-user to restart Premiere Pro, the one path confirmed to always leave the
-panel correct.
-
-## [v2.3.3] — Fixed the "Reload panel" button
-
-It called a bare `location.reload()`, which could leave the old poll
-interval running underneath the fresh page and race with `init()`
-re-running — the panel could get stuck showing the raw HTML placeholder
-badge, an empty temp dir field, and a spurious "Please set a temp
-directory" error, all while the actually-installed files were fine. Now
-stops the bridge (clearing the interval) before reloading, same fix class
-as Photoshop MCP's `wss.close()`-before-reload.
-
-## [v2.3.2] — Reverted the license.json USER_DATA change
-
-v2.3.1 (panel side, unreleased separately from the npm tag) moved
-`getLicensePath()` from `SystemPath.EXTENSION` to `SystemPath.USER_DATA` to
-fix license saves failing with EPERM under a system-wide install. Live
-testing found a deeper issue: the CEP panel's embedded Node
-`fs.writeFileSync` can report success without the write actually landing on
-disk on this Premiere Pro version — confirmed by writing the target file
-directly and watching Premiere's own "successful" save leave it untouched.
-Reverted back to `SystemPath.EXTENSION` (pre-fix behavior) until this CEP
-Node.js reliability issue is understood; the original EPERM bug is still
-open, to be investigated outside production.
-
-## [v2.3.1] — macOS example paths in tool descriptions
-
-`create_sequence`'s description and example calls only showed Windows
-`C:\Program Files\...` preset paths, even though the actual runtime preset
-lookup already searched macOS `/Applications/...` locations too — now the
-description and both examples (Windows + macOS) match what the code
-actually does, so the LLM doesn't suggest a Windows-only path to a Mac
-user. No runtime/behavior change.
-
-## [v2.2.0] — `--doctor` diagnostic command
-
-`premiere-pro-mcp --doctor` runs a standalone setup check — no MCP client or
-Premiere Pro needs to be running: Node version, Premiere Pro install
-detected on disk, license key present + live-validated against
-synthetic.com.ar, and the CEP bridge temp directory is writable. Prints a
-pass/warn/fail summary and exits 1 if anything failed, so it's scriptable.
-Fixed a real crash found while building this: forcing `process.exit()`
-right after the live license check's `fetch()` call could crash with a
-libuv assertion on Windows (`UV_HANDLE_CLOSING`, src/win/async.c) — now
-sets `process.exitCode` and lets the event loop drain naturally instead.
-
-## [v2.1.0] — CRITICAL: correct the version line, ship everything since 2.0.0
-
-`@synthetic-ai/premiere-mcp@2.0.0` (published 2026-06-10, the npm rename
-from unscoped `premiere-pro-mcp`) has been the only version ever actually
-published to the registry — `npm view` confirms `dist-tags.latest` and the
-full `versions` list both show only `2.0.0`, right up until this release.
-Six commits after the rename (v1.1.2 through v1.1.8, including v1.1.7's
-**server-side license enforcement**) bumped `package.json`'s version
-*backward* into a stale pre-rename 1.1.x line instead of continuing from
-2.0.0, and were committed/tested but never `npm publish`ed under that
-wrong version number. Net effect: every customer running
-`npx @synthetic-ai/premiere-mcp` has been getting the unmodified 2.0.0
-tarball — with **zero license checking on any of the 437 tools** — for
-over three months, discovered 2026-09-23 while shipping the macOS preset
-fix below. This release corrects the version line (2.0.0 → 2.1.0, a real
-semver increase) and ships every accumulated fix at once:
-- License enforcement (was v1.1.7): every tool except `ping` /
-  `get_version_info` now validates `PREMIERE_PRO_MCP_LICENSE`.
-- In-panel auto-update + local license storage (was v1.1.2).
-- ExtendScript obfuscation breaking `evalFile()` (was v1.1.4).
-- Bridge could wedge forever after a single failed command read (was v1.1.5).
-- macOS default sequence-preset paths (was v1.1.8, see below).
-
-## [v1.1.8] — macOS default preset paths (superseded by v2.1.0, never actually reached "latest" — see above)
-
-`create_sequence`, `create_sequence_from_clip`, and `get_default_sequence_presets`
-only ever probed Windows install paths for the default `.sqpreset` (and, for
-`create_sequence`, only a single hardcoded PP 2026 path with no probing at
-all). All three now check both Windows and macOS locations across PP
-2026/2025/2024/CC 2023, matching the pattern `export_sequence` already used
-for AME presets. When nothing is found, the tools return a clear error
-asking for an explicit `preset_path` instead of silently using a
-definitely-wrong fallback. Found via a site-wide macOS-compatibility audit
-of every Synthetic product (2026-09-23) — this was the one confirmed gap in
-an otherwise genuinely cross-platform architecture (no launch step to
-break, unlike ae-mcp). Unverified on real macOS hardware — no Mac available
-to test against yet.
-
-## [v1.1.7] — License enforcement
-
-The MCP server itself (all 437 tools) never actually validated
-`PREMIERE_PRO_MCP_LICENSE` — the CEP panel had a license field for its own
-auto-update, but the server side was wide open. Added the same
-`checkLicense()` gate ae-mcp and photoshop-mcp already have: every tool
-except `ping` / `get_version_info` now requires a valid license, validated
-against `https://synthetic.com.ar/api/v1/license/validate` and cached for an
-hour.
-
----
-
-All notable changes to this MCP server. Every fix below was discovered via
-**static audit + live runtime testing against Premiere Pro 2026.2.2 on
-Spanish-localized Windows**.
-
-The audit started at **31/100 sellability score** (22% green tools) and
-finished at **~78/100** (~75% green) after the rounds below.
-
----
-
-## [v1.2.0] — PP 2026 compatibility + locale resilience
-
-### Round 6 — Live runtime validation
-- `6f20892` capture_frame: honest error for PP 2026 host limitation
-- `8152021` bridge: sanitize NaN and Infinity to null
-- `a74ce33` Round 5: 8 more fixes from full smoke test (137 tools tested)
-- `45fdaba` track-targeting: locale-resilient set_clip_position/scale/rotation
-- `f9589cb` premiere.jsx: locale-resilient fadeIn/fadeOut/crossFadeClips
-- `29e941d` graceful fallbacks for setSpeed signature + track volume
-- `0533162` Live-test fixes: setSpeed signature, locale prop names, audio clip volume
-- `084ef49` Live-test fixes: set_clip_opacity locale, color_correct Lumetri name
-
-### Round 5 — Bridge JSON sanitization
-- `f3d83d7` Fix bridge JSON: ExtendScript ignores replacer; sanitize tree pre-stringify
-
-### Round 4 — premiere.jsx loading (single highest-impact fix)
-- `366f325` Fix premiere.jsx SyntaxError that broke ALL JSX helpers
-  - **1-char fix, ~30+ tools unblocked**
-  - `premiere.jsx` (22k lines) had `package:` as bare property name at line
-    22006. ExtendScript is strict ES3 where `package` is reserved → entire
-    file fails to parse → every JSX-helper-backed tool returns
-    `ReferenceError: <fn> is not a function`. Quoting fixes everything.
-- `b12a0d8` Round 4: bridge JSON-parse failure + locale-resilient transition lookup
-
-### Round 3 — Concrete code bugs from re-audit
-- `21bf821` Round 3 part 2: fix remaining 9 files
-- `e4534d5` Round 3: fix 32 concrete code bugs from re-audit
-  - ticks/Time correctness (markers, source-monitor, scripting, clipboard, audio)
-  - property-vs-method (media.check_offline_media)
-  - QE-only methods routed correctly (timeline.move_clip/speed_change, transitions)
-  - missing `app.enableQE()` guards
-  - nested Lumetri prop lookup via `__findProp`
-
-### Round 2 — Locale-resilient helpers
-- `bdaebaa` Round 2: guard QE multicam enumeration and proxy detach
-- `48d3648` Round 2 part 2: fix remaining 8 files
-- `2b718b3` Round 2 part 1: locale-resilient helpers + fix 13 tool files
-  - Added `__findIntrinsic(clip, key)` with matchName-first lookup
-  - Added `__findComponent`, `__findProp`, `__readMaybe`, `__findTransition`
-
-### Round 1 — Property-vs-method bugs
-- `ffe6931` Fix 21 red tools: property-vs-method bugs, missing APIs, stub handlers
-- `35ecbfa` Fix PP 2026 compatibility: sequence creation, tracks, audio, effects, export
-
----
-
-## Validated tool inventory
-
-### ✅ 66 tools confirmed working in runtime (PP 2026.2.2 es-ES)
-Inspection, transform, audio/video FX, timeline editing, selection, markers,
-sequence ops, project/bins, captions, source monitor, track management,
-metadata, scripting, export. Full list in [README.md](README.md).
-
-### ⚠️ Honest errors (PP 2026 host limitations, not bugs)
-- `set_track_volume`, `speed_change`, `capture_frame`, Lumetri-when-not-applied
-- All return clear errors with the recommended UI workaround
-
-### Validated against
-- Premiere Pro 2026.2.2 on Windows
-- Spanish (es-ES) locale — names like "Opacidad", "Movimiento", "Escala",
-  "Posición", "Disolvencia cruzada" all handled
-- 15-item test project with multi-track timeline, transitions, fades, Lumetri

package/cep-plugin/.debug

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<ExtensionList>
-  <Extension Id="com.mcp.premiere.bridge.panel">
-    <HostList>
-      <Host Name="PPRO" Port="8088"/>
-    </HostList>
-  </Extension>
-</ExtensionList>