premiere-pro-mcp 1.15.0 → 1.15.2

package/CHANGELOG.md

@@ -6,6 +6,38 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [1.15.2] - 2026-09-14
+
+### Fixed
+
+- `trim_clip` now rolls back source metadata to prevent clip corruption when a partial write occurs (source points changed but timeline edge didn't move). Previously these clips entered a permanently-stuck state. (#509, #503)
+- `export_frame`, `capture_frame`, `freeze_frame`, and the `export_sequence_*_review_frames` tools now write the requested frame on macOS Premiere Pro 26.5 / 27 beta. QE still exporters take `(timecodeString, pathWithoutExtension)`; the previous `(path, width, height)` call returned `false` without writing a file, so every frame export fell through to the Media Encoder fallback. Frame time is now formatted with `Time.getFormatted()` in the sequence's display format (drop-frame included), the editor's playhead is no longer moved, and the result reports the timecode and frame index that were rendered. (#510)
+- Preset discovery (`get_encoder_presets`, the default `export_sequence` preset, proxy ingest presets, and the still-image fallback) now looks inside the `.app` bundle that lives one level below `/Applications/Adobe Media Encoder <version>/` on macOS. Previously only the user's own presets under `~/Documents/Adobe/Adobe Media Encoder/*/Presets` were found. (#510)
+- `verify_premiere_connection` now aligns panel and active sequence identity checks. (#501)
+- `create_mogrt_recipe` now exposes composition parameter controls correctly. (#504)
+- `apply_mogrt` now surfaces buildToolScript and importMGT error details. (#505)
+- `inspect_color_value` argument unwrapping no longer fails. (#506)
+
+### Changed
+
+- Removed orphaned chat-plugin directory and build scripts. (#502)
+- Pinned Adobe type definitions at 26.3 until drift receipts are rewritten for stable 26.5. (#508)
+
+## [1.15.1] - 2026-09-11
+
+### Fixed
+
+- Use a null destination for UXP project-root file imports, matching the Premiere API contract.
+- Consolidate exported page aliases with permanent redirects and improve homepage accessibility, image delivery, and installation journeys.
+
+### Changed
+
+- Add a searchable tool reference, precise client configuration, and clearer competitive evaluation guidance.
+- Refresh the homepage experiment with Premiere artwork and gallery layouts, with end-to-end journey coverage.
+- Update landing dependencies and comparable GitHub search measurement.
+
+Automated checks do not establish licensed Premiere or After Effects playback or rendered-output verification.
+
 ## [1.15.0] - 2026-09-08
 
 ### Added

package/README.md

@@ -10,6 +10,8 @@
 
 Free, MIT licensed, local-first, and published to npm as [`premiere-pro-mcp`](https://www.npmjs.com/package/premiere-pro-mcp) — the only package name that installs this project.
 
+[Website](https://premiere-pro-mcp.com/) · [Setup guides](https://premiere-pro-mcp.com/blog/how-to-set-up-premiere-pro-mcp/) · [Search tools](https://premiere-pro-mcp.com/tools/) · [Troubleshooting](https://premiere-pro-mcp.com/docs/troubleshooting/) · [Release facts](https://premiere-pro-mcp.com/facts/)
+
 Development source: 369 core tools across 53 modules, 4 resources, and 17 guided workflows. A connected UXP host adds 93 capability-gated tools.
 
 The [completed AE render handoff](docs/after-effects-render-handoff.md) previews and confirms importing one finished render into an existing Premiere bin, with host and file rechecks and an import receipt.
@@ -95,14 +97,21 @@ It is also separate from other MCP servers for Premiere Pro. The only npm packag
 published from this repository is `premiere-pro-mcp`, and no other package name
 installs it.
 
+**Comparing similarly named packages?** Both this package and
+`adobe-premiere-pro-mcp` declare a `premiere-pro-mcp` executable. Verify the package
+and repository before configuring a client. The new
+[local configuration helper](docs/client-configuration.md) prints Claude, Cursor,
+VS Code, or Codex settings that point directly to this installation. It is a
+feature included in v1.15.1 and later.
+
 The current source exposes 369 core tools for supported workflow steps spanning the supported ExtendScript, QE DOM, local media and interchange analysis, revisioned project-context retrieval, safe edit-planning, project-intake preview, review handoff, connection verification, and guarded After Effects MOGRT authoring, batch, library, render-queue, inspection, and Premiere-handoff workflows. A compatible, authenticated UXP panel adds 93 documented, capability-gated tools without replacing the production CEP bridge.
 
 <a id="latest-release"></a>
 
-### Latest release: 1.15.0
+### Latest release: 1.15.2
 
-The previously published v1.14.9 npm artifact contains **349 core tools**, 347 in its default profile,
-and 440 with a compatible UXP connection. The development catalog above can include
+The published v1.15.1 npm artifact contains **369 core tools**, 367 in its default profile,
+and 460 with a compatible UXP connection. The development catalog above can include
 unreleased work. See the [versioned facts and package provenance](https://premiere-pro-mcp.com/facts/).
 
 ### Try a bounded workflow
@@ -151,7 +160,7 @@ if the connection is unavailable.
   local Premiere processes. See the generated [supported action catalog](docs/supported-actions.md)
   for individual capability and verification contracts.
 
-See the [v1.15.0 release notes](https://github.com/leancoderkavy/premiere-pro-mcp/releases/tag/v1.15.0)
+See the [v1.15.1 release notes](https://github.com/leancoderkavy/premiere-pro-mcp/releases/tag/v1.15.1)
 for complete details. Live installation in Premiere Pro still requires host verification.
 
 ### Current MCP protocol support
@@ -198,9 +207,9 @@ their bins, media rules, and organization rules before a facility uses one.
 
 ### Easiest supported path: Claude Desktop
 
-1. Download the current [Claude Desktop bundle (`.mcpb`)](https://github.com/leancoderkavy/premiere-pro-mcp/releases/download/v1.15.0/premiere-pro-mcp-1.15.0.mcpb).
+1. Download the current [Claude Desktop bundle (`.mcpb`)](https://github.com/leancoderkavy/premiere-pro-mcp/releases/download/v1.15.1/premiere-pro-mcp-1.15.1.mcpb).
 2. In Claude Desktop, open **Settings > Extensions > Advanced settings > Install Extension**, select the downloaded bundle, and restart Claude Desktop.
-3. Download the separate [signed Premiere connector (`.zxp`)](https://github.com/leancoderkavy/premiere-pro-mcp/releases/download/v1.15.0/MCPBridgeCEP.zxp). Open it with your trusted ZXP installer. If your computer has no ZXP installer, use the npm connector installer in **Advanced setup** below.
+3. Download the separate [signed Premiere connector (`.zxp`)](https://github.com/leancoderkavy/premiere-pro-mcp/releases/download/v1.15.1/MCPBridgeCEP.zxp). Open it with your trusted ZXP installer. If your computer has no ZXP installer, use the npm connector installer in **Advanced setup** below.
 4. Restart Premiere, open a project, then open **Window > Extensions > MCP for Adobe Premiere Pro**.
 5. In Claude, enter: `Safely check my Premiere connection with verify_premiere_connection. Make no changes.`
 
@@ -497,11 +506,11 @@ From a clone of this repository:
 ```bash
 codex plugin marketplace add .
 codex plugin add premiere-pro@premiere-pro-mcp
-npx -y premiere-pro-mcp@1.15.0 --install-cep
+npx -y premiere-pro-mcp@1.15.1 --install-cep
 ```
 
 Restart Premiere Pro and start a new Codex session after installation. The plugin
-launches `premiere-pro-mcp@1.15.0` through `npx`; the separate CEP installation is
+launches `premiere-pro-mcp@1.15.1` through `npx`; the separate CEP installation is
 required because the MCP server communicates with the running Premiere host through
 the local bridge.
 
@@ -532,7 +541,7 @@ For Claude Code, add this repository as a marketplace and install the plugin:
 Then install the Premiere bridge and start a new Claude Code session:
 
 ```bash
-npx -y premiere-pro-mcp@1.15.0 --install-cep
+npx -y premiere-pro-mcp@1.15.1 --install-cep
 ```
 
 The Claude Code package lives in

package/after-effects-cep-plugin/CSXS/manifest.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<ExtensionManifest Version="7.0" ExtensionBundleId="com.mcp.aftereffects.bridge" ExtensionBundleVersion="1.15.0" ExtensionBundleName="MCP for Adobe After Effects">
+<ExtensionManifest Version="7.0" ExtensionBundleId="com.mcp.aftereffects.bridge" ExtensionBundleVersion="1.15.2" ExtensionBundleName="MCP for Adobe After Effects">
   <ExtensionList>
-    <Extension Id="com.mcp.aftereffects.bridge.panel" Version="1.15.0"/>
+    <Extension Id="com.mcp.aftereffects.bridge.panel" Version="1.15.2"/>
   </ExtensionList>
   <ExecutionEnvironment>
     <HostList>

package/cep-plugin/CSXS/manifest.xml

@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<ExtensionManifest Version="7.0" ExtensionBundleId="com.mcp.premiere.bridge" ExtensionBundleVersion="1.15.0" ExtensionBundleName="MCP for Adobe Premiere Pro">
+<ExtensionManifest Version="7.0" ExtensionBundleId="com.mcp.premiere.bridge" ExtensionBundleVersion="1.15.2" ExtensionBundleName="MCP for Adobe Premiere Pro">
   <ExtensionList>
-    <Extension Id="com.mcp.premiere.bridge.panel" Version="1.15.0"/>
-    <Extension Id="com.mcp.premiere.bridge.headless" Version="1.15.0"/>
+    <Extension Id="com.mcp.premiere.bridge.panel" Version="1.15.2"/>
+    <Extension Id="com.mcp.premiere.bridge.headless" Version="1.15.2"/>
   </ExtensionList>
   <ExecutionEnvironment>
     <HostList>

package/cep-plugin/index.html

@@ -81,7 +81,7 @@
     <section class="update-section" aria-live="polite">
       <div class="update-copy">
         <span class="section-label">MCP updates</span>
-        <strong id="updateTitle">Version 1.15.0</strong>
+        <strong id="updateTitle">Version 1.15.2</strong>
         <span id="updateDetail">Checking the global MCP server and connector release…</span>
       </div>
       <button id="btnUpdate" class="button button-update" onclick="handleUpdateClick()" type="button" aria-describedby="updateDetail" disabled>

package/cep-plugin/updater.cjs

@@ -7,7 +7,7 @@
 })(this, function () {
   "use strict";
 
-  var CURRENT_VERSION = "1.15.0";
+  var CURRENT_VERSION = "1.15.2";
   var PACKAGE_NAME = "premiere-pro-mcp";
   var LATEST_PACKAGE_API = "https://registry.npmjs.org/" + PACKAGE_NAME;
   var LATEST_RELEASE_API =

package/dist/bridge/script-builder.js

@@ -289,9 +289,21 @@ function __collectEprFiles(folder, out) {
 
 // macOS applications are bundles: AME/Premiere resources live below Contents,
 // whereas the Windows installers put the same folders directly below the app root.
+// On macOS the /Applications entry is normally a plain folder that holds the bundle
+// ("/Applications/Adobe Media Encoder 2026/Adobe Media Encoder 2026.app"), so when
+// Contents is not directly there, look one level down for the ".app".
 function __adobeApplicationResourceFolder(appFolder, relativePath) {
-  var prefix = appFolder.fsName + (__isMacOS() ? "/Contents/" : "/");
-  return new Folder(prefix + relativePath);
+  if (!__isMacOS()) return new Folder(appFolder.fsName + "/" + relativePath);
+
+  var direct = new Folder(appFolder.fsName + "/Contents/" + relativePath);
+  if (direct.exists) return direct;
+
+  var bundles = appFolder.getFiles(function(f) { return /\\.app$/i.test(f.name); });
+  for (var i = 0; i < bundles.length; i++) {
+    var nested = new Folder(bundles[i].fsName + "/Contents/" + relativePath);
+    if (nested.exists) return nested;
+  }
+  return direct;
 }
 
 // All export presets AME ships, plus the user's own saved presets.
@@ -370,7 +382,8 @@ function __findProxyPreset() {
 
 function __findStillPreset(outputPath) {
   var wantJpeg = /\\.jpe?g$/i.test(outputPath);
-  var needles = wantJpeg ? ["jpeg", "jpg"] : ["png"];
+  var wantTiff = /\\.tiff?$/i.test(outputPath);
+  var needles = wantJpeg ? ["jpeg", "jpg"] : (wantTiff ? ["tiff", "tif"] : ["png"]);
   var presets = __collectAllPresets();
 
   for (var n = 0; n < needles.length; n++) {
@@ -416,63 +429,102 @@ function __firstWrittenFile(outputPath) {
   }
 }
 
-// Export a single frame to disk. Returns { ok, method, path, notes } / { ok:false, error, notes }.
+// Premiere's own timecode string for a tick position, in the sequence's display
+// format (drop-frame sequences get semicolons, a "frames" display gets a bare frame
+// count). The QE still exporters take (timecodeString, pathWithoutExtension): a ticks
+// string is silently read as frame 0, a bare frame number is read as a timecode, and
+// the (path, width, height) call returns false without writing anything.
+function __qeTimecodeForTicks(seq, ticks) {
+  var tb = parseFloat(seq.timebase); // ticks per frame
+  var frameIdx = Math.floor(parseFloat(ticks) / tb + 0.000001);
+  if (!(frameIdx >= 0)) frameIdx = 0;
+  var frameTicks = frameIdx * tb;
+
+  var displayFormat = 100;
+  try { displayFormat = seq.getSettings().videoDisplayFormat; } catch (e) {}
+  try {
+    var fr = new Time(); fr.ticks = String(tb);
+    var t = new Time(); t.ticks = String(frameTicks);
+    if (typeof t.getFormatted === "function") {
+      return { timecode: t.getFormatted(fr, displayFormat), frame: frameIdx };
+    }
+  } catch (e2) {}
+
+  // Fallback: non-drop timecode at the nominal integer base (24 for 23.976, 30 for 29.97).
+  var nominal = Math.round(TICKS_PER_SECOND / tb);
+  var ff = frameIdx % nominal;
+  var s = Math.floor(frameIdx / nominal) % 60;
+  var m = Math.floor(frameIdx / (nominal * 60)) % 60;
+  var h = Math.floor(frameIdx / (nominal * 3600));
+  return { timecode: __pad(h) + ":" + __pad(m) + ":" + __pad(s) + ":" + __pad(ff), frame: frameIdx };
+}
+
+// Export a single frame to disk. Returns { ok, method, path, notes, timecode, frame }
+// / { ok:false, error, notes }.
 //
 // exportFramePNG/exportFrameJPEG do NOT exist on the public DOM sequence — only on
-// the QE sequence — and even there they return false and write nothing on some
-// builds. So we try QE first, verify against the filesystem rather than the return
-// value, and fall back to a one-frame Media Encoder export.
+// the QE sequence — where they take a timecode string and a path WITHOUT extension
+// (they append .png / .jpg themselves). The playhead is never moved: the timecode
+// argument alone selects the frame. We verify against the filesystem rather than the
+// return value, and fall back to a one-frame Media Encoder export.
 function __exportStillFrame(outputPath, ticks) {
   var seq = app.project.activeSequence;
   if (!seq) return { ok: false, error: "No active sequence", notes: [] };
 
   var notes = [];
-  var savedPos = null;
-  try { savedPos = seq.getPlayerPosition().ticks; } catch (e) {}
-
-  if (ticks) {
-    try { seq.setPlayerPosition(String(ticks)); } catch (e) { notes.push("setPlayerPosition: " + e.toString()); }
-  }
   var atTicks = ticks;
   if (!atTicks) {
     try { atTicks = seq.getPlayerPosition().ticks; } catch (e) { atTicks = "0"; }
   }
 
-  // Clear any stale file so that a file existing afterwards proves we wrote it.
+  var dot = outputPath.lastIndexOf(".");
+  var slash = Math.max(outputPath.lastIndexOf("/"), outputPath.lastIndexOf("\\\\"));
+  var ext = dot > slash ? outputPath.substring(dot).toLowerCase() : "";
+  if (ext === "") { outputPath = outputPath + ".png"; ext = ".png"; }
+  var basePath = outputPath.substring(0, outputPath.length - ext.length);
+  var wantJpeg = ext === ".jpg" || ext === ".jpeg";
+  var qeCanWrite = wantJpeg || ext === ".png";
+  var qePath = basePath + (wantJpeg ? ".jpg" : ".png");
+
+  // Clear any stale file (under either name) so that a file existing afterwards proves we wrote it.
   var stale = new File(outputPath);
   if (stale.exists) { try { stale.remove(); } catch (e) {} }
-
-  var wantJpeg = /\\.jpe?g$/i.test(outputPath);
-
-  // --- Path 1: QE DOM. Signature is (path, width, height) with string args. ---
-  try {
-    app.enableQE();
-    var qeSeq = qe.project.getActiveSequence();
-    if (!qeSeq) {
-      notes.push("QE: no active sequence");
-    } else {
-      var fn = wantJpeg ? qeSeq.exportFrameJPEG : qeSeq.exportFramePNG;
-      if (typeof fn !== "function") {
-        notes.push("QE: exportFrame" + (wantJpeg ? "JPEG" : "PNG") + " unavailable on this build");
+  var staleQe = new File(qePath);
+  if (staleQe.exists) { try { staleQe.remove(); } catch (e) {} }
+
+  // --- Path 1: QE DOM. Signature is (timecodeString, pathWithoutExtension). ---
+  var at = null;
+  if (!qeCanWrite) {
+    notes.push("QE: no still exporter for " + ext + "; using Media Encoder");
+  } else {
+    try {
+      app.enableQE();
+      var qeSeq = qe.project.getActiveSequence();
+      if (!qeSeq) {
+        notes.push("QE: no active sequence");
       } else {
-        var w = String(seq.frameSizeHorizontal);
-        var h = String(seq.frameSizeVertical);
-        try {
-          notes.push("QE returned " + fn.call(qeSeq, outputPath, w, h));
-        } catch (eArgs) {
-          try { notes.push("QE returned " + fn.call(qeSeq, outputPath, w)); }
-          catch (eArgs2) { notes.push("QE: " + eArgs2.toString()); }
+        var fn = wantJpeg ? qeSeq.exportFrameJPEG : qeSeq.exportFramePNG;
+        if (typeof fn !== "function") {
+          notes.push("QE: exportFrame" + (wantJpeg ? "JPEG" : "PNG") + " unavailable on this build");
+        } else {
+          at = __qeTimecodeForTicks(seq, atTicks);
+          notes.push("QE " + qeSeq.name + " @ " + at.timecode + " (frame " + at.frame + ") returned " + fn.call(qeSeq, at.timecode, basePath));
         }
       }
+    } catch (eQE) {
+      notes.push("QE: " + eQE.toString());
     }
-  } catch (eQE) {
-    notes.push("QE: " + eQE.toString());
+  }
+
+  // QE always names the file base + ".png"/".jpg"; give the caller the name they asked for.
+  var produced = new File(qePath);
+  if (qePath !== outputPath && produced.exists && produced.length > 0) {
+    try { produced.rename(decodeURI(new File(outputPath).name)); } catch (e) {}
   }
 
   var written = __firstWrittenFile(outputPath);
   if (written) {
-    if (savedPos) { try { seq.setPlayerPosition(savedPos); } catch (e) {} }
-    return { ok: true, method: "qe", path: written, notes: notes };
+    return { ok: true, method: "qe", path: written, notes: notes, timecode: at ? at.timecode : null, frame: at ? at.frame : null };
   }
   notes.push("QE wrote no file; falling back to Media Encoder");
 
@@ -511,10 +563,8 @@ function __exportStillFrame(outputPath, ticks) {
     notes.push("AME: " + eAME.toString());
   }
 
-  if (savedPos) { try { seq.setPlayerPosition(savedPos); } catch (e) {} }
-
   written = __firstWrittenFile(outputPath);
-  if (written) return { ok: true, method: "ame", path: written, notes: notes };
+  if (written) return { ok: true, method: "ame", path: written, notes: notes, timecode: null, frame: null };
 
   return {
     ok: false,

package/dist/client-config.d.ts

@@ -0,0 +1,11 @@
+export declare const CLIENT_CONFIG_TARGETS: readonly ["claude", "cursor", "vscode", "codex"];
+export type ClientConfigTarget = typeof CLIENT_CONFIG_TARGETS[number];
+/** Resolve this action before any installer, update, or server startup branch. */
+export declare function parseClientConfigAction(args: string[]): ClientConfigTarget | undefined;
+/**
+ * Print a mergeable entry for this installed copy, bypassing the shared global
+ * command name. No file/config inspection, environment copying, or host contact.
+ * Paths are intentionally local and must not be included in public diagnostics.
+ */
+export declare function renderClientConfig(target: ClientConfigTarget, nodeExecutable: string, serverEntrypoint: string, platform?: NodeJS.Platform): string;
+//# sourceMappingURL=client-config.d.ts.map

package/dist/client-config.js

@@ -0,0 +1,37 @@
+import path from "node:path";
+export const CLIENT_CONFIG_TARGETS = ["claude", "cursor", "vscode", "codex"];
+const usage = "Usage: premiere-pro-mcp --print-client-config <claude|cursor|vscode|codex>. Use this action alone.";
+/** Resolve this action before any installer, update, or server startup branch. */
+export function parseClientConfigAction(args) {
+    if (!args.some((arg) => arg === "--print-client-config" || arg.startsWith("--print-client-config=")))
+        return undefined;
+    if (args.length !== 2 || args[0] !== "--print-client-config" ||
+        !CLIENT_CONFIG_TARGETS.includes(args[1])) {
+        throw new Error(usage);
+    }
+    return args[1];
+}
+/**
+ * Print a mergeable entry for this installed copy, bypassing the shared global
+ * command name. No file/config inspection, environment copying, or host contact.
+ * Paths are intentionally local and must not be included in public diagnostics.
+ */
+export function renderClientConfig(target, nodeExecutable, serverEntrypoint, platform = process.platform) {
+    if (!CLIENT_CONFIG_TARGETS.includes(target))
+        throw new Error(usage);
+    const paths = platform === "win32" ? path.win32 : path.posix;
+    for (const value of [nodeExecutable, serverEntrypoint]) {
+        if (!paths.isAbsolute(value) || /[\u0000-\u001f\u007f]/u.test(value) || value.includes("${")) {
+            throw new Error("Client configuration requires absolute paths without control characters or client variable expressions.");
+        }
+    }
+    const entry = { command: nodeExecutable, args: [serverEntrypoint] };
+    if (target === "codex") {
+        return `[mcp_servers.premiere-pro-leancoderkavy]\ncommand = ${JSON.stringify(entry.command)}\nargs = ${JSON.stringify(entry.args)}\n`;
+    }
+    const config = target === "vscode"
+        ? { servers: { "premiere-pro-leancoderkavy": { type: "stdio", ...entry } } }
+        : { mcpServers: { "premiere-pro-leancoderkavy": entry } };
+    return `${JSON.stringify(config, null, 2)}\n`;
+}
+//# sourceMappingURL=client-config.js.map

package/dist/homepage-experiment.d.ts

@@ -0,0 +1,30 @@
+import type http from "node:http";
+export declare const HOMEPAGE_FLAG = "homepage-cinematic-2026";
+export type HomepageVariant = "control" | "test";
+type Properties = Record<string, string | number | boolean>;
+export interface HomepageAnalytics {
+    evaluate(id: string): Promise<unknown>;
+    capture(id: string, event: string, properties: Properties): void;
+    shutdown(): Promise<void>;
+}
+export declare function homepageAnalyticsPermitted(req: Pick<http.IncomingMessage, "headers">): boolean;
+/** Isolated from MCP telemetry: each visitor gets an anonymous identity. */
+export declare class HomepageExperiment {
+    private readonly client;
+    private readonly secret;
+    private readonly enabled;
+    private readonly decisions;
+    private readonly eventCounts;
+    private evaluations;
+    constructor(client: HomepageAnalytics | undefined, secret: string, enabled: boolean);
+    private get active();
+    private sign;
+    private read;
+    private cookie;
+    assign(req: http.IncomingMessage, res: http.ServerResponse): Promise<HomepageVariant | undefined>;
+    handleEvent(req: http.IncomingMessage, res: http.ServerResponse): Promise<void>;
+    shutdown(): Promise<void>;
+}
+export declare function createHomepageExperiment(env?: NodeJS.ProcessEnv): HomepageExperiment;
+export {};
+//# sourceMappingURL=homepage-experiment.d.ts.map