premiere-pro-mcp 1.21.0 → 1.22.0

package/CHANGELOG.md

@@ -6,6 +6,19 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [1.22.0] - 2026-10-08
+
+### Fixed
+
+- The Windows private-directory ACL check waits up to 30 seconds for `powershell.exe` instead of 5, in the server and in both CEP panels. On a loaded machine (including CI runners with coverage) PowerShell could take longer than 5 seconds to start, which made the check throw and blocked the bridge. A timeout still fails closed: the directory is not used unless the ACL check succeeds.
+- Effect writes, stabilization, smart-bin creation, proxy detachment, folder imports, sequence creation, marker deletion and clip selection now distinguish requested edits from host readback, report ignored writes as failures and unreadable results as `committed_unverified`. Selection counts describe applied states; stabilization does not claim a completed analysis. CEP selected-clip removal refuses ripple requests before deleting because clip absence cannot verify gap closure.
+- `set_sequence_display_format` writes Premiere's display codes (video 100-113, audio 200-201) and maps the older 0-11 / 0-1 inputs onto them. Premiere 26.5.2 stores and reads back any number, so the old values "verified" but did not select the format (2 formatted as non-drop timecode, 102 as drop-frame). `set_sequence_frame_rate` now reports the clips Premiere re-snaps to the new frame grid (`clipsMoved`, `maxShiftSeconds`, `movedClips`) with a warning that changing back does not restore them.
+- `create_subclip` now returns the new subclip's `nodeId` and reads its stored range back. On Premiere 26.5.2 a soft-boundary subclip's `getInPoint`/`getOutPoint` read the whole media, so the range is read from the subclip's project metadata (`VideoInPoint`/`VideoOutPoint` timecode and frame rate). The result reports requested and observed in/out seconds, with `outcome: "verified"` when both are within one media frame of the request and `committed_unverified` otherwise or when the metadata cannot be read.
+- `add_title` reports the start Premiere stored for the placed graphic. Premiere snaps it to the frame grid (a requested 5 s lands at 5.005 s at 29.97 fps), so `startSeconds` and the new `appliedStartSeconds` come from the placed clip, and the request is kept as `requestedStartSeconds`.
+- `update_marker` reports the stored marker start as `timeSeconds` (for example 7.5075 s rather than the requested 7.5 s) and adds `requestedSeconds`.
+- `manage_proxies` with `action: "toggle"` can set a known proxy display state. The action changes Premiere's application-wide proxy display (`app.setEnableProxies`), not the given item, and it only flipped the current state, so on Premiere 26.5.2 an agent could not ask for proxies on or off and two calls undid each other. It now accepts `enabled: true | false`, writes only when the state differs, and verifies by reading `app.getEnableProxies()` back; a host that ignores the write is reported as a failure. Omitting `enabled` still flips the state. Results report `previousEnabled`, `proxiesEnabled`, `changed` and `mode` (`set` or `flip`), and the description now says the action is application-wide.
+- Still-image mark clearing now identifies unreadable still duration explicitly; `set_clip_start_time` shares the verified implementation of `set_start_time` and is documented as its alias. Colour selection states that it uses the source project item label because CEP has no timeline clip-label getter. Baked title-cache cleanup retains the newest 50 matching files and leaves unrelated directory entries untouched.
+
 ## [1.21.0] - 2026-10-07
 
 ### Fixed
@@ -71,6 +84,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
   - **Markers.** `manage_markers_uxp` `add` now forwards and applies `color_index` and verifies every requested field. Previously the colour was dropped while the add reported verified.
   - **Frame export.** `export_frame_uxp` retries with the file extension when Premiere rejects an extension-less name ("File Format is not supported"). It also waits up to 15 s for the PNG, which 26.5.2 writes after the call returns, and it checks for the file by walking the approved workspace folder: a plugin with request-only file access cannot open arbitrary `file:` URLs, so the old check reported a written frame as missing.
   - **Media health.** `maintain_media_health_uxp` treats a single `project_item_id` as a one-item list for inspect, refresh and set_offline.
+
 - `import_media` no longer reports an error when an `.xml`, `.aaf`, `.edl` or `.prproj` file imports correctly. Interchange files create sequences and bins rather than an item with the file's path, so they now return `outcome: "committed_unverified"` with `interchange: true`, which stops retries from duplicating the sequence (#805).
 
 - `duplicate_clip` no longer places a copy one frame short. Premiere can snap the source out point a frame early, so on Premiere 26.5.2 a 677-frame clip was copied as 676 frames, and the tool still reported `verified` because it allowed two frames of drift. It now trims each placed copy, and its linked partner, back to the original end, reports `endCorrected`, and verifies start, end and source in-point to within half a frame.

package/README.md

@@ -129,13 +129,13 @@ The current source exposes 393 core tools for supported workflow steps spanning
 
 <a id="latest-release"></a>
 
-### Latest release: 1.21.0
+### Latest release: 1.22.0
 
-The published v1.21.0 npm artifact contains **393 core tools**, 391 in its default profile,
+The published v1.22.0 npm artifact contains **393 core tools**, 391 in its default profile,
 and 487 with a compatible UXP connection. The development catalog above can include
 unreleased work. See the [versioned facts and package provenance](https://premiere-pro-mcp.com/facts/).
 
-GitHub releases use `v<SemVer>` for both title and tag, such as `v1.21.0`.
+GitHub releases use `v<SemVer>` for both title and tag, such as `v1.22.0`.
 See [release naming and version conventions](docs/release-conventions.md).
 
 ### Try a bounded workflow
@@ -154,6 +154,8 @@ if the connection is unavailable.
 
 ### Release highlights
 
+- **1.22.0 readback receipts:** effect writes, stabilization, smart bins, proxies, folder imports, sequence creation, marker deletion and clip selection report what Premiere applied as `verified`, `committed_unverified` or `failed`; `create_subclip`, `add_title` and `update_marker` report the stored values; `set_sequence_frame_rate` lists clips Premiere re-snapped.
+- **1.22.0 display codes and proxies:** `set_sequence_display_format` writes Premiere's real display codes (video 100-113, audio 200-201) and maps the older 0-11 and 0-1 inputs onto them; `manage_proxies` toggle can set a known proxy display state; the Windows ACL check waits up to 30 seconds for PowerShell.
 - **1.21.0 Claude Desktop startup fix:** the extension starts when optional settings are blank, and Desktop's discover-only probe no longer holds the UXP port, so the real server keeps its UXP tools.
 - **1.21.0 frame-grid verification:** project-item marks, sequence In/Out, work area, link/unlink, zero point, transitions, `replace_clip` and `duplicate_clip` verify against Premiere's own frame and sample grids and fail closed; UXP tools snap times to the sequence frame grid.
 - **1.20.0 verified range removal:** `ripple_remove_timeline_ranges` previews, then applies a multi-range ripple removal with a single-use confirmation token and clip-level readback (QE razor; experimental).
@@ -193,7 +195,7 @@ if the connection is unavailable.
   local Premiere processes. See the generated [supported action catalog](docs/supported-actions.md)
   for individual capability and verification contracts.
 
-See the [v1.21.0 release notes](https://github.com/leancoderkavy/premiere-pro-mcp/releases/tag/v1.21.0)
+See the [v1.22.0 release notes](https://github.com/leancoderkavy/premiere-pro-mcp/releases/tag/v1.22.0)
 for complete details. Live installation in Premiere Pro still requires host verification.
 
 ### Current MCP protocol support
@@ -241,7 +243,7 @@ their bins, media rules, and organization rules before a facility uses one.
 > ### Install the published package (verify the name)
 >
 > ```bash
-> npm i -g premiere-pro-mcp@1.21.0
+> npm i -g premiere-pro-mcp@1.22.0
 > ```
 >
 > This repository publishes only **`premiere-pro-mcp`**. A differently named package (`adobe-premiere-pro-mcp`) may also declare a `premiere-pro-mcp` executable. Before configuring a client, confirm:
@@ -249,7 +251,7 @@ their bins, media rules, and organization rules before a facility uses one.
 > | Check | Expected |
 > | --- | --- |
 > | Package name | `premiere-pro-mcp` (not `adobe-premiere-pro-mcp`) |
-> | Version | `1.21.0` |
+> | Version | `1.22.0` |
 > | Homepage / repo | https://premiere-pro-mcp.com/ · https://github.com/leancoderkavy/premiere-pro-mcp |
 >
 > ```bash
@@ -262,9 +264,9 @@ their bins, media rules, and organization rules before a facility uses one.
 
 ### Easiest supported path: Claude Desktop
 
-1. Download the current [Claude Desktop bundle (`.mcpb`)](https://github.com/leancoderkavy/premiere-pro-mcp/releases/download/v1.21.0/premiere-pro-mcp-1.21.0.mcpb).
+1. Download the current [Claude Desktop bundle (`.mcpb`)](https://github.com/leancoderkavy/premiere-pro-mcp/releases/download/v1.22.0/premiere-pro-mcp-1.22.0.mcpb).
 2. In Claude Desktop, open **Settings > Extensions > Advanced settings > Install Extension**, select the downloaded bundle, and restart Claude Desktop.
-3. Download the separate [signed Premiere connector (`.zxp`)](https://github.com/leancoderkavy/premiere-pro-mcp/releases/download/v1.21.0/MCPBridgeCEP.zxp). Open it with your trusted ZXP installer. If your computer has no ZXP installer, use the npm connector installer in **Advanced setup** below.
+3. Download the separate [signed Premiere connector (`.zxp`)](https://github.com/leancoderkavy/premiere-pro-mcp/releases/download/v1.22.0/MCPBridgeCEP.zxp). Open it with your trusted ZXP installer. If your computer has no ZXP installer, use the npm connector installer in **Advanced setup** below.
 4. Restart Premiere, open a project, then open **Window > Extensions > MCP for Adobe Premiere Pro**.
 5. In Claude, enter: `Safely check my Premiere connection with verify_premiere_connection. Make no changes.`
 
@@ -568,11 +570,11 @@ From a clone of this repository:
 ```bash
 codex plugin marketplace add .
 codex plugin add premiere-pro@premiere-pro-mcp
-npx -y premiere-pro-mcp@1.21.0 --install-cep
+npx -y premiere-pro-mcp@1.22.0 --install-cep
 ```
 
 Restart Premiere Pro and start a new Codex session after installation. The plugin
-launches `premiere-pro-mcp@1.21.0` through `npx`; the separate CEP installation is
+launches `premiere-pro-mcp@1.22.0` through `npx`; the separate CEP installation is
 required because the MCP server communicates with the running Premiere host through
 the local bridge.
 
@@ -610,7 +612,7 @@ For Claude Code, add this repository as a marketplace and install the plugin:
 Then install the Premiere bridge and start a new Claude Code session:
 
 ```bash
-npx -y premiere-pro-mcp@1.21.0 --install-cep
+npx -y premiere-pro-mcp@1.22.0 --install-cep
 ```
 
 The Claude Code package lives in

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

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

package/after-effects-cep-plugin/bridge-directory-security.cjs

@@ -91,7 +91,7 @@
           encoding: "utf8",
           windowsHide: true,
           stdio: ["ignore", "pipe", "pipe"],
-          timeout: 5000,
+          timeout: 30000,
           maxBuffer: 64 * 1024,
           env: commandEnvironment,
         }

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.21.0" ExtensionBundleName="MCP for Adobe Premiere Pro">
+<ExtensionManifest Version="7.0" ExtensionBundleId="com.mcp.premiere.bridge" ExtensionBundleVersion="1.22.0" ExtensionBundleName="MCP for Adobe Premiere Pro">
   <ExtensionList>
-    <Extension Id="com.mcp.premiere.bridge.panel" Version="1.21.0"/>
-    <Extension Id="com.mcp.premiere.bridge.headless" Version="1.21.0"/>
+    <Extension Id="com.mcp.premiere.bridge.panel" Version="1.22.0"/>
+    <Extension Id="com.mcp.premiere.bridge.headless" Version="1.22.0"/>
   </ExtensionList>
   <ExecutionEnvironment>
     <HostList>

package/cep-plugin/bridge-directory-security.cjs

@@ -91,7 +91,7 @@
           encoding: "utf8",
           windowsHide: true,
           stdio: ["ignore", "pipe", "pipe"],
-          timeout: 5000,
+          timeout: 30000,
           maxBuffer: 64 * 1024,
           env: commandEnvironment,
         }

package/cep-plugin/index.html

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

package/cep-plugin/updater.cjs

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

package/dist/bridge/file-bridge.js

@@ -183,6 +183,9 @@ export const WINDOWS_BRIDGE_ACL_SCRIPT = [
     '})',
     '[pscustomobject]@{ ownerSid = $owner; currentUserSid = $current; unsafeWriteAces = $unsafe; unsafeAncestorEntries = $unsafeAncestors } | ConvertTo-Json -Compress',
 ].join("\n");
+// Starting powershell.exe can take several seconds on a loaded Windows machine (CI runners
+// with coverage timed out at 5 s). A timeout still fails closed: the caller throws.
+const WINDOWS_ACL_CHECK_TIMEOUT_MS = 30_000;
 export function inspectWindowsBridgeDirectoryAcl(directory, initialize, privacy = {}) {
     let script = WINDOWS_BRIDGE_ACL_SCRIPT;
     if (privacy.readAccess) {
@@ -198,7 +201,7 @@ export function inspectWindowsBridgeDirectoryAcl(directory, initialize, privacy
         encoding: "utf8",
         windowsHide: true,
         stdio: ["ignore", "pipe", "pipe"],
-        timeout: 5000,
+        timeout: WINDOWS_ACL_CHECK_TIMEOUT_MS,
         maxBuffer: 64 * 1024,
         env: {
             ...process.env,

package/dist/tools/advanced.js

@@ -888,7 +888,7 @@ export function getAdvancedTools(bridgeOptions, dependencies = {}) {
             },
         },
         set_clip_selection: {
-            description: "Select or deselect a clip in the active sequence",
+            description: "Select or deselect a clip in the active sequence and read its selection state back.",
             parameters: {
                 type: "object",
                 properties: {
@@ -904,12 +904,18 @@ export function getAdvancedTools(bridgeOptions, dependencies = {}) {
                 required: ["node_id", "selected"],
             },
             handler: async (args) => {
+                if (typeof args.selected !== "boolean")
+                    return { success: false, error: "selected must be a boolean" };
                 const script = buildToolScript(`
           var result = __findClip("${escapeForExtendScript(args.node_id)}");
           if (!result) return __error("Clip not found");
-          
           result.clip.setSelected(${args.selected ? 1 : 0}, true);
-          return __result({ selected: ${args.selected}, clipName: result.clip.name });
+          var applied = null;
+          try { var observed = result.clip.isSelected(); if (typeof observed === "boolean" || observed === 0 || observed === 1) applied = !!observed; } catch (readError) {}
+          var verified = applied === ${args.selected};
+          var receipt = { selected: applied, requestedSelected: ${args.selected}, clipName: result.clip.name, verified: verified, outcome: applied === null ? "committed_unverified" : (verified ? "verified" : "failed") };
+          if (applied !== null && !verified) return __jsonStringify({ success: false, error: "Premiere did not apply the requested clip selection.", data: receipt });
+          return __result(receipt);
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -1087,7 +1093,7 @@ export function getAdvancedTools(bridgeOptions, dependencies = {}) {
             },
         },
         create_sequence_from_clips: {
-            description: "Create a new sequence by automatically placing project items in order",
+            description: "Create a new sequence from project items, then verify its registered identity, name and source-item placements. clipCount reports observed track items; requestedClipCount reports requested source items.",
             parameters: {
                 type: "object",
                 properties: {
@@ -1104,6 +1110,8 @@ export function getAdvancedTools(bridgeOptions, dependencies = {}) {
                 required: ["name", "item_ids"],
             },
             handler: async (args) => {
+                if (!args.name || !Array.isArray(args.item_ids) || !args.item_ids.length || args.item_ids.some((id) => typeof id !== "string" || !id))
+                    return { success: false, error: "name and at least one non-empty item_id are required" };
                 const itemLookups = args.item_ids
                     .map((id, i) => `var item${i} = __findProjectItem("${escapeForExtendScript(id)}"); if (!item${i}) return __error("Item not found: ${escapeForExtendScript(id)}"); items.push(item${i});`)
                     .join("\n          ");
@@ -1111,9 +1119,48 @@ export function getAdvancedTools(bridgeOptions, dependencies = {}) {
           var items = [];
           ${itemLookups}
           
+          var beforeIds = {};
+          for (var b = 0; b < app.project.sequences.numSequences; b++) beforeIds[String(app.project.sequences[b].sequenceID)] = true;
           var seq = app.project.createNewSequenceFromClips("${escapeForExtendScript(args.name)}", items);
           if (!seq) return __error("Failed to create sequence from clips");
-          return __result({ created: true, name: seq.name, id: seq.sequenceID, clipCount: items.length });
+          var registered = null;
+          for (var r = 0; r < app.project.sequences.numSequences; r++) if (String(app.project.sequences[r].sequenceID) === String(seq.sequenceID)) registered = app.project.sequences[r];
+          var observedItems = [], appliedCount = 0, readable = true;
+          try {
+            if (!registered || !String(seq.sequenceID)) readable = false;
+            else {
+              var groups = [registered.videoTracks, registered.audioTracks];
+              for (var g = 0; g < groups.length; g++) {
+                var tracks = groups[g];
+                if (!tracks || typeof tracks.numTracks !== "number") { readable = false; continue; }
+                for (var t = 0; t < tracks.numTracks; t++) {
+                  for (var c = 0; c < tracks[t].clips.numItems; c++) {
+                    var clip = tracks[t].clips[c];
+                    appliedCount++;
+                    if (!clip.projectItem || !clip.projectItem.nodeId || !clip.start || !isFinite(Number(clip.start.ticks))) { readable = false; continue; }
+                    observedItems.push({ id: String(clip.projectItem.nodeId), start: Number(clip.start.ticks), kind: g });
+                  }
+                }
+              }
+            }
+          } catch (readError) { readable = false; }
+          var placementVerified = readable;
+          var lastStart = -1;
+          var used = {};
+          for (var i = 0; i < items.length && readable; i++) {
+            var match = -1;
+            for (var k = 0; k < observedItems.length; k++) {
+              if (!used[k] && observedItems[k].id === String(items[i].nodeId) && observedItems[k].start >= lastStart && (match < 0 || observedItems[k].start < observedItems[match].start)) match = k;
+            }
+            if (match < 0) { placementVerified = false; break; }
+            lastStart = observedItems[match].start;
+            for (var u = 0; u < observedItems.length; u++) if (observedItems[u].id === observedItems[match].id && observedItems[u].start === lastStart) used[u] = true;
+          }
+          var identityVerified = !!registered && !!String(seq.sequenceID) && !beforeIds[String(seq.sequenceID)] && registered.name === "${escapeForExtendScript(args.name)}";
+          var verified = identityVerified && placementVerified;
+          var receipt = { created: !!registered, name: registered ? registered.name : null, id: seq.sequenceID, clipCount: readable ? appliedCount : null, requestedClipCount: items.length, verified: verified, outcome: !readable ? "committed_unverified" : (verified ? "verified" : "failed"), verification: "Sequence identity, name and ordered source placements only; playback and persistence remain unverified." };
+          if (readable && !verified) return __jsonStringify({ success: false, error: "Created sequence did not match the requested identity, name or source placements.", data: receipt });
+          return __result(receipt);
         `);
                 return sendCommand(script, bridgeOptions);
             },

package/dist/tools/effects.js

@@ -587,7 +587,7 @@ export function getEffectsTools(bridgeOptions) {
             },
         },
         stabilize_clip: {
-            description: "Apply the Warp Stabilizer effect to a clip for video stabilization. Uses QE DOM.",
+            description: "Apply Warp Stabilizer using the experimental QE DOM. Verifies component addition and readable parameter values, never analysis completion. Numeric or unreadable Method popup values remain unverified because no documented label mapping is available.",
             parameters: {
                 type: "object",
                 properties: {
@@ -608,6 +608,10 @@ export function getEffectsTools(bridgeOptions) {
                 required: ["node_id"],
             },
             handler: async (args) => {
+                if (args.smoothness !== undefined && (!Number.isFinite(args.smoothness) || args.smoothness < 0 || args.smoothness > 100))
+                    return { success: false, error: "smoothness must be a finite percentage from 0 to 100" };
+                if (args.method !== undefined && !["Subspace Warp", "Position", "Position, Scale, Rotation"].includes(args.method))
+                    return { success: false, error: "Unsupported stabilization method" };
                 const script = buildToolScript(`
           app.enableQE();
           var qeSeq = qe.project.getActiveSequence();
@@ -625,6 +629,8 @@ export function getEffectsTools(bridgeOptions) {
           var qeClip = __findQeClipByDomClip(qeTrack, result.clip);
           if (!qeClip) return __error("Could not match the QE clip for " + result.clip.name + " by timeline start; nothing was changed.");
 
+          var componentCountBefore = result.clip.components.numItems;
+          if (typeof componentCountBefore !== "number" || !isFinite(componentCountBefore)) return __error("Cannot read clip components; nothing was changed.");
           // Find and apply Warp Stabilizer
           var effectCatalog = __getQeEffectCatalog("video");
           if (!effectCatalog.ok) return __error(effectCatalog.error);
@@ -640,32 +646,59 @@ export function getEffectsTools(bridgeOptions) {
           
           if (!found) return __error("Warp Stabilizer effect not found");
           
-          // Set properties if specified
           var clip = result.clip;
-          var changes = { stabilized: true };
-          ${args.smoothness !== undefined || args.method !== undefined ? `
-          for (var i = 0; i < clip.components.numItems; i++) {
-            var comp = clip.components[i];
-            if (comp.displayName === "Warp Stabilizer") {
-              for (var p = 0; p < comp.properties.numItems; p++) {
-                var prop = comp.properties[p];
-                ${args.smoothness !== undefined ? `
-                if (prop.displayName === "Smoothness") {
-                  prop.setValue(${args.smoothness}, true);
-                  changes.smoothness = ${args.smoothness};
-                }` : ""}
-                ${args.method !== undefined ? `
-                if (prop.displayName === "Method") {
-                  prop.setValue("${escapeForExtendScript(args.method)}", true);
-                  changes.method = "${escapeForExtendScript(args.method)}";
-                }` : ""}
+          var afterCount = null;
+          var stabilizer = null;
+          try {
+            afterCount = clip.components.numItems;
+            if (typeof afterCount !== "number" || !isFinite(afterCount)) afterCount = null;
+            if (afterCount !== null) {
+              for (var componentIndex = componentCountBefore; componentIndex < afterCount; componentIndex++) {
+                if (clip.components[componentIndex].displayName === "Warp Stabilizer") stabilizer = clip.components[componentIndex];
               }
-              break;
             }
+          } catch (componentReadError) { afterCount = null; }
+          var changes = { stabilized: false };
+          var data = { clipName: clip.name, changes: changes, requested: { smoothness: ${args.smoothness === undefined ? "null" : args.smoothness}, method: ${args.method === undefined ? "null" : `"${escapeForExtendScript(args.method)}"`} }, applied: { smoothness: null, method: null }, componentCountBefore: componentCountBefore, componentCountAfter: afterCount, verified: false, outcome: "committed_unverified", analysisStatus: "unknown", info: "Effect and parameter readback only; analysis completion and rendered stabilization require separate inspection." };
+          if (afterCount !== null && afterCount <= componentCountBefore) { data.outcome = "failed"; return __error("Premiere did not add Warp Stabilizer.", data); }
+          if (!stabilizer) return __result(data);
+          changes.stabilized = true;
+          var parameterVerified = true;
+          var parameterMismatch = false;
+          var warnings = [];
+          function setStabilizerParameter(name, requested, field) {
+            if (requested === null) return;
+            var property = null;
+            var matches = 0;
+            for (var propertyIndex = 0; propertyIndex < stabilizer.properties.numItems; propertyIndex++) {
+              if (stabilizer.properties[propertyIndex].displayName === name) { property = stabilizer.properties[propertyIndex]; matches++; }
+            }
+            if (matches !== 1) { parameterVerified = false; warnings.push(name + " property is unavailable or ambiguous."); return; }
+            try {
+              if (name === "Method") {
+                var currentMethod = property.getValue();
+                if (typeof currentMethod !== "string" || (currentMethod !== "Subspace Warp" && currentMethod !== "Position" && currentMethod !== "Position, Scale, Rotation")) {
+                  parameterVerified = false;
+                  warnings.push("Method popup mapping is unavailable; method was not changed.");
+                  return;
+                }
+              }
+              property.setValue(requested, true);
+              var actual = property.getValue();
+              if (actual === undefined || actual === null || (typeof actual === "number" && !isFinite(actual))) { parameterVerified = false; return; }
+              data.applied[field] = actual;
+              changes[field] = actual;
+              var same = typeof actual === "number" && typeof requested === "number" ? Math.abs(actual - requested) <= 0.0001 : actual === requested;
+              if (!same) { parameterMismatch = true; parameterVerified = false; }
+            } catch (parameterError) { parameterVerified = false; warnings.push(name + " write or readback unavailable: " + String(parameterError)); }
           }
-          ` : ""}
-          
-          return __result({ clipName: clip.name, info: "Warp Stabilizer applied. Analysis will begin automatically.", changes: changes });
+          setStabilizerParameter("Smoothness", data.requested.smoothness, "smoothness");
+          setStabilizerParameter("Method", data.requested.method, "method");
+          data.warnings = warnings;
+          data.verified = parameterVerified;
+          data.outcome = parameterMismatch ? "failed" : (parameterVerified ? "verified" : "committed_unverified");
+          if (parameterMismatch) return __error("Warp Stabilizer parameter readback does not match the requested value.", data);
+          return __result(data);
         `);
                 return sendCommand(script, bridgeOptions);
             },

package/dist/tools/export.d.ts

@@ -862,6 +862,10 @@ export declare function getExportTools(bridgeOptions: BridgeOptions): {
                     type: string;
                     description: string;
                 };
+                enabled: {
+                    type: string;
+                    description: string;
+                };
             };
             required: string[];
         };
@@ -872,6 +876,7 @@ export declare function getExportTools(bridgeOptions: BridgeOptions): {
             output_path?: string;
             preset_path?: string;
             start_batch?: boolean;
+            enabled?: boolean;
         }) => Promise<import("../bridge/file-bridge.js").CommandResult | {
             success: boolean;
             error: string;

package/dist/tools/export.js

@@ -1549,7 +1549,7 @@ export function getExportTools(bridgeOptions) {
             },
         },
         create_subclip: {
-            description: "Create a subclip from a project item with in/out points",
+            description: "Create a subclip from a project item with in/out points. Returns the new item's nodeId and reads its stored range back from Premiere project metadata: outcome verified when the observed in/out seconds are within one media frame of the request, otherwise committed_unverified.",
             parameters: {
                 type: "object",
                 properties: {
@@ -1573,13 +1573,18 @@ export function getExportTools(bridgeOptions) {
                 required: ["item_id", "name", "in_seconds", "out_seconds"],
             },
             handler: async (args) => {
+                if (!Number.isFinite(args.in_seconds) || !Number.isFinite(args.out_seconds) || args.in_seconds < 0 || args.out_seconds <= args.in_seconds) {
+                    return { success: false, error: "in_seconds and out_seconds must be finite, in_seconds must be non-negative, and out_seconds must be after in_seconds." };
+                }
                 const script = buildToolScript(`
           var item = __findProjectItem("${escapeForExtendScript(args.item_id)}");
           if (!item) return __error("Item not found");
-          
-          var inTicks = __secondsToTicks(${args.in_seconds}).toString();
-          var outTicks = __secondsToTicks(${args.out_seconds}).toString();
-          
+
+          var requestedInSeconds = ${args.in_seconds};
+          var requestedOutSeconds = ${args.out_seconds};
+          var inTicks = __secondsToTicks(requestedInSeconds).toString();
+          var outTicks = __secondsToTicks(requestedOutSeconds).toString();
+
           var subclip = item.createSubClip(
             "${escapeForExtendScript(args.name)}",
             inTicks,
@@ -1588,9 +1593,80 @@ export function getExportTools(bridgeOptions) {
             1, // takeVideo
             1  // takeAudio
           );
-          
+
           if (!subclip) return __error("Failed to create subclip");
-          return __result({ created: true, name: "${escapeForExtendScript(args.name)}", source: item.name });
+
+          // A soft-boundary subclip's getInPoint/getOutPoint read the whole media
+          // on Premiere 26.5, so read the stored range from project metadata.
+          // Each point holds an rdf:value timecode and a frame_rate child in
+          // ticks per frame; the Out timecode names the last frame (inclusive).
+          function __subclipTimecodeFrames(timecode, frameTicks) {
+            var parts = String(timecode).match(/^\\s*(\\d+)[:;.](\\d+)[:;.](\\d+)([:;.])(\\d+)\\s*$/);
+            if (!parts) return NaN;
+            var nominal = Math.round(TICKS_PER_SECOND / frameTicks);
+            var hours = parseInt(parts[1], 10);
+            var minutes = parseInt(parts[2], 10);
+            var frames = ((hours * 60 + minutes) * 60 + parseInt(parts[3], 10)) * nominal + parseInt(parts[5], 10);
+            if (parts[4] === ";" && (nominal === 30 || nominal === 60)) {
+              var totalMinutes = hours * 60 + minutes;
+              frames -= (nominal / 15) * (totalMinutes - Math.floor(totalMinutes / 10));
+            }
+            return frames;
+          }
+          function __subclipPoint(xml, column) {
+            var tagName = "Column.Intrinsic." + column;
+            var openStart = xml.indexOf(tagName);
+            if (openStart < 0) return null;
+            var openEnd = xml.indexOf(">", openStart);
+            if (openEnd < 0 || xml.charAt(openEnd - 1) === "/") return null;
+            var closeStart = xml.indexOf(tagName, openEnd);
+            if (closeStart < 0) return null;
+            var body = xml.substring(openEnd + 1, closeStart);
+            var value = body.match(/<rdf:value>\\s*([^<]*?)\\s*<\\/rdf:value>/);
+            var rate = body.match(/frame_rate>\\s*(\\d+)\\s*</);
+            if (!value || !rate) return null;
+            var frameTicks = parseFloat(rate[1]);
+            if (!isFinite(frameTicks) || frameTicks <= 0) return null;
+            var frames = __subclipTimecodeFrames(value[1], frameTicks);
+            if (!isFinite(frames)) return null;
+            return { frames: frames, frameTicks: frameTicks, timecode: value[1] };
+          }
+
+          var nodeId = null;
+          try { nodeId = subclip.nodeId ? String(subclip.nodeId) : null; } catch (nodeIdError) {}
+          var receipt = {
+            created: true,
+            nodeId: nodeId,
+            name: "${escapeForExtendScript(args.name)}",
+            source: item.name,
+            requestedInSeconds: requestedInSeconds,
+            requestedOutSeconds: requestedOutSeconds,
+            observedInSeconds: null,
+            observedOutSeconds: null,
+            outcome: "committed_unverified",
+            verified: false
+          };
+          try { if (subclip.name) receipt.name = String(subclip.name); } catch (nameError) {}
+          var metadata = null;
+          try { metadata = subclip.getProjectMetadata ? String(subclip.getProjectMetadata()) : null; } catch (metadataError) {}
+          var inPoint = metadata ? __subclipPoint(metadata, "VideoInPoint") : null;
+          var outPoint = metadata ? __subclipPoint(metadata, "VideoOutPoint") : null;
+          if (!inPoint || !outPoint) {
+            receipt.note = "Premiere created the subclip, but its stored in/out range could not be read from project metadata.";
+            return __result(receipt);
+          }
+          receipt.observedInSeconds = __ticksToSeconds(inPoint.frames * inPoint.frameTicks);
+          receipt.observedOutSeconds = __ticksToSeconds((outPoint.frames + 1) * outPoint.frameTicks);
+          receipt.observedInTimecode = inPoint.timecode;
+          receipt.observedOutTimecode = outPoint.timecode;
+          var tolerance = __ticksToSeconds(Math.max(inPoint.frameTicks, outPoint.frameTicks)) + 0.000001;
+          if (Math.abs(receipt.observedInSeconds - requestedInSeconds) <= tolerance && Math.abs(receipt.observedOutSeconds - requestedOutSeconds) <= tolerance) {
+            receipt.outcome = "verified";
+            receipt.verified = true;
+          } else {
+            receipt.note = "Premiere stored a subclip range more than one media frame from the request.";
+          }
+          return __result(receipt);
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -1910,7 +1986,10 @@ export function getExportTools(bridgeOptions) {
             },
         },
         manage_proxies: {
-            description: "Create, attach, or toggle proxies for a project item. " +
+            description: "Create or attach proxies for a project item, or set Premiere's proxy display. " +
+                "'toggle' is application-wide, not per item: it changes app.getEnableProxies()/setEnableProxies() for every sequence and monitor, " +
+                "and item_id is only checked to exist. Pass enabled: true or false to set a known state; omitting enabled flips the current state, " +
+                "so two calls undo each other. The result reports previousEnabled and proxiesEnabled read back from Premiere. " +
                 "Note: 'create' only requests a proxy encode from Adobe Media Encoder and returns an unverified handoff. " +
                 "Independently verify the AME queue or output file before calling this tool again with action 'attach' " +
                 "and proxy_path set to the output_path you passed here. Optional start_batch requests processing of every ready AME queue job, including unrelated jobs. " +
@@ -1946,10 +2025,21 @@ export function getExportTools(bridgeOptions) {
                         type: "boolean",
                         description: AME_START_BATCH_DESCRIPTION,
                     },
+                    enabled: {
+                        type: "boolean",
+                        description: "For 'toggle' only: sets the application-wide proxy display to this state (true shows proxies, false shows full-resolution media) " +
+                            "and verifies it by reading app.getEnableProxies() back. Omit to flip the current state, which is discouraged because the outcome depends on a state you have not read.",
+                    },
                 },
                 required: ["item_id", "action"],
             },
             handler: async (args) => {
+                if (!["create", "attach", "toggle"].includes(args.action)) {
+                    return { success: false, error: "action must be create, attach, or toggle. Nothing was changed." };
+                }
+                if (args.enabled !== undefined && typeof args.enabled !== "boolean") {
+                    return { success: false, error: "enabled must be a boolean" };
+                }
                 let presetPath = args.preset_path;
                 const skippedPresets = [];
                 if (args.action === "create" && args.output_path && !presetPath) {
@@ -2035,11 +2125,27 @@ export function getExportTools(bridgeOptions) {
             if (typeof app.getEnableProxies !== "function" || typeof app.setEnableProxies !== "function") {
               return __error("This Premiere build does not expose app.getEnableProxies/setEnableProxies; toggle proxies in the Program Monitor.");
             }
+            var requestedEnabled = ${args.enabled === undefined ? "null" : args.enabled ? "true" : "false"};
             var wasEnabled = Number(app.getEnableProxies()) === 1;
-            app.setEnableProxies(wasEnabled ? 0 : 1);
+            var targetEnabled = requestedEnabled === null ? !wasEnabled : requestedEnabled;
+            if (targetEnabled !== wasEnabled) app.setEnableProxies(targetEnabled ? 1 : 0);
             var nowEnabled = Number(app.getEnableProxies()) === 1;
-            if (nowEnabled === wasEnabled) return __error("Premiere did not change the proxy display setting.");
-            return __result({ action: "toggle", proxiesEnabled: nowEnabled, verified: true, scope: "application-wide proxy display" });
+            if (nowEnabled !== targetEnabled) {
+              return __error(
+                "Premiere did not apply the proxy display setting: requested " + (targetEnabled ? "enabled" : "disabled") + ", read back " + (nowEnabled ? "enabled" : "disabled") + ".",
+                { action: "toggle", previousEnabled: wasEnabled, requestedEnabled: targetEnabled, proxiesEnabled: nowEnabled, verified: false, outcome: "failed", scope: "application-wide proxy display" }
+              );
+            }
+            return __result({
+              action: "toggle",
+              mode: requestedEnabled === null ? "flip" : "set",
+              previousEnabled: wasEnabled,
+              proxiesEnabled: nowEnabled,
+              changed: nowEnabled !== wasEnabled,
+              verified: true,
+              outcome: "verified",
+              scope: "application-wide proxy display"
+            });
           }
 
           return __error("Unknown proxy action: " + action);