premiere-pro-mcp 1.6.0 → 1.7.0

package/CHANGELOG.md

@@ -6,6 +6,27 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [1.7.0] - 2026-08-01
+
+### Added
+
+- Added six capability-gated Premiere 26.3+ UXP tools: `rename_track_uxp`,
+  `create_subclip_uxp`, `list_markers_uxp`, `set_source_monitor_position_uxp`,
+  `has_transcript_uxp`, and `export_aaf_uxp`.
+- Added Adobe 26.3 coverage documentation and contract tests for the public MCP
+  schemas, protocol commands, and live-host verification gate.
+
+### Changed
+
+- Documented the stable 26.3 baseline separately from Adobe's 26.5 beta type
+  declarations. Beta-only APIs are not advertised as supported.
+
+### Validation
+
+- Automated contract tests validate catalog exposure, argument translation, host
+  capability probes, and result envelopes. A real Premiere 26.3+ host still must
+  validate each mutation and export before it can be called live-host verified.
+
 ## [1.6.0] - 2026-07-31
 
 ### Added

package/README.md

@@ -1,12 +1,12 @@
 <div align="center">
 
-# Premiere Pro MCP Server
+# Premiere Pro MCP
 
 [![MCP Toplist](https://mcptoplist.com/badge/glama%2Fleancoderkavy%2Fpremiere-pro-mcp.svg)](https://mcptoplist.com/server/glama%2Fleancoderkavy%2Fpremiere-pro-mcp)
 
 **Give AI full control over Adobe Premiere Pro.**
 
-279 core tools across 31 modules, 3 resources, and 4 guided workflows. A connected UXP host adds 10 capability-gated tools.
+279 core tools across 31 modules, 3 resources, and 4 guided workflows. A connected UXP host adds 16 capability-gated tools.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![Node.js](https://img.shields.io/badge/Node.js-20.19%2B-green.svg)](https://nodejs.org)
@@ -27,14 +27,14 @@ An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that l
 "Add the B-roll clips to V2, apply a cross dissolve between each, color correct them to match the A-roll, and export a 1080p ProRes."
 ```
 
-The AI handles the entire workflow through 279 core tools spanning the supported ExtendScript, QE DOM, local media analysis, and safe edit-planning surfaces. A compatible, authenticated UXP panel adds 10 documented, capability-gated workflows without replacing the production CEP bridge.
+The AI handles the entire workflow through 279 core tools spanning the supported ExtendScript, QE DOM, local media analysis, and safe edit-planning surfaces. A compatible, authenticated UXP panel adds 16 documented, capability-gated workflows without replacing the production CEP bridge.
 
-### What's new in 1.6.0
+### What's new in 1.7.0
 
-- **Capability-aware UXP foundation:** compatible Premiere 25.6-26.3 hosts can expose revisioned project inspection, verified saves, preset sequence creation, OTIO/FCP XML interchange, transcript-language discovery, Object Mask detection, and Adobe Media Encoder controls.
-- **Retry-safe UXP mutations:** optional operation IDs prevent a client retry from repeating a completed command in the same panel session, while each command reports `verified` or `committed_unverified` evidence honestly.
-- **Safe project creation:** `create_project` rejects directory paths and verifies Premiere opened the requested `.prproj` before reporting success.
-- **Current distribution metadata:** the CEP/UXP panels, Codex and Claude plugins, landing page, and npm package now all identify v1.6.0.
+- **Six documented workflows:** compatible 26.3+ hosts can expose UXP track renaming, subclip creation, stable marker IDs, Source Monitor seeking, transcript presence checks, and AAF export.
+- **Capability first:** a tool is discoverable only with the authenticated local panel; the panel's live `capabilities.get` response—not package metadata—decides whether the current host supports it.
+- **Evidence boundary:** automated tests validate schemas, routing, capability declarations, transactions, and result envelopes. They do not verify a specific Premiere installation. See [Adobe UXP 26.3 coverage](docs/adobe-uxp-26.3-coverage.md) for the exact host gate and the stable-versus-beta policy.
+- **Adobe-aligned validation:** the official Premiere 26.3 declarations and ESLint rules now enforce supported signatures and lock/transaction boundaries in CI.
 
 ### Added in 1.2.0
 
@@ -248,11 +248,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.6.0 --install-cep
+npx -y premiere-pro-mcp@1.7.0 --install-cep
 ```
 
 Restart Premiere Pro and start a new Codex session after installation. The plugin
-launches `premiere-pro-mcp@1.6.0` through `npx`; the separate CEP installation is
+launches `premiere-pro-mcp@1.7.0` through `npx`; the separate CEP installation is
 required because the MCP server communicates with the running Premiere host through
 the local bridge.
 
@@ -272,7 +272,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.6.0 --install-cep
+npx -y premiere-pro-mcp@1.7.0 --install-cep
 ```
 
 The Claude Code package lives in
@@ -362,14 +362,17 @@ PREMIERE_UXP_TOKEN="replace-with-a-long-random-secret" premiere-pro-mcp
 
 Enter the same token in the UXP panel. The listener binds only to `127.0.0.1:7777`, authenticates the WebSocket upgrade, requires a versioned capability handshake, correlates concurrent requests, and fails pending work on timeout or disconnect. Set `PREMIERE_UXP_PORT` to use another loopback port.
 
-When enabled, MCP discovery includes `get_uxp_capabilities`, `get_uxp_state`, `inspect_project_uxp`, `save_project_uxp`, `create_sequence_with_preset_uxp`, `export_interchange_uxp`, `get_transcript_languages_uxp`, `detect_object_masks_uxp`, `configure_encoder_uxp`, and `export_frame_uxp`. Commands are advertised only while the authenticated local UXP bridge is connected; the host capability handshake remains the authority for support in the running Premiere build. A failed UXP command is never silently retried through CEP because the first operation may have partially succeeded.
+When enabled, MCP discovery includes `get_uxp_capabilities`, `get_uxp_state`, `inspect_project_uxp`, `save_project_uxp`, `create_sequence_with_preset_uxp`, `export_interchange_uxp`, `get_transcript_languages_uxp`, `detect_object_masks_uxp`, `configure_encoder_uxp`, `export_frame_uxp`, `rename_track_uxp`, `create_subclip_uxp`, `list_markers_uxp`, `set_source_monitor_position_uxp`, `has_transcript_uxp`, and `export_aaf_uxp`. Commands are advertised only while the authenticated local UXP bridge is connected; the host capability handshake remains the authority for support in the running Premiere build. A failed UXP command is never silently retried through CEP because the first operation may have partially succeeded.
 
 Premiere 26.2-26.3 hosts also expose documented UXP workflows for revisioned project
 inspection, verified project saves, preset-based sequence creation, OTIO/FCP XML
-interchange, transcript-language discovery, Object Mask detection, and Adobe Media
-Encoder control. Mutations accept optional idempotency keys and return explicit
-verification outcomes. See [the UXP capability foundation](docs/uxp-capability-foundation.md)
-for the command matrix and live-host validation boundary.
+interchange, transcript-language discovery, Object Mask detection, Adobe Media
+Encoder control, track renaming, subclip creation, stable marker inspection,
+Source Monitor positioning, and clip transcript detection. Mutations accept optional
+idempotency keys and return explicit verification outcomes. See [the Adobe UXP 26.3
+coverage matrix](docs/adobe-uxp-26.3-coverage.md) and [the UXP capability
+foundation](docs/uxp-capability-foundation.md) for the command matrix and live-host
+validation boundary.
 
 ---
 
@@ -413,7 +416,7 @@ The file-based IPC bridge is simple, reliable, and works across macOS and Window
 
 ---
 
-## Tools (279 core total; 277 under the default profile; 287 with a connected UXP bridge)
+## Tools (279 core total; 277 under the default profile; 293 with a connected UXP bridge)
 
 ### Discovery & Inspection (10 + 10)
 

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.6.0" ExtensionBundleName="MCP Bridge">
+<ExtensionManifest Version="7.0" ExtensionBundleId="com.mcp.premiere.bridge" ExtensionBundleVersion="1.7.0" ExtensionBundleName="MCP Bridge">
   <ExtensionList>
-    <Extension Id="com.mcp.premiere.bridge.panel" Version="1.6.0"/>
-    <Extension Id="com.mcp.premiere.bridge.headless" Version="1.6.0"/>
+    <Extension Id="com.mcp.premiere.bridge.panel" Version="1.7.0"/>
+    <Extension Id="com.mcp.premiere.bridge.headless" Version="1.7.0"/>
   </ExtensionList>
   <ExecutionEnvironment>
     <HostList>

package/cep-plugin/index.html

@@ -65,7 +65,7 @@
     <section class="update-section" aria-live="polite">
       <div class="update-copy">
         <span class="section-label">Connector updates</span>
-        <strong id="updateTitle">Version 1.6.0</strong>
+        <strong id="updateTitle">Version 1.7.0</strong>
         <span id="updateDetail">Checking for updates…</span>
       </div>
       <button id="btnUpdate" class="button button-update" onclick="handleUpdateClick()" type="button" disabled>

package/cep-plugin/updater.cjs

@@ -7,7 +7,7 @@
 })(this, function () {
   "use strict";
 
-  var CURRENT_VERSION = "1.6.0";
+  var CURRENT_VERSION = "1.7.0";
   var LATEST_RELEASE_API =
     "https://api.github.com/repos/leancoderkavy/premiere-pro-mcp/releases/latest";
   var RELEASES_URL =

package/dist/advanced-feature-support.d.ts

@@ -94,6 +94,7 @@ export declare function buildAdvancedFeatureSupport(context?: AdvancedFeatureCon
         objectMask: {
             status: AdvancedFeatureStatus;
             callableThroughCurrentMcpTransport: boolean;
+            prerequisites: string[];
             supportedOperations: string[];
             unsupportedOperations: string[];
             userAssistedWorkflow: string;

package/dist/advanced-feature-support.js

@@ -108,12 +108,13 @@ export function buildAdvancedFeatureSupport(context = {}) {
                 detection: "No documented flag safely distinguishes a generated extension from an ordinary clip.",
             },
             objectMask: {
-                status: "user-assisted",
-                callableThroughCurrentMcpTransport: false,
-                supportedOperations: ["inspect ordinary effect components after a mask is created"],
-                unsupportedOperations: ["invoke object selection", "run tracking", "identify an Object Mask artifact reliably"],
-                userAssistedWorkflow: "Create and track the mask in Premiere, then use generic effect/property inspection where exposed.",
-                detection: "No documented stable Object Mask identifier is exposed.",
+                status: "partial",
+                callableThroughCurrentMcpTransport: true,
+                prerequisites: ["Premiere Pro 26.3+", "connected UXP bridge"],
+                supportedOperations: ["detect whether a project or sequence contains an Object Mask"],
+                unsupportedOperations: ["invoke object selection", "create an Object Mask", "run tracking", "edit Object Mask parameters"],
+                userAssistedWorkflow: "Create and track the mask in Premiere; the MCP can then detect its presence through the documented UXP API.",
+                detection: "Premiere Pro 26.3+ exposes ObjectMaskUtils.hasObjectMask through the documented UXP API.",
             },
             captionTranslation: {
                 status: "user-assisted",

package/dist/platform-capabilities.d.ts

@@ -2,6 +2,49 @@ import type { CapabilityConfig } from "./security/capabilities.js";
 import { type CatalogToolDefinition } from "./tool-capability-report.js";
 export declare const SUPPORTED_HOST_PLATFORMS: readonly ["darwin", "win32"];
 export type SupportedHostPlatform = (typeof SUPPORTED_HOST_PLATFORMS)[number];
+export type AdobeUxpCoverageAvailability = "current" | "planned";
+export type AdobeUxpCoverageImplementationStatus = "implemented" | "planned";
+export type AdobeUxpCoverageVerificationStatus = "automated_contract_verified" | "committed_unverified" | "not_started";
+export type AdobeUxpCoverageLiveHostVerificationStatus = "not_run" | "verified";
+export interface AdobeUxpCoverageEntry {
+    id: string;
+    adobeApi: string[];
+    documentationUrls: string[];
+    minimumPremiereVersion: string;
+    backend: "uxp";
+    uxpCommand: string | null;
+    mcpTools: string[];
+    availability: AdobeUxpCoverageAvailability;
+    implementationStatus: AdobeUxpCoverageImplementationStatus;
+    verificationStatus: AdobeUxpCoverageVerificationStatus;
+    liveHostVerificationStatus: AdobeUxpCoverageLiveHostVerificationStatus;
+    mutatesProject: boolean;
+    undoable: boolean;
+    idempotency: "operation_id" | "operation_id_when_supported" | "not_applicable";
+    verificationBoundary: string;
+}
+export interface AdobeUxpCoverageManifest {
+    schemaVersion: 1;
+    source: {
+        apiPackage: "@adobe/premierepro";
+        apiVersion: string;
+        changelogUrl: string;
+    };
+    entries: AdobeUxpCoverageEntry[];
+}
+export interface AdobeUxpCoverageReport extends AdobeUxpCoverageManifest {
+    summary: {
+        total: number;
+        current: number;
+        planned: number;
+        implemented: number;
+        committedUnverified: number;
+        automatedContractVerified: number;
+        liveHostVerified: number;
+    };
+}
+export declare const ADOBE_UXP_COVERAGE_MANIFEST: AdobeUxpCoverageManifest;
+export declare function buildAdobeUxpCoverageReport(): AdobeUxpCoverageReport;
 export declare function platformName(platform: NodeJS.Platform): string;
 export declare function buildPlatformCapabilityReport(capabilities: CapabilityConfig, platform?: NodeJS.Platform, tempDirectory?: string, toolCatalog?: Record<string, CatalogToolDefinition>): {
     schemaVersion: number;
@@ -23,7 +66,7 @@ export declare function buildPlatformCapabilityReport(capabilities: CapabilityCo
             platforms: string[];
             premiereVersions: string;
             transport: string;
-            capabilities: ("edit" | "export" | "filesystem" | "inspect" | "unsafe-script")[];
+            capabilities: ("inspect" | "edit" | "export" | "filesystem" | "unsafe-script")[];
             delivery: {
                 interchange: string[];
                 presetValidation: boolean;
@@ -42,6 +85,7 @@ export declare function buildPlatformCapabilityReport(capabilities: CapabilityCo
             platforms: string[];
             premiereVersions: string;
             transport: string;
+            apiCoverage: AdobeUxpCoverageReport;
             commands: string[];
             unsupportedCommands: {
                 "captions.create": string;
@@ -59,8 +103,8 @@ export declare function buildPlatformCapabilityReport(capabilities: CapabilityCo
     };
     authority: {
         source: "default" | "environment" | "explicit";
-        enabled: ("edit" | "export" | "filesystem" | "inspect" | "unsafe-script")[];
-        disabled: ("edit" | "export" | "filesystem" | "inspect" | "unsafe-script")[];
+        enabled: ("inspect" | "edit" | "export" | "filesystem" | "unsafe-script")[];
+        disabled: ("inspect" | "edit" | "export" | "filesystem" | "unsafe-script")[];
     };
     tools: {
         schemaVersion: number;

package/dist/platform-capabilities.js

@@ -1,8 +1,146 @@
+import { createRequire } from "node:module";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { buildToolCapabilityReport, } from "./tool-capability-report.js";
 export const SUPPORTED_HOST_PLATFORMS = ["darwin", "win32"];
 const ALL_CAPABILITIES = ["inspect", "edit", "export", "filesystem", "unsafe-script"];
+const require = createRequire(import.meta.url);
+const adobeUxpCoverage = require("./resources/adobe-uxp-coverage.json");
+function asRecord(value, label) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`${label} must be an object`);
+    }
+    return value;
+}
+function stringArray(value, label) {
+    if (!Array.isArray(value) || value.length === 0 || value.some((item) => typeof item !== "string" || !item)) {
+        throw new Error(`${label} must be a non-empty string array`);
+    }
+    return value;
+}
+function stringValue(value, label) {
+    if (typeof value !== "string" || !value)
+        throw new Error(`${label} must be a non-empty string`);
+    return value;
+}
+function validateDocumentationUrl(value, label) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new Error(`${label} must be a valid URL`);
+    }
+    if (url.protocol !== "https:" || url.hostname !== "developer.adobe.com" || !url.pathname.startsWith("/premiere-pro/uxp/")) {
+        throw new Error(`${label} must point to the official Premiere Pro UXP documentation`);
+    }
+}
+function validateAdobeUxpCoverageManifest(value) {
+    const manifest = asRecord(value, "Adobe UXP coverage manifest");
+    if (manifest.schemaVersion !== 1)
+        throw new Error("Adobe UXP coverage manifest schemaVersion must be 1");
+    const source = asRecord(manifest.source, "Adobe UXP coverage manifest source");
+    if (source.apiPackage !== "@adobe/premierepro") {
+        throw new Error("Adobe UXP coverage manifest must identify @adobe/premierepro as its source package");
+    }
+    const apiVersion = stringValue(source.apiVersion, "Adobe UXP coverage manifest source.apiVersion");
+    const changelogUrl = stringValue(source.changelogUrl, "Adobe UXP coverage manifest source.changelogUrl");
+    validateDocumentationUrl(changelogUrl, "Adobe UXP coverage manifest source.changelogUrl");
+    if (!Array.isArray(manifest.entries) || manifest.entries.length === 0) {
+        throw new Error("Adobe UXP coverage manifest entries must be a non-empty array");
+    }
+    const ids = new Set();
+    const entries = manifest.entries.map((rawEntry, index) => {
+        const label = `Adobe UXP coverage manifest entry ${index}`;
+        const entry = asRecord(rawEntry, label);
+        const id = stringValue(entry.id, `${label}.id`);
+        if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(id) || ids.has(id)) {
+            throw new Error(`${label}.id must be a unique kebab-case identifier`);
+        }
+        ids.add(id);
+        const documentationUrls = stringArray(entry.documentationUrls, `${label}.documentationUrls`);
+        documentationUrls.forEach((url) => validateDocumentationUrl(url, `${label}.documentationUrls`));
+        const availability = entry.availability;
+        if (availability !== "current" && availability !== "planned") {
+            throw new Error(`${label}.availability must be current or planned`);
+        }
+        const implementationStatus = entry.implementationStatus;
+        if (implementationStatus !== "implemented" && implementationStatus !== "planned") {
+            throw new Error(`${label}.implementationStatus must be implemented or planned`);
+        }
+        const verificationStatus = entry.verificationStatus;
+        if (verificationStatus !== "automated_contract_verified"
+            && verificationStatus !== "committed_unverified"
+            && verificationStatus !== "not_started") {
+            throw new Error(`${label}.verificationStatus is not supported`);
+        }
+        const liveHostVerificationStatus = entry.liveHostVerificationStatus;
+        if (liveHostVerificationStatus !== "not_run" && liveHostVerificationStatus !== "verified") {
+            throw new Error(`${label}.liveHostVerificationStatus is not supported`);
+        }
+        const idempotency = entry.idempotency;
+        if (idempotency !== "operation_id" && idempotency !== "operation_id_when_supported" && idempotency !== "not_applicable") {
+            throw new Error(`${label}.idempotency is not supported`);
+        }
+        if (entry.backend !== "uxp")
+            throw new Error(`${label}.backend must be uxp`);
+        if (entry.uxpCommand !== null && typeof entry.uxpCommand !== "string") {
+            throw new Error(`${label}.uxpCommand must be a string or null`);
+        }
+        if (typeof entry.mutatesProject !== "boolean" || typeof entry.undoable !== "boolean") {
+            throw new Error(`${label} mutation metadata must be boolean`);
+        }
+        return {
+            id,
+            adobeApi: stringArray(entry.adobeApi, `${label}.adobeApi`),
+            documentationUrls,
+            minimumPremiereVersion: stringValue(entry.minimumPremiereVersion, `${label}.minimumPremiereVersion`),
+            backend: "uxp",
+            uxpCommand: entry.uxpCommand,
+            mcpTools: stringArray(entry.mcpTools, `${label}.mcpTools`),
+            availability,
+            implementationStatus,
+            verificationStatus,
+            liveHostVerificationStatus,
+            mutatesProject: entry.mutatesProject,
+            undoable: entry.undoable,
+            idempotency,
+            verificationBoundary: stringValue(entry.verificationBoundary, `${label}.verificationBoundary`),
+        };
+    });
+    return {
+        schemaVersion: 1,
+        source: {
+            apiPackage: "@adobe/premierepro",
+            apiVersion,
+            changelogUrl,
+        },
+        entries,
+    };
+}
+export const ADOBE_UXP_COVERAGE_MANIFEST = validateAdobeUxpCoverageManifest(adobeUxpCoverage);
+export function buildAdobeUxpCoverageReport() {
+    const entries = ADOBE_UXP_COVERAGE_MANIFEST.entries.map((entry) => ({
+        ...entry,
+        adobeApi: [...entry.adobeApi],
+        documentationUrls: [...entry.documentationUrls],
+        mcpTools: [...entry.mcpTools],
+    }));
+    return {
+        schemaVersion: ADOBE_UXP_COVERAGE_MANIFEST.schemaVersion,
+        source: { ...ADOBE_UXP_COVERAGE_MANIFEST.source },
+        entries,
+        summary: {
+            total: entries.length,
+            current: entries.filter((entry) => entry.availability === "current").length,
+            planned: entries.filter((entry) => entry.availability === "planned").length,
+            implemented: entries.filter((entry) => entry.implementationStatus === "implemented").length,
+            committedUnverified: entries.filter((entry) => entry.verificationStatus === "committed_unverified").length,
+            automatedContractVerified: entries.filter((entry) => entry.verificationStatus === "automated_contract_verified").length,
+            liveHostVerified: entries.filter((entry) => entry.liveHostVerificationStatus === "verified").length,
+        },
+    };
+}
 export function platformName(platform) {
     if (platform === "darwin")
         return "macOS";
@@ -53,6 +191,7 @@ export function buildPlatformCapabilityReport(capabilities, platform = process.p
                 platforms: ["macOS", "Windows"],
                 premiereVersions: "25.6+",
                 transport: "loopback WebSocket",
+                apiCoverage: buildAdobeUxpCoverageReport(),
                 commands: [
                     "capabilities.get",
                     "state.get",