premiere-pro-mcp 1.0.0 → 1.1.0

package/README.md

@@ -8,7 +8,9 @@
 
 [![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.12-purple.svg)](https://modelcontextprotocol.io)
+[![MCP](https://img.shields.io/badge/MCP-1.27-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--2025%2B-9999FF.svg)](https://www.adobe.com/products/premiere.html)
 
 </div>
@@ -162,6 +164,7 @@ Add to `.cursor/mcp.json` in your project or global config:
 
 ## Architecture
 
+**Local (stdio):**
 ```
 ┌───────────────┐   stdio (MCP)   ┌──────────────┐   File-based IPC   ┌──────────────┐
 │  AI Client    │ ◄──────────────► │  MCP Server  │ ◄────────────────► │  CEP Plugin  │
@@ -177,6 +180,15 @@ Add to `.cursor/mcp.json` in your project or global config:
                                                                        └──────────────┘
 ```
 
+**Remote (HTTP/SSE — Fly.io):**
+```
+┌───────────────┐  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    └──────────────┘
+└───────────────┘                   └─────────────────────┘
+```
+
 1. AI client invokes an MCP tool (e.g., `add_to_timeline`)
 2. MCP server generates ES3-compatible ExtendScript with helper functions prepended
 3. Script is written to a `.jsx` command file in a shared temp directory
@@ -332,12 +344,63 @@ These are automatically available to MCP clients that support resources, giving
 
 ---
 
+## Remote Deployment (Fly.io)
+
+The server includes an HTTP/SSE transport (`src/http-server.ts`) for remote access via [mcp-remote](https://github.com/geelen/mcp-remote) or any MCP client that supports Streamable HTTP.
+
+A live instance is running at **https://premiere-pro-mcp.fly.dev**.
+
+### Connect via mcp-remote
+
+```json
+{
+  "mcpServers": {
+    "premiere-pro": {
+      "command": "npx",
+      "args": ["mcp-remote", "https://premiere-pro-mcp.fly.dev/mcp"]
+    }
+  }
+}
+```
+
+### Self-host on Fly.io
+
+```bash
+# Clone and deploy your own instance
+git clone https://github.com/ppmcp/premiere-pro-mcp.git
+cd premiere-pro-mcp
+fly apps create your-app-name
+fly deploy --remote-only
+
+# Optional: add bearer token auth
+fly secrets set MCP_AUTH_TOKEN=your-secret-token
+```
+
+Then connect with:
+```json
+{
+  "mcpServers": {
+    "premiere-pro": {
+      "command": "npx",
+      "args": ["mcp-remote", "https://your-app-name.fly.dev/mcp",
+               "--header", "Authorization: Bearer your-secret-token"]
+    }
+  }
+}
+```
+
+> **Note:** The file bridge still requires the CEP plugin to share the same `PREMIERE_TEMP_DIR`. For cloud deployments this means running a sync agent or using `fly proxy` / WireGuard to reach your local machine.
+
+---
+
 ## 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` |
+| `PORT` | HTTP port (HTTP/SSE transport only) | `3000` |
+| `MCP_AUTH_TOKEN` | Bearer token for HTTP transport auth (optional) | unset |
 
 ---
 
@@ -347,6 +410,7 @@ These are automatically available to MCP clients that support resources, giving
 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 all 269 tools + 2 resources
 │   ├── bridge/
 │   │   ├── file-bridge.ts       # File-based IPC (write .jsx, poll .json)
@@ -390,6 +454,8 @@ premiere-pro-mcp/
 │   └── CSInterface.js           # Adobe CEP interface library
 ├── scripts/
 │   └── install-cep.sh           # CEP plugin installer (symlink + debug mode)
+├── Dockerfile                   # Multi-stage Docker build for Fly.io
+├── fly.toml                     # Fly.io deployment config
 ├── RESEARCH.md                  # API research and implementation status
 ├── CONTRIBUTING.md              # Contribution guidelines
 ├── CHANGELOG.md                 # Version history

package/dist/http-server.d.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * HTTP/SSE transport entry point for remote deployment (e.g. Fly.io).
+ *
+ * The MCP server is identical to the stdio version — only the transport differs.
+ * Clients connect via the MCP Streamable HTTP transport:
+ *   POST /mcp  — send JSON-RPC messages
+ *   GET  /mcp  — open SSE stream
+ *
+ * The bridge still uses the local filesystem temp directory, so the CEP plugin
+ * must be reachable from the same machine OR you must set PREMIERE_TEMP_DIR to
+ * a shared volume mount that the CEP plugin also writes to.
+ *
+ * Environment variables:
+ *   PORT               HTTP port to listen on (default: 3000)
+ *   PREMIERE_TEMP_DIR  Shared temp directory for the file bridge
+ *   PREMIERE_TIMEOUT_MS Command timeout in ms (default: 30000)
+ *   MCP_AUTH_TOKEN     Optional bearer token to require on all requests
+ */
+export {};
+//# sourceMappingURL=http-server.d.ts.map

package/dist/http-server.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+/**
+ * HTTP/SSE transport entry point for remote deployment (e.g. Fly.io).
+ *
+ * The MCP server is identical to the stdio version — only the transport differs.
+ * Clients connect via the MCP Streamable HTTP transport:
+ *   POST /mcp  — send JSON-RPC messages
+ *   GET  /mcp  — open SSE stream
+ *
+ * The bridge still uses the local filesystem temp directory, so the CEP plugin
+ * must be reachable from the same machine OR you must set PREMIERE_TEMP_DIR to
+ * a shared volume mount that the CEP plugin also writes to.
+ *
+ * Environment variables:
+ *   PORT               HTTP port to listen on (default: 3000)
+ *   PREMIERE_TEMP_DIR  Shared temp directory for the file bridge
+ *   PREMIERE_TIMEOUT_MS Command timeout in ms (default: 30000)
+ *   MCP_AUTH_TOKEN     Optional bearer token to require on all requests
+ */
+import http from "node:http";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { createServer } from "./server.js";
+import { cleanupTempDir, getTempDir } from "./bridge/file-bridge.js";
+const PORT = parseInt(process.env.PORT ?? "3000", 10);
+const AUTH_TOKEN = process.env.MCP_AUTH_TOKEN;
+const bridgeOptions = {
+    tempDir: process.env.PREMIERE_TEMP_DIR,
+    timeoutMs: process.env.PREMIERE_TIMEOUT_MS
+        ? parseInt(process.env.PREMIERE_TIMEOUT_MS, 10)
+        : undefined,
+};
+const tempDir = getTempDir(bridgeOptions);
+console.error(`[premiere-pro-mcp] Starting HTTP server on port ${PORT}...`);
+console.error(`[premiere-pro-mcp] Temp directory: ${tempDir}`);
+cleanupTempDir(bridgeOptions);
+// Each request gets its own transport+server instance (stateless per-request model)
+const httpServer = http.createServer(async (req, res) => {
+    // Health check
+    if (req.method === "GET" && req.url === "/health") {
+        res.writeHead(200, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ status: "ok", service: "premiere-pro-mcp" }));
+        return;
+    }
+    // Only handle /mcp endpoint
+    if (!req.url?.startsWith("/mcp")) {
+        res.writeHead(404);
+        res.end("Not found");
+        return;
+    }
+    // Optional bearer token auth
+    if (AUTH_TOKEN) {
+        const authHeader = req.headers["authorization"] ?? "";
+        const provided = authHeader.startsWith("Bearer ") ? authHeader.slice(7) : "";
+        if (provided !== AUTH_TOKEN) {
+            res.writeHead(401, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: "Unauthorized" }));
+            return;
+        }
+    }
+    const mcpServer = createServer(bridgeOptions);
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: undefined, // stateless
+    });
+    res.on("close", () => {
+        transport.close().catch(() => { });
+        mcpServer.close().catch(() => { });
+    });
+    try {
+        await mcpServer.connect(transport);
+        await transport.handleRequest(req, res);
+    }
+    catch (err) {
+        console.error("[premiere-pro-mcp] Request error:", err);
+        if (!res.headersSent) {
+            res.writeHead(500, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: "Internal server error" }));
+        }
+    }
+});
+httpServer.listen(PORT, "0.0.0.0", () => {
+    console.error(`[premiere-pro-mcp] HTTP server listening on 0.0.0.0:${PORT}`);
+    console.error(`[premiere-pro-mcp] MCP endpoint: http://0.0.0.0:${PORT}/mcp`);
+    if (AUTH_TOKEN) {
+        console.error(`[premiere-pro-mcp] Auth: Bearer token required`);
+    }
+    else {
+        console.error(`[premiere-pro-mcp] Auth: none (set MCP_AUTH_TOKEN to enable)`);
+    }
+});
+process.on("SIGTERM", () => {
+    console.error("[premiere-pro-mcp] SIGTERM received, shutting down...");
+    httpServer.close(() => process.exit(0));
+});
+process.on("SIGINT", () => {
+    console.error("[premiere-pro-mcp] SIGINT received, shutting down...");
+    httpServer.close(() => process.exit(0));
+});
+//# sourceMappingURL=http-server.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "premiere-pro-mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP server for controlling Adobe Premiere Pro via CEP/ExtendScript — 269 tools for AI-driven video editing",
   "main": "dist/index.js",
   "type": "module",
@@ -20,6 +20,10 @@
     "build": "tsc",
     "dev": "tsc --watch",
     "start": "node dist/index.js",
+    "start:http": "node dist/http-server.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
     "install-cep": "bash scripts/install-cep.sh"
   },
   "repository": {
@@ -55,6 +59,7 @@
   },
   "devDependencies": {
     "@types/node": "^22.10.0",
-    "typescript": "^5.7.0"
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
   }
 }

package/scripts/build-chat-dmg.sh

@@ -0,0 +1,210 @@
+#!/usr/bin/env bash
+# Build a macOS DMG for the Premiere Pro AI Chat plugin.
+# The DMG contains the plugin folder + an installer script.
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+PLUGIN_SRC="$PROJECT_ROOT/chat-plugin"
+BUILD_DIR="$PROJECT_ROOT/build"
+DMG_NAME="Premiere-Pro-AI-Chat"
+DMG_VOLUME="Premiere Pro AI Chat"
+VERSION="1.0.0"
+
+echo "========================================"
+echo "  Building DMG: $DMG_NAME v$VERSION"
+echo "========================================"
+echo ""
+
+# Clean previous DMG staging (preserve other build artifacts)
+rm -rf "$BUILD_DIR/dmg-staging"
+mkdir -p "$BUILD_DIR/dmg-staging"
+
+STAGING="$BUILD_DIR/dmg-staging"
+
+# ---- Copy plugin files ----
+echo "Copying plugin files..."
+mkdir -p "$STAGING/Premiere Pro AI Chat.cep"
+cp -R "$PLUGIN_SRC/"* "$STAGING/Premiere Pro AI Chat.cep/"
+echo "✓ Plugin files copied"
+
+# ---- Create installer script inside DMG ----
+cat > "$STAGING/Install Plugin.command" << 'INSTALLER_EOF'
+#!/usr/bin/env bash
+# Premiere Pro AI Chat — One-click Installer
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_NAME="com.ppro.ai.chat"
+PLUGIN_SRC="$SCRIPT_DIR/Premiere Pro AI Chat.cep"
+CEP_DIR="$HOME/Library/Application Support/Adobe/CEP/extensions"
+
+echo ""
+echo "╔══════════════════════════════════════════╗"
+echo "║   Premiere Pro AI Chat — Installer       ║"
+echo "╚══════════════════════════════════════════╝"
+echo ""
+
+# Verify source
+if [ ! -d "$PLUGIN_SRC" ]; then
+  echo "✗ Error: Plugin files not found."
+  echo "  Make sure you're running this from the DMG."
+  exit 1
+fi
+
+# Create CEP directory
+mkdir -p "$CEP_DIR"
+
+# Remove old installation
+if [ -d "$CEP_DIR/$PLUGIN_NAME" ] || [ -L "$CEP_DIR/$PLUGIN_NAME" ]; then
+  echo "Removing previous installation..."
+  rm -rf "$CEP_DIR/$PLUGIN_NAME"
+fi
+
+# Copy plugin
+echo "Installing plugin..."
+cp -R "$PLUGIN_SRC" "$CEP_DIR/$PLUGIN_NAME"
+echo "✓ Plugin installed to: $CEP_DIR/$PLUGIN_NAME"
+
+# Enable unsigned extensions
+echo "Enabling unsigned CEP extensions..."
+for ver in 9 10 11 12; do
+  defaults write com.adobe.CSXS.$ver PlayerDebugMode 1 2>/dev/null || true
+done
+echo "✓ Debug mode enabled"
+
+echo ""
+echo "════════════════════════════════════════════"
+echo "  ✓ Installation complete!"
+echo ""
+echo "  Next steps:"
+echo "    1. Restart Premiere Pro (if running)"
+echo "    2. Go to: Window → Extensions → AI Chat"
+echo "    3. Enter your Claude or Gemini API key"
+echo "    4. Start chatting!"
+echo "════════════════════════════════════════════"
+echo ""
+echo "Press any key to close..."
+read -n 1 -s
+INSTALLER_EOF
+
+chmod +x "$STAGING/Install Plugin.command"
+echo "✓ Installer script created"
+
+# ---- Create README ----
+cat > "$STAGING/README.txt" << 'README_EOF'
+Premiere Pro AI Chat Plugin
+============================
+
+An embedded AI chat panel for Adobe Premiere Pro.
+Control your edits with natural language using Claude or Gemini.
+
+INSTALLATION
+============
+
+Option 1: Double-click "Install Plugin.command"
+  - This will copy the plugin to your Adobe CEP extensions folder
+  - It will enable unsigned extensions automatically
+
+Option 2: Manual Install
+  - Copy the "Premiere Pro AI Chat.cep" folder to:
+    ~/Library/Application Support/Adobe/CEP/extensions/com.ppro.ai.chat
+  - Enable unsigned extensions by running in Terminal:
+    defaults write com.adobe.CSXS.11 PlayerDebugMode 1
+
+USAGE
+=====
+
+1. Open Premiere Pro
+2. Go to: Window → Extensions → AI Chat
+3. Choose Claude or Gemini as your AI provider
+4. Enter your API key
+5. Start chatting! The AI can:
+   - Query your project (clips, sequences, tracks)
+   - Edit your timeline (add clips, effects, transitions)
+   - Export sequences
+   - And much more
+
+REQUIREMENTS
+============
+
+- macOS 10.14+
+- Adobe Premiere Pro 2020 (v14.0) or later
+- Claude API key (console.anthropic.com) or
+  Gemini API key (aistudio.google.com)
+
+SUPPORT
+=======
+
+GitHub: https://github.com/ppmcp/premiere-pro-mcp
+Issues: https://github.com/ppmcp/premiere-pro-mcp/issues
+README_EOF
+
+echo "✓ README created"
+
+# ---- Create Uninstaller ----
+cat > "$STAGING/Uninstall Plugin.command" << 'UNINSTALL_EOF'
+#!/usr/bin/env bash
+set -e
+
+PLUGIN_NAME="com.ppro.ai.chat"
+CEP_DIR="$HOME/Library/Application Support/Adobe/CEP/extensions"
+
+echo ""
+echo "Uninstalling Premiere Pro AI Chat..."
+
+if [ -d "$CEP_DIR/$PLUGIN_NAME" ] || [ -L "$CEP_DIR/$PLUGIN_NAME" ]; then
+  rm -rf "$CEP_DIR/$PLUGIN_NAME"
+  echo "✓ Plugin removed."
+else
+  echo "Plugin not found — nothing to remove."
+fi
+
+echo ""
+echo "Press any key to close..."
+read -n 1 -s
+UNINSTALL_EOF
+
+chmod +x "$STAGING/Uninstall Plugin.command"
+echo "✓ Uninstaller created"
+
+# ---- Build DMG ----
+echo ""
+echo "Building DMG..."
+
+DMG_PATH="$BUILD_DIR/$DMG_NAME-v$VERSION.dmg"
+TEMP_DMG="$BUILD_DIR/temp.dmg"
+
+# Create a temporary DMG
+hdiutil create -srcfolder "$STAGING" \
+  -volname "$DMG_VOLUME" \
+  -format UDRW \
+  -fs HFS+ \
+  -size 20m \
+  "$TEMP_DMG" \
+  -quiet
+
+# Convert to compressed read-only DMG
+hdiutil convert "$TEMP_DMG" \
+  -format UDZO \
+  -imagekey zlib-level=9 \
+  -o "$DMG_PATH" \
+  -quiet
+
+rm -f "$TEMP_DMG"
+
+echo "✓ DMG built: $DMG_PATH"
+
+# Get file size
+DMG_SIZE=$(du -h "$DMG_PATH" | cut -f1 | xargs)
+
+echo ""
+echo "========================================"
+echo "  ✓ Build complete!"
+echo ""
+echo "  File: $DMG_PATH"
+echo "  Size: $DMG_SIZE"
+echo "========================================"
+echo ""

package/scripts/build-chat-zip.sh

@@ -0,0 +1,291 @@
+#!/usr/bin/env bash
+# Build a cross-platform ZIP for the Premiere Pro AI Chat plugin.
+# The ZIP contains the plugin folder + installers for macOS and Windows.
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+PLUGIN_SRC="$PROJECT_ROOT/chat-plugin"
+BUILD_DIR="$PROJECT_ROOT/build"
+ZIP_NAME="Premiere-Pro-AI-Chat"
+VERSION="1.0.0"
+
+echo "========================================"
+echo "  Building ZIP: $ZIP_NAME v$VERSION"
+echo "========================================"
+echo ""
+
+# Clean previous build
+rm -rf "$BUILD_DIR/zip-staging"
+mkdir -p "$BUILD_DIR/zip-staging"
+
+STAGING="$BUILD_DIR/zip-staging/$ZIP_NAME-v$VERSION"
+mkdir -p "$STAGING"
+
+# ---- Copy plugin files ----
+echo "Copying plugin files..."
+mkdir -p "$STAGING/com.ppro.ai.chat"
+cp -R "$PLUGIN_SRC/"* "$STAGING/com.ppro.ai.chat/"
+echo "✓ Plugin files copied"
+
+# ---- Create Windows installer (.bat) ----
+cat > "$STAGING/Install-Windows.bat" << 'BAT_EOF'
+@echo off
+REM Premiere Pro AI Chat — Windows Installer
+
+setlocal enabledelayedexpansion
+
+echo.
+echo ==========================================
+echo   Premiere Pro AI Chat - Windows Installer
+echo ==========================================
+echo.
+
+set "SCRIPT_DIR=%~dp0"
+set "PLUGIN_SRC=%SCRIPT_DIR%com.ppro.ai.chat"
+set "PLUGIN_NAME=com.ppro.ai.chat"
+set "CEP_DIR=%APPDATA%\Adobe\CEP\extensions"
+
+if not exist "%PLUGIN_SRC%" (
+    echo [ERROR] Plugin files not found.
+    echo Make sure you extracted the ZIP first.
+    pause
+    exit /b 1
+)
+
+REM Create CEP directory
+if not exist "%CEP_DIR%" mkdir "%CEP_DIR%"
+
+REM Remove old installation
+if exist "%CEP_DIR%\%PLUGIN_NAME%" (
+    echo Removing previous installation...
+    rmdir /s /q "%CEP_DIR%\%PLUGIN_NAME%"
+)
+
+REM Copy plugin
+echo Installing plugin...
+xcopy /s /e /i /q "%PLUGIN_SRC%" "%CEP_DIR%\%PLUGIN_NAME%"
+echo [OK] Plugin installed to: %CEP_DIR%\%PLUGIN_NAME%
+
+REM Enable unsigned extensions (CSXS 9-12)
+echo Enabling unsigned CEP extensions...
+for %%v in (9 10 11 12) do (
+    reg add "HKCU\SOFTWARE\Adobe\CSXS.%%v" /v PlayerDebugMode /t REG_SZ /d 1 /f >nul 2>&1
+)
+echo [OK] Debug mode enabled
+
+echo.
+echo ==========================================
+echo   [OK] Installation complete!
+echo.
+echo   Next steps:
+echo     1. Restart Premiere Pro (if running)
+echo     2. Go to: Window ^> Extensions ^> AI Chat
+echo     3. Enter your Claude or Gemini API key
+echo     4. Start chatting!
+echo ==========================================
+echo.
+pause
+BAT_EOF
+
+echo "✓ Windows installer created"
+
+# ---- Create Windows uninstaller (.bat) ----
+cat > "$STAGING/Uninstall-Windows.bat" << 'UNBAT_EOF'
+@echo off
+REM Premiere Pro AI Chat — Windows Uninstaller
+
+set "PLUGIN_NAME=com.ppro.ai.chat"
+set "CEP_DIR=%APPDATA%\Adobe\CEP\extensions"
+
+echo.
+echo Uninstalling Premiere Pro AI Chat...
+
+if exist "%CEP_DIR%\%PLUGIN_NAME%" (
+    rmdir /s /q "%CEP_DIR%\%PLUGIN_NAME%"
+    echo [OK] Plugin removed.
+) else (
+    echo Plugin not found - nothing to remove.
+)
+
+echo.
+pause
+UNBAT_EOF
+
+echo "✓ Windows uninstaller created"
+
+# ---- Create macOS installer (.command) ----
+cat > "$STAGING/Install-macOS.command" << 'MAC_EOF'
+#!/usr/bin/env bash
+# Premiere Pro AI Chat — macOS Installer
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_NAME="com.ppro.ai.chat"
+PLUGIN_SRC="$SCRIPT_DIR/com.ppro.ai.chat"
+CEP_DIR="$HOME/Library/Application Support/Adobe/CEP/extensions"
+
+echo ""
+echo "╔══════════════════════════════════════════╗"
+echo "║   Premiere Pro AI Chat — Installer       ║"
+echo "╚══════════════════════════════════════════╝"
+echo ""
+
+if [ ! -d "$PLUGIN_SRC" ]; then
+  echo "✗ Error: Plugin files not found."
+  exit 1
+fi
+
+mkdir -p "$CEP_DIR"
+
+if [ -d "$CEP_DIR/$PLUGIN_NAME" ] || [ -L "$CEP_DIR/$PLUGIN_NAME" ]; then
+  echo "Removing previous installation..."
+  rm -rf "$CEP_DIR/$PLUGIN_NAME"
+fi
+
+echo "Installing plugin..."
+cp -R "$PLUGIN_SRC" "$CEP_DIR/$PLUGIN_NAME"
+echo "✓ Plugin installed to: $CEP_DIR/$PLUGIN_NAME"
+
+echo "Enabling unsigned CEP extensions..."
+for ver in 9 10 11 12; do
+  defaults write com.adobe.CSXS.$ver PlayerDebugMode 1 2>/dev/null || true
+done
+echo "✓ Debug mode enabled"
+
+echo ""
+echo "════════════════════════════════════════════"
+echo "  ✓ Installation complete!"
+echo ""
+echo "  Next steps:"
+echo "    1. Restart Premiere Pro (if running)"
+echo "    2. Go to: Window → Extensions → AI Chat"
+echo "    3. Enter your Claude or Gemini API key"
+echo "    4. Start chatting!"
+echo "════════════════════════════════════════════"
+echo ""
+echo "Press any key to close..."
+read -n 1 -s
+MAC_EOF
+
+chmod +x "$STAGING/Install-macOS.command"
+echo "✓ macOS installer created"
+
+# ---- Create macOS uninstaller ----
+cat > "$STAGING/Uninstall-macOS.command" << 'UNMAC_EOF'
+#!/usr/bin/env bash
+set -e
+
+PLUGIN_NAME="com.ppro.ai.chat"
+CEP_DIR="$HOME/Library/Application Support/Adobe/CEP/extensions"
+
+echo ""
+echo "Uninstalling Premiere Pro AI Chat..."
+
+if [ -d "$CEP_DIR/$PLUGIN_NAME" ] || [ -L "$CEP_DIR/$PLUGIN_NAME" ]; then
+  rm -rf "$CEP_DIR/$PLUGIN_NAME"
+  echo "✓ Plugin removed."
+else
+  echo "Plugin not found — nothing to remove."
+fi
+
+echo ""
+echo "Press any key to close..."
+read -n 1 -s
+UNMAC_EOF
+
+chmod +x "$STAGING/Uninstall-macOS.command"
+echo "✓ macOS uninstaller created"
+
+# ---- Create README ----
+cat > "$STAGING/README.txt" << 'README_EOF'
+Premiere Pro AI Chat Plugin
+============================
+
+An embedded AI chat panel for Adobe Premiere Pro.
+Control your edits with natural language using Claude or Gemini.
+
+INSTALLATION
+============
+
+Windows:
+  1. Extract this ZIP file
+  2. Right-click "Install-Windows.bat" → Run as administrator
+  3. Restart Premiere Pro
+  4. Go to: Window → Extensions → AI Chat
+
+macOS:
+  1. Extract this ZIP file
+  2. Double-click "Install-macOS.command"
+  3. Restart Premiere Pro
+  4. Go to: Window → Extensions → AI Chat
+
+Manual Install (any OS):
+  - Copy the "com.ppro.ai.chat" folder to your CEP extensions folder:
+    Windows: %APPDATA%\Adobe\CEP\extensions\
+    macOS:   ~/Library/Application Support/Adobe/CEP/extensions/
+  - Enable unsigned extensions:
+    Windows: Set registry key HKCU\SOFTWARE\Adobe\CSXS.11 → PlayerDebugMode = "1"
+    macOS:   Run: defaults write com.adobe.CSXS.11 PlayerDebugMode 1
+
+UNINSTALL
+=========
+
+Windows: Run "Uninstall-Windows.bat"
+macOS:   Double-click "Uninstall-macOS.command"
+
+USAGE
+=====
+
+1. Open Premiere Pro
+2. Go to: Window → Extensions → AI Chat
+3. Choose Claude or Gemini as your AI provider
+4. Enter your API key
+5. Start chatting! The AI can:
+   - Query your project (clips, sequences, tracks)
+   - Edit your timeline (add clips, effects, transitions)
+   - Export sequences
+   - And much more
+
+REQUIREMENTS
+============
+
+- Windows 10+ or macOS 10.14+
+- Adobe Premiere Pro 2020 (v14.0) or later
+- Claude API key (console.anthropic.com) or
+  Gemini API key (aistudio.google.com)
+
+SUPPORT
+=======
+
+GitHub: https://github.com/ppmcp/premiere-pro-mcp
+Issues: https://github.com/ppmcp/premiere-pro-mcp/issues
+README_EOF
+
+echo "✓ README created"
+
+# ---- Build ZIP ----
+echo ""
+echo "Building ZIP..."
+
+ZIP_PATH="$BUILD_DIR/$ZIP_NAME-v$VERSION.zip"
+rm -f "$ZIP_PATH"
+
+cd "$BUILD_DIR/zip-staging"
+zip -r -q "$ZIP_PATH" "$ZIP_NAME-v$VERSION/"
+
+ZIP_SIZE=$(du -h "$ZIP_PATH" | cut -f1 | xargs)
+
+echo "✓ ZIP built: $ZIP_PATH"
+
+echo ""
+echo "========================================"
+echo "  ✓ Build complete!"
+echo ""
+echo "  File: $ZIP_PATH"
+echo "  Size: $ZIP_SIZE"
+echo "  Works on: macOS + Windows"
+echo "========================================"
+echo ""

package/scripts/install-chat-plugin.bat

@@ -0,0 +1,67 @@
+@echo off
+REM Premiere Pro AI Chat — Windows Installer
+REM Copies the plugin to the Adobe CEP extensions folder
+REM and enables unsigned extensions via registry.
+
+setlocal enabledelayedexpansion
+
+echo ========================================
+echo   Premiere Pro AI Chat — Plugin Installer
+echo ========================================
+echo.
+
+REM Resolve paths
+set "SCRIPT_DIR=%~dp0"
+set "PROJECT_ROOT=%SCRIPT_DIR%.."
+set "PLUGIN_SRC=%PROJECT_ROOT%\chat-plugin"
+set "PLUGIN_NAME=com.ppro.ai.chat"
+set "CEP_DIR=%APPDATA%\Adobe\CEP\extensions"
+
+echo Plugin source: %PLUGIN_SRC%
+echo CEP target:    %CEP_DIR%\%PLUGIN_NAME%
+echo.
+
+REM Verify source exists
+if not exist "%PLUGIN_SRC%" (
+    echo [ERROR] Plugin source not found at %PLUGIN_SRC%
+    pause
+    exit /b 1
+)
+
+REM Create CEP extensions directory if needed
+if not exist "%CEP_DIR%" (
+    echo Creating CEP extensions directory...
+    mkdir "%CEP_DIR%"
+)
+
+REM Remove existing installation
+if exist "%CEP_DIR%\%PLUGIN_NAME%" (
+    echo Removing existing installation...
+    rmdir /s /q "%CEP_DIR%\%PLUGIN_NAME%"
+)
+
+REM Copy plugin
+echo Installing plugin...
+xcopy /s /e /i /q "%PLUGIN_SRC%" "%CEP_DIR%\%PLUGIN_NAME%"
+echo [OK] Plugin installed
+
+REM Enable unsigned extensions (CSXS 9-12)
+echo.
+echo Enabling unsigned CEP extensions...
+for %%v in (9 10 11 12) do (
+    reg add "HKCU\SOFTWARE\Adobe\CSXS.%%v" /v PlayerDebugMode /t REG_SZ /d 1 /f >nul 2>&1
+)
+echo [OK] Debug mode enabled (CSXS 9-12)
+
+echo.
+echo ========================================
+echo   [OK] Installation complete!
+echo ========================================
+echo.
+echo Next steps:
+echo   1. Restart Premiere Pro (if running)
+echo   2. Open: Window ^> Extensions ^> AI Chat
+echo   3. Enter your Claude or Gemini API key
+echo   4. Start chatting to control Premiere Pro!
+echo.
+pause

package/scripts/install-chat-plugin.sh

@@ -0,0 +1,85 @@
+#!/usr/bin/env bash
+# Install the Premiere Pro AI Chat CEP plugin
+# Creates a symlink (or copies) from the chat-plugin/ directory
+# into the Adobe CEP extensions folder.
+
+set -e
+
+PLUGIN_NAME="com.ppro.ai.chat"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+PLUGIN_SRC="$PROJECT_ROOT/chat-plugin"
+
+echo "========================================"
+echo "  Premiere Pro AI Chat — Plugin Installer"
+echo "========================================"
+echo ""
+
+# Detect OS
+if [[ "$OSTYPE" == "darwin"* ]]; then
+  CEP_DIR="$HOME/Library/Application Support/Adobe/CEP/extensions"
+elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+  CEP_DIR="$HOME/.config/Adobe/CEP/extensions"
+else
+  echo "⚠  Windows detected. Please manually copy:"
+  echo "   From: $PLUGIN_SRC"
+  echo "   To:   %APPDATA%\\Adobe\\CEP\\extensions\\$PLUGIN_NAME"
+  echo ""
+  echo "Then set registry key to enable unsigned extensions:"
+  echo '   HKEY_CURRENT_USER\SOFTWARE\Adobe\CSXS.11'
+  echo '   PlayerDebugMode = "1" (String)'
+  exit 0
+fi
+
+echo "Plugin source: $PLUGIN_SRC"
+echo "CEP target:    $CEP_DIR/$PLUGIN_NAME"
+echo ""
+
+# Verify source exists
+if [ ! -d "$PLUGIN_SRC" ]; then
+  echo "✗ Error: Plugin source not found at $PLUGIN_SRC"
+  exit 1
+fi
+
+# Create CEP extensions directory if needed
+if [ ! -d "$CEP_DIR" ]; then
+  echo "Creating CEP extensions directory..."
+  mkdir -p "$CEP_DIR"
+fi
+
+# Remove existing installation
+if [ -L "$CEP_DIR/$PLUGIN_NAME" ] || [ -d "$CEP_DIR/$PLUGIN_NAME" ]; then
+  echo "Removing existing installation..."
+  rm -rf "$CEP_DIR/$PLUGIN_NAME"
+fi
+
+# Create symlink
+echo "Creating symlink..."
+ln -s "$PLUGIN_SRC" "$CEP_DIR/$PLUGIN_NAME"
+echo "✓ Symlink created"
+
+# Enable unsigned extensions (macOS)
+if [[ "$OSTYPE" == "darwin"* ]]; then
+  echo ""
+  echo "Enabling unsigned CEP extensions..."
+  # Support CSXS versions 9-12 for various Premiere Pro versions
+  for ver in 9 10 11 12; do
+    defaults write com.adobe.CSXS.$ver PlayerDebugMode 1 2>/dev/null || true
+  done
+  echo "✓ Debug mode enabled (CSXS 9-12)"
+fi
+
+echo ""
+echo "========================================"
+echo "  ✓ Installation complete!"
+echo "========================================"
+echo ""
+echo "Next steps:"
+echo "  1. Restart Premiere Pro (if running)"
+echo "  2. Open: Window → Extensions → AI Chat"
+echo "  3. Enter your Claude or Gemini API key"
+echo "  4. Start chatting to control Premiere Pro!"
+echo ""
+echo "Note: The AI Chat panel and MCP Bridge panel"
+echo "can run side by side if you have both installed."
+echo ""