@remotion/studio-server 4.0.505 → 4.0.506

package/dist/helpers/coding-agent-registry.d.ts

@@ -0,0 +1,14 @@
+import type { DefaultCodingAgent } from '@remotion/renderer';
+export type InstalledCodingAgent = {
+    id: DefaultCodingAgent;
+    name: string;
+    applicationPath: string;
+};
+export type CodingAgentDiscoveryContext = {
+    platform: NodeJS.Platform;
+    homeDirectory: string;
+    pathExists: (filePath: string) => boolean;
+    findMacApplications: (bundleIdentifier: string) => Promise<readonly string[]>;
+};
+export declare const discoverAvailableCodingAgents: (context: CodingAgentDiscoveryContext) => Promise<readonly InstalledCodingAgent[]>;
+export declare const getAvailableCodingAgents: () => Promise<readonly InstalledCodingAgent[]>;

package/dist/helpers/coding-agent-registry.js

@@ -0,0 +1,90 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAvailableCodingAgents = exports.discoverAvailableCodingAgents = void 0;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = __importDefault(require("node:path"));
+const node_util_1 = require("node:util");
+const renderer_1 = require("@remotion/renderer");
+const execFilePromise = (0, node_util_1.promisify)(node_child_process_1.execFile);
+const codingAgentDefinitions = {
+    codex: {
+        name: 'Codex',
+        bundleIdentifiers: ['com.openai.codex'],
+        applicationNames: ['ChatGPT.app'],
+    },
+    cursor: {
+        name: 'Cursor',
+        bundleIdentifiers: ['com.todesktop.230313mzl4w4u92'],
+        applicationNames: ['Cursor.app'],
+    },
+    'github-copilot': {
+        name: 'GitHub Copilot',
+        bundleIdentifiers: ['com.github.githubapp'],
+        applicationNames: ['GitHub Copilot.app'],
+    },
+    'claude-code': {
+        name: 'Claude Code',
+        bundleIdentifiers: ['com.anthropic.claudefordesktop'],
+        applicationNames: ['Claude.app'],
+    },
+};
+const findMacApplications = async (bundleIdentifier) => {
+    try {
+        const { stdout } = await execFilePromise('mdfind', [
+            `kMDItemCFBundleIdentifier == '${bundleIdentifier}'`,
+        ]);
+        return stdout
+            .split('\n')
+            .map((line) => line.trim())
+            .filter(Boolean);
+    }
+    catch (_a) {
+        return [];
+    }
+};
+const defaultDiscoveryContext = {
+    platform: process.platform,
+    homeDirectory: (0, node_os_1.homedir)(),
+    pathExists: node_fs_1.existsSync,
+    findMacApplications,
+};
+const discoverAvailableCodingAgents = async (context) => {
+    if (context.platform !== 'darwin') {
+        return [];
+    }
+    const installedCodingAgents = [];
+    for (const id of renderer_1.defaultCodingAgentIds) {
+        const definition = codingAgentDefinitions[id];
+        const discoveredApplications = (await Promise.all(definition.bundleIdentifiers.map((bundleIdentifier) => context.findMacApplications(bundleIdentifier)))).flat();
+        const knownApplications = definition.applicationNames.flatMap((name) => [
+            node_path_1.default.posix.join('/Applications', name),
+            node_path_1.default.posix.join(context.homeDirectory, 'Applications', name),
+        ]);
+        for (const applicationPath of new Set([
+            ...discoveredApplications,
+            ...knownApplications,
+        ])) {
+            if (context.pathExists(applicationPath)) {
+                installedCodingAgents.push({
+                    applicationPath,
+                    id,
+                    name: definition.name,
+                });
+                break;
+            }
+        }
+    }
+    return installedCodingAgents;
+};
+exports.discoverAvailableCodingAgents = discoverAvailableCodingAgents;
+let availableCodingAgents = null;
+const getAvailableCodingAgents = () => {
+    availableCodingAgents !== null && availableCodingAgents !== void 0 ? availableCodingAgents : (availableCodingAgents = (0, exports.discoverAvailableCodingAgents)(defaultDiscoveryContext));
+    return availableCodingAgents;
+};
+exports.getAvailableCodingAgents = getAvailableCodingAgents;

package/dist/index.d.ts

@@ -7,7 +7,7 @@ export type { RemotionSkillsScope, RemotionSkillsStatus, } from './detect-outdat
 export type { RemotionSkillName } from './remotion-skill-names';
 export { detectOutdatedRemotionSkills, parseRemotionSkillVersion, remotionSkillNames, };
 export declare const StudioServerInternals: {
-    startStudio: ({ browserArgs, browserFlag, shouldOpenBrowser, fullEntryPath, logLevel, getCurrentInputProps, getEnvVariables, desiredPort, remotionRoot, relativePublicDir, bundlerOverride, rspackOverride, webpackOverride, poll, getRenderDefaults, getRenderQueue, getNumberOfAudioTags, queueMethods, previewEntry, gitSource, binariesDirectory, forceIPv4, getAudioLatencyHint, getPreviewSampleRate, enableCrossSiteIsolation, forceNew, rspack, getStudioRuntimeConfig, getDefaultEditor, configFile, }: {
+    startStudio: ({ browserArgs, browserFlag, shouldOpenBrowser, fullEntryPath, logLevel, getCurrentInputProps, getEnvVariables, desiredPort, remotionRoot, relativePublicDir, bundlerOverride, rspackOverride, webpackOverride, poll, getRenderDefaults, getRenderQueue, getNumberOfAudioTags, queueMethods, previewEntry, gitSource, binariesDirectory, forceIPv4, getAudioLatencyHint, getPreviewSampleRate, enableCrossSiteIsolation, forceNew, rspack, getStudioRuntimeConfig, getDefaultCodingAgent, getDefaultEditor, configFile, }: {
         browserArgs: string;
         browserFlag: string;
         logLevel: "error" | "info" | "trace" | "verbose" | "warn";
@@ -36,6 +36,7 @@ export declare const StudioServerInternals: {
         forceNew: boolean;
         rspack: boolean;
         getStudioRuntimeConfig: () => import("@remotion/studio-shared").StudioRuntimeConfig;
+        getDefaultCodingAgent: () => "claude-code" | "codex" | "cursor" | "github-copilot" | null;
         getDefaultEditor: () => import("@remotion/renderer").DefaultEditor | null;
         configFile: string | null;
     }) => Promise<import("./start-studio").StartStudioResult>;
@@ -135,5 +136,9 @@ export declare const StudioServerInternals: {
         global: import("./detect-outdated-remotion-skills").RemotionSkillsStatus;
     };
     parseRemotionSkillVersion: (contents: string) => string | null;
-    remotionSkillNames: readonly ["remotion-best-practices", "remotion-captions", "remotion-create", "remotion-docs", "remotion-interactivity", "remotion-maps", "remotion-markup", "remotion-multimedia", "remotion-render", "remotion-saas", "remotion-upgrade"];
+    remotionSkillNames: readonly ["remotion-best-practices", "remotion-captions", "remotion-create", "remotion-docs", "remotion-interactivity", "remotion-maps", "remotion-markup", "remotion-multimedia", "remotion-render", "remotion-saas", "remotion-studio", "remotion-upgrade"];
+    getEditorName: ({ getDefaultEditor, logLevel, }: {
+        getDefaultEditor: () => import("@remotion/renderer").DefaultEditor | null;
+        logLevel: "error" | "info" | "trace" | "verbose" | "warn";
+    }) => Promise<string | null>;
 };

package/dist/index.js

@@ -20,6 +20,7 @@ const package_manager_spawn_options_1 = require("./helpers/package-manager-spawn
 const max_timeline_tracks_1 = require("./max-timeline-tracks");
 const get_package_manager_1 = require("./preview-server/get-package-manager");
 const live_events_1 = require("./preview-server/live-events");
+const open_in_editor_1 = require("./preview-server/routes/open-in-editor");
 const update_available_1 = require("./preview-server/update-available");
 const remotion_skill_names_1 = require("./remotion-skill-names");
 Object.defineProperty(exports, "remotionSkillNames", { enumerable: true, get: function () { return remotion_skill_names_1.remotionSkillNames; } });
@@ -54,4 +55,5 @@ exports.StudioServerInternals = {
     detectOutdatedRemotionSkills: detect_outdated_remotion_skills_1.detectOutdatedRemotionSkills,
     parseRemotionSkillVersion: detect_outdated_remotion_skills_1.parseRemotionSkillVersion,
     remotionSkillNames: remotion_skill_names_1.remotionSkillNames,
+    getEditorName: open_in_editor_1.getEditorName,
 };

package/dist/preview-server/api-routes.js

@@ -12,6 +12,7 @@ const batch_update_keyframe_settings_1 = require("./routes/batch-update-keyframe
 const cancel_render_1 = require("./routes/cancel-render");
 const composition_component_info_1 = require("./routes/composition-component-info");
 const convert_figma_clipboard_to_svg_1 = require("./routes/convert-figma-clipboard-to-svg");
+const default_coding_agent_1 = require("./routes/default-coding-agent");
 const default_editor_1 = require("./routes/default-editor");
 const delete_effect_1 = require("./routes/delete-effect");
 const delete_jsx_node_1 = require("./routes/delete-jsx-node");
@@ -102,6 +103,8 @@ exports.allApiRoutes = {
     '/api/rename-static-file': rename_static_file_1.renameStaticFileHandler,
     '/api/restart-studio': restart_studio_1.handleRestartStudio,
     '/api/update-public-license': update_public_license_1.updatePublicLicenseHandler,
+    '/api/default-coding-agent-info': default_coding_agent_1.getDefaultCodingAgentInfoHandler,
+    '/api/update-default-coding-agent': default_coding_agent_1.updateDefaultCodingAgentHandler,
     '/api/default-editor-info': default_editor_1.getDefaultEditorInfoHandler,
     '/api/update-default-editor': default_editor_1.updateDefaultEditorHandler,
     '/api/install-package': install_dependency_1.handleInstallPackage,

package/dist/preview-server/api-types.d.ts

@@ -1,5 +1,5 @@
 import type { IncomingMessage, ServerResponse } from 'node:http';
-import type { DefaultEditor, LogLevel } from '@remotion/renderer';
+import type { DefaultCodingAgent, DefaultEditor, LogLevel } from '@remotion/renderer';
 import type { RenderJobWithCleanup } from '@remotion/studio-shared';
 export type QueueMethods = {
     removeJob: (jobId: string) => void;
@@ -22,5 +22,6 @@ export type ApiHandler<ReqData, ResData> = (params: {
     publicDir: string;
     binariesDirectory: string | null;
     configFile: string | null;
+    getDefaultCodingAgent: () => DefaultCodingAgent | null;
     getDefaultEditor: () => DefaultEditor | null;
 }) => Promise<ResData>;

package/dist/preview-server/handler.d.ts

@@ -1,7 +1,7 @@
 import type { IncomingMessage, ServerResponse } from 'node:http';
 import type { DefaultEditor } from '@remotion/renderer';
 import type { ApiHandler, QueueMethods } from './api-types';
-export declare const handleRequest: <Req, Res>({ remotionRoot, request, response, entryPoint, handler, logLevel, methods, binariesDirectory, publicDir, configFile, getDefaultEditor, }: {
+export declare const handleRequest: <Req, Res>({ remotionRoot, request, response, entryPoint, handler, logLevel, methods, binariesDirectory, publicDir, configFile, getDefaultCodingAgent, getDefaultEditor, }: {
     remotionRoot: string;
     publicDir: string;
     request: IncomingMessage;
@@ -9,6 +9,7 @@ export declare const handleRequest: <Req, Res>({ remotionRoot, request, response
     entryPoint: string;
     binariesDirectory: string | null;
     configFile: string | null;
+    getDefaultCodingAgent: () => "claude-code" | "codex" | "cursor" | "github-copilot" | null;
     getDefaultEditor: () => DefaultEditor | null;
     handler: ApiHandler<Req, Res>;
     logLevel: "error" | "info" | "trace" | "verbose" | "warn";

package/dist/preview-server/handler.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleRequest = void 0;
 const parse_body_1 = require("./parse-body");
 const validate_same_origin_1 = require("./validate-same-origin");
-const handleRequest = async ({ remotionRoot, request, response, entryPoint, handler, logLevel, methods, binariesDirectory, publicDir, configFile, getDefaultEditor, }) => {
+const handleRequest = async ({ remotionRoot, request, response, entryPoint, handler, logLevel, methods, binariesDirectory, publicDir, configFile, getDefaultCodingAgent, getDefaultEditor, }) => {
     if (request.method === 'OPTIONS') {
         response.statusCode = 200;
         response.end();
@@ -25,6 +25,7 @@ const handleRequest = async ({ remotionRoot, request, response, entryPoint, hand
             binariesDirectory,
             publicDir,
             configFile,
+            getDefaultCodingAgent,
             getDefaultEditor,
         });
         response.end(JSON.stringify({

package/dist/preview-server/routes/default-coding-agent.d.ts

@@ -0,0 +1,8 @@
+import type { GetDefaultCodingAgentInfoRequest, GetDefaultCodingAgentInfoResponse, UpdateDefaultCodingAgentRequest, UpdateDefaultCodingAgentResponse } from '@remotion/studio-shared';
+import type { ApiHandler } from '../api-types';
+export declare const updateDefaultCodingAgentInConfig: ({ configContents, defaultCodingAgent, }: {
+    configContents: string;
+    defaultCodingAgent: "claude-code" | "codex" | "cursor" | "github-copilot" | null;
+}) => string;
+export declare const getDefaultCodingAgentInfoHandler: ApiHandler<GetDefaultCodingAgentInfoRequest, GetDefaultCodingAgentInfoResponse>;
+export declare const updateDefaultCodingAgentHandler: ApiHandler<UpdateDefaultCodingAgentRequest, UpdateDefaultCodingAgentResponse>;

package/dist/preview-server/routes/default-coding-agent.js

@@ -0,0 +1,103 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateDefaultCodingAgentHandler = exports.getDefaultCodingAgentInfoHandler = exports.updateDefaultCodingAgentInConfig = void 0;
+const node_fs_1 = require("node:fs");
+const renderer_1 = require("@remotion/renderer");
+const recast = __importStar(require("recast"));
+const parse_ast_1 = require("../../codemods/parse-ast");
+const file_watcher_1 = require("../../file-watcher");
+const coding_agent_registry_1 = require("../../helpers/coding-agent-registry");
+const updateDefaultCodingAgentInConfig = ({ configContents, defaultCodingAgent, }) => {
+    const ast = (0, parse_ast_1.parseAst)(configContents);
+    recast.types.visit(ast.program, {
+        visitExpressionStatement(path) {
+            const { expression } = path.node;
+            if (expression.type === 'CallExpression' &&
+                expression.callee.type === 'MemberExpression' &&
+                !expression.callee.computed &&
+                expression.callee.object.type === 'Identifier' &&
+                expression.callee.object.name === 'Config' &&
+                expression.callee.property.type === 'Identifier' &&
+                expression.callee.property.name === 'setDefaultCodingAgent') {
+                path.prune();
+                return false;
+            }
+            this.traverse(path);
+        },
+    });
+    const configWithoutExistingCalls = recast.print(ast, {
+        lineTerminator: '\n',
+    }).code;
+    if (defaultCodingAgent === null) {
+        return configWithoutExistingCalls;
+    }
+    const separator = configWithoutExistingCalls.endsWith('\n') ? '' : '\n';
+    return `${configWithoutExistingCalls}${separator}Config.setDefaultCodingAgent('${defaultCodingAgent}');\n`;
+};
+exports.updateDefaultCodingAgentInConfig = updateDefaultCodingAgentInConfig;
+const getDefaultCodingAgentInfoHandler = async ({ getDefaultCodingAgent }) => {
+    const installedCodingAgents = await (0, coding_agent_registry_1.getAvailableCodingAgents)();
+    return {
+        defaultCodingAgent: getDefaultCodingAgent(),
+        installedCodingAgents: installedCodingAgents.map(({ id, name }) => ({
+            id,
+            name,
+        })),
+    };
+};
+exports.getDefaultCodingAgentInfoHandler = getDefaultCodingAgentInfoHandler;
+const updateDefaultCodingAgentHandler = ({ input, configFile }) => {
+    if (configFile === null || configFile === undefined) {
+        return Promise.resolve({
+            success: false,
+            reason: 'No Remotion config file was loaded.',
+        });
+    }
+    if (input.defaultCodingAgent !== null &&
+        !renderer_1.defaultCodingAgentIds.includes(input.defaultCodingAgent)) {
+        return Promise.resolve({
+            success: false,
+            reason: `Unknown coding agent: ${input.defaultCodingAgent}`,
+        });
+    }
+    const configContents = (0, node_fs_1.readFileSync)(configFile, 'utf8');
+    (0, file_watcher_1.writeFileAndNotifyFileWatchers)(configFile, (0, exports.updateDefaultCodingAgentInConfig)({
+        configContents,
+        defaultCodingAgent: input.defaultCodingAgent,
+    }), undefined);
+    return Promise.resolve({ success: true });
+};
+exports.updateDefaultCodingAgentHandler = updateDefaultCodingAgentHandler;

package/dist/preview-server/routes/element-install-plan.d.ts

@@ -5,6 +5,7 @@ export declare const validateElementInstallPosition: (position: import("@remotio
 export declare const validateElementForInstallation: (element: {
     dependencies: import("@remotion/studio-protocol").ElementDependency[];
     durationInFrames?: number | undefined;
+    installationMode?: import("@remotion/studio-protocol").ElementInstallationMode | undefined;
     slug: string;
     displayName: string;
     sourceCode: string;

package/dist/preview-server/routes/insert-element.js

@@ -22,13 +22,15 @@ const hasExpectedFileState = ({ expected, actual, }) => {
     return actual.sourceHash === expected.sourceHash;
 };
 const insertElementHandler = ({ input: { compositionFile, compositionId, element, expectedFileState, from, position, overwriteExisting, }, remotionRoot, logLevel, }) => (0, source_file_write_queue_1.withSourceFileWriteQueue)(async () => {
-    var _a;
+    var _a, _b;
     try {
         (0, element_install_plan_1.validateElementInstallPosition)(position);
         if (from !== null &&
             (!Number.isInteger(from) || !Number.isFinite(from) || from < 0)) {
             throw new Error('from must be a non-negative integer');
         }
+        const installationMode = (_a = element.installationMode) !== null && _a !== void 0 ? _a : 'wrapped';
+        const componentOwnsSequence = installationMode === 'component-owned-sequence';
         renderer_1.RenderInternals.Log.trace({ indent: false, logLevel }, `[insert-element] Received request for compositionFile="${compositionFile}" compositionId="${compositionId}" element="${element.slug}"`);
         const plan = await (0, element_install_plan_1.getElementInstallPlan)({
             compositionFile,
@@ -81,18 +83,32 @@ const insertElementHandler = ({ input: { compositionFile, compositionId, element
                 componentName: plan.componentName,
                 importName: plan.componentName,
                 importPath: plan.importPath,
-                props: [],
-                position: null,
+                props: componentOwnsSequence
+                    ? [
+                        ...(element.durationInFrames === undefined
+                            ? []
+                            : [
+                                {
+                                    name: 'durationInFrames',
+                                    value: element.durationInFrames,
+                                },
+                            ]),
+                        { name: 'name', value: element.displayName },
+                    ]
+                    : [],
+                position: componentOwnsSequence ? position : null,
             },
-            from: null,
+            from: componentOwnsSequence ? from : null,
             prettierConfigOverride: null,
-            wrapInSequence: {
-                dimensions: element.dimensions,
-                durationInFrames: (_a = element.durationInFrames) !== null && _a !== void 0 ? _a : null,
-                from,
-                name: element.displayName,
-                position,
-            },
+            wrapInSequence: componentOwnsSequence
+                ? null
+                : {
+                    dimensions: element.dimensions,
+                    durationInFrames: (_b = element.durationInFrames) !== null && _b !== void 0 ? _b : null,
+                    from,
+                    name: element.displayName,
+                    position,
+                },
         });
         const finalPlan = await (0, element_install_plan_1.getElementInstallPlan)({
             compositionFile,

package/dist/preview-server/routes/install-dependency.d.ts

@@ -1,5 +1,4 @@
-import type { ElementDependency } from '@remotion/studio-protocol';
-import { type InstallPackageRequest, type InstallPackageResponse } from '@remotion/studio-shared';
+import { type InstallPackageRequest, type InstallPackageResponse, type PackageInstallSpec } from '@remotion/studio-shared';
 import type { ApiHandler } from '../api-types';
-export declare const getPackageInstallSpec: (dependency: string | ElementDependency) => string;
+export declare const getPackageInstallSpec: (dependency: PackageInstallSpec) => string;
 export declare const handleInstallPackage: ApiHandler<InstallPackageRequest, InstallPackageResponse>;

package/dist/preview-server/routes/install-dependency.js

@@ -13,15 +13,13 @@ const getExtraPackageVersion = (packageName) => {
     return pkg ? pkg.version : null;
 };
 const getPackageInstallSpec = (dependency) => {
-    const { name, version } = typeof dependency === 'string'
-        ? { name: dependency, version: null }
-        : dependency;
-    const extraVersion = getExtraPackageVersion(name);
-    if (extraVersion)
-        return `${name}@${extraVersion}`;
+    const { name, version } = dependency;
     if (name === 'remotion' || name.startsWith('@remotion/'))
         return `${name}@${version_1.VERSION}`;
-    return version === null ? name : `${name}@${version}`;
+    if (version !== null)
+        return `${name}@${version}`;
+    const extraVersion = getExtraPackageVersion(name);
+    return extraVersion === null ? name : `${name}@${extraVersion}`;
 };
 exports.getPackageInstallSpec = getPackageInstallSpec;
 const handleInstallPackage = async ({ logLevel, remotionRoot, input: { dependencies } }) => {

package/dist/preview-server/start-server.d.ts

@@ -42,6 +42,7 @@ export declare const startServer: (options: {
     forceNew: boolean;
     rspack: boolean;
     getStudioRuntimeConfig: () => StudioRuntimeConfig;
+    getDefaultCodingAgent: () => "claude-code" | "codex" | "cursor" | "github-copilot" | null;
     getDefaultEditor: () => DefaultEditor | null;
     configFile: string | null;
 }) => Promise<StartServerResult>;

package/dist/preview-server/start-server.js

@@ -102,6 +102,7 @@ const startServer = async (options) => {
                 getPreviewSampleRate: options.getPreviewSampleRate,
                 enableCrossSiteIsolation: options.enableCrossSiteIsolation,
                 getStudioRuntimeConfig: options.getStudioRuntimeConfig,
+                getDefaultCodingAgent: options.getDefaultCodingAgent,
                 getDefaultEditor: options.getDefaultEditor,
                 configFile: options.configFile,
             });

package/dist/preview-server/studio-protocol/handle-license-key.d.ts

@@ -1,6 +1,11 @@
 import type { IncomingMessage, ServerResponse } from 'node:http';
-export declare const handleStudioProtocolLicenseKey: ({ configFile, request, response, }: {
+import type { LiveEventsServer } from '../live-events';
+type FocusStudioTab = (studioUrl: string) => void;
+export declare const handleStudioProtocolLicenseKey: ({ configFile, focusStudioTab, liveEventsServer, request, response, }: {
     readonly configFile: string | null;
+    readonly focusStudioTab: FocusStudioTab;
+    readonly liveEventsServer: LiveEventsServer;
     readonly request: IncomingMessage;
     readonly response: ServerResponse<IncomingMessage>;
 }) => Promise<void>;
+export {};

package/dist/preview-server/studio-protocol/handle-license-key.js

@@ -5,7 +5,6 @@ const studio_protocol_1 = require("@remotion/studio-protocol");
 const zod_1 = require("zod");
 const element_install_state_1 = require("../element-install-state");
 const parse_body_1 = require("../parse-body");
-const update_public_license_1 = require("../routes/update-public-license");
 const origin_policy_1 = require("./origin-policy");
 const protocol_response_1 = require("./protocol-response");
 const studioProtocolLicenseKeyRequestSchema = zod_1.z.object({
@@ -16,7 +15,7 @@ const studioProtocolLicenseKeyRequestSchema = zod_1.z.object({
     licenseKey: zod_1.z.string(),
 });
 const MAX_STUDIO_PROTOCOL_LICENSE_KEY_BODY_SIZE = 4096;
-const handleStudioProtocolLicenseKey = async ({ configFile, request, response, }) => {
+const handleStudioProtocolLicenseKey = async ({ configFile, focusStudioTab, liveEventsServer, request, response, }) => {
     (0, origin_policy_1.setStudioProtocolCorsHeaders)({ licenseKey: true, request, response });
     const requestOrigin = (0, origin_policy_1.getAllowedLicenseKeyOrigin)(request.headers.origin);
     if (requestOrigin === null) {
@@ -104,26 +103,25 @@ const handleStudioProtocolLicenseKey = async ({ configFile, request, response, }
         });
         return;
     }
-    try {
-        (0, update_public_license_1.setPublicLicenseKeyInConfigFile)({
-            configFile,
-            publicLicenseKey: parsedRequest.data.licenseKey,
-        });
-    }
-    catch (_a) {
+    const delivered = liveEventsServer.sendEventToClientId(target.clientId, {
+        type: 'license-key-install-request',
+        licenseKey: parsedRequest.data.licenseKey,
+    });
+    if (!delivered) {
         (0, protocol_response_1.writeStudioProtocolError)({
-            code: 'config-write-failed',
-            message: 'Could not update the Remotion config file.',
+            code: 'target-expired',
+            message: 'The selected Remotion Studio tab is no longer connected.',
             response,
-            status: 500,
+            status: 409,
         });
         return;
     }
+    focusStudioTab(target.studioUrl);
     response.writeHead(200, { 'Content-Type': 'application/json' });
     response.end(JSON.stringify({
         protocol: 'remotion-studio-protocol',
         protocolVersion: 1,
-        status: 'license-key-set',
+        status: 'awaiting-confirmation',
     }));
 };
 exports.handleStudioProtocolLicenseKey = handleStudioProtocolLicenseKey;

package/dist/remotion-skill-names.d.ts

@@ -1,2 +1,2 @@
-export declare const remotionSkillNames: readonly ["remotion-best-practices", "remotion-captions", "remotion-create", "remotion-docs", "remotion-interactivity", "remotion-maps", "remotion-markup", "remotion-multimedia", "remotion-render", "remotion-saas", "remotion-upgrade"];
+export declare const remotionSkillNames: readonly ["remotion-best-practices", "remotion-captions", "remotion-create", "remotion-docs", "remotion-interactivity", "remotion-maps", "remotion-markup", "remotion-multimedia", "remotion-render", "remotion-saas", "remotion-studio", "remotion-upgrade"];
 export type RemotionSkillName = (typeof remotionSkillNames)[number];

package/dist/remotion-skill-names.js

@@ -12,5 +12,6 @@ exports.remotionSkillNames = [
     'remotion-multimedia',
     'remotion-render',
     'remotion-saas',
+    'remotion-studio',
     'remotion-upgrade',
 ];

package/dist/routes.d.ts

@@ -3,7 +3,7 @@ import type { DefaultEditor } from '@remotion/renderer';
 import type { GitSource, RenderDefaults, RenderJob, StudioRuntimeConfig } from '@remotion/studio-shared';
 import type { QueueMethods } from './preview-server/api-types';
 import type { LiveEventsServer } from './preview-server/live-events';
-export declare const handleRoutes: ({ staticHash, staticHashPrefix, outputHash, outputHashPrefix, request, response, liveEventsServer, getCurrentInputProps, getEnvVariables, remotionRoot, entryPoint, publicDir, logLevel, getRenderQueue, getRenderDefaults, getNumberOfAudioTags, queueMethods: methods, gitSource, binariesDirectory, getAudioLatencyHint, getPreviewSampleRate, enableCrossSiteIsolation, getStudioRuntimeConfig, getDefaultEditor, configFile, }: {
+export declare const handleRoutes: ({ staticHash, staticHashPrefix, outputHash, outputHashPrefix, request, response, liveEventsServer, getCurrentInputProps, getEnvVariables, remotionRoot, entryPoint, publicDir, logLevel, getRenderQueue, getRenderDefaults, getNumberOfAudioTags, queueMethods: methods, gitSource, binariesDirectory, getAudioLatencyHint, getPreviewSampleRate, enableCrossSiteIsolation, getStudioRuntimeConfig, getDefaultCodingAgent, getDefaultEditor, configFile, }: {
     staticHash: string;
     staticHashPrefix: string;
     outputHash: string;
@@ -27,6 +27,7 @@ export declare const handleRoutes: ({ staticHash, staticHashPrefix, outputHash,
     getPreviewSampleRate: () => number | null;
     enableCrossSiteIsolation: boolean;
     getStudioRuntimeConfig: () => StudioRuntimeConfig;
+    getDefaultCodingAgent: () => "claude-code" | "codex" | "cursor" | "github-copilot" | null;
     getDefaultEditor: () => DefaultEditor | null;
     configFile: string | null;
 }) => Promise<void>;

package/dist/routes.js

@@ -252,7 +252,7 @@ const handleBeep = (_, response) => {
     readStream.pipe(response);
     return Promise.resolve();
 };
-const handleRoutes = ({ staticHash, staticHashPrefix, outputHash, outputHashPrefix, request, response, liveEventsServer, getCurrentInputProps, getEnvVariables, remotionRoot, entryPoint, publicDir, logLevel, getRenderQueue, getRenderDefaults, getNumberOfAudioTags, queueMethods: methods, gitSource, binariesDirectory, getAudioLatencyHint, getPreviewSampleRate, enableCrossSiteIsolation, getStudioRuntimeConfig, getDefaultEditor, configFile, }) => {
+const handleRoutes = ({ staticHash, staticHashPrefix, outputHash, outputHashPrefix, request, response, liveEventsServer, getCurrentInputProps, getEnvVariables, remotionRoot, entryPoint, publicDir, logLevel, getRenderQueue, getRenderDefaults, getNumberOfAudioTags, queueMethods: methods, gitSource, binariesDirectory, getAudioLatencyHint, getPreviewSampleRate, enableCrossSiteIsolation, getStudioRuntimeConfig, getDefaultCodingAgent, getDefaultEditor, configFile, }) => {
     const url = new URL(request.url, 'http://localhost');
     if (url.pathname === '/api/file-source') {
         return handleFileSource({
@@ -299,7 +299,15 @@ const handleRoutes = ({ staticHash, staticHashPrefix, outputHash, outputHashPref
             });
         }
         if (url.pathname === '/api/studio-protocol/license-key') {
-            return (0, handle_license_key_1.handleStudioProtocolLicenseKey)({ configFile, request, response });
+            return (0, handle_license_key_1.handleStudioProtocolLicenseKey)({
+                configFile,
+                focusStudioTab: (studioUrl) => {
+                    (0, better_opn_1.focusBrowserTab)({ url: studioUrl }).catch(() => undefined);
+                },
+                liveEventsServer,
+                request,
+                response,
+            });
         }
         return (0, handle_install_1.handleStudioProtocolInstall)({
             focusStudioTab: (studioUrl) => {
@@ -323,6 +331,7 @@ const handleRoutes = ({ staticHash, staticHashPrefix, outputHash, outputHashPref
                 binariesDirectory,
                 publicDir,
                 configFile,
+                getDefaultCodingAgent,
                 getDefaultEditor,
             });
         }

package/dist/start-studio.d.ts

@@ -7,7 +7,7 @@ export type StartStudioResult = {
 } | {
     type: 'already-running';
 };
-export declare const startStudio: ({ browserArgs, browserFlag, shouldOpenBrowser, fullEntryPath, logLevel, getCurrentInputProps, getEnvVariables, desiredPort, remotionRoot, relativePublicDir, bundlerOverride, rspackOverride, webpackOverride, poll, getRenderDefaults, getRenderQueue, getNumberOfAudioTags, queueMethods, previewEntry, gitSource, binariesDirectory, forceIPv4, getAudioLatencyHint, getPreviewSampleRate, enableCrossSiteIsolation, forceNew, rspack, getStudioRuntimeConfig, getDefaultEditor, configFile, }: {
+export declare const startStudio: ({ browserArgs, browserFlag, shouldOpenBrowser, fullEntryPath, logLevel, getCurrentInputProps, getEnvVariables, desiredPort, remotionRoot, relativePublicDir, bundlerOverride, rspackOverride, webpackOverride, poll, getRenderDefaults, getRenderQueue, getNumberOfAudioTags, queueMethods, previewEntry, gitSource, binariesDirectory, forceIPv4, getAudioLatencyHint, getPreviewSampleRate, enableCrossSiteIsolation, forceNew, rspack, getStudioRuntimeConfig, getDefaultCodingAgent, getDefaultEditor, configFile, }: {
     browserArgs: string;
     browserFlag: string;
     logLevel: "error" | "info" | "trace" | "verbose" | "warn";
@@ -36,6 +36,7 @@ export declare const startStudio: ({ browserArgs, browserFlag, shouldOpenBrowser
     forceNew: boolean;
     rspack: boolean;
     getStudioRuntimeConfig: () => StudioRuntimeConfig;
+    getDefaultCodingAgent: () => "claude-code" | "codex" | "cursor" | "github-copilot" | null;
     getDefaultEditor: () => DefaultEditor | null;
     configFile: string | null;
 }) => Promise<StartStudioResult>;

package/dist/start-studio.js

@@ -19,7 +19,7 @@ const public_folder_1 = require("./preview-server/public-folder");
 const start_server_1 = require("./preview-server/start-server");
 const server_ready_1 = require("./server-ready");
 const watch_root_file_1 = require("./watch-root-file");
-const startStudio = async ({ browserArgs, browserFlag, shouldOpenBrowser, fullEntryPath, logLevel, getCurrentInputProps, getEnvVariables, desiredPort, remotionRoot, relativePublicDir, bundlerOverride, rspackOverride, webpackOverride, poll, getRenderDefaults, getRenderQueue, getNumberOfAudioTags, queueMethods, previewEntry, gitSource, binariesDirectory, forceIPv4, getAudioLatencyHint, getPreviewSampleRate, enableCrossSiteIsolation, forceNew, rspack, getStudioRuntimeConfig, getDefaultEditor, configFile, }) => {
+const startStudio = async ({ browserArgs, browserFlag, shouldOpenBrowser, fullEntryPath, logLevel, getCurrentInputProps, getEnvVariables, desiredPort, remotionRoot, relativePublicDir, bundlerOverride, rspackOverride, webpackOverride, poll, getRenderDefaults, getRenderQueue, getNumberOfAudioTags, queueMethods, previewEntry, gitSource, binariesDirectory, forceIPv4, getAudioLatencyHint, getPreviewSampleRate, enableCrossSiteIsolation, forceNew, rspack, getStudioRuntimeConfig, getDefaultCodingAgent, getDefaultEditor, configFile, }) => {
     try {
         if (typeof Bun === 'undefined') {
             process.title = 'node (npx remotion studio)';
@@ -93,6 +93,7 @@ const startStudio = async ({ browserArgs, browserFlag, shouldOpenBrowser, fullEn
         forceNew,
         rspack,
         getStudioRuntimeConfig,
+        getDefaultCodingAgent,
         getDefaultEditor,
         configFile,
     });

package/package.json

@@ -3,7 +3,7 @@
 		"url": "https://github.com/remotion-dev/remotion/tree/main/packages/studio-server"
 	},
 	"name": "@remotion/studio-server",
-	"version": "4.0.505",
+	"version": "4.0.506",
 	"description": "Run a Remotion Studio with a server backend",
 	"main": "dist",
 	"scripts": {
@@ -23,7 +23,7 @@
 		"access": "public"
 	},
 	"dependencies": {
-		"@remotion/studio-protocol": "4.0.505",
+		"@remotion/studio-protocol": "4.0.506",
 		"@babel/types": "7.24.0",
 		"@babel/parser": "7.24.1",
 		"@svgr/core": "8.1.0",
@@ -32,12 +32,12 @@
 		"semver": "7.5.3",
 		"zod": "4.4.3",
 		"prettier": "3.8.1",
-		"remotion": "4.0.505",
+		"remotion": "4.0.506",
 		"recast": "0.23.11",
-		"@remotion/bundler": "4.0.505",
-		"@remotion/renderer": "4.0.505",
-		"@remotion/studio-codemods": "4.0.505",
-		"@remotion/studio-shared": "4.0.505",
+		"@remotion/bundler": "4.0.506",
+		"@remotion/renderer": "4.0.506",
+		"@remotion/studio-codemods": "4.0.506",
+		"@remotion/studio-shared": "4.0.506",
 		"memfs": "3.4.3",
 		"open": "8.4.2"
 	},
@@ -45,7 +45,7 @@
 		"ast-types": "0.16.1",
 		"react": "19.2.3",
 		"@types/semver": "7.5.3",
-		"@remotion/eslint-config-internal": "4.0.505",
+		"@remotion/eslint-config-internal": "4.0.506",
 		"eslint": "9.19.0",
 		"@types/node": "20.12.14",
 		"@typescript/native-preview": "7.0.0-dev.20260217.1"