{"record":{"id":"cfe17ba1f3ca964d","repo":"remotion-dev/remotion","slug":"guide-guideid-not-found-in-the-current-composit","errorCode":null,"errorMessage":"Guide ${guideId} not found in the current composition.","messagePattern":"Guide (.+?) not found in the current composition\\.","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/studio/src/components/WebMcp.tsx","lineNumber":1479,"sourceCode":"\t\t\t\t\t\tadditionalProperties: false,\n\t\t\t\t\t},\n\t\t\t\t\tannotations: {readOnlyHint: false},\n\t\t\t\t\texecute: ({guideId}) => {\n\t\t\t\t\t\tif (typeof guideId !== 'string' || guideId.length === 0) {\n\t\t\t\t\t\t\tthrow new Error('guideId must be a non-empty string.');\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tconst compositionId = currentCompositionRef.current;\n\t\t\t\t\t\tif (compositionId === null) {\n\t\t\t\t\t\t\tthrow new Error('No composition is currently selected.');\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tconst guideExists = guidesListRef.current.some(\n\t\t\t\t\t\t\t(guide) =>\n\t\t\t\t\t\t\t\tguide.id === guideId && guide.compositionId === compositionId,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tif (!guideExists) {\n\t\t\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t\t\t`Guide ${guideId} not found in the current composition.`,\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tconst nextGuides = guidesListRef.current.filter(\n\t\t\t\t\t\t\t(guide) =>\n\t\t\t\t\t\t\t\tguide.id !== guideId || guide.compositionId !== compositionId,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tguidesListRef.current = nextGuides;\n\t\t\t\t\t\tsetGuidesList(() => nextGuides);\n\t\t\t\t\t\tpersistGuidesList(nextGuides);\n\n\t\t\t\t\t\tconst removedGuideWasSelected = selectedItemsRef.current.some(\n\t\t\t\t\t\t\t(item) => item.type === 'guide' && item.guideId === guideId,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tif (removedGuideWasSelected) {\n\t\t\t\t\t\t\tclearSelection();\n\t\t\t\t\t\t}","sourceCodeStart":1461,"sourceCodeEnd":1497,"githubUrl":"https://github.com/remotion-dev/remotion/blob/b2f4e34732f3c6c222ea029413e22dc402218cd7/packages/studio/src/components/WebMcp.tsx#L1461-L1497","documentation":"The remove-guide tool checks guidesListRef for a guide with the given ID belonging to the current composition; not finding one throws this error.","triggerScenarios":"Passing a stale guide ID from another composition, a deleted guide, or a made-up ID.","commonSituations":"Agents caching guide IDs across composition switches or after guides were already removed.","solutions":["List guides for the current composition first and use a current ID"],"exampleFix":null,"handlingStrategy":"validation","validationCode":"const guides = await listGuidesTool();\nconst exists = guides.some((g) => g.id === guideId);\nif (!exists) throw new Error('guide not found');","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Re-list guides before removal; never cache IDs across compositions"],"tags":["mcp","guides","state"],"backgroundTag":"entity-not-found","analyzedSha":"b2f4e34732f3c6c222ea029413e22dc402218cd7","analyzedAt":"2026-08-28T15:39:09.316Z","contentChangedAt":"2026-08-28T15:39:09.316Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}