premiere-pro-mcp 1.2.3 → 1.3.1

package/CHANGELOG.md

@@ -6,6 +6,37 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [1.3.1] - 2026-07-25
+
+### Fixed
+
+- Fixed `set_sequence_frame_rate` to convert frames per second into Premiere's required
+  ticks-per-frame `Time` value and verify the applied setting instead of assigning a numeric frame
+  period that could corrupt the sequence timebase. ([#37](https://github.com/leancoderkavy/premiere-pro-mcp/issues/37))
+
+## [1.3.0] - 2026-07-25
+
+### Added
+
+- Added a Windows release workflow that builds and verifies a signed CEP ZXP with Adobe's pinned
+  `ZXPSignCmd`, includes it in the npm package, and installs it ahead of the unsigned development
+  bundle.
+- Added `--diagnose-cep` to verify installation metadata, debug-key types, and recent Premiere
+  signature failures.
+
+### Changed
+
+- Upgraded the toolchain to TypeScript 7, Vitest 4, Zod 4, `@types/node` 26, and
+  `@modelcontextprotocol/sdk` 1.29.
+- Updated the landing app to Next.js 16.2.12 and patched production transitive dependencies.
+- Raised the supported Node.js floor to 20.19 and expanded CI through Node.js 24.
+
+### Fixed
+
+- Added explicit Node types for TypeScript 7 and updated Zod 4 JSON-schema conversion.
+- Fixed Windows installations that require a signed CEP extension instead of the debug-mode raw
+  folder used by development builds. ([#36](https://github.com/leancoderkavy/premiere-pro-mcp/issues/36))
+
 ## [1.2.3] - 2026-07-23
 
 ### Changed

package/README.md

@@ -7,8 +7,8 @@
 269 tools across 29 modules, 3 resources, and 4 guided workflows.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![Node.js](https://img.shields.io/badge/Node.js-18%2B-green.svg)](https://nodejs.org)
-[![MCP](https://img.shields.io/badge/MCP-1.27-purple.svg)](https://modelcontextprotocol.io)
+[![Node.js](https://img.shields.io/badge/Node.js-20.19%2B-green.svg)](https://nodejs.org)
+[![MCP](https://img.shields.io/badge/MCP-1.29-purple.svg)](https://modelcontextprotocol.io)
 [![npm](https://img.shields.io/npm/v/premiere-pro-mcp.svg)](https://www.npmjs.com/package/premiere-pro-mcp)
 [![Fly.io](https://img.shields.io/badge/Fly.io-deployed-7C3AED.svg)](https://premiere-pro-mcp.fly.dev)
 [![Premiere Pro](https://img.shields.io/badge/Premiere%20Pro-2020--2026-9999FF.svg)](https://www.adobe.com/products/premiere.html)
@@ -19,23 +19,24 @@
 
 ## What is this?
 
-An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that lets AI assistants like **Claude**, **Windsurf**, **Cursor**, or any MCP-compatible client directly control Adobe Premiere Pro — importing media, editing timelines, applying effects, managing keyframes, exporting, and more.
+An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that lets AI assistants like **Claude**, **Windsurf**, **Cursor**, **GitHub Copilot**, or any MCP-compatible client directly control Adobe Premiere Pro — importing media, editing timelines, applying effects, managing keyframes, exporting, and more.
 
-```
+```text
 "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 269 tools spanning the supported ExtendScript, QE DOM, and safe edit-planning surfaces.
 
-### What's new in 1.2.3
+### What's new in 1.3.1
 
-- npm and GitHub metadata now target Adobe Premiere Pro MCP, AI video editing, automation, and
-  Model Context Protocol discovery terms with explicit TypeScript and public-registry metadata.
-- npm repository, homepage, issue, and clone links now point to the maintained project.
-- Mutation tools now verify Premiere state, audio dB is converted to amplitude correctly, and
-  affected Premiere Pro 26.3 hosts return actionable errors instead of false success.
-- npm publishing now has a guided local helper and a GitHub Actions workflow so releases can be
-  published without repeating manual auth and validation steps.
+- Windows npm releases now include a verified, signed CEP ZXP and install it automatically, covering
+  hosts that reject the raw development bundle even when `PlayerDebugMode` is enabled.
+- `set_sequence_frame_rate` now converts frames per second to Premiere ticks per frame and verifies
+  the applied setting instead of assigning a numeric frame period.
+- `premiere-pro-mcp --diagnose-cep` checks the installed manifest, debug-key types, and recent
+  Premiere signature failures.
+- TypeScript 7, Vitest 4, Zod 4, MCP SDK 1.29, Next.js 16.2, and patched transitive dependencies
+  modernize the toolchain and remove production audit findings.
 
 ### Added in 1.2.0
 
@@ -189,6 +190,24 @@ Add to `.cursor/mcp.json` in your project or global config:
 
 </details>
 
+<details>
+<summary><strong>GitHub Copilot (VS Code)</strong></summary>
+
+Add to your VS Code MCP server configuration:
+
+```json
+{
+  "mcpServers": {
+    "premiere-pro": {
+      "command": "node",
+      "args": ["/absolute/path/to/premiere-pro-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+</details>
+
 ### 4. Verify the bridge in Premiere Pro
 
 1. Open (or restart) Premiere Pro
@@ -201,7 +220,7 @@ The default bridge directory is derived from the operating system on both sides,
 ### Windows and macOS capability coverage
 
 | Surface | Windows | macOS | Verification boundary |
-|---|---|---|---|
+| :------ | :------ | :---- | :-------------------- |
 | CEP production bridge | Premiere Pro 2020–2026 | Premiere Pro 2020–2026 | Run `get_capabilities`, then `ping` with Premiere open |
 | UXP preview bridge | Premiere Pro 25.6+ | Premiere Pro 25.6+ | Live loopback WebSocket and host API verification required |
 | npm CEP installer | Copies plugin and verifies `REG_SZ` debug keys | Copies plugin and verifies the installed manifest/debug settings | Restart Premiere after installation |
@@ -214,28 +233,31 @@ The default bridge directory is derived from the operating system on both sides,
 ## Architecture
 
 **Local (stdio):**
-```
-┌───────────────┐   stdio (MCP)   ┌──────────────┐   File-based IPC   ┌──────────────┐
-│  AI Client    │ ◄──────────────► │  MCP Server  │ ◄────────────────► │  CEP Plugin  │
+
+```text
+┌───────────────┐   stdio (MCP)    ┌──────────────┐   File-based IPC   ┌───────────────┐
+│  AI Client    │ ◄──────────────► │  MCP Server  │ ◄────────────────► │  CEP Plugin   │
 │  (Claude,     │                  │  (Node.js /  │   .jsx commands    │  (runs inside │
-│   Windsurf,   │                  │   TypeScript) │   .json responses  │   Premiere)   │
-│   Cursor)     │                  └──────────────┘                    └──────┬────────┘
+│   Windsurf,   │                  │  TypeScript) │   .json responses  │  Premiere)    │
+│   Cursor,     │                  └──────────────┘                    └──────┬────────┘
+│   Copilot)    │                                                             │
 └───────────────┘                                                             │ evalScript()
                                                                               ▼
-                                                                       ┌──────────────┐
+                                                                       ┌───────────────┐
                                                                        │  Premiere Pro │
                                                                        │  ExtendScript │
                                                                        │  + QE DOM     │
-                                                                       └──────────────┘
+                                                                       └───────────────┘
 ```
 
 **Remote (HTTP/SSE — Fly.io):**
-```
+
+```text
 ┌───────────────┐  HTTP+SSE (MCP)  ┌─────────────────────┐   File-based IPC   ┌──────────────┐
-│  AI Client    │ ◄───────────────► │  MCP Server         │ ◄────────────────► │  CEP Plugin  │
-│  (any MCP     │                   │  premiere-pro-mcp   │   .jsx / .json     │  (Premiere)  │
-│   client)     │                   │  .fly.dev           │   shared volume    └──────────────┘
-└───────────────┘                   └─────────────────────┘
+│  AI Client    │ ◄──────────────► │  MCP Server         │ ◄────────────────► │  CEP Plugin  │
+│  (any MCP     │                  │  premiere-pro-mcp   │   .jsx / .json     │  (Premiere)  │
+│   client)     │                  │  .fly.dev           │   shared volume    └──────────────┘
+└───────────────┘                  └─────────────────────┘
 ```
 
 1. AI client invokes an MCP tool (e.g., `add_to_timeline`)
@@ -248,12 +270,12 @@ The file-based IPC bridge is simple, reliable, and works across macOS and Window
 
 ---
 
-## Tools (268)
+## Tools (269)
 
 ### Discovery & Inspection (10 + 10)
 
 | Tool | Description |
-|------|-------------|
+| :--- | :---------- |
 | `get_project_info` | Current project name, path, sequences, items |
 | `get_active_sequence` | Detailed active sequence with all clips |
 | `list_project_items` | All items in the project panel |
@@ -268,7 +290,7 @@ The file-based IPC bridge is simple, reliable, and works across macOS and Window
 ### Project Management (26)
 
 | Tool | Description |
-|------|-------------|
+| :--- | :---------- |
 | `save_project` / `save_project_as` / `open_project` | File operations |
 | `create_project` / `close_project` | Project lifecycle |
 | `import_media` / `import_folder` / `import_ae_comps` | Import media and AE comps |
@@ -281,7 +303,7 @@ The file-based IPC bridge is simple, reliable, and works across macOS and Window
 ### Timeline & Editing (10 + 27 advanced)
 
 | Tool | Description |
-|------|-------------|
+| :--- | :---------- |
 | `add_to_timeline` / `overwrite_clip` | Insert and overwrite edits |
 | `ripple_delete` | Remove clip and close gap (QE) |
 | `roll_edit` / `slide_edit` / `slip_edit` | Professional trim modes (QE) |
@@ -302,7 +324,7 @@ The file-based IPC bridge is simple, reliable, and works across macOS and Window
 ### Effects & Color (8)
 
 | Tool | Description |
-|------|-------------|
+| :--- | :---------- |
 | `apply_effect` / `apply_audio_effect` | Apply by name (QE) |
 | `remove_effect` / `remove_all_effects` | Remove effects |
 | `color_correct` | Lumetri: exposure, contrast, temperature, etc. |
@@ -312,7 +334,7 @@ The file-based IPC bridge is simple, reliable, and works across macOS and Window
 ### Keyframes (8)
 
 | Tool | Description |
-|------|-------------|
+| :--- | :---------- |
 | `add_keyframe` / `get_keyframes` | Create and read keyframes |
 | `remove_keyframe` / `remove_keyframe_range` | Delete keyframes |
 | `set_keyframe_interpolation` | Linear / Hold / Bezier |
@@ -322,7 +344,7 @@ The file-based IPC bridge is simple, reliable, and works across macOS and Window
 ### Export & Encoding (14)
 
 | Tool | Description |
-|------|-------------|
+| :--- | :---------- |
 | `export_sequence` | Export via Adobe Media Encoder |
 | `capture_frame` | Export frame as PNG, return as base64 image |
 | `export_as_fcp_xml` / `export_aaf` / `export_omf` | Interchange formats |
@@ -332,7 +354,7 @@ The file-based IPC bridge is simple, reliable, and works across macOS and Window
 ### Source Monitor & Playback (7 + 4)
 
 | Tool | Description |
-|------|-------------|
+| :--- | :---------- |
 | `open_in_source` / `close_source_monitor` | Source monitor control |
 | `insert_from_source` / `overwrite_from_source` | 3-point editing |
 | `play_timeline` / `stop_playback` | Playback control (QE) |
@@ -341,7 +363,7 @@ The file-based IPC bridge is simple, reliable, and works across macOS and Window
 ### Selection & Clipboard (7 + 6)
 
 | Tool | Description |
-|------|-------------|
+| :--- | :---------- |
 | `select_clips_by_name` / `select_clips_in_range` | Smart selection |
 | `copy_effects_between_clips` | Copy effects via QE |
 | `batch_apply_effect` | Apply effect to multiple clips |
@@ -350,7 +372,7 @@ The file-based IPC bridge is simple, reliable, and works across macOS and Window
 ### Media Properties (16)
 
 | Tool | Description |
-|------|-------------|
+| :--- | :---------- |
 | `set_offline` / `has_proxy` / `detach_proxy` | Offline/proxy management |
 | `set_override_frame_rate` | Override FPS |
 | `set_scale_to_frame_size` | Auto-scale to sequence frame |
@@ -360,7 +382,7 @@ The file-based IPC bridge is simple, reliable, and works across macOS and Window
 ### Sequence Management (11)
 
 | Tool | Description |
-|------|-------------|
+| :--- | :---------- |
 | `create_sequence` / `create_sequence_from_preset` | Create sequences from `.sqpreset` files without opening Premiere's modal dialog |
 | `duplicate_sequence` / `delete_sequence` | Manage sequences |
 | `auto_reframe_sequence` | Auto-reframe for social media |
@@ -370,14 +392,14 @@ The file-based IPC bridge is simple, reliable, and works across macOS and Window
 ### Workspace & Captions (2 + 1)
 
 | Tool | Description |
-|------|-------------|
+| :--- | :---------- |
 | `get_workspaces` / `set_workspace` | Switch workspace layouts |
 | `create_caption_track` | Create caption/subtitle tracks |
 
 ### Scripting (6)
 
 | Tool | Description |
-|------|-------------|
+| :--- | :----------- |
 | `execute_extendscript` | Run arbitrary ExtendScript (ES3) |
 | `evaluate_expression` | Quick one-line eval |
 | `send_raw_script` | Bypass security validation (advanced) |
@@ -393,7 +415,7 @@ Track targeting, batch operations, markers, audio levels, motion/transform, meta
 The server exposes three LLM context resources and four workflow prompts:
 
 | Resource URI | Description |
-|-------------|-------------|
+| :----------- | :---------- |
 | `config://premiere-instructions` | Best practices: workflow order, timeline rules, effect tips, error handling |
 | `config://extendscript-reference` | Complete ExtendScript API reference for writing custom scripts |
 | `config://premiere-workflows` | Machine-readable catalog for rough cuts, dialogue cleanup, captions, and delivery |
@@ -434,6 +456,7 @@ fly deploy --remote-only
 ```
 
 Then connect with:
+
 ```json
 {
   "mcpServers": {
@@ -453,11 +476,12 @@ Then connect with:
 ## Environment Variables
 
 | Variable | Description | Default |
-|----------|-------------|--------|
+| :------- | :---------- | :------ |
 | `PREMIERE_TEMP_DIR` | Shared temp directory for MCP ↔ CEP communication | OS temp dir + `/premiere-mcp-bridge` |
 | `PREMIERE_TIMEOUT_MS` | Command timeout in milliseconds | `30000` |
 | `PREMIERE_DEFAULT_SEQUENCE_PRESET` | Override the auto-discovered `.sqpreset` used by `create_sequence` | auto-discovered |
 | `PREMIERE_MCP_CAPABILITIES` | Comma-separated authority profile; add `unsafe-script` only when raw scripting is required | `inspect,edit,export,filesystem` |
+| `PREMIERE_MCP_DEBUG` | Set to `1` (or `true`) to emit verbose server diagnostics to stderr | unset |
 | `PORT` | HTTP port (HTTP/SSE transport only) | `3000` |
 | `MCP_AUTH_TOKEN` | Bearer token required by the HTTP transport | unset |
 | `ALLOW_UNAUTHENTICATED` | Set to `1` to run HTTP without auth (unsafe; throwaway instances only) | unset |
@@ -466,16 +490,16 @@ Then connect with:
 
 ## Project Structure
 
-```
+```text
 premiere-pro-mcp/
 ├── src/
 │   ├── index.ts                 # Entry point — stdio transport setup
 │   ├── http-server.ts           # Entry point — HTTP/SSE transport (Fly.io / remote)
-│   ├── server.ts                # MCP server — registers 268 tools + 3 resources + 4 prompts
+│   ├── server.ts                # MCP server — registers 269 tools + 3 resources + 4 prompts
 │   ├── bridge/
 │   │   ├── file-bridge.ts       # File-based IPC (write .jsx, poll .json)
 │   │   └── script-builder.ts    # ExtendScript generator with ES3 helpers
-│   ├── tools/                   # 28 tool modules
+│   ├── tools/                   # 29 tool modules
 │   │   ├── discovery.ts         # Project discovery and queries
 │   │   ├── project.ts           # Project management and import
 │   │   ├── media.ts             # Media and proxy management
@@ -579,6 +603,11 @@ Many tools use the undocumented QE DOM (enabled via `app.enableQE()`). These too
    - Windows: `dir "%APPDATA%\Adobe\CEP\extensions\MCPBridgeCEP"`
 3. Completely restart Premiere Pro (not just close/reopen the project)
 4. Check the CSXS version matches your Premiere Pro version
+5. Run `premiere-pro-mcp --diagnose-cep` to check installation metadata and recent Premiere logs.
+
+Version 1.3.0 and newer installs the signed `artifacts/MCPBridgeCEP.zxp` included in the npm
+package on Windows. If diagnostics report `Signature verification failed`, reinstall the latest
+npm version, fully quit every Premiere process, run `premiere-pro-mcp --install-cep`, and relaunch.
 
 </details>
 

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

package/dist/index.js

@@ -8,6 +8,12 @@ import path from "path";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const projectRoot = path.resolve(__dirname, "..");
+const debugEnabled = /^(1|true|yes|on|debug)$/i.test(process.env.PREMIERE_MCP_DEBUG ?? "");
+function debugLog(message) {
+    if (debugEnabled) {
+        console.error(`[premiere-pro-mcp] ${message}`);
+    }
+}
 // Handle CLI flags
 const args = process.argv.slice(2);
 if (args.includes("--help") || args.includes("-h")) {
@@ -17,6 +23,7 @@ premiere-pro-mcp — MCP server for Adobe Premiere Pro (269 tools)
 Usage:
   premiere-pro-mcp              Start the MCP server (stdio transport)
   premiere-pro-mcp --install-cep   Install the CEP plugin into Premiere Pro
+  premiere-pro-mcp --diagnose-cep  Check the CEP install, debug keys, and Premiere signature logs
   premiere-pro-mcp --help          Show this help message
   premiere-pro-mcp --version       Show version
 
@@ -24,8 +31,9 @@ Environment variables:
   PREMIERE_TEMP_DIR     Shared temp directory (default: OS temp + /premiere-mcp-bridge)
   PREMIERE_TIMEOUT_MS   Command timeout in ms (default: 30000)
   PREMIERE_MCP_CAPABILITIES  Comma-separated authority profile
+  PREMIERE_MCP_DEBUG    Set to 1/true to enable verbose stderr diagnostics
 
-More info: https://github.com/ppmcp/premiere-pro-mcp
+More info: https://github.com/leancoderkavy/premiere-pro-mcp
 `);
     process.exit(0);
 }
@@ -34,8 +42,9 @@ if (args.includes("--version") || args.includes("-v")) {
     console.log(pkg.default.version);
     process.exit(0);
 }
-if (args.includes("--install-cep")) {
-    console.log("Installing CEP plugin...\n");
+if (args.includes("--install-cep") || args.includes("--diagnose-cep")) {
+    const diagnose = args.includes("--diagnose-cep");
+    console.log(diagnose ? "Diagnosing CEP plugin...\n" : "Installing CEP plugin...\n");
     const isWindows = process.platform === "win32";
     const isMacOS = process.platform === "darwin";
     if (!isWindows && !isMacOS) {
@@ -45,17 +54,23 @@ if (args.includes("--install-cep")) {
     const scriptPath = path.join(projectRoot, "scripts", isWindows ? "install-cep.ps1" : "install-cep.sh");
     try {
         if (isWindows) {
-            execFileSync("powershell.exe", ["-NoProfile", "-ExecutionPolicy", "Bypass", "-File", scriptPath], { stdio: "inherit", cwd: projectRoot });
+            const powershellArgs = ["-NoProfile", "-ExecutionPolicy", "Bypass", "-File", scriptPath];
+            if (diagnose)
+                powershellArgs.push("-Diagnose");
+            execFileSync("powershell.exe", powershellArgs, { stdio: "inherit", cwd: projectRoot });
         }
         else {
-            execFileSync("bash", [scriptPath, "--copy"], { stdio: "inherit", cwd: projectRoot });
+            execFileSync("bash", [scriptPath, diagnose ? "--diagnose" : "--copy"], {
+                stdio: "inherit",
+                cwd: projectRoot,
+            });
         }
     }
     catch {
-        console.error("CEP installation failed. Try running manually:");
+        console.error(`CEP ${diagnose ? "diagnostics" : "installation"} failed. Try running manually:`);
         console.error(isWindows
-            ? `  powershell -ExecutionPolicy Bypass -File "${scriptPath}"`
-            : `  bash "${scriptPath}"`);
+            ? `  powershell -ExecutionPolicy Bypass -File "${scriptPath}"${diagnose ? " -Diagnose" : ""}`
+            : `  bash "${scriptPath}" ${diagnose ? "--diagnose" : "--copy"}`);
         process.exit(1);
     }
     process.exit(0);
@@ -68,14 +83,14 @@ async function main() {
             : undefined,
     };
     const tempDir = getTempDir(bridgeOptions);
-    console.error(`[premiere-pro-mcp] Starting MCP server...`);
-    console.error(`[premiere-pro-mcp] Temp directory: ${tempDir}`);
+    debugLog("Starting MCP server...");
+    debugLog(`Temp directory: ${tempDir}`);
     // Clean up any stale files from previous sessions
     cleanupTempDir(bridgeOptions);
     const server = createServer(bridgeOptions);
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error(`[premiere-pro-mcp] Server connected and ready`);
+    debugLog("Server connected and ready");
 }
 main().catch((err) => {
     console.error("[premiere-pro-mcp] Fatal error:", err);

package/dist/platform-capabilities.d.ts

@@ -22,7 +22,7 @@ export declare function buildPlatformCapabilityReport(capabilities: CapabilityCo
             platforms: string[];
             premiereVersions: string;
             transport: string;
-            capabilities: ("inspect" | "edit" | "export" | "filesystem" | "unsafe-script")[];
+            capabilities: ("edit" | "export" | "filesystem" | "inspect" | "unsafe-script")[];
         };
         uxp: {
             status: string;
@@ -35,8 +35,8 @@ export declare function buildPlatformCapabilityReport(capabilities: CapabilityCo
     };
     authority: {
         source: "default" | "environment" | "explicit";
-        enabled: ("inspect" | "edit" | "export" | "filesystem" | "unsafe-script")[];
-        disabled: ("inspect" | "edit" | "export" | "filesystem" | "unsafe-script")[];
+        enabled: ("edit" | "export" | "filesystem" | "inspect" | "unsafe-script")[];
+        disabled: ("edit" | "export" | "filesystem" | "inspect" | "unsafe-script")[];
     };
 };
 //# sourceMappingURL=platform-capabilities.d.ts.map

package/dist/server.js

@@ -31,7 +31,7 @@ import { getEditPlanTools } from "./tools/edit-plans.js";
 import { guardToolHandler, resolveCapabilities } from "./security/index.js";
 import { EXTENDSCRIPT_REFERENCE } from "./resources/extendscript-reference.js";
 import { WORKFLOW_PROMPTS, WORKFLOW_RESOURCE } from "./workflows/catalog.js";
-import { annotationsForTool, structuredToolResult } from "./workflows/tool-metadata.js";
+import { annotationsForTool, structuredToolResult, } from "./workflows/tool-metadata.js";
 import { z } from "zod";
 const PREMIERE_INSTRUCTIONS = `You are controlling Adobe Premiere Pro through MCP tools. Follow these best practices:
 
@@ -96,6 +96,56 @@ CUSTOM SCRIPTING:
 `;
 const toolCatalogCache = new Map();
 const schemaCache = new WeakMap();
+const debugEnabled = /^(1|true|yes|on|debug)$/i.test(process.env.PREMIERE_MCP_DEBUG ?? "");
+function debugLog(message) {
+    if (debugEnabled) {
+        console.error(`[premiere-pro-mcp] ${message}`);
+    }
+}
+function jsonSchemaPropToZod(prop) {
+    const propType = prop.type;
+    if (propType === "string") {
+        if (prop.enum && Array.isArray(prop.enum) && prop.enum.length > 0) {
+            const enumValues = prop.enum;
+            return z.enum(enumValues);
+        }
+        return z.string();
+    }
+    if (propType === "number") {
+        return z.number();
+    }
+    if (propType === "boolean") {
+        return z.boolean();
+    }
+    if (propType === "array") {
+        const itemSchema = (prop.items ?? {});
+        // Use unknown as a safe fallback while still emitting a concrete items schema.
+        const itemZod = Object.keys(itemSchema).length > 0
+            ? jsonSchemaPropToZod(itemSchema)
+            : z.unknown();
+        return z.array(itemZod);
+    }
+    if (propType === "object") {
+        const nestedProperties = (prop.properties ?? {});
+        const nestedRequired = new Set((prop.required ?? []));
+        if (Object.keys(nestedProperties).length === 0) {
+            return z.record(z.string(), z.unknown());
+        }
+        const nestedShape = {};
+        for (const [nestedKey, nestedProp] of Object.entries(nestedProperties)) {
+            let nestedZod = jsonSchemaPropToZod(nestedProp);
+            if (nestedProp.description) {
+                nestedZod = nestedZod.describe(nestedProp.description);
+            }
+            if (!nestedRequired.has(nestedKey)) {
+                nestedZod = nestedZod.optional();
+            }
+            nestedShape[nestedKey] = nestedZod;
+        }
+        return z.object(nestedShape).passthrough();
+    }
+    return z.unknown();
+}
 /**
  * Convert a JSON Schema-style parameters object to a Zod shape for MCP SDK registration.
  */
@@ -107,33 +157,7 @@ function jsonSchemaToZodShape(params) {
     const properties = (params.properties ?? {});
     const required = (params.required ?? []);
     for (const [key, prop] of Object.entries(properties)) {
-        let zodType;
-        const propType = prop.type;
-        switch (propType) {
-            case "string":
-                if (prop.enum) {
-                    const enumValues = prop.enum;
-                    zodType = z.enum(enumValues);
-                }
-                else {
-                    zodType = z.string();
-                }
-                break;
-            case "number":
-                zodType = z.number();
-                break;
-            case "boolean":
-                zodType = z.boolean();
-                break;
-            case "array":
-                zodType = z.array(z.any());
-                break;
-            case "object":
-                zodType = z.record(z.any());
-                break;
-            default:
-                zodType = z.any();
-        }
+        let zodType = jsonSchemaPropToZod(prop);
         if (prop.description) {
             zodType = zodType.describe(prop.description);
         }
@@ -206,9 +230,13 @@ export function createServer(bridgeOptions) {
                 if (result.success) {
                     // Special handling for capture_frame: return image content block
                     const data = result.data;
-                    if (data && data.mimeType === "image/png" && typeof data.base64 === "string") {
+                    if (data &&
+                        data.mimeType === "image/png" &&
+                        typeof data.base64 === "string") {
                         return {
-                            structuredContent: structuredToolResult(name, true, { mimeType: data.mimeType }),
+                            structuredContent: structuredToolResult(name, true, {
+                                mimeType: data.mimeType,
+                            }),
                             content: [
                                 {
                                     type: "image",
@@ -275,10 +303,20 @@ export function createServer(bridgeOptions) {
         description: "High-level, safety-oriented Premiere Pro workflow catalog",
         mimeType: "application/json",
     }, async (uri) => ({
-        contents: [{ uri: uri.href, mimeType: "application/json", text: WORKFLOW_RESOURCE }],
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: "application/json",
+                text: WORKFLOW_RESOURCE,
+            },
+        ],
     }));
     for (const prompt of WORKFLOW_PROMPTS) {
-        server.registerPrompt(prompt.name, { title: prompt.title, description: prompt.description, argsSchema: prompt.argsSchema }, prompt.render);
+        server.registerPrompt(prompt.name, {
+            title: prompt.title,
+            description: prompt.description,
+            argsSchema: prompt.argsSchema,
+        }, prompt.render);
     }
     // Register ExtendScript API reference resource
     server.resource("extendscript-reference", "config://extendscript-reference", {
@@ -293,7 +331,7 @@ export function createServer(bridgeOptions) {
         ],
     }));
     const toolCount = Object.keys(toolModules).length;
-    console.error(`[premiere-pro-mcp] Registered ${toolCount} tools + 3 resources + ${WORKFLOW_PROMPTS.length} prompts`);
+    debugLog(`Registered ${toolCount} tools + 3 resources + ${WORKFLOW_PROMPTS.length} prompts`);
     return server;
 }
 //# sourceMappingURL=server.js.map

package/dist/tools/advanced.d.ts

@@ -315,6 +315,9 @@ export declare function getAdvancedTools(bridgeOptions: BridgeOptions): {
                 };
                 item_ids: {
                     type: string;
+                    items: {
+                        type: string;
+                    };
                     description: string;
                 };
             };

package/dist/tools/advanced.js

@@ -1,4 +1,4 @@
-import { buildToolScript, escapeForExtendScript } from "../bridge/script-builder.js";
+import { buildToolScript, escapeForExtendScript, } from "../bridge/script-builder.js";
 import { sendCommand } from "../bridge/file-bridge.js";
 export function getAdvancedTools(bridgeOptions) {
     return {
@@ -573,6 +573,7 @@ export function getAdvancedTools(bridgeOptions) {
                     },
                     item_ids: {
                         type: "array",
+                        items: { type: "string" },
                         description: "Array of project item names or node IDs to include in order",
                     },
                 },
@@ -792,7 +793,15 @@ export function getAdvancedTools(bridgeOptions) {
                         description: "Blue (0-255)",
                     },
                 },
-                required: ["node_id", "component_name", "property_name", "alpha", "red", "green", "blue"],
+                required: [
+                    "node_id",
+                    "component_name",
+                    "property_name",
+                    "alpha",
+                    "red",
+                    "green",
+                    "blue",
+                ],
             },
             handler: async (args) => {
                 const script = buildToolScript(`

package/dist/tools/edit-plans.d.ts

@@ -74,15 +74,15 @@ export declare function getEditPlanTools(bridgeOptions: BridgeOptions, dependenc
             plan: unknown;
             confirmation_token: string;
         }) => Promise<{
+            success: boolean;
+            error?: string;
             data: {
                 operationId: string;
             };
-            success: boolean;
-            error?: string;
         } | {
-            error: string;
             success: boolean;
             data?: unknown;
+            error: string;
         }>;
     };
 };

package/dist/tools/health.d.ts

@@ -26,7 +26,7 @@ export declare function getHealthTools(bridgeOptions: BridgeOptions, capabilitie
                         platforms: string[];
                         premiereVersions: string;
                         transport: string;
-                        capabilities: ("inspect" | "edit" | "export" | "filesystem" | "unsafe-script")[];
+                        capabilities: ("edit" | "export" | "filesystem" | "inspect" | "unsafe-script")[];
                     };
                     uxp: {
                         status: string;
@@ -39,8 +39,8 @@ export declare function getHealthTools(bridgeOptions: BridgeOptions, capabilitie
                 };
                 authority: {
                     source: "default" | "environment" | "explicit";
-                    enabled: ("inspect" | "edit" | "export" | "filesystem" | "unsafe-script")[];
-                    disabled: ("inspect" | "edit" | "export" | "filesystem" | "unsafe-script")[];
+                    enabled: ("edit" | "export" | "filesystem" | "inspect" | "unsafe-script")[];
+                    disabled: ("edit" | "export" | "filesystem" | "inspect" | "unsafe-script")[];
                 };
             };
         }>;

package/dist/tools/project.d.ts

@@ -115,6 +115,9 @@ export declare function getProjectTools(bridgeOptions: BridgeOptions): {
                 };
                 comp_names: {
                     type: string;
+                    items: {
+                        type: string;
+                    };
                     description: string;
                 };
                 target_bin: {
@@ -246,6 +249,9 @@ export declare function getProjectTools(bridgeOptions: BridgeOptions): {
                 };
                 sequence_ids: {
                     type: string;
+                    items: {
+                        type: string;
+                    };
                     description: string;
                 };
             };

package/dist/tools/project.js

@@ -1,4 +1,4 @@
-import { buildToolScript, escapeForExtendScript } from "../bridge/script-builder.js";
+import { buildToolScript, escapeForExtendScript, } from "../bridge/script-builder.js";
 import { sendCommand } from "../bridge/file-bridge.js";
 export function getProjectTools(bridgeOptions) {
     return {
@@ -169,6 +169,7 @@ export function getProjectTools(bridgeOptions) {
                     },
                     comp_names: {
                         type: "array",
+                        items: { type: "string" },
                         description: "Array of composition names to import. If omitted, imports all comps.",
                     },
                     target_bin: {
@@ -183,7 +184,9 @@ export function getProjectTools(bridgeOptions) {
                     ? `var targetBin = __findProjectItem("${escapeForExtendScript(args.target_bin)}"); if (!targetBin) return __error("Bin not found");`
                     : `var targetBin = app.project.rootItem;`;
                 if (args.comp_names && args.comp_names.length > 0) {
-                    const comps = args.comp_names.map(c => `"${escapeForExtendScript(c)}"`).join(", ");
+                    const comps = args.comp_names
+                        .map((c) => `"${escapeForExtendScript(c)}"`)
+                        .join(", ");
                     const script = buildToolScript(`
             ${binLookup}
             app.project.importAEComps("${escapeForExtendScript(args.ae_project_path)}", [${comps}], targetBin);
@@ -358,6 +361,7 @@ export function getProjectTools(bridgeOptions) {
                     },
                     sequence_ids: {
                         type: "array",
+                        items: { type: "string" },
                         description: "Array of sequence IDs to import from the source project. If omitted, all sequences are imported.",
                     },
                 },
@@ -365,7 +369,9 @@ export function getProjectTools(bridgeOptions) {
             },
             handler: async (args) => {
                 if (args.sequence_ids && args.sequence_ids.length > 0) {
-                    const ids = args.sequence_ids.map(id => `"${escapeForExtendScript(id)}"`).join(", ");
+                    const ids = args.sequence_ids
+                        .map((id) => `"${escapeForExtendScript(id)}"`)
+                        .join(", ");
                     const script = buildToolScript(`
             app.project.importSequences("${escapeForExtendScript(args.project_path)}", [${ids}]);
             return __result({ imported: true, sequenceIds: [${ids}] });

package/dist/tools/track-targeting.d.ts

@@ -580,6 +580,9 @@ export declare function getTrackTargetingTools(bridgeOptions: BridgeOptions): {
             properties: {
                 item_ids: {
                     type: string;
+                    items: {
+                        type: string;
+                    };
                     description: string;
                 };
                 target_bin: {

package/dist/tools/track-targeting.js

@@ -1,4 +1,4 @@
-import { buildToolScript, escapeForExtendScript } from "../bridge/script-builder.js";
+import { buildToolScript, escapeForExtendScript, } from "../bridge/script-builder.js";
 import { sendCommand } from "../bridge/file-bridge.js";
 export function getTrackTargetingTools(bridgeOptions) {
     return {
@@ -367,17 +367,21 @@ export function getTrackTargetingTools(bridgeOptions) {
           var item = __findProjectItem("${escapeForExtendScript(args.item_id)}");
           if (!item) return __error("Item not found");
 
-          ${args.in_seconds !== undefined ? `
+          ${args.in_seconds !== undefined
+                    ? `
           var inTime = new Time();
           inTime.seconds = ${args.in_seconds};
           item.setInPoint(inTime.ticks, ${mediaType});
-          ` : ""}
+          `
+                    : ""}
 
-          ${args.out_seconds !== undefined ? `
+          ${args.out_seconds !== undefined
+                    ? `
           var outTime = new Time();
           outTime.seconds = ${args.out_seconds};
           item.setOutPoint(outTime.ticks, ${mediaType});
-          ` : ""}
+          `
+                    : ""}
 
           return __result({ item: item.name, inSet: ${args.in_seconds !== undefined}, outSet: ${args.out_seconds !== undefined} });
         `);
@@ -403,10 +407,12 @@ export function getTrackTargetingTools(bridgeOptions) {
             handler: async (args) => {
                 const script = buildToolScript(`
           var targetBin = app.project.rootItem;
-          ${args.target_bin ? `
+          ${args.target_bin
+                    ? `
           var found = __findProjectItem("${escapeForExtendScript(args.target_bin)}");
           if (found && found.type === 2) targetBin = found;
-          ` : ""}
+          `
+                    : ""}
 
           app.project.importFiles(["${escapeForExtendScript(args.first_file_path)}"], true, targetBin, true);
 
@@ -1115,6 +1121,7 @@ export function getTrackTargetingTools(bridgeOptions) {
                 properties: {
                     item_ids: {
                         type: "array",
+                        items: { type: "string" },
                         description: "Array of node IDs or names of items to move",
                     },
                     target_bin: {

package/dist/tools/utility.d.ts

@@ -23,6 +23,9 @@ export declare function getUtilityTools(bridgeOptions: BridgeOptions): {
             properties: {
                 item_ids: {
                     type: string;
+                    items: {
+                        type: string;
+                    };
                     description: string;
                 };
             };
@@ -101,6 +104,8 @@ export declare function getUtilityTools(bridgeOptions: BridgeOptions): {
             properties: {
                 frame_rate: {
                     type: string;
+                    minimum: number;
+                    maximum: number;
                     description: string;
                 };
             };

package/dist/tools/utility.js

@@ -1,4 +1,4 @@
-import { buildToolScript, escapeForExtendScript } from "../bridge/script-builder.js";
+import { buildToolScript, escapeForExtendScript, } from "../bridge/script-builder.js";
 import { sendCommand } from "../bridge/file-bridge.js";
 export function getUtilityTools(bridgeOptions) {
     return {
@@ -33,6 +33,7 @@ export function getUtilityTools(bridgeOptions) {
                 properties: {
                     item_ids: {
                         type: "array",
+                        items: { type: "string" },
                         description: "Array of node IDs or names of items to delete",
                     },
                 },
@@ -209,12 +210,20 @@ export function getUtilityTools(bridgeOptions) {
                 properties: {
                     frame_rate: {
                         type: "number",
+                        minimum: 1,
+                        maximum: 240,
                         description: "New frame rate (e.g., 23.976, 24, 25, 29.97, 30, 50, 59.94, 60)",
                     },
                 },
                 required: ["frame_rate"],
             },
             handler: async (args) => {
+                if (!Number.isFinite(args.frame_rate) || args.frame_rate < 1 || args.frame_rate > 240) {
+                    return {
+                        success: false,
+                        error: "frame_rate must be a finite value between 1 and 240 fps",
+                    };
+                }
                 const script = buildToolScript(`
           var seq = app.project.activeSequence;
           if (!seq) return __error("No active sequence");
@@ -222,10 +231,30 @@ export function getUtilityTools(bridgeOptions) {
           var settings = seq.getSettings();
           if (!settings) return __error("Could not get sequence settings");
 
-          settings.videoFrameRate = ${args.frame_rate};
+          var requestedFps = ${args.frame_rate};
+          var requestedTicks = Math.round(TICKS_PER_SECOND / requestedFps);
+          var frameDuration = new Time();
+          frameDuration.ticks = requestedTicks.toString();
+          settings.videoFrameRate = frameDuration;
           seq.setSettings(settings);
 
-          return __result({ frameRate: ${args.frame_rate}, sequence: seq.name });
+          var applied = seq.getSettings();
+          if (!applied || !applied.videoFrameRate) {
+            return __error("Premiere did not return the updated sequence frame rate");
+          }
+          var appliedTicks = parseFloat(applied.videoFrameRate.ticks);
+          if (!isFinite(appliedTicks) || Math.abs(appliedTicks - requestedTicks) > 1) {
+            return __error(
+              "Premiere did not apply the requested frame rate: expected " +
+              requestedTicks + " ticks/frame, got " + appliedTicks
+            );
+          }
+
+          return __result({
+            frameRate: requestedFps,
+            ticksPerFrame: requestedTicks.toString(),
+            sequence: seq.name
+          });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -582,7 +611,13 @@ export function getUtilityTools(bridgeOptions) {
                 properties: {
                     marker_type: {
                         type: "string",
-                        enum: ["Comment", "Chapter", "Segmentation", "WebLink", "FlashCuePoint"],
+                        enum: [
+                            "Comment",
+                            "Chapter",
+                            "Segmentation",
+                            "WebLink",
+                            "FlashCuePoint",
+                        ],
                         description: "Type of marker to filter",
                     },
                     sequence_id: {
@@ -706,11 +741,13 @@ export function getUtilityTools(bridgeOptions) {
           ${args.name ? `marker.name = "${escapeForExtendScript(args.name)}";` : ""}
           ${args.comments ? `marker.comments = "${escapeForExtendScript(args.comments)}";` : ""}
           ${args.type ? `marker.type = "${escapeForExtendScript(args.type)}";` : ""}
-          ${args.duration_seconds !== undefined ? `
+          ${args.duration_seconds !== undefined
+                    ? `
           var endTime = new Time();
           endTime.seconds = ${args.time_seconds + args.duration_seconds};
           marker.end = endTime;
-          ` : ""}
+          `
+                    : ""}
           ${args.color_index !== undefined ? `marker.setColorByIndex(${args.color_index});` : ""}
 
           return __result({ added: true, item: item.name, timeSeconds: ${args.time_seconds} });
@@ -967,14 +1004,22 @@ export function getUtilityTools(bridgeOptions) {
           if (!project) return __error("No project open");
 
           var set = {};
-          ${args.captured_video ? `
-          try { project.setScratchDiskPath("${escapeForExtendScript(args.captured_video)}", 0); set.capturedVideo = "${escapeForExtendScript(args.captured_video)}"; } catch(e) {}` : ""}
-          ${args.captured_audio ? `
-          try { project.setScratchDiskPath("${escapeForExtendScript(args.captured_audio)}", 1); set.capturedAudio = "${escapeForExtendScript(args.captured_audio)}"; } catch(e) {}` : ""}
-          ${args.video_previews ? `
-          try { project.setScratchDiskPath("${escapeForExtendScript(args.video_previews)}", 2); set.videoPreviews = "${escapeForExtendScript(args.video_previews)}"; } catch(e) {}` : ""}
-          ${args.audio_previews ? `
-          try { project.setScratchDiskPath("${escapeForExtendScript(args.audio_previews)}", 3); set.audioPreviews = "${escapeForExtendScript(args.audio_previews)}"; } catch(e) {}` : ""}
+          ${args.captured_video
+                    ? `
+          try { project.setScratchDiskPath("${escapeForExtendScript(args.captured_video)}", 0); set.capturedVideo = "${escapeForExtendScript(args.captured_video)}"; } catch(e) {}`
+                    : ""}
+          ${args.captured_audio
+                    ? `
+          try { project.setScratchDiskPath("${escapeForExtendScript(args.captured_audio)}", 1); set.capturedAudio = "${escapeForExtendScript(args.captured_audio)}"; } catch(e) {}`
+                    : ""}
+          ${args.video_previews
+                    ? `
+          try { project.setScratchDiskPath("${escapeForExtendScript(args.video_previews)}", 2); set.videoPreviews = "${escapeForExtendScript(args.video_previews)}"; } catch(e) {}`
+                    : ""}
+          ${args.audio_previews
+                    ? `
+          try { project.setScratchDiskPath("${escapeForExtendScript(args.audio_previews)}", 3); set.audioPreviews = "${escapeForExtendScript(args.audio_previews)}"; } catch(e) {}`
+                    : ""}
 
           return __result(set);
         `);

package/dist/workflows/catalog.d.ts

@@ -23,8 +23,8 @@ export declare const WORKFLOW_CATALOG: readonly [{
 export declare const WORKFLOW_RESOURCE: string;
 export declare const WORKFLOW_PROMPTS: {
     name: string;
-    title: "Assemble a rough cut" | "Clean up dialogue" | "Caption and style a sequence" | "Prepare a delivery export";
-    description: "Inspect the project, import media, create or select a sequence, assemble clips, then verify and save." | "Inspect audio tracks, normalize dialogue, apply conservative cleanup, and verify levels before saving." | "Inspect the active sequence, create captions, apply styling, verify timing, and save." | "Validate the sequence and destination, export with an explicit preset, then report the produced artifact.";
+    title: "Assemble a rough cut" | "Caption and style a sequence" | "Clean up dialogue" | "Prepare a delivery export";
+    description: "Inspect audio tracks, normalize dialogue, apply conservative cleanup, and verify levels before saving." | "Inspect the active sequence, create captions, apply styling, verify timing, and save." | "Inspect the project, import media, create or select a sequence, assemble clips, then verify and save." | "Validate the sequence and destination, export with an explicit preset, then report the produced artifact.";
     argsSchema: {
         goal: z.ZodString;
         constraints: z.ZodOptional<z.ZodString>;

package/dist/workflows/tool-metadata.d.ts

@@ -2,12 +2,12 @@ import type { ToolAnnotations } from "@modelcontextprotocol/sdk/types.js";
 /** Conservative MCP hints. They describe expected behavior, never authorization. */
 export declare function annotationsForTool(name: string): ToolAnnotations;
 export declare function structuredToolResult(tool: string, success: boolean, data?: unknown, error?: string): {
-    data: {} | null;
     ok: boolean;
     tool: string;
+    data: {} | null;
 } | {
-    error: string;
     ok: boolean;
     tool: string;
+    error: string;
 };
 //# sourceMappingURL=tool-metadata.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "premiere-pro-mcp",
-  "version": "1.2.3",
+  "version": "1.3.1",
   "description": "Adobe Premiere Pro MCP server with 269 AI video editing tools for timeline automation, effects, media management, and export.",
   "main": "dist/index.js",
   "types": "./dist/index.d.ts",
@@ -12,6 +12,7 @@
     "dist/**/*.js",
     "dist/**/*.d.ts",
     "cep-plugin",
+    "artifacts/MCPBridgeCEP.zxp",
     "uxp-plugin",
     "scripts",
     "README.md",
@@ -70,15 +71,19 @@
     "registry": "https://registry.npmjs.org/"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.19.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.1",
-    "zod": "^3.23.0"
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/node": "^22.10.0",
-    "typescript": "^5.7.0",
-    "vitest": "^3.2.7"
+    "@types/node": "^26.1.1",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
+  },
+  "overrides": {
+    "@hono/node-server": "^2.0.5",
+    "body-parser": "^2.3.0"
   }
 }

package/scripts/build-chat-dmg.sh

@@ -138,8 +138,8 @@ REQUIREMENTS
 SUPPORT
 =======
 
-GitHub: https://github.com/ppmcp/premiere-pro-mcp
-Issues: https://github.com/ppmcp/premiere-pro-mcp/issues
+GitHub: https://github.com/leancoderkavy/premiere-pro-mcp
+Issues: https://github.com/leancoderkavy/premiere-pro-mcp/issues
 README_EOF
 
 echo "✓ README created"

package/scripts/build-chat-zip.sh

@@ -260,8 +260,8 @@ REQUIREMENTS
 SUPPORT
 =======
 
-GitHub: https://github.com/ppmcp/premiere-pro-mcp
-Issues: https://github.com/ppmcp/premiere-pro-mcp/issues
+GitHub: https://github.com/leancoderkavy/premiere-pro-mcp
+Issues: https://github.com/leancoderkavy/premiere-pro-mcp/issues
 README_EOF
 
 echo "✓ README created"

package/scripts/build-signed-cep.ps1

@@ -0,0 +1,66 @@
+param(
+  [string]$OutputPath = "",
+  [string]$ZxpSignCmdPath = "",
+  [string]$CertificatePath = "",
+  [string]$CertificatePassword = ""
+)
+
+$ErrorActionPreference = "Stop"
+
+$projectDir = Split-Path -Parent $PSScriptRoot
+$pluginSource = Join-Path $projectDir "cep-plugin"
+if (-not $OutputPath) {
+  $OutputPath = Join-Path $projectDir "artifacts\MCPBridgeCEP.zxp"
+}
+$OutputPath = [System.IO.Path]::GetFullPath($OutputPath)
+$outputDir = Split-Path -Parent $OutputPath
+New-Item -ItemType Directory -Force -Path $outputDir | Out-Null
+
+$temporaryRoot = Join-Path ([System.IO.Path]::GetTempPath()) ("premiere-pro-mcp-zxp-" + [guid]::NewGuid().ToString("N"))
+New-Item -ItemType Directory -Path $temporaryRoot | Out-Null
+
+try {
+  if (-not $ZxpSignCmdPath) {
+    $ZxpSignCmdPath = Join-Path $temporaryRoot "ZXPSignCmd.exe"
+    $downloadUrl = "https://raw.githubusercontent.com/Adobe-CEP/CEP-Resources/ab5e4e3e53a42fad08e1225a22a991bb1ffe73f6/ZXPSignCMD/4.1.103/win64/ZXPSignCmd.exe"
+    Invoke-WebRequest -Uri $downloadUrl -OutFile $ZxpSignCmdPath
+  }
+
+  if (-not (Test-Path -LiteralPath $ZxpSignCmdPath)) {
+    throw "ZXPSignCmd was not found at $ZxpSignCmdPath"
+  }
+  if (-not (Test-Path -LiteralPath (Join-Path $pluginSource "CSXS\manifest.xml"))) {
+    throw "CEP plugin manifest not found at $pluginSource"
+  }
+
+  if (-not $CertificatePassword) {
+    $CertificatePassword = [guid]::NewGuid().ToString("N")
+  }
+  if (-not $CertificatePath) {
+    $CertificatePath = Join-Path $temporaryRoot "premiere-pro-mcp-release.p12"
+    & $ZxpSignCmdPath -selfSignedCert US California "Premiere Pro MCP" "Premiere Pro MCP" $CertificatePassword $CertificatePath
+    if ($LASTEXITCODE -ne 0) {
+      throw "ZXPSignCmd failed to create the release certificate."
+    }
+  }
+
+  if (Test-Path -LiteralPath $OutputPath) {
+    Remove-Item -LiteralPath $OutputPath -Force
+  }
+  & $ZxpSignCmdPath -sign $pluginSource $OutputPath $CertificatePath $CertificatePassword
+  if ($LASTEXITCODE -ne 0 -or -not (Test-Path -LiteralPath $OutputPath)) {
+    throw "ZXPSignCmd failed to create $OutputPath"
+  }
+
+  & $ZxpSignCmdPath -verify $OutputPath
+  if ($LASTEXITCODE -ne 0) {
+    throw "ZXPSignCmd could not verify $OutputPath"
+  }
+
+  Write-Host "Signed CEP package verified: $OutputPath"
+}
+finally {
+  if (Test-Path -LiteralPath $temporaryRoot) {
+    Remove-Item -LiteralPath $temporaryRoot -Recurse -Force
+  }
+}

package/scripts/install-cep.ps1

@@ -6,6 +6,7 @@ $ErrorActionPreference = "Stop"
 
 $projectDir = Split-Path -Parent $PSScriptRoot
 $pluginSource = Join-Path $projectDir "cep-plugin"
+$signedPackage = Join-Path $projectDir "artifacts\MCPBridgeCEP.zxp"
 $cepRoot = Join-Path $env:APPDATA "Adobe\CEP\extensions"
 $pluginDestination = Join-Path $cepRoot "MCPBridgeCEP"
 $resolvedCepRoot = [System.IO.Path]::GetFullPath($cepRoot).TrimEnd([System.IO.Path]::DirectorySeparatorChar)
@@ -29,7 +30,23 @@ if (-not $Diagnose) {
   if (Test-Path -LiteralPath $pluginDestination) {
     Remove-Item -LiteralPath $resolvedDestination -Recurse -Force
   }
-  Copy-Item -LiteralPath $pluginSource -Destination $pluginDestination -Recurse
+  if (Test-Path -LiteralPath $signedPackage) {
+    $temporaryZip = Join-Path ([System.IO.Path]::GetTempPath()) ("MCPBridgeCEP-" + [guid]::NewGuid().ToString("N") + ".zip")
+    try {
+      Copy-Item -LiteralPath $signedPackage -Destination $temporaryZip
+      Expand-Archive -LiteralPath $temporaryZip -DestinationPath $pluginDestination
+      Write-Host "Installed signed CEP package: $signedPackage"
+    }
+    finally {
+      if (Test-Path -LiteralPath $temporaryZip) {
+        Remove-Item -LiteralPath $temporaryZip -Force
+      }
+    }
+  }
+  else {
+    Copy-Item -LiteralPath $pluginSource -Destination $pluginDestination -Recurse
+    Write-Warning "No signed CEP package is present; installed the development bundle and enabled PlayerDebugMode."
+  }
 
   # Adobe requires PlayerDebugMode to be a String value. A DWORD that happens
   # to contain 1 is ignored by CEP and the unsigned extension is not discovered.
@@ -59,10 +76,24 @@ foreach ($version in 9..14) {
   }
 }
 
+$signatureFailures = Get-ChildItem -Path $env:TEMP -Filter "CEP*-PPRO.log" -File -ErrorAction SilentlyContinue |
+  Sort-Object LastWriteTime -Descending |
+  Select-Object -First 5 |
+  Select-String -Pattern "Signature verification failed for extension com\.mcp\.premiere\.bridge" -ErrorAction SilentlyContinue
+if ($signatureFailures) {
+  $latestFailure = $signatureFailures | Select-Object -First 1
+  $problems += "Premiere logged a signature failure in $($latestFailure.Path). Reinstall from a release containing artifacts\MCPBridgeCEP.zxp, fully quit Premiere, and relaunch it."
+}
+
 if ($problems.Count -gt 0) {
   Write-Error ($problems -join [Environment]::NewLine)
   exit 1
 }
 
 Write-Host ""
-Write-Host "Installation verified. Restart Premiere Pro, then open Window > Extensions > MCP Bridge."
+if ($Diagnose) {
+  Write-Host "CEP diagnostics passed."
+}
+else {
+  Write-Host "Installation verified. Restart Premiere Pro, then open Window > Extensions > MCP Bridge."
+}

package/uxp-plugin/manifest.json

@@ -2,7 +2,7 @@
   "manifestVersion": 5,
   "id": "com.ppmcp.premiere.uxp",
   "name": "Premiere Pro MCP Bridge",
-  "version": "1.2.3",
+  "version": "1.3.1",
   "main": "index.html",
   "host": { "app": "premierepro", "minVersion": "25.6.0" },
   "entrypoints": [