premiere-pro-mcp 1.16.2 → 1.16.4

package/CHANGELOG.md

@@ -6,6 +6,51 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [1.16.4] - 2026-09-20
+
+### Added
+
+- Claude Fable 5.1 client workflow guidance for Cursor and other compatible MCP
+  clients, covering model selection, data-retention opt-in, tool discovery, and
+  serialized Premiere verification. (#576)
+- Named Premiere metadata field inspect and update through existing CEP and UXP
+  tools, with field readback instead of requiring complete packet dumps. (#577)
+
+### Changed
+
+- Shared `AGENTS.md` as the canonical repo map for IDE and coding-agent stubs,
+  and pin client CEP install commands to the published package. (#582)
+
+### Fixed
+
+- `set_item_in_out` and `set_source_in_out` pass seconds, not ticks, to
+  `ProjectItem.setInPoint`/`setOutPoint` and verify tick readback. A Source
+  Monitor readback mismatch restores original marks when possible and otherwise
+  reports a partial state. The ExtendScript reference documents those setter
+  arguments as seconds. (#579)
+- CEP `create_subsequence` verifies the new sequence without ES5
+  `Array.indexOf`, which ExtendScript does not provide. (#579)
+- `ripple_delete` now fails closed when QE sync-lock state cannot be read,
+  instead of omitting neighbours and reporting a verified ripple. (#578)
+- Still-image `capture_frame` / `export_frame` AME fallback restores sequence
+  in/out only after those marks can be read, so a failed restore cannot leave
+  the sequence pinned to one frame. (#580)
+
+Automated checks do not establish licensed Premiere or After Effects playback or
+rendered-output verification.
+
+## [1.16.3] - 2026-09-18
+
+### Changed
+
+- Changelog landing intro no longer stacks a large vertical pad on the shared
+  public-content main padding.
+- npm minor and patch updates: `@posthog/core` 1.54.2, `@posthog/types` 1.412.1,
+  `posthog-node` 5.52.4, `zod` 4.6.5, and `@types/node` 26.6.1.
+
+Automated checks do not establish licensed Premiere or After Effects playback or
+rendered-output verification.
+
 ## [1.16.2] - 2026-09-18
 
 ### Fixed

package/README.md

@@ -12,7 +12,7 @@ Free, MIT licensed, local-first, and published to npm as [`premiere-pro-mcp`](ht
 
 [Website](https://premiere-pro-mcp.com/) · [Recorded demo](https://premiere-pro-mcp.com/demo/) · [Compare servers](https://premiere-pro-mcp.com/compare/) · [Setup guides](https://premiere-pro-mcp.com/blog/how-to-set-up-premiere-pro-mcp/) · [Search tools](https://premiere-pro-mcp.com/tools/) · [Troubleshooting](https://premiere-pro-mcp.com/docs/troubleshooting/) · [Release facts](https://premiere-pro-mcp.com/facts/)
 
-Development source: 381 core tools across 56 modules, 4 resources, and 18 guided workflows. A connected UXP host adds 95 capability-gated tools.
+Development source: 381 core tools across 56 modules, 4 resources, and 19 guided workflows. A connected UXP host adds 95 capability-gated tools.
 
 The [completed AE render handoff](docs/after-effects-render-handoff.md) previews and confirms importing one finished render into an existing Premiere bin, with host and file rechecks and an import receipt.
 
@@ -50,7 +50,7 @@ The [completed AE render handoff](docs/after-effects-render-handoff.md) previews
   - [Configure your MCP client](#3-configure-your-mcp-client)
   - [Verify the bridge in Premiere Pro](#4-verify-the-bridge-in-premiere-pro)
 - [Clients and capability coverage](#codex-plugin)
-  - [Codex plugin](#codex-plugin) · [Claude](#claude) · [GPT-6 Astra tool discovery](#gpt-6-astra-and-agent-tool-discovery)
+  - [Codex plugin](#codex-plugin) · [Claude](#claude) · [GPT-6 Astra tool discovery](#gpt-6-astra-and-agent-tool-discovery) · [Claude Fable 5.1](#claude-fable-51)
   - [Windows and macOS capability coverage](#windows-and-macos-capability-coverage)
   - [After Effects MOGRT studio](#after-effects-mogrt-studio)
   - [Collaboration and AI feature boundaries](#collaboration-and-ai-feature-boundaries)
@@ -108,9 +108,9 @@ The current source exposes 381 core tools for supported workflow steps spanning
 
 <a id="latest-release"></a>
 
-### Latest release: 1.16.2
+### Latest release: 1.16.4
 
-The published v1.16.1 npm artifact contains **381 core tools**, 379 in its default profile,
+The published v1.16.3 npm artifact contains **381 core tools**, 379 in its default profile,
 and 474 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/).
 
@@ -160,7 +160,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.16.2 release notes](https://github.com/leancoderkavy/premiere-pro-mcp/releases/tag/v1.16.2)
+See the [v1.16.4 release notes](https://github.com/leancoderkavy/premiere-pro-mcp/releases/tag/v1.16.4)
 for complete details. Live installation in Premiere Pro still requires host verification.
 
 ### Current MCP protocol support
@@ -208,7 +208,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.16.2
+> npm i -g premiere-pro-mcp@1.16.4
 > ```
 >
 > 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:
@@ -216,7 +216,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.16.2` |
+> | Version | `1.16.4` |
 > | Homepage / repo | https://premiere-pro-mcp.com/ · https://github.com/leancoderkavy/premiere-pro-mcp |
 >
 > ```bash
@@ -229,9 +229,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.16.2/premiere-pro-mcp-1.16.2.mcpb).
+1. Download the current [Claude Desktop bundle (`.mcpb`)](https://github.com/leancoderkavy/premiere-pro-mcp/releases/download/v1.16.4/premiere-pro-mcp-1.16.4.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.16.2/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.16.4/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.`
 
@@ -488,6 +488,9 @@ Add to `.cursor/mcp.json` in your project or global config:
 }
 ```
 
+After the server is enabled, select Claude Fable 5.1 in Cursor when you want a
+longer-horizon session. See [Claude Fable 5.1 workflows](docs/claude-fable-5-1.md).
+
 </details>
 
 <details>
@@ -528,11 +531,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.15.1 --install-cep
+npx -y premiere-pro-mcp@1.16.3 --install-cep
 ```
 
 Restart Premiere Pro and start a new Codex session after installation. The plugin
-launches `premiere-pro-mcp@1.15.1` through `npx`; the separate CEP installation is
+launches `premiere-pro-mcp@1.16.3` through `npx`; the separate CEP installation is
 required because the MCP server communicates with the running Premiere host through
 the local bridge.
 
@@ -563,7 +566,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.15.1 --install-cep
+npx -y premiere-pro-mcp@1.16.3 --install-cep
 ```
 
 The Claude Code package lives in
@@ -581,6 +584,26 @@ Install the resulting file from `artifacts/` through **Settings > Extensions >
 Advanced settings > Install Extension**. The Premiere CEP bridge must still be
 installed separately.
 
+### Claude Fable 5.1
+
+Use Cursor, Claude Desktop, or Claude Code with Claude Fable 5.1
+(`claude-fable-5-1`) when your account has access. Model selection belongs to the
+client; this server does not run an Anthropic model. Fable 5.1 is optional:
+other Claude models can call the same MCP tools. If Cursor Privacy Mode or an
+Enterprise plan is enabled, an admin must approve Anthropic's Fable data-retention
+policy before the model is available.
+
+The server supplies session-aware workflow instructions and bounded tool discovery:
+call `get_capabilities` with `{"tool_query":"transcript","tool_limit":10}` to
+find relevant operations, their descriptions, and backend requirements. Keep
+Premiere mutations serialized even in a long Fable 5.1 session. Image review of
+returned frames is not playback or delivery proof.
+
+See [Claude Fable 5.1 workflows](docs/claude-fable-5-1.md) for connection order,
+privacy boundaries, evidence retrieval, Cursor's Opus fallback, and the division
+between MCP and client capabilities. The public walkthrough is
+[How to Use Claude Fable 5.1 with MCP for Adobe Premiere Pro](https://premiere-pro-mcp.com/blog/claude-fable-5-1-premiere-pro-mcp/).
+
 ### Windows and macOS capability coverage
 
 | Surface | Windows | macOS | Verification boundary |
@@ -1147,13 +1170,13 @@ Track targeting, batch operations, markers, audio levels, motion/transform, meta
 
 ## MCP Resources
 
-The server exposes fourteen LLM context resources and eleven workflow prompts:
+The server exposes fourteen LLM context resources and nineteen workflow prompts:
 
 | Resource URI | Description |
 | :----------- | :---------- |
-| `config://premiere-instructions` | Best practices: workflow order, timeline rules, effect tips, error handling |
+| `config://premiere-instructions` | Best practices: workflow order, metadata layers, timeline rules, error handling |
 | `config://extendscript-reference` | Complete ExtendScript API reference for writing custom scripts |
-| `config://premiere-workflows` | Machine-readable catalog for rough cuts, dialogue cleanup, captions, and delivery |
+| `config://premiere-workflows` | Machine-readable catalog for rough cuts, metadata review, dialogue cleanup, captions, and delivery |
 | `config://premiere-project-context` | Revisioned local project-context indexing and retrieval workflow |
 | `premiere://project/info` | Fresh, path-redacted current-project and active-sequence summary |
 | `premiere://project/sequences` | Bounded sequence inventory with stable Premiere IDs |
@@ -1164,7 +1187,7 @@ The server exposes fourteen LLM context resources and eleven workflow prompts:
 | `premiere://effects/applied` | Bounded active-timeline component inventory |
 | `premiere://transitions/available` | Bounded video/audio transition catalog for planning |
 | `premiere://export/presets` | Bounded export-preset names and formats, without native paths |
-| `premiere://project/metadata` | Read-only project and active-timeline summary, without paths or timestamps |
+| `premiere://project/metadata` | Path-redacted project and active-timeline summary — not XMP or Project Metadata XML |
 
 The ten `premiere://` snapshots are read-only CEP bridge requests. They include a
 revision token for stale-state detection and omit native media, project-tree, preset,
@@ -1377,6 +1400,7 @@ premiere-pro-mcp/
 ├── Dockerfile                   # Multi-stage Docker build for Fly.io
 ├── fly.toml                     # Fly.io deployment config
 ├── RESEARCH.md                  # API research and implementation status
+├── AGENTS.md                    # IDE / coding-agent map
 ├── CONTRIBUTING.md              # Contribution guidelines
 ├── CHANGELOG.md                 # Version history
 └── LICENSE                      # MIT License
@@ -1433,7 +1457,9 @@ by default. Enable them only by setting
   directories writable by group/other users are refused by both the server and panels;
   tightening permissions alone cannot make previously staged commands trustworthy.
   On Windows, only the current user, SYSTEM and Administrators may have write access,
-  including inherited grants. ACL inspection failures also stop startup. Ancestors must
+  including inherited grants. Windows capability and app-container SIDs (`S-1-15-*`)
+  are ignored: they are not logon principals and appear as inherited FullControl on
+  stock `%LOCALAPPDATA%` paths. ACL inspection failures also stop startup. Ancestors must
   also prevent other users from replacing the bridge path; a private child inside a
   broadly writable parent is insufficient (POSIX sticky temp directories are supported).
   Choose a new directory under a private user-owned location if the connector rejects
@@ -1471,6 +1497,8 @@ Premiere Pro; its npm package is `premiere-pro-mcp`.
 Install the [Claude Desktop bundle](#easiest-supported-path-claude-desktop), install
 the separate signed Premiere connector, restart Premiere, then ask Claude to run
 `verify_premiere_connection` with no changes. That first prompt is read-only.
+Claude Fable 5.1 is an optional client model for Cursor, Claude Desktop, or Claude
+Code; see [Claude Fable 5.1 workflows](docs/claude-fable-5-1.md).
 
 **Where is the GitHub repository?**
 <https://github.com/leancoderkavy/premiere-pro-mcp>. Releases, the signed `.zxp`
@@ -1596,6 +1624,7 @@ buy prioritized support, roadmap influence, or any claim about unverified host b
 ## Contributing
 
 Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+AI agents and IDE assistants should read [AGENTS.md](AGENTS.md).
 
 The evidence-backed [next improvement pull-request roadmap](docs/next-improvement-pr-roadmap.md)
 breaks the proposed feature, protocol, reliability, and performance work into ten

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

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

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

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.16.2</strong>
+        <strong id="updateTitle">Version 1.16.4</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.16.2";
+  var CURRENT_VERSION = "1.16.4";
   var PACKAGE_NAME = "premiere-pro-mcp";
   var LATEST_PACKAGE_API = "https://registry.npmjs.org/" + PACKAGE_NAME;
   var LATEST_RELEASE_API =

package/dist/bridge/script-builder.js

@@ -556,24 +556,26 @@ function __exportStillFrame(outputPath, ticks) {
         savedIn = seq.getInPointAsTime().ticks;
         savedOut = seq.getOutPointAsTime().ticks;
       } catch (e) {}
-
-      // seq.timebase is ticks-per-frame, but Sequence.setInPoint/setOutPoint take
-      // seconds (unlike setPlayerPosition, which takes ticks). Convert before
-      // setting the one-frame range or Premiere targets an astronomically large
-      // interval and the still export produces no file.
-      var frameTicks = parseFloat(seq.timebase);
-      var startTicks = parseFloat(atTicks);
-      seq.setInPoint(__ticksToSeconds(startTicks));
-      seq.setOutPoint(__ticksToSeconds(startTicks + frameTicks));
-
-      try {
-        seq.exportAsMediaDirect(outputPath, preset, app.encoder.ENCODE_IN_TO_OUT);
-        notes.push("AME preset: " + preset);
-      } finally {
+      // Unreadable in/out cannot be restored. Changing them anyway left the
+      // sequence pinned to a one-frame export range after QE-to-AME fallback.
+      if (savedIn === null || savedIn === undefined || savedOut === null || savedOut === undefined) {
+        notes.push("AME: could not read sequence in/out points, so they were not changed for a one-frame export");
+      } else {
+        // seq.timebase is ticks-per-frame, but Sequence.setInPoint/setOutPoint take
+        // seconds (unlike setPlayerPosition, which takes ticks). Convert before
+        // setting the one-frame range or Premiere targets an astronomically large
+        // interval and the still export produces no file.
+        var frameTicks = parseFloat(seq.timebase);
+        var startTicks = parseFloat(atTicks);
         try {
-          if (savedIn !== null) seq.setInPoint(__ticksToSeconds(savedIn));
-          if (savedOut !== null) seq.setOutPoint(__ticksToSeconds(savedOut));
-        } catch (e) {}
+          seq.setInPoint(__ticksToSeconds(startTicks));
+          seq.setOutPoint(__ticksToSeconds(startTicks + frameTicks));
+          seq.exportAsMediaDirect(outputPath, preset, app.encoder.ENCODE_IN_TO_OUT);
+          notes.push("AME preset: " + preset);
+        } finally {
+          try { seq.setInPoint(__ticksToSeconds(savedIn)); } catch (eIn) {}
+          try { seq.setOutPoint(__ticksToSeconds(savedOut)); } catch (eOut) {}
+        }
       }
     }
   } catch (eAME) {

package/dist/resources/adobe-uxp-coverage.json

@@ -1003,6 +1003,58 @@
       "idempotency": "operation_id",
       "verificationBoundary": "metadata_readback"
     },
+    {
+      "id": "bounded-xmp-field-inspection",
+      "adobeApi": [
+        "Metadata.getProjectMetadata",
+        "Metadata.getXMPMetadata",
+        "Metadata.getProjectColumnsMetadata"
+      ],
+      "documentationUrls": [
+        "https://developer.adobe.com/premiere-pro/uxp/ppro-reference/classes/metadata/",
+        "https://developer.adobe.com/premiere-pro/uxp/uxp-api/reference-js/modules/uxp/xmp/xmp-classes/xmp-meta"
+      ],
+      "minimumPremiereVersion": "25.6.0",
+      "backend": "uxp",
+      "uxpCommand": "metadata.fields.inspect",
+      "mcpTools": ["manage_metadata_uxp"],
+      "availability": "current",
+      "implementationStatus": "implemented",
+      "verificationStatus": "automated_contract_verified",
+      "liveHostVerificationStatus": "not_run",
+      "mutatesProject": false,
+      "undoable": false,
+      "idempotency": "not_applicable",
+      "verificationBoundary": "bounded_metadata_field_readback"
+    },
+    {
+      "id": "guarded-xmp-field-update",
+      "adobeApi": [
+        "Metadata.getProjectMetadata",
+        "Metadata.getXMPMetadata",
+        "Metadata.createSetProjectMetadataAction",
+        "Metadata.createSetXMPMetadataAction",
+        "Project.lockedAccess",
+        "Project.executeTransaction"
+      ],
+      "documentationUrls": [
+        "https://developer.adobe.com/premiere-pro/uxp/ppro-reference/classes/metadata/",
+        "https://developer.adobe.com/premiere-pro/uxp/ppro-reference/classes/project/",
+        "https://developer.adobe.com/premiere-pro/uxp/uxp-api/reference-js/modules/uxp/xmp/xmp-classes/xmp-meta"
+      ],
+      "minimumPremiereVersion": "25.6.0",
+      "backend": "uxp",
+      "uxpCommand": "metadata.fields.update",
+      "mcpTools": ["manage_metadata_uxp"],
+      "availability": "current",
+      "implementationStatus": "implemented",
+      "verificationStatus": "automated_contract_verified",
+      "liveHostVerificationStatus": "not_run",
+      "mutatesProject": true,
+      "undoable": true,
+      "idempotency": "operation_id",
+      "verificationBoundary": "metadata_field_readback"
+    },
     {
       "id": "bounded-project-columns-metadata-inspection",
       "adobeApi": [

package/dist/resources/extendscript-reference.js

@@ -48,8 +48,8 @@ export const EXTENDSCRIPT_REFERENCE = [
     "item.createBin(name)           - ProjectItem (new bin)",
     "item.createSmartBin(name, query)",
     "item.createSubClip(name, startTicks, endTicks, hasHardBoundaries, takeVideo, takeAudio)",
-    "item.setInPoint(ticks, mediaType)",
-    "item.setOutPoint(ticks, mediaType)",
+    "item.setInPoint(seconds, mediaType)",
+    "item.setOutPoint(seconds, mediaType)",
     "item.getInPoint(mediaType)     - Time",
     "item.getOutPoint(mediaType)    - Time",
     "item.setOverridePixelAspectRatio(num, den)",

package/dist/resources/live-context-resources.js

@@ -486,7 +486,7 @@ export function getLiveContextResources(bridgeOptions) {
         {
             name: "premiere-project-metadata",
             uri: "premiere://project/metadata",
-            description: "Read-only project and active-timeline metadata summary with paths and timestamps withheld.",
+            description: "Read-only path-redacted project and active-timeline summary. Not Premiere project-metadata XML or XMP; use get_metadata parse_fields, manage_metadata_uxp inspect_fields, or inspect_project_panel_metadata_uxp for named clip fields.",
             read: (uri) => projectMetadata(uri, "premiere://project/metadata"),
         },
     ];

package/dist/resources/uxp-js-api-inventory.json

@@ -13,8 +13,8 @@
   },
   "stats": {
     "total": 3406,
-    "mapped": 12,
-    "unmapped": 3394,
+    "mapped": 20,
+    "unmapped": 3386,
     "manifestOnly": 0
   },
   "manifestOnly": [],
@@ -16257,7 +16257,7 @@
     {
       "symbol": "uxp.XMPConst",
       "kind": "class",
-      "coverage": "unmapped"
+      "coverage": "mapped"
     },
     {
       "symbol": "uxp.XMPDateTime",
@@ -16402,12 +16402,12 @@
     {
       "symbol": "uxp.XMPMeta",
       "kind": "class",
-      "coverage": "unmapped"
+      "coverage": "mapped"
     },
     {
       "symbol": "uxp.XMPMeta.[[construct]]",
       "kind": "constructor",
-      "coverage": "unmapped"
+      "coverage": "mapped"
     },
     {
       "symbol": "uxp.XMPMeta.appendArrayItem",
@@ -16497,7 +16497,7 @@
     {
       "symbol": "uxp.XMPMeta.getProperty",
       "kind": "method",
-      "coverage": "unmapped"
+      "coverage": "mapped"
     },
     {
       "symbol": "uxp.XMPMeta.getQualifier",
@@ -16517,7 +16517,7 @@
     {
       "symbol": "uxp.XMPMeta.iterator",
       "kind": "method",
-      "coverage": "unmapped"
+      "coverage": "mapped"
     },
     {
       "symbol": "uxp.XMPMeta.registerNamespace",
@@ -16527,7 +16527,7 @@
     {
       "symbol": "uxp.XMPMeta.serialize",
       "kind": "method",
-      "coverage": "unmapped"
+      "coverage": "mapped"
     },
     {
       "symbol": "uxp.XMPMeta.serializeToArray",
@@ -16547,7 +16547,7 @@
     {
       "symbol": "uxp.XMPMeta.setProperty",
       "kind": "method",
-      "coverage": "unmapped"
+      "coverage": "mapped"
     },
     {
       "symbol": "uxp.XMPMeta.setQualifier",
@@ -17047,7 +17047,7 @@
     {
       "symbol": "uxp.xmp",
       "kind": "variable",
-      "coverage": "unmapped"
+      "coverage": "mapped"
     }
   ]
 }

package/dist/security/capabilities.js

@@ -176,7 +176,9 @@ const ACTION_CAPABILITIES = {
     },
     manage_metadata_uxp: {
         get: ["inspect"],
+        inspect_fields: ["inspect"],
         update: ["edit"],
+        update_field: ["edit"],
     },
     inspect_project_panel_metadata_uxp: {
         panel: ["inspect"],

package/dist/tools/advanced.js

@@ -77,14 +77,26 @@ export function getAdvancedTools(bridgeOptions) {
           var ti;
           for (ti = 0; ti < vN; ti++) {
             if (result.trackType === "video" && ti === result.trackIndex) continue;
-            var slv = false;
-            try { slv = !!qeTrackFor("video", ti).isSyncLocked(); } catch (e1) {}
+            var slv = null;
+            try {
+              var qv = qeTrackFor("video", ti);
+              if (qv && typeof qv.isSyncLocked === "function") slv = !!qv.isSyncLocked();
+            } catch (e1) { slv = null; }
+            if (slv === null) {
+              return __error("Ripple delete refused; nothing was changed. Could not read isSyncLocked() on video track " + ti + ". Pass scope 'own_track' to shift only the clip's track (this will desync other tracks).");
+            }
             if (slv) addPart("video", ti, false);
           }
           for (ti = 0; ti < aN; ti++) {
             if (result.trackType === "audio" && ti === result.trackIndex) continue;
-            var sla = false;
-            try { sla = !!qeTrackFor("audio", ti).isSyncLocked(); } catch (e2) {}
+            var sla = null;
+            try {
+              var qa = qeTrackFor("audio", ti);
+              if (qa && typeof qa.isSyncLocked === "function") sla = !!qa.isSyncLocked();
+            } catch (e2) { sla = null; }
+            if (sla === null) {
+              return __error("Ripple delete refused; nothing was changed. Could not read isSyncLocked() on audio track " + ti + ". Pass scope 'own_track' to shift only the clip's track (this will desync other tracks).");
+            }
             if (sla) addPart("audio", ti, false);
           }
           `
@@ -92,11 +104,23 @@ export function getAdvancedTools(bridgeOptions) {
 
           // A locked participating track cannot be edited; shifting the others
           // without it would silently desync, so refuse rather than half-ripple.
+          // Unreadable lock state is the same risk as an unread sync lock.
           var lockedList = [];
           var pi;
           for (pi = 0; pi < parts.length; pi++) {
-            var lk = false;
-            try { lk = !!qeTrackFor(parts[pi].type, parts[pi].index).isLocked(); } catch (e3) {}
+            var lk = null;
+            try {
+              if (typeof parts[pi].domTrack.isLocked === "function") lk = !!parts[pi].domTrack.isLocked();
+            } catch (eDomLock) { lk = null; }
+            if (lk === null) {
+              try {
+                var ql = qeTrackFor(parts[pi].type, parts[pi].index);
+                if (ql && typeof ql.isLocked === "function") lk = !!ql.isLocked();
+              } catch (e3) { lk = null; }
+            }
+            if (lk === null) {
+              return __error("Ripple delete refused; nothing was changed. Could not read isLocked() on " + parts[pi].type + " track " + parts[pi].index + ". Unlock them or use scope 'own_track' (which will desync other tracks).");
+            }
             if (lk) lockedList.push(parts[pi].type + " track " + parts[pi].index);
           }
           if (lockedList.length) {

package/dist/tools/metadata.d.ts

@@ -9,6 +9,14 @@ export declare function getMetadataTools(bridgeOptions: BridgeOptions): {
                     type: string;
                     description: string;
                 };
+                parse_fields: {
+                    type: string;
+                    description: string;
+                };
+                include_sensitive: {
+                    type: string;
+                    description: string;
+                };
                 include_project_metadata: {
                     type: string;
                     description: string;
@@ -22,6 +30,8 @@ export declare function getMetadataTools(bridgeOptions: BridgeOptions): {
         };
         handler: (args: {
             item_id: string;
+            parse_fields?: boolean;
+            include_sensitive?: boolean;
             include_project_metadata?: boolean;
             include_xmp_metadata?: boolean;
         }) => Promise<import("../bridge/file-bridge.js").CommandResult>;
@@ -43,6 +53,19 @@ export declare function getMetadataTools(bridgeOptions: BridgeOptions): {
                     type: string;
                     description: string;
                 };
+                packet: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                field_namespace: {
+                    type: string;
+                    description: string;
+                };
+                expected_value: {
+                    type: string;
+                    description: string;
+                };
                 metadata_xml: {
                     type: string;
                     description: string;
@@ -62,6 +85,9 @@ export declare function getMetadataTools(bridgeOptions: BridgeOptions): {
             item_id: string;
             field_name?: string;
             value?: string;
+            packet?: string;
+            field_namespace?: string;
+            expected_value?: string;
             metadata_xml?: string;
             updated_fields?: string[];
         }) => Promise<import("../bridge/file-bridge.js").CommandResult>;