Skip to content

🎥 Make videos programmatically with React

`@remotion/studio`: Add "Copy context for agents" to multi-sequence context menu

Cursor Agent9036b1242874
diff --git a/packages/studio/src/components/Timeline/TimelineSequence.tsx b/packages/studio/src/components/Timeline/TimelineSequence.tsx
index 3d8620b18c..94cc9b423a 100644
--- a/packages/studio/src/components/Timeline/TimelineSequence.tsx
+++ b/packages/studio/src/components/Timeline/TimelineSequence.tsx
@@ -59,6 +59,7 @@ import {
getSequenceContextMenuItems,
} from './get-sequence-context-menu-items';
import {getSequenceSplitMenuItem} from './get-sequence-split-menu-item';
+import {getSequencesContextForAgents} from './get-sequences-context-for-agents';
import {
getKeyframeDisplayOffset,
getKeyframePlaybackRate,
@@ -1040,14 +1041,21 @@ const TimelineSequenceInner: React.FC<{
}
if (selectedSequenceNodePathInfos !== null) {
- return getMultiSequenceContextMenuItems({
- deleteDisabled: !previewInteractive,
- duplicateDisabled: !previewInteractive,
- splitDisabled: !previewInteractive,
- onDeleteSelectedSequences,
- onDuplicateSelectedSequences,
- onSplitSelectedSequences,
- });
+ return getSequencesContextForAgents({
+ nodePathInfos: selectedSequenceNodePathInfos,
+ overrideIdsToNodePaths: overrideIdToNodePathMappingsRef.current,
+ sequences,
+ }).then((contextForAgents) =>
+ getMultiSequenceContextMenuItems({
+ contextForAgents,
+ deleteDisabled: !previewInteractive,
+ duplicateDisabled: !previewInteractive,
+ splitDisabled: !previewInteractive,
+ onDeleteSelectedSequences,
+ onDuplicateSelectedSequences,
+ onSplitSelectedSequences,
+ }),
+ );
}
const splitMenuItem = getSequenceSplitMenuItem({
@@ -1137,6 +1145,7 @@ const TimelineSequenceInner: React.FC<{
openInCodingAgent,
openInEditor,
originalLocation,
+ overrideIdToNodePathMappingsRef,
previewInteractive,
previewServerState,
propStatusesForOverride,
@@ -1147,6 +1156,7 @@ const TimelineSequenceInner: React.FC<{
selectedItems.length,
selectedSequenceNodePathInfos,
sequenceFrameOffset,
+ sequences,
setPropStatuses,
setSelectedModal,
validatedLocation?.source,
diff --git a/packages/studio/src/components/Timeline/TimelineSequenceItem.tsx b/packages/studio/src/components/Timeline/TimelineSequenceItem.tsx
index e667eea0bc..fff17601c2 100644
--- a/packages/studio/src/components/Timeline/TimelineSequenceItem.tsx
+++ b/packages/studio/src/components/Timeline/TimelineSequenceItem.tsx
@@ -81,6 +81,7 @@ import {
getSequenceContextMenuItems,
} from './get-sequence-context-menu-items';
import {getSequenceSplitMenuItem} from './get-sequence-split-menu-item';
+import {getSequencesContextForAgents} from './get-sequences-context-for-agents';
import {getCurrentFrame} from './imperative-state';
import {saveSequenceProps} from './save-sequence-prop';
import {splitSelectedTimelineItems} from './split-selected-timeline-item';
@@ -1245,14 +1246,21 @@ const TimelineSequenceItemInner: React.FC<{
}
if (selectedSequenceNodePathInfos !== null) {
- return getMultiSequenceContextMenuItems({
- deleteDisabled: !previewInteractive,
- duplicateDisabled: !previewInteractive,
- splitDisabled: !previewInteractive,
- onDeleteSelectedSequences,
- onDuplicateSelectedSequences,
- onSplitSelectedSequences,
- });
+ return getSequencesContextForAgents({
+ nodePathInfos: selectedSequenceNodePathInfos,
+ overrideIdsToNodePaths: overrideIdToNodePathMappingsRef.current,
+ sequences: sequencesRef.current,
+ }).then((contextForAgents) =>
+ getMultiSequenceContextMenuItems({
+ contextForAgents,
+ deleteDisabled: !previewInteractive,
+ duplicateDisabled: !previewInteractive,
+ splitDisabled: !previewInteractive,
+ onDeleteSelectedSequences,
+ onDuplicateSelectedSequences,
+ onSplitSelectedSequences,
+ }),
+ );
}
const splitMenuItem = getSequenceSplitMenuItem({
@@ -1422,6 +1430,7 @@ const TimelineSequenceItemInner: React.FC<{
openInCodingAgent,
openInEditor,
originalLocation,
+ overrideIdToNodePathMappingsRef,
previewInteractive,
previewServerState,
propStatusesForOverride,
@@ -1432,6 +1441,7 @@ const TimelineSequenceItemInner: React.FC<{
selectedSequenceNodePathInfos,
sequence,
sequenceFrameOffset,
+ sequencesRef,
setSelectedModal,
setPropStatuses,
validatedLocation?.source,
diff --git a/packages/studio/src/components/Timeline/get-sequence-context-menu-items.ts b/packages/studio/src/components/Timeline/get-sequence-context-menu-items.ts
index 003ec62669..c3229e8f03 100644
--- a/packages/studio/src/components/Timeline/get-sequence-context-menu-items.ts
+++ b/packages/studio/src/components/Timeline/get-sequence-context-menu-items.ts
@@ -120,6 +120,7 @@ const copyImageToClipboard = async (element: Element): Promise<void> => {
};
export const getMultiSequenceContextMenuItems = ({
+ contextForAgents,
deleteDisabled,
duplicateDisabled,
splitDisabled,
@@ -127,6 +128,7 @@ export const getMultiSequenceContextMenuItems = ({
onDuplicateSelectedSequences,
onSplitSelectedSequences,
}: {
+ readonly contextForAgents: string | null;
readonly deleteDisabled: boolean;
readonly duplicateDisabled: boolean;
readonly splitDisabled: boolean;
@@ -135,6 +137,11 @@ export const getMultiSequenceContextMenuItems = ({
readonly onSplitSelectedSequences: () => void;
}): ComboboxValue[] => {
return [
+ getCopyContextForAgentsMenuItem({contextForAgents}),
+ {
+ type: 'divider',
+ id: 'copy-context-for-agents-divider',
+ },
{
type: 'item',
id: 'duplicate-selected-sequences',
diff --git a/packages/studio/src/components/Timeline/get-sequences-context-for-agents.ts b/packages/studio/src/components/Timeline/get-sequences-context-for-agents.ts
new file mode 100644
index 0000000000..265c437946
--- /dev/null
+++ b/packages/studio/src/components/Timeline/get-sequences-context-for-agents.ts
@@ -0,0 +1,48 @@
+import type {OverrideIdToNodePaths, TSequence} from 'remotion';
+import {NoReactInternals} from 'remotion/no-react';
+import {formatContextForAgents} from '../../helpers/format-file-location';
+import type {SequenceNodePathInfo} from '../../helpers/get-timeline-sequence-sort-key';
+import {findTrackForNodePathInfo} from './find-track-for-node-path-info';
+import {getOriginalLocationFromStack} from './TimelineStack/get-stack';
+
+export const getSequencesContextForAgents = async ({
+ nodePathInfos,
+ overrideIdsToNodePaths,
+ sequences,
+}: {
+ readonly nodePathInfos: readonly SequenceNodePathInfo[];
+ readonly overrideIdsToNodePaths: OverrideIdToNodePaths;
+ readonly sequences: TSequence[];
+}): Promise<string | null> => {
+ const contexts = await Promise.all(
+ nodePathInfos.map(async (nodePathInfo) => {
+ const track = findTrackForNodePathInfo({
+ sequences,
+ overrideIdsToNodePaths,
+ nodePathInfo,
+ });
+ const stack = track?.sequence.getStack() ?? null;
+ if (!track || !stack) {
+ return null;
+ }
+
+ const location = await getOriginalLocationFromStack(
+ stack,
+ 'sequence',
+ ).catch(() => null);
+
+ return formatContextForAgents({
+ location,
+ name:
+ track.sequence.displayName ||
+ track.sequence.controls?.componentName ||
+ null,
+ root: window.remotion_cwd,
+ });
+ }),
+ );
+ // Programmatically duplicated sequences share the same source location.
+ const uniqueContexts = [...new Set(contexts.filter(NoReactInternals.truthy))];
+
+ return uniqueContexts.length === 0 ? null : uniqueContexts.join('\n');
+};