@synthetic-ai/premiere-mcp 2.1.0 → 2.3.0-dev.0

package/dist/tools/keyframes.js

@@ -19,43 +19,43 @@ export function getKeyframeTools(bridgeOptions) {
                 required: ["node_id", "effect_name"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var result = __findClip("${escapeForExtendScript(args.node_id)}");
-          if (!result) return __error("Clip not found");
-          
-          var clip = result.clip;
-          var effectName = "${escapeForExtendScript(args.effect_name)}";
-          var comp = null;
-          
-          for (var i = 0; i < clip.components.numItems; i++) {
-            if (clip.components[i].displayName === effectName || clip.components[i].matchName === effectName) {
-              comp = clip.components[i];
-              break;
-            }
-          }
-          
-          if (!comp) return __error("Effect not found: " + effectName);
-          
-          var props = [];
-          for (var p = 0; p < comp.properties.numItems; p++) {
-            var prop = comp.properties[p];
-            var info = {
-              index: p,
-              displayName: prop.displayName,
-              isTimeVarying: false,
-              keyframesSupported: false
-            };
-            try { info.isTimeVarying = prop.isTimeVarying(); } catch(e) {}
-            try { info.keyframesSupported = prop.areKeyframesSupported(); } catch(e) {}
-            try { info.value = prop.getValue(0, 0); } catch(e) {}
-            props.push(info);
-          }
-          
-          return __result({
-            effect: comp.displayName,
-            matchName: comp.matchName,
-            properties: props
-          });
+                const script = buildToolScript(`
+          var result = __findClip("${escapeForExtendScript(args.node_id)}");
+          if (!result) return __error("Clip not found");
+          
+          var clip = result.clip;
+          var effectName = "${escapeForExtendScript(args.effect_name)}";
+          var comp = null;
+          
+          for (var i = 0; i < clip.components.numItems; i++) {
+            if (clip.components[i].displayName === effectName || clip.components[i].matchName === effectName) {
+              comp = clip.components[i];
+              break;
+            }
+          }
+          
+          if (!comp) return __error("Effect not found: " + effectName);
+          
+          var props = [];
+          for (var p = 0; p < comp.properties.numItems; p++) {
+            var prop = comp.properties[p];
+            var info = {
+              index: p,
+              displayName: prop.displayName,
+              isTimeVarying: false,
+              keyframesSupported: false
+            };
+            try { info.isTimeVarying = prop.isTimeVarying(); } catch(e) {}
+            try { info.keyframesSupported = prop.areKeyframesSupported(); } catch(e) {}
+            try { info.value = prop.getValue(0, 0); } catch(e) {}
+            props.push(info);
+          }
+          
+          return __result({
+            effect: comp.displayName,
+            matchName: comp.matchName,
+            properties: props
+          });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -85,36 +85,36 @@ export function getKeyframeTools(bridgeOptions) {
                 required: ["node_id", "effect_name", "property_name", "value"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var result = __findClip("${escapeForExtendScript(args.node_id)}");
-          if (!result) return __error("Clip not found");
-          
-          var clip = result.clip;
-          var comp = null;
-          for (var i = 0; i < clip.components.numItems; i++) {
-            if (clip.components[i].displayName === "${escapeForExtendScript(args.effect_name)}" || clip.components[i].matchName === "${escapeForExtendScript(args.effect_name)}") {
-              comp = clip.components[i];
-              break;
-            }
-          }
-          if (!comp) return __error("Effect not found: ${escapeForExtendScript(args.effect_name)}");
-          
-          var prop = null;
-          for (var p = 0; p < comp.properties.numItems; p++) {
-            if (comp.properties[p].displayName === "${escapeForExtendScript(args.property_name)}") {
-              prop = comp.properties[p];
-              break;
-            }
-          }
-          if (!prop) return __error("Property not found: ${escapeForExtendScript(args.property_name)}");
-          
-          prop.setValue(${args.value}, true);
-          return __result({
-            set: true,
-            effect: "${escapeForExtendScript(args.effect_name)}",
-            property: "${escapeForExtendScript(args.property_name)}",
-            value: ${args.value}
-          });
+                const script = buildToolScript(`
+          var result = __findClip("${escapeForExtendScript(args.node_id)}");
+          if (!result) return __error("Clip not found");
+          
+          var clip = result.clip;
+          var comp = null;
+          for (var i = 0; i < clip.components.numItems; i++) {
+            if (clip.components[i].displayName === "${escapeForExtendScript(args.effect_name)}" || clip.components[i].matchName === "${escapeForExtendScript(args.effect_name)}") {
+              comp = clip.components[i];
+              break;
+            }
+          }
+          if (!comp) return __error("Effect not found: ${escapeForExtendScript(args.effect_name)}");
+          
+          var prop = null;
+          for (var p = 0; p < comp.properties.numItems; p++) {
+            if (comp.properties[p].displayName === "${escapeForExtendScript(args.property_name)}") {
+              prop = comp.properties[p];
+              break;
+            }
+          }
+          if (!prop) return __error("Property not found: ${escapeForExtendScript(args.property_name)}");
+          
+          prop.setValue(${args.value}, true);
+          return __result({
+            set: true,
+            effect: "${escapeForExtendScript(args.effect_name)}",
+            property: "${escapeForExtendScript(args.property_name)}",
+            value: ${args.value}
+          });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -140,56 +140,56 @@ export function getKeyframeTools(bridgeOptions) {
                 required: ["node_id", "effect_name", "property_name"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var result = __findClip("${escapeForExtendScript(args.node_id)}");
-          if (!result) return __error("Clip not found");
-          
-          var clip = result.clip;
-          var comp = null;
-          for (var i = 0; i < clip.components.numItems; i++) {
-            if (clip.components[i].displayName === "${escapeForExtendScript(args.effect_name)}" || clip.components[i].matchName === "${escapeForExtendScript(args.effect_name)}") {
-              comp = clip.components[i];
-              break;
-            }
-          }
-          if (!comp) return __error("Effect not found");
-          
-          var prop = null;
-          for (var p = 0; p < comp.properties.numItems; p++) {
-            if (comp.properties[p].displayName === "${escapeForExtendScript(args.property_name)}") {
-              prop = comp.properties[p];
-              break;
-            }
-          }
-          if (!prop) return __error("Property not found");
-          
-          var isTimeVarying = false;
-          try { isTimeVarying = prop.isTimeVarying(); } catch(e) {}
-          
-          if (!isTimeVarying) {
-            return __result({ keyframes: [], isTimeVarying: false, message: "Property has no keyframes" });
-          }
-          
-          var keys = prop.getKeys();
-          var keyframes = [];
-          if (keys) {
-            for (var k = 0; k < keys.length; k++) {
-              var time = keys[k];
-              var val = null;
-              try { val = prop.getValueAtKey(time); } catch(e) {}
-              keyframes.push({
-                time: __ticksToSeconds(time.ticks),
-                value: val
-              });
-            }
-          }
-          
-          return __result({
-            effect: "${escapeForExtendScript(args.effect_name)}",
-            property: "${escapeForExtendScript(args.property_name)}",
-            isTimeVarying: true,
-            keyframes: keyframes
-          });
+                const script = buildToolScript(`
+          var result = __findClip("${escapeForExtendScript(args.node_id)}");
+          if (!result) return __error("Clip not found");
+          
+          var clip = result.clip;
+          var comp = null;
+          for (var i = 0; i < clip.components.numItems; i++) {
+            if (clip.components[i].displayName === "${escapeForExtendScript(args.effect_name)}" || clip.components[i].matchName === "${escapeForExtendScript(args.effect_name)}") {
+              comp = clip.components[i];
+              break;
+            }
+          }
+          if (!comp) return __error("Effect not found");
+          
+          var prop = null;
+          for (var p = 0; p < comp.properties.numItems; p++) {
+            if (comp.properties[p].displayName === "${escapeForExtendScript(args.property_name)}") {
+              prop = comp.properties[p];
+              break;
+            }
+          }
+          if (!prop) return __error("Property not found");
+          
+          var isTimeVarying = false;
+          try { isTimeVarying = prop.isTimeVarying(); } catch(e) {}
+          
+          if (!isTimeVarying) {
+            return __result({ keyframes: [], isTimeVarying: false, message: "Property has no keyframes" });
+          }
+          
+          var keys = prop.getKeys();
+          var keyframes = [];
+          if (keys) {
+            for (var k = 0; k < keys.length; k++) {
+              var time = keys[k];
+              var val = null;
+              try { val = prop.getValueAtKey(time); } catch(e) {}
+              keyframes.push({
+                time: __ticksToSeconds(time.ticks),
+                value: val
+              });
+            }
+          }
+          
+          return __result({
+            effect: "${escapeForExtendScript(args.effect_name)}",
+            property: "${escapeForExtendScript(args.property_name)}",
+            isTimeVarying: true,
+            keyframes: keyframes
+          });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -223,48 +223,48 @@ export function getKeyframeTools(bridgeOptions) {
                 required: ["node_id", "effect_name", "property_name", "time_seconds", "value"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var result = __findClip("${escapeForExtendScript(args.node_id)}");
-          if (!result) return __error("Clip not found");
-          
-          var clip = result.clip;
-          var comp = null;
-          for (var i = 0; i < clip.components.numItems; i++) {
-            if (clip.components[i].displayName === "${escapeForExtendScript(args.effect_name)}" || clip.components[i].matchName === "${escapeForExtendScript(args.effect_name)}") {
-              comp = clip.components[i];
-              break;
-            }
-          }
-          if (!comp) return __error("Effect not found");
-          
-          var prop = null;
-          for (var p = 0; p < comp.properties.numItems; p++) {
-            if (comp.properties[p].displayName === "${escapeForExtendScript(args.property_name)}") {
-              prop = comp.properties[p];
-              break;
-            }
-          }
-          if (!prop) return __error("Property not found");
-          
-          // Enable keyframes if not already
-          try {
-            if (!prop.isTimeVarying()) {
-              prop.setTimeVarying(true);
-            }
-          } catch(e) {}
-          
-          var time = new Time();
-          time.ticks = __secondsToTicks(${args.time_seconds}).toString();
-          prop.addKey(time);
-          prop.setValueAtKey(time, ${args.value}, true);
-          
-          return __result({
-            added: true,
-            effect: "${escapeForExtendScript(args.effect_name)}",
-            property: "${escapeForExtendScript(args.property_name)}",
-            time: ${args.time_seconds},
-            value: ${args.value}
-          });
+                const script = buildToolScript(`
+          var result = __findClip("${escapeForExtendScript(args.node_id)}");
+          if (!result) return __error("Clip not found");
+          
+          var clip = result.clip;
+          var comp = null;
+          for (var i = 0; i < clip.components.numItems; i++) {
+            if (clip.components[i].displayName === "${escapeForExtendScript(args.effect_name)}" || clip.components[i].matchName === "${escapeForExtendScript(args.effect_name)}") {
+              comp = clip.components[i];
+              break;
+            }
+          }
+          if (!comp) return __error("Effect not found");
+          
+          var prop = null;
+          for (var p = 0; p < comp.properties.numItems; p++) {
+            if (comp.properties[p].displayName === "${escapeForExtendScript(args.property_name)}") {
+              prop = comp.properties[p];
+              break;
+            }
+          }
+          if (!prop) return __error("Property not found");
+          
+          // Enable keyframes if not already
+          try {
+            if (!prop.isTimeVarying()) {
+              prop.setTimeVarying(true);
+            }
+          } catch(e) {}
+          
+          var time = new Time();
+          time.ticks = __secondsToTicks(${args.time_seconds}).toString();
+          prop.addKey(time);
+          prop.setValueAtKey(time, ${args.value}, true);
+          
+          return __result({
+            added: true,
+            effect: "${escapeForExtendScript(args.effect_name)}",
+            property: "${escapeForExtendScript(args.property_name)}",
+            time: ${args.time_seconds},
+            value: ${args.value}
+          });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -294,39 +294,39 @@ export function getKeyframeTools(bridgeOptions) {
                 required: ["node_id", "effect_name", "property_name", "time_seconds"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var result = __findClip("${escapeForExtendScript(args.node_id)}");
-          if (!result) return __error("Clip not found");
-          
-          var clip = result.clip;
-          var comp = null;
-          for (var i = 0; i < clip.components.numItems; i++) {
-            if (clip.components[i].displayName === "${escapeForExtendScript(args.effect_name)}" || clip.components[i].matchName === "${escapeForExtendScript(args.effect_name)}") {
-              comp = clip.components[i];
-              break;
-            }
-          }
-          if (!comp) return __error("Effect not found");
-          
-          var prop = null;
-          for (var p = 0; p < comp.properties.numItems; p++) {
-            if (comp.properties[p].displayName === "${escapeForExtendScript(args.property_name)}") {
-              prop = comp.properties[p];
-              break;
-            }
-          }
-          if (!prop) return __error("Property not found");
-          
-          var time = new Time();
-          time.ticks = __secondsToTicks(${args.time_seconds}).toString();
-          prop.removeKey(time);
-          
-          return __result({
-            removed: true,
-            effect: "${escapeForExtendScript(args.effect_name)}",
-            property: "${escapeForExtendScript(args.property_name)}",
-            time: ${args.time_seconds}
-          });
+                const script = buildToolScript(`
+          var result = __findClip("${escapeForExtendScript(args.node_id)}");
+          if (!result) return __error("Clip not found");
+          
+          var clip = result.clip;
+          var comp = null;
+          for (var i = 0; i < clip.components.numItems; i++) {
+            if (clip.components[i].displayName === "${escapeForExtendScript(args.effect_name)}" || clip.components[i].matchName === "${escapeForExtendScript(args.effect_name)}") {
+              comp = clip.components[i];
+              break;
+            }
+          }
+          if (!comp) return __error("Effect not found");
+          
+          var prop = null;
+          for (var p = 0; p < comp.properties.numItems; p++) {
+            if (comp.properties[p].displayName === "${escapeForExtendScript(args.property_name)}") {
+              prop = comp.properties[p];
+              break;
+            }
+          }
+          if (!prop) return __error("Property not found");
+          
+          var time = new Time();
+          time.ticks = __secondsToTicks(${args.time_seconds}).toString();
+          prop.removeKey(time);
+          
+          return __result({
+            removed: true,
+            effect: "${escapeForExtendScript(args.effect_name)}",
+            property: "${escapeForExtendScript(args.property_name)}",
+            time: ${args.time_seconds}
+          });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -360,49 +360,49 @@ export function getKeyframeTools(bridgeOptions) {
                 required: ["node_id", "effect_name", "property_name", "start_seconds", "end_seconds"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var result = __findClip("${escapeForExtendScript(args.node_id)}");
-          if (!result) return __error("Clip not found");
-          
-          var clip = result.clip;
-          var comp = null;
-          for (var i = 0; i < clip.components.numItems; i++) {
-            if (clip.components[i].displayName === "${escapeForExtendScript(args.effect_name)}" || clip.components[i].matchName === "${escapeForExtendScript(args.effect_name)}") {
-              comp = clip.components[i];
-              break;
-            }
-          }
-          if (!comp) return __error("Effect not found");
-          
-          var prop = null;
-          for (var p = 0; p < comp.properties.numItems; p++) {
-            if (comp.properties[p].displayName === "${escapeForExtendScript(args.property_name)}") {
-              prop = comp.properties[p];
-              break;
-            }
-          }
-          if (!prop) return __error("Property not found");
-          
-          var keys = prop.getKeys();
-          var startTicks = parseFloat(__secondsToTicks(${args.start_seconds}));
-          var endTicks = parseFloat(__secondsToTicks(${args.end_seconds}));
-          var removed = 0;
-          if (keys) {
-            for (var k = keys.length - 1; k >= 0; k--) {
-              var kt = parseFloat(keys[k].ticks);
-              if (kt >= startTicks && kt <= endTicks) {
-                prop.removeKey(keys[k]);
-                removed++;
-              }
-            }
-          }
-
-          return __result({
-            removed: removed,
-            effect: "${escapeForExtendScript(args.effect_name)}",
-            property: "${escapeForExtendScript(args.property_name)}",
-            range: { start: ${args.start_seconds}, end: ${args.end_seconds} }
-          });
+                const script = buildToolScript(`
+          var result = __findClip("${escapeForExtendScript(args.node_id)}");
+          if (!result) return __error("Clip not found");
+          
+          var clip = result.clip;
+          var comp = null;
+          for (var i = 0; i < clip.components.numItems; i++) {
+            if (clip.components[i].displayName === "${escapeForExtendScript(args.effect_name)}" || clip.components[i].matchName === "${escapeForExtendScript(args.effect_name)}") {
+              comp = clip.components[i];
+              break;
+            }
+          }
+          if (!comp) return __error("Effect not found");
+          
+          var prop = null;
+          for (var p = 0; p < comp.properties.numItems; p++) {
+            if (comp.properties[p].displayName === "${escapeForExtendScript(args.property_name)}") {
+              prop = comp.properties[p];
+              break;
+            }
+          }
+          if (!prop) return __error("Property not found");
+          
+          var keys = prop.getKeys();
+          var startTicks = parseFloat(__secondsToTicks(${args.start_seconds}));
+          var endTicks = parseFloat(__secondsToTicks(${args.end_seconds}));
+          var removed = 0;
+          if (keys) {
+            for (var k = keys.length - 1; k >= 0; k--) {
+              var kt = parseFloat(keys[k].ticks);
+              if (kt >= startTicks && kt <= endTicks) {
+                prop.removeKey(keys[k]);
+                removed++;
+              }
+            }
+          }
+
+          return __result({
+            removed: removed,
+            effect: "${escapeForExtendScript(args.effect_name)}",
+            property: "${escapeForExtendScript(args.property_name)}",
+            range: { start: ${args.start_seconds}, end: ${args.end_seconds} }
+          });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -439,38 +439,38 @@ export function getKeyframeTools(bridgeOptions) {
             handler: async (args) => {
                 const interpMap = { linear: 0, hold: 4, bezier: 5 };
                 const interpType = interpMap[args.interpolation] ?? 0;
-                const script = buildToolScript(`
-          var result = __findClip("${escapeForExtendScript(args.node_id)}");
-          if (!result) return __error("Clip not found");
-          
-          var clip = result.clip;
-          var comp = null;
-          for (var i = 0; i < clip.components.numItems; i++) {
-            if (clip.components[i].displayName === "${escapeForExtendScript(args.effect_name)}" || clip.components[i].matchName === "${escapeForExtendScript(args.effect_name)}") {
-              comp = clip.components[i];
-              break;
-            }
-          }
-          if (!comp) return __error("Effect not found");
-          
-          var prop = null;
-          for (var p = 0; p < comp.properties.numItems; p++) {
-            if (comp.properties[p].displayName === "${escapeForExtendScript(args.property_name)}") {
-              prop = comp.properties[p];
-              break;
-            }
-          }
-          if (!prop) return __error("Property not found");
-          
-          var time = new Time();
-          time.ticks = __secondsToTicks(${args.time_seconds}).toString();
-          prop.setInterpolationTypeAtKey(time, ${interpType}, true);
-          
-          return __result({
-            set: true,
-            interpolation: "${args.interpolation}",
-            time: ${args.time_seconds}
-          });
+                const script = buildToolScript(`
+          var result = __findClip("${escapeForExtendScript(args.node_id)}");
+          if (!result) return __error("Clip not found");
+          
+          var clip = result.clip;
+          var comp = null;
+          for (var i = 0; i < clip.components.numItems; i++) {
+            if (clip.components[i].displayName === "${escapeForExtendScript(args.effect_name)}" || clip.components[i].matchName === "${escapeForExtendScript(args.effect_name)}") {
+              comp = clip.components[i];
+              break;
+            }
+          }
+          if (!comp) return __error("Effect not found");
+          
+          var prop = null;
+          for (var p = 0; p < comp.properties.numItems; p++) {
+            if (comp.properties[p].displayName === "${escapeForExtendScript(args.property_name)}") {
+              prop = comp.properties[p];
+              break;
+            }
+          }
+          if (!prop) return __error("Property not found");
+          
+          var time = new Time();
+          time.ticks = __secondsToTicks(${args.time_seconds}).toString();
+          prop.setInterpolationTypeAtKey(time, ${interpType}, true);
+          
+          return __result({
+            set: true,
+            interpolation: "${args.interpolation}",
+            time: ${args.time_seconds}
+          });
         `);
                 return sendCommand(script, bridgeOptions);
             },
@@ -500,108 +500,108 @@ export function getKeyframeTools(bridgeOptions) {
                 required: ["node_id", "effect_name", "property_name", "time_seconds"],
             },
             handler: async (args) => {
-                const script = buildToolScript(`
-          var result = __findClip("${escapeForExtendScript(args.node_id)}");
-          if (!result) return __error("Clip not found");
-          
-          var clip = result.clip;
-          var comp = null;
-          for (var i = 0; i < clip.components.numItems; i++) {
-            if (clip.components[i].displayName === "${escapeForExtendScript(args.effect_name)}" || clip.components[i].matchName === "${escapeForExtendScript(args.effect_name)}") {
-              comp = clip.components[i];
-              break;
-            }
-          }
-          if (!comp) return __error("Effect not found");
-          
-          var prop = null;
-          for (var p = 0; p < comp.properties.numItems; p++) {
-            if (comp.properties[p].displayName === "${escapeForExtendScript(args.property_name)}") {
-              prop = comp.properties[p];
-              break;
-            }
-          }
-          if (!prop) return __error("Property not found");
-          
-          var targetTicks = parseFloat(__secondsToTicks(${args.time_seconds}).toString());
-          var value = null;
-          var source = "static";
-
-          var isTimeVarying = false;
-          try { isTimeVarying = prop.isTimeVarying(); } catch(e) { isTimeVarying = false; }
-
-          if (isTimeVarying) {
-            var keys = prop.getKeys();
-            if (keys && keys.length > 0) {
-              // Look for an exact key match by tick value.
-              var exactKey = null;
-              for (var k = 0; k < keys.length; k++) {
-                if (parseFloat(keys[k].ticks) === targetTicks) {
-                  exactKey = keys[k];
-                  break;
-                }
-              }
-              if (exactKey !== null) {
-                value = prop.getValueAtKey(exactKey);
-                source = "exact-key";
-              } else {
-                // Find the bracketing keys (lower = last key before target, upper = first key after target).
-                var lowerKey = null;
-                var upperKey = null;
-                var lowerTicks = 0;
-                var upperTicks = 0;
-                for (var k2 = 0; k2 < keys.length; k2++) {
-                  var kt = parseFloat(keys[k2].ticks);
-                  if (kt <= targetTicks && (lowerKey === null || kt > lowerTicks)) {
-                    lowerKey = keys[k2];
-                    lowerTicks = kt;
-                  }
-                  if (kt >= targetTicks && (upperKey === null || kt < upperTicks)) {
-                    upperKey = keys[k2];
-                    upperTicks = kt;
-                  }
-                }
-                if (lowerKey !== null && upperKey !== null) {
-                  var lowerVal = prop.getValueAtKey(lowerKey);
-                  var upperVal = prop.getValueAtKey(upperKey);
-                  var span = upperTicks - lowerTicks;
-                  var ratio = (span === 0) ? 0 : (targetTicks - lowerTicks) / span;
-                  if (typeof lowerVal === "number" && typeof upperVal === "number") {
-                    value = lowerVal + (upperVal - lowerVal) * ratio;
-                  } else if (lowerVal && upperVal && typeof lowerVal.length === "number" && typeof upperVal.length === "number") {
-                    var arr = [];
-                    for (var d = 0; d < lowerVal.length; d++) {
-                      arr.push(lowerVal[d] + (upperVal[d] - lowerVal[d]) * ratio);
-                    }
-                    value = arr;
-                  } else {
-                    value = lowerVal;
-                  }
-                  source = "interpolated";
-                } else if (lowerKey !== null) {
-                  value = prop.getValueAtKey(lowerKey);
-                  source = "exact-key";
-                } else if (upperKey !== null) {
-                  value = prop.getValueAtKey(upperKey);
-                  source = "exact-key";
-                }
-              }
-            } else {
-              try { value = prop.getValue(); } catch(e) { value = null; }
-              source = "static";
-            }
-          } else {
-            try { value = prop.getValue(); } catch(e) { value = null; }
-            source = "static";
-          }
-
-          return __result({
-            effect: "${escapeForExtendScript(args.effect_name)}",
-            property: "${escapeForExtendScript(args.property_name)}",
-            time: ${args.time_seconds},
-            value: value,
-            source: source
-          });
+                const script = buildToolScript(`
+          var result = __findClip("${escapeForExtendScript(args.node_id)}");
+          if (!result) return __error("Clip not found");
+          
+          var clip = result.clip;
+          var comp = null;
+          for (var i = 0; i < clip.components.numItems; i++) {
+            if (clip.components[i].displayName === "${escapeForExtendScript(args.effect_name)}" || clip.components[i].matchName === "${escapeForExtendScript(args.effect_name)}") {
+              comp = clip.components[i];
+              break;
+            }
+          }
+          if (!comp) return __error("Effect not found");
+          
+          var prop = null;
+          for (var p = 0; p < comp.properties.numItems; p++) {
+            if (comp.properties[p].displayName === "${escapeForExtendScript(args.property_name)}") {
+              prop = comp.properties[p];
+              break;
+            }
+          }
+          if (!prop) return __error("Property not found");
+          
+          var targetTicks = parseFloat(__secondsToTicks(${args.time_seconds}).toString());
+          var value = null;
+          var source = "static";
+
+          var isTimeVarying = false;
+          try { isTimeVarying = prop.isTimeVarying(); } catch(e) { isTimeVarying = false; }
+
+          if (isTimeVarying) {
+            var keys = prop.getKeys();
+            if (keys && keys.length > 0) {
+              // Look for an exact key match by tick value.
+              var exactKey = null;
+              for (var k = 0; k < keys.length; k++) {
+                if (parseFloat(keys[k].ticks) === targetTicks) {
+                  exactKey = keys[k];
+                  break;
+                }
+              }
+              if (exactKey !== null) {
+                value = prop.getValueAtKey(exactKey);
+                source = "exact-key";
+              } else {
+                // Find the bracketing keys (lower = last key before target, upper = first key after target).
+                var lowerKey = null;
+                var upperKey = null;
+                var lowerTicks = 0;
+                var upperTicks = 0;
+                for (var k2 = 0; k2 < keys.length; k2++) {
+                  var kt = parseFloat(keys[k2].ticks);
+                  if (kt <= targetTicks && (lowerKey === null || kt > lowerTicks)) {
+                    lowerKey = keys[k2];
+                    lowerTicks = kt;
+                  }
+                  if (kt >= targetTicks && (upperKey === null || kt < upperTicks)) {
+                    upperKey = keys[k2];
+                    upperTicks = kt;
+                  }
+                }
+                if (lowerKey !== null && upperKey !== null) {
+                  var lowerVal = prop.getValueAtKey(lowerKey);
+                  var upperVal = prop.getValueAtKey(upperKey);
+                  var span = upperTicks - lowerTicks;
+                  var ratio = (span === 0) ? 0 : (targetTicks - lowerTicks) / span;
+                  if (typeof lowerVal === "number" && typeof upperVal === "number") {
+                    value = lowerVal + (upperVal - lowerVal) * ratio;
+                  } else if (lowerVal && upperVal && typeof lowerVal.length === "number" && typeof upperVal.length === "number") {
+                    var arr = [];
+                    for (var d = 0; d < lowerVal.length; d++) {
+                      arr.push(lowerVal[d] + (upperVal[d] - lowerVal[d]) * ratio);
+                    }
+                    value = arr;
+                  } else {
+                    value = lowerVal;
+                  }
+                  source = "interpolated";
+                } else if (lowerKey !== null) {
+                  value = prop.getValueAtKey(lowerKey);
+                  source = "exact-key";
+                } else if (upperKey !== null) {
+                  value = prop.getValueAtKey(upperKey);
+                  source = "exact-key";
+                }
+              }
+            } else {
+              try { value = prop.getValue(); } catch(e) { value = null; }
+              source = "static";
+            }
+          } else {
+            try { value = prop.getValue(); } catch(e) { value = null; }
+            source = "static";
+          }
+
+          return __result({
+            effect: "${escapeForExtendScript(args.effect_name)}",
+            property: "${escapeForExtendScript(args.property_name)}",
+            time: ${args.time_seconds},
+            value: value,
+            source: source
+          });
         `);
                 return sendCommand(script, bridgeOptions);
             },