@synthetic-ai/premiere-mcp 2.3.1-dev.1 → 2.3.4

package/dist/bridge/file-bridge.js

@@ -1,6 +1,7 @@
 import { mkdirSync, writeFileSync, readFileSync, unlinkSync, existsSync, readdirSync, renameSync } from "node:fs";
 import { join } from "node:path";
 import { tmpdir } from "node:os";
+import { t } from "../i18n.js";
 const DEFAULT_TEMP_DIR = join(tmpdir(), "premiere-mcp-bridge");
 const POLL_INTERVAL_MS = 100;
 const DEFAULT_TIMEOUT_MS = 30000;
@@ -46,7 +47,7 @@ export async function sendCommand(script, options) {
 function validateScript(script, allowUnsafe = false) {
     const MAX_SCRIPT_SIZE = 500 * 1024; // 500KB
     if (Buffer.byteLength(script, "utf-8") > MAX_SCRIPT_SIZE) {
-        throw new Error("Script exceeds 500KB size limit");
+        throw new Error(t("msg.bridge.scriptTooLarge", { limit: "500KB" }));
     }
     if (allowUnsafe)
         return;
@@ -59,7 +60,7 @@ function validateScript(script, allowUnsafe = false) {
     ];
     for (const pattern of dangerousPatterns) {
         if (pattern.test(script)) {
-            throw new Error(`Script contains blocked pattern: ${pattern.source}`);
+            throw new Error(t("msg.bridge.blockedPattern", { pattern: pattern.source }));
         }
     }
 }
@@ -96,7 +97,7 @@ async function pollForResponse(resFile, timeoutMs) {
                 catch (e) {
                     resolve({
                         success: false,
-                        error: `Failed to parse response: ${e instanceof Error ? e.message : String(e)}`,
+                        error: t("msg.bridge.parseFailed", { error: e instanceof Error ? e.message : String(e) }),
                     });
                 }
                 return;
@@ -104,7 +105,7 @@ async function pollForResponse(resFile, timeoutMs) {
             if (Date.now() - start > timeoutMs) {
                 resolve({
                     success: false,
-                    error: `Command timed out after ${timeoutMs}ms. Is the CEP plugin running in Premiere Pro?`,
+                    error: t("msg.bridge.timeout", { ms: timeoutMs }),
                 });
                 return;
             }

package/dist/http-server.d.ts

@@ -16,6 +16,7 @@
  *   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
+ *   PREMIERE_PRO_MCP_LANG  Language of tool descriptions/messages (see src/i18n.ts)
  */
 export {};
 //# sourceMappingURL=http-server.d.ts.map

package/dist/http-server.js

@@ -16,6 +16,7 @@
  *   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
+ *   PREMIERE_PRO_MCP_LANG  Language of tool descriptions/messages (see src/i18n.ts)
  */
 import http from "node:http";
 import fs from "node:fs";
@@ -24,6 +25,7 @@ import { fileURLToPath } from "node:url";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { createServer } from "./server.js";
 import { cleanupTempDir, getTempDir } from "./bridge/file-bridge.js";
+import { logLanguage } from "./i18n.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const LANDING_DIR = path.resolve(__dirname, "../landing-dist");
 const MIME = {
@@ -72,6 +74,7 @@ const bridgeOptions = {
 const tempDir = getTempDir(bridgeOptions);
 console.error(`[premiere-pro-mcp] Starting HTTP server on port ${PORT}...`);
 console.error(`[premiere-pro-mcp] Temp directory: ${tempDir}`);
+logLanguage();
 cleanupTempDir(bridgeOptions);
 // Each request gets its own transport+server instance (stateless per-request model)
 const httpServer = http.createServer(async (req, res) => {

package/dist/i18n.d.ts

@@ -0,0 +1,42 @@
+/**
+ * i18n — language of the tool descriptions and of the messages this server
+ * prints or returns to the MCP client.
+ *
+ * The runtime (node.cjs + i18n-core.cjs) and the dictionaries come from the
+ * central synthetic-idiomas repo, vendored into <package root>/i18n by
+ * scripts/sync-i18n.mjs. They're loaded at runtime (not compiled in), resolved
+ * relative to this module: dist/i18n.js → ../i18n, and the esbuild bundle at
+ * release/server/index.mjs → release/i18n (scripts/package.mjs copies it).
+ *
+ * The language is picked ONCE at startup, first match wins:
+ *   PREMIERE_PRO_MCP_LANG → SYNTHETIC_LANG →
+ *   <USER_DATA>/com.mcp.premiere.bridge/settings.json (written by the panels'
+ *   language selector) → <USER_DATA>/com.synthetic/settings.json → English.
+ * MCP clients only read tool descriptions when they connect, so a change in
+ * the panel applies after the MCP server (or the client app) restarts.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const LANG_ENV_VAR = "PREMIERE_PRO_MCP_LANG";
+export declare const SETTINGS_FOLDER = "com.mcp.premiere.bridge";
+type Vars = Record<string, string | number | null | undefined>;
+interface ServerI18n {
+    language: string;
+    languageSource: string;
+    t(key: string, vars?: Vars | null, fallbackText?: string): string;
+}
+export declare const i18n: ServerI18n;
+/** Localized text for a `msg.*` key, with `{placeholders}` filled from `vars`. */
+export declare function t(key: string, vars?: Vars): string;
+/** Language codes supported by the dictionaries, e.g. "en, es, pt-BR, …". */
+export declare function supportedLanguages(): string[];
+/** Display name of the active language in its own language ("Español"). */
+export declare function languageName(): string;
+/**
+ * Serve translated tool descriptions from tools/list. Call after every tool
+ * is registered and before connect(). No-op in English.
+ */
+export declare function localizeToolsList(server: McpServer): boolean;
+/** One stderr line at startup: which language and where the choice came from. */
+export declare function logLanguage(): void;
+export {};
+//# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.js

@@ -0,0 +1,69 @@
+/**
+ * i18n — language of the tool descriptions and of the messages this server
+ * prints or returns to the MCP client.
+ *
+ * The runtime (node.cjs + i18n-core.cjs) and the dictionaries come from the
+ * central synthetic-idiomas repo, vendored into <package root>/i18n by
+ * scripts/sync-i18n.mjs. They're loaded at runtime (not compiled in), resolved
+ * relative to this module: dist/i18n.js → ../i18n, and the esbuild bundle at
+ * release/server/index.mjs → release/i18n (scripts/package.mjs copies it).
+ *
+ * The language is picked ONCE at startup, first match wins:
+ *   PREMIERE_PRO_MCP_LANG → SYNTHETIC_LANG →
+ *   <USER_DATA>/com.mcp.premiere.bridge/settings.json (written by the panels'
+ *   language selector) → <USER_DATA>/com.synthetic/settings.json → English.
+ * MCP clients only read tool descriptions when they connect, so a change in
+ * the panel applies after the MCP server (or the client app) restarts.
+ */
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+export const LANG_ENV_VAR = "PREMIERE_PRO_MCP_LANG";
+export const SETTINGS_FOLDER = "com.mcp.premiere.bridge";
+const I18N_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "i18n");
+// A local name (not `require`) so bundlers leave this runtime load alone.
+const requireCjs = createRequire(import.meta.url);
+let runtime = null;
+let loadError = null;
+try {
+    runtime = requireCjs(path.join(I18N_DIR, "node.cjs"));
+}
+catch (err) {
+    loadError = (err instanceof Error ? err.message : String(err)).split("\n")[0];
+}
+export const i18n = runtime
+    ? runtime.createServerI18n({
+        localesDir: path.join(I18N_DIR, "locales"),
+        envVar: LANG_ENV_VAR,
+        settingsFolder: SETTINGS_FOLDER,
+    })
+    : { language: "en", languageSource: "default", t: (key) => key };
+/** Localized text for a `msg.*` key, with `{placeholders}` filled from `vars`. */
+export function t(key, vars) {
+    return i18n.t(key, vars);
+}
+/** Language codes supported by the dictionaries, e.g. "en, es, pt-BR, …". */
+export function supportedLanguages() {
+    return runtime ? runtime.core.LANGUAGES.map((l) => l.code) : ["en"];
+}
+/** Display name of the active language in its own language ("Español"). */
+export function languageName() {
+    const found = runtime?.core.LANGUAGES.find((l) => l.code === i18n.language);
+    return found ? found.name : i18n.language;
+}
+/**
+ * Serve translated tool descriptions from tools/list. Call after every tool
+ * is registered and before connect(). No-op in English.
+ */
+export function localizeToolsList(server) {
+    return runtime ? runtime.patchMcpServerToolsList(server, i18n) : false;
+}
+/** One stderr line at startup: which language and where the choice came from. */
+export function logLanguage() {
+    if (loadError) {
+        console.error(`[premiere-pro-mcp] i18n not loaded from ${I18N_DIR} (${loadError}) — run scripts/sync-i18n.mjs`);
+        return;
+    }
+    console.error(`[premiere-pro-mcp] Language: ${i18n.language} (${i18n.languageSource})`);
+}
+//# sourceMappingURL=i18n.js.map

package/dist/index.js

@@ -3,6 +3,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { createServer } from "./server.js";
 import { cleanupTempDir, getTempDir } from "./bridge/file-bridge.js";
 import { checkLicense } from "./license.js";
+import { t, i18n, languageName, logLanguage, supportedLanguages, LANG_ENV_VAR } from "./i18n.js";
 import { execSync } from "child_process";
 import { fileURLToPath } from "url";
 import path from "path";
@@ -39,7 +40,7 @@ function premiereInstallCandidates() {
 // ("UV_HANDLE_CLOSING", src/win/async.c) before the process actually exits.
 // Setting exitCode and letting the event loop drain naturally avoids it.
 async function runDoctor() {
-    console.log(`\n${DIM}premiere-mcp doctor — checking your setup${RESET}\n`);
+    console.log(`\n${DIM}${t("msg.doctor.title")}${RESET}\n`);
     let hasFail = false;
     // 1. Node version
     const nodeMajor = parseInt(process.version.slice(1).split(".")[0], 10);
@@ -48,35 +49,35 @@ async function runDoctor() {
     }
     else {
         hasFail = true;
-        printCheck("fail", `Node.js ${process.version}`, "Requires Node 18 or newer — update from nodejs.org");
+        printCheck("fail", `Node.js ${process.version}`, t("msg.doctor.nodeTooOld"));
     }
     // 2. OS (informational — both are supported, this just confirms detection)
     const osLabel = process.platform === "darwin" ? "macOS" : process.platform === "win32" ? "Windows" : process.platform;
-    printCheck(process.platform === "darwin" || process.platform === "win32" ? "pass" : "warn", `OS: ${osLabel}`);
+    printCheck(process.platform === "darwin" || process.platform === "win32" ? "pass" : "warn", t("msg.doctor.os", { os: osLabel }));
     // 3. Premiere Pro install detected on disk
     const found = premiereInstallCandidates().find((p) => existsSync(p));
     if (found) {
-        printCheck("pass", "Premiere Pro detected", found);
+        printCheck("pass", t("msg.doctor.premiereFound"), found);
     }
     else {
-        printCheck("warn", "Premiere Pro not found in the usual install location", "Not fatal — the MCP server only needs Premiere Pro running when a tool actually calls it.");
+        printCheck("warn", t("msg.doctor.premiereNotFound"), t("msg.doctor.premiereNotFoundDetail"));
     }
     // 4. License key present
     const licenseKey = process.env.PREMIERE_PRO_MCP_LICENSE;
     if (!licenseKey) {
         hasFail = true;
-        printCheck("fail", "PREMIERE_PRO_MCP_LICENSE not set", "Add it to your MCP client config (claude_desktop_config.json or equivalent).");
+        printCheck("fail", t("msg.doctor.licenseMissing"), t("msg.doctor.licenseMissingDetail"));
     }
     else {
-        printCheck("pass", `License key present (${licenseKey.slice(0, 8)}...)`);
+        printCheck("pass", t("msg.doctor.licensePresent", { prefix: licenseKey.slice(0, 8) }));
         // 5. Live validation against synthetic.com.ar (also exercises network reachability)
         const result = await checkLicense();
         if (result.valid) {
-            printCheck("pass", "License validates", result.expiresAt ? `Expires: ${result.expiresAt}` : "No expiration");
+            printCheck("pass", t("msg.doctor.licenseValid"), result.expiresAt ? t("msg.doctor.licenseExpires", { date: result.expiresAt }) : t("msg.doctor.licenseNoExpiration"));
         }
         else {
             hasFail = true;
-            printCheck("fail", "License validation failed", result.message ?? "Unknown reason");
+            printCheck("fail", t("msg.doctor.licenseInvalid"), result.message ?? t("msg.doctor.unknownReason"));
         }
     }
     // 6. Bridge temp directory writable
@@ -87,36 +88,44 @@ async function runDoctor() {
         const probe = path.join(tempDir, `.doctor-probe-${Date.now()}`);
         writeFileSync(probe, "ok");
         unlinkSync(probe);
-        printCheck("pass", "Bridge temp directory writable", tempDir);
+        printCheck("pass", t("msg.doctor.tempWritable"), tempDir);
     }
     catch (err) {
         hasFail = true;
-        printCheck("fail", "Bridge temp directory not writable", `${tempDir} — ${err instanceof Error ? err.message : String(err)}`);
+        printCheck("fail", t("msg.doctor.tempNotWritable"), `${tempDir} — ${err instanceof Error ? err.message : String(err)}`);
     }
+    // 7. Language of tool descriptions + messages (informational)
+    printCheck("pass", t("msg.doctor.language", { language: languageName() }), i18n.languageSource === "default"
+        ? t("msg.doctor.languageDefault")
+        : t("msg.doctor.languageFrom", { source: i18n.languageSource }));
     console.log(hasFail
-        ? `\n${RED}Some checks failed.${RESET} Fix the items above, or share this output with support at https://synthetic.com.ar/dashboard/support\n`
-        : `\n${GREEN}Everything looks good.${RESET}\n`);
+        ? `\n${RED}${t("msg.doctor.someFailed")}${RESET} ${t("msg.doctor.someFailedHint")}\n`
+        : `\n${GREEN}${t("msg.doctor.allGood")}${RESET}\n`);
     return hasFail;
 }
 // Handle CLI flags
 const args = process.argv.slice(2);
 if (args.includes("--help") || args.includes("-h")) {
-    console.log(`
-premiere-pro-mcp — MCP server for Adobe Premiere Pro (437 tools)
-
-Usage:
-  premiere-pro-mcp              Start the MCP server (stdio transport)
-  premiere-pro-mcp --doctor        Check your setup (Node, license, Premiere Pro, temp dir)
-  premiere-pro-mcp --install-cep   Install the CEP plugin into Premiere Pro
-  premiere-pro-mcp --help          Show this help message
-  premiere-pro-mcp --version       Show version
-
-Environment variables:
-  PREMIERE_TEMP_DIR     Shared temp directory (default: OS temp + /premiere-mcp-bridge)
-  PREMIERE_TIMEOUT_MS   Command timeout in ms (default: 30000)
-
-More info: https://synthetic.com.ar
-`);
+    const row = (cmd, text, width) => `  ${cmd.padEnd(width)} ${text}`;
+    console.log([
+        "",
+        `premiere-pro-mcp — ${t("msg.help.title", { count: 437 })}`,
+        "",
+        t("msg.help.usage"),
+        row("premiere-pro-mcp", t("msg.help.start"), 31),
+        row("premiere-pro-mcp --doctor", t("msg.help.doctor"), 31),
+        row("premiere-pro-mcp --install-cep", t("msg.help.installCep"), 31),
+        row("premiere-pro-mcp --help", t("msg.help.help"), 31),
+        row("premiere-pro-mcp --version", t("msg.help.version"), 31),
+        "",
+        t("msg.help.env"),
+        row("PREMIERE_TEMP_DIR", t("msg.help.envTempDir"), 22),
+        row("PREMIERE_TIMEOUT_MS", t("msg.help.envTimeout"), 22),
+        row(LANG_ENV_VAR, t("msg.help.envLang", { languages: supportedLanguages().join(", ") }), 22),
+        "",
+        t("msg.help.moreInfo", { url: "https://synthetic.com.ar" }),
+        "",
+    ].join("\n"));
     process.exit(0);
 }
 if (args.includes("--version") || args.includes("-v")) {
@@ -132,12 +141,12 @@ if (args.includes("--doctor")) {
 }
 if (args.includes("--install-cep")) {
     const scriptPath = path.join(projectRoot, "scripts", "install-cep.sh");
-    console.log("Installing CEP plugin...\n");
+    console.log(`${t("msg.installCep.installing")}\n`);
     try {
         execSync(`bash "${scriptPath}"`, { stdio: "inherit", cwd: projectRoot });
     }
     catch {
-        console.error("CEP installation failed. Try running manually:");
+        console.error(t("msg.installCep.failed"));
         console.error(`  bash "${scriptPath}"`);
         process.exit(1);
     }
@@ -153,6 +162,7 @@ async function main() {
     const tempDir = getTempDir(bridgeOptions);
     console.error(`[premiere-pro-mcp] Starting MCP server...`);
     console.error(`[premiere-pro-mcp] Temp directory: ${tempDir}`);
+    logLanguage();
     // Clean up any stale files from previous sessions
     cleanupTempDir(bridgeOptions);
     const server = createServer(bridgeOptions);

package/dist/license.js

@@ -7,6 +7,7 @@ import os from "node:os";
 import fs from "node:fs";
 import path from "node:path";
 import crypto from "node:crypto";
+import { t } from "./i18n.js";
 const LICENSE_KEY = process.env.PREMIERE_PRO_MCP_LICENSE;
 const LICENSE_VALIDATION_URL = "https://synthetic.com.ar/api/v1/license/validate";
 const LICENSE_CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
@@ -68,7 +69,7 @@ export async function checkLicense() {
         cache = {
             valid: false,
             plan: null,
-            message: "No license key. Set PREMIERE_PRO_MCP_LICENSE in your MCP config. Get a license at https://synthetic.com.ar/premiere-mcp",
+            message: t("msg.license.missing"),
             checkedAt: Date.now(),
         };
         return cache;
@@ -91,7 +92,7 @@ export async function checkLicense() {
         else {
             cache = {
                 valid: false,
-                message: "License server unreachable. Check your internet connection.",
+                message: t("msg.license.unreachable"),
                 checkedAt: Date.now(),
             };
         }
@@ -99,23 +100,24 @@ export async function checkLicense() {
     catch {
         cache = {
             valid: false,
-            message: "License server unreachable. Check your internet connection.",
+            message: t("msg.license.unreachable"),
             checkedAt: Date.now(),
         };
     }
     return cache;
 }
 export function licenseErrorResponse(toolName) {
-    const msg = cache?.message ?? "Invalid or missing license.";
+    // cache.message may come from the license server as-is (not translated here).
+    const msg = cache?.message ?? t("msg.license.invalid");
     return {
         content: [
             {
                 type: "text",
                 text: JSON.stringify({
-                    error: "License required",
+                    error: t("msg.license.required"),
                     detail: msg,
                     tool: toolName,
-                    info: "Get a license at https://synthetic.com.ar/premiere-mcp",
+                    info: t("msg.license.getLicense"),
                 }),
             },
         ],

package/dist/server.js

@@ -37,6 +37,7 @@ import { getExportPresetsTools } from "./tools/export-presets.js";
 import { getSequenceSettingsTools } from "./tools/sequence-settings.js";
 import { EXTENDSCRIPT_REFERENCE } from "./resources/extendscript-reference.js";
 import { checkLicense, licenseErrorResponse, FREE_TOOLS } from "./license.js";
+import { t, localizeToolsList } from "./i18n.js";
 import { z } from "zod";
 const PREMIERE_INSTRUCTIONS = `You are controlling Adobe Premiere Pro through MCP tools. Follow these best practices:
 
@@ -218,7 +219,7 @@ export function createServer(bridgeOptions) {
                                 },
                                 {
                                     type: "text",
-                                    text: "Frame captured successfully.",
+                                    text: t("msg.tool.frameCaptured"),
                                 },
                             ],
                         };
@@ -237,7 +238,7 @@ export function createServer(bridgeOptions) {
                         content: [
                             {
                                 type: "text",
-                                text: `Error: ${result.error}`,
+                                text: t("msg.tool.error", { message: String(result.error) }),
                             },
                         ],
                         isError: true,
@@ -249,7 +250,7 @@ export function createServer(bridgeOptions) {
                     content: [
                         {
                             type: "text",
-                            text: `Error: ${err instanceof Error ? err.message : String(err)}`,
+                            text: t("msg.tool.error", { message: err instanceof Error ? err.message : String(err) }),
                         },
                     ],
                     isError: true,
@@ -259,7 +260,7 @@ export function createServer(bridgeOptions) {
     }
     // Register LLM instructions resource
     server.resource("premiere-instructions", "config://premiere-instructions", {
-        description: "Instructions and best practices for using Premiere Pro via MCP tools",
+        description: t("msg.resource.instructions"),
         mimeType: "text/plain",
     }, async (uri) => ({
         contents: [
@@ -271,7 +272,7 @@ export function createServer(bridgeOptions) {
     }));
     // Register ExtendScript API reference resource
     server.resource("extendscript-reference", "config://extendscript-reference", {
-        description: "Complete Premiere Pro ExtendScript API reference for writing custom scripts via execute_extendscript",
+        description: t("msg.resource.extendscriptReference"),
         mimeType: "text/plain",
     }, async (uri) => ({
         contents: [
@@ -281,6 +282,9 @@ export function createServer(bridgeOptions) {
             },
         ],
     }));
+    // Translated tool descriptions in tools/list (both stdio and HTTP entry
+    // points build their server here, before connect()). No-op in English.
+    localizeToolsList(server);
     const toolCount = Object.keys(toolModules).length;
     console.error(`[premiere-pro-mcp] Registered ${toolCount} tools + 2 resources`);
     return server;

package/dist/tools/effects.js

@@ -1,5 +1,6 @@
 import { buildToolScript, escapeForExtendScript } from "../bridge/script-builder.js";
 import { sendCommand } from "../bridge/file-bridge.js";
+import { t } from "../i18n.js";
 export function getEffectsTools(bridgeOptions) {
     return {
         apply_effect: {
@@ -232,7 +233,7 @@ Example: apply_effect({ node_id: "abc123", effect_name: "Lumetri Color" })`,
                     { name: "Clip Name", category: "Utility" },
                     { name: "SDR Conform", category: "Utility" },
                 ];
-                return { success: true, data: { effects, count: effects.length, note: "Static list of common Premiere Pro video effects. Use apply_effect with these exact names." } };
+                return { success: true, data: { effects, count: effects.length, note: t("msg.tool.videoEffectsNote") } };
             },
         },
         list_available_audio_effects: {
@@ -279,7 +280,7 @@ Example: apply_effect({ node_id: "abc123", effect_name: "Lumetri Color" })`,
                     // Time & Pitch
                     { name: "Pitch & Time", category: "Time & Pitch" },
                 ];
-                return { success: true, data: { effects, count: effects.length, note: "Static list of common Premiere Pro audio effects. Use apply_audio_effect with these exact names." } };
+                return { success: true, data: { effects, count: effects.length, note: t("msg.tool.audioEffectsNote") } };
             },
         },
         color_correct: {

package/dist/tools/export.js

@@ -1,5 +1,6 @@
 import { buildToolScript, escapeForExtendScript } from "../bridge/script-builder.js";
 import { sendCommand } from "../bridge/file-bridge.js";
+import { t } from "../i18n.js";
 import { readFileSync, unlinkSync, existsSync } from "node:fs";
 import { join } from "node:path";
 import { tmpdir } from "node:os";
@@ -363,7 +364,7 @@ Example: export_sequence({ output_path: "/Users/me/exports/prores.mov", preset_p
                     attempts++;
                 }
                 if (!existsSync(tempPath)) {
-                    return { success: false, error: "Frame export completed but file not found at: " + tempPath };
+                    return { success: false, error: t("msg.tool.frameNotFound", { path: tempPath }) };
                 }
                 try {
                     const imageData = readFileSync(tempPath);
@@ -383,7 +384,7 @@ Example: export_sequence({ output_path: "/Users/me/exports/prores.mov", preset_p
                     };
                 }
                 catch (e) {
-                    return { success: false, error: `Failed to read captured frame: ${e instanceof Error ? e.message : String(e)}` };
+                    return { success: false, error: t("msg.tool.frameReadFailed", { error: e instanceof Error ? e.message : String(e) }) };
                 }
             },
         },

package/dist/tools/transitions.js

@@ -1,5 +1,6 @@
 import { buildToolScript, escapeForExtendScript } from "../bridge/script-builder.js";
 import { sendCommand } from "../bridge/file-bridge.js";
+import { t } from "../i18n.js";
 export function getTransitionsTools(bridgeOptions) {
     return {
         add_transition: {
@@ -247,7 +248,7 @@ export function getTransitionsTools(bridgeOptions) {
                     { name: "Swing Out", category: "3D Motion" },
                     { name: "Tumble Away", category: "3D Motion" },
                 ];
-                return { success: true, data: { transitions, count: transitions.length, note: "Static list of common Premiere Pro video transitions. Use add_transition with these exact names." } };
+                return { success: true, data: { transitions, count: transitions.length, note: t("msg.tool.videoTransitionsNote") } };
             },
         },
         list_available_audio_transitions: {
@@ -259,7 +260,7 @@ export function getTransitionsTools(bridgeOptions) {
                     { name: "Constant Power", category: "Crossfade", description: "Crossfade using constant power (equal loudness) - default" },
                     { name: "Exponential Fade", category: "Crossfade", description: "Exponential fade curve" },
                 ];
-                return { success: true, data: { transitions, count: transitions.length, note: "Premiere Pro has 3 audio transitions. 'Constant Power' is the recommended default for music crossfades." } };
+                return { success: true, data: { transitions, count: transitions.length, note: t("msg.tool.audioTransitionsNote") } };
             },
         },
     };