remotion-dev/remotion · error · Error

guideId must be a non-empty string.

Error message

guideId must be a non-empty string.

What it means

The remove-guide tool requires guideId to be a non-empty string. Empty or non-string values are rejected before any state lookup.

Source

Thrown at packages/studio/src/components/WebMcp.tsx:1466

					description:
						'Remove a guide from the current Remotion Studio composition by its guide ID.',
					inputSchema: {
						type: 'object',
						properties: {
							guideId: {
								type: 'string',
								minLength: 1,
								description:
									'The guide ID returned by get_guides or add_guide.',
							},
						},
						required: ['guideId'],
						additionalProperties: false,
					},
					annotations: {readOnlyHint: false},
					execute: ({guideId}) => {
						if (typeof guideId !== 'string' || guideId.length === 0) {
							throw new Error('guideId must be a non-empty string.');
						}

						const compositionId = currentCompositionRef.current;
						if (compositionId === null) {
							throw new Error('No composition is currently selected.');
						}

						const guideExists = guidesListRef.current.some(
							(guide) =>
								guide.id === guideId && guide.compositionId === compositionId,
						);
						if (!guideExists) {
							throw new Error(
								`Guide ${guideId} not found in the current composition.`,
							);
						}

						const nextGuides = guidesListRef.current.filter(

View on GitHub (pinned to b2f4e34732)

Solutions

1. Pass the exact guide ID string previously returned by the list/add guide tools

if (typeof guideId !== 'string' || guideId.length === 0) throw new Error('guideId required');

const isNonEmptyString = (v: unknown): v is string => typeof v === 'string' && v.length > 0;

When it happens

Trigger: Calling remove-guide with guideId: "", null, or a number.

Common situations: LLM clients hallucinating guide IDs or passing an empty default.

Understand the failure class

Background: "Must be a positive integer", "Invalid value", "Unsupported": the invalid-argument-value error family, when a library rejects the value you pass — this error's family across 35 libraries.

Related errors

• orientation must be either "horizontal" or "vertical".
• position must be a finite number.
• The artifact filename ${artifact.filename} was emitted more
• Composition ${compositionName} not found.
• visible must be a boolean.

AI-assisted analysis of remotion-dev/remotion@b2f4e34732 (2026-08-28). Data as JSON: /api/errors/8d884c7055556a7e. Report an issue: GitHub.