@hybridlabor-api/aos 4.4.0 → 4.4.2-beta.0

package/mcps/davinci-resolve-mcp/src/granular/media_pool_item.py

@@ -1,1020 +0,0 @@
-"""MediaPoolItem operations and metadata helpers."""
-
-from src.granular.common import *  # noqa: F401,F403
-from src.utils.media_analysis import mark_registry_stale_for_clip as _mark_analysis_registry_stale
-
-resolve = ResolveProxy()
-
-
-def _invalidate_analysis_registry_for_clip(project, clip, *, reason: str) -> Optional[Dict[str, Any]]:
-    """Best-effort: mark cached analysis stale after a Resolve clip replace.
-
-    Called from replace_clip / replace_media_pool_clip / preserve_sub_clip
-    after the Resolve API confirms the mutation. Failures here must NEVER
-    block the Resolve mutation — we return the result for diagnostics but
-    swallow exceptions so registry trouble does not corrupt the user's edit.
-    """
-    if project is None or clip is None:
-        return None
-    try:
-        project_name = project.GetName() if hasattr(project, "GetName") else None
-        project_id = project.GetUniqueId() if hasattr(project, "GetUniqueId") else None
-        clip_id = clip.GetUniqueId() if hasattr(clip, "GetUniqueId") else None
-        media_id = clip.GetMediaId() if hasattr(clip, "GetMediaId") else None
-        source_file = None
-        try:
-            source_file = clip.GetClipProperty("File Path") if hasattr(clip, "GetClipProperty") else None
-        except Exception:
-            source_file = None
-        return _mark_analysis_registry_stale(
-            project_name=project_name,
-            project_id=project_id,
-            clip_id=clip_id,
-            media_id=media_id,
-            source_file=source_file,
-            reason=reason,
-        )
-    except Exception as exc:  # noqa: BLE001 — never break a Resolve mutation
-        return {"success": False, "error": f"registry invalidation skipped: {type(exc).__name__}: {exc}"}
-
-@mcp.tool(annotations=EXTERNAL_DESTRUCTIVE_TOOL)
-def link_proxy_media(clip_name: str, proxy_file_path: str) -> str:
-    """Link a proxy media file to a clip.
-    
-    Args:
-        clip_name: Name of the clip to link proxy to
-        proxy_file_path: Path to the proxy media file
-    """
-    pm, current_project = get_current_project()
-    if not current_project:
-        return "Error: No project currently open"
-    
-    media_pool = current_project.GetMediaPool()
-    if not media_pool:
-        return "Error: Failed to get Media Pool"
-    
-    # Find the clip by name (lazy walk; stops at the first match)
-    clips = iter_all_media_pool_clips(media_pool)
-    target_clip = None
-
-    for clip in clips:
-        if clip.GetName() == clip_name:
-            target_clip = clip
-            break
-    
-    if not target_clip:
-        return f"Error: Clip '{clip_name}' not found in Media Pool"
-    
-    # Check if file exists
-    if not os.path.exists(proxy_file_path):
-        return f"Error: Proxy file '{proxy_file_path}' does not exist"
-    
-    try:
-        result = target_clip.LinkProxyMedia(proxy_file_path)
-        if result:
-            return f"Successfully linked proxy media '{proxy_file_path}' to clip '{clip_name}'"
-        else:
-            return f"Failed to link proxy media to clip '{clip_name}'"
-    except Exception as e:
-        return f"Error linking proxy media: {str(e)}"
-
-
-@mcp.tool()
-def unlink_proxy_media(clip_name: str) -> str:
-    """Unlink proxy media from a clip.
-    
-    Args:
-        clip_name: Name of the clip to unlink proxy from
-    """
-    pm, current_project = get_current_project()
-    if not current_project:
-        return "Error: No project currently open"
-    
-    media_pool = current_project.GetMediaPool()
-    if not media_pool:
-        return "Error: Failed to get Media Pool"
-    
-    # Find the clip by name (lazy walk; stops at the first match)
-    clips = iter_all_media_pool_clips(media_pool)
-    target_clip = None
-
-    for clip in clips:
-        if clip.GetName() == clip_name:
-            target_clip = clip
-            break
-    
-    if not target_clip:
-        return f"Error: Clip '{clip_name}' not found in Media Pool"
-    
-    try:
-        result = target_clip.UnlinkProxyMedia()
-        if result:
-            return f"Successfully unlinked proxy media from clip '{clip_name}'"
-        else:
-            return f"Failed to unlink proxy media from clip '{clip_name}'"
-    except Exception as e:
-        return f"Error unlinking proxy media: {str(e)}"
-
-
-@mcp.tool()
-def replace_clip(clip_name: str, replacement_path: str) -> str:
-    """Replace a clip with another media file.
-    
-    Args:
-        clip_name: Name of the clip to be replaced
-        replacement_path: Path to the replacement media file
-    """
-    pm, current_project = get_current_project()
-    if not current_project:
-        return "Error: No project currently open"
-    
-    media_pool = current_project.GetMediaPool()
-    if not media_pool:
-        return "Error: Failed to get Media Pool"
-    
-    # Find the clip by name (lazy walk; stops at the first match)
-    clips = iter_all_media_pool_clips(media_pool)
-    target_clip = None
-
-    for clip in clips:
-        if clip.GetName() == clip_name:
-            target_clip = clip
-            break
-    
-    if not target_clip:
-        return f"Error: Clip '{clip_name}' not found in Media Pool"
-    
-    # Check if file exists
-    if not os.path.exists(replacement_path):
-        return f"Error: Replacement file '{replacement_path}' does not exist"
-    
-    try:
-        result = target_clip.ReplaceClip(replacement_path)
-        if result:
-            _invalidate_analysis_registry_for_clip(
-                current_project, target_clip, reason="replace_clip"
-            )
-            return f"Successfully replaced clip '{clip_name}' with '{replacement_path}'"
-        else:
-            return f"Failed to replace clip '{clip_name}'"
-    except Exception as e:
-        return f"Error replacing clip: {str(e)}"
-
-
-@mcp.tool()
-def transcribe_audio(clip_name: str, use_speaker_detection: Optional[bool] = None) -> str:
-    """Transcribe audio for a clip.
-
-    The transcription language follows the project's Speech Recognition setting
-    (Project Settings > Subtitles), not a per-call argument.
-
-    Args:
-        clip_name: Name of the clip to transcribe
-        use_speaker_detection: Optional (Resolve 21+). Enable speaker detection.
-            If omitted, the project's setting is used.
-    """
-    pm, current_project = get_current_project()
-    if not current_project:
-        return "Error: No project currently open"
-    
-    media_pool = current_project.GetMediaPool()
-    if not media_pool:
-        return "Error: Failed to get Media Pool"
-    
-    # Find the clip by name (lazy walk; stops at the first match)
-    clips = iter_all_media_pool_clips(media_pool)
-    target_clip = None
-
-    for clip in clips:
-        if clip.GetName() == clip_name:
-            target_clip = clip
-            break
-    
-    if not target_clip:
-        return f"Error: Clip '{clip_name}' not found in Media Pool"
-    
-    # Resolve 21's signature is TranscribeAudio(useSpeakerDetection=None); pass the
-    # bool only when supplied so older Resolve builds (no arg) keep working.
-    try:
-        if use_speaker_detection is None:
-            result = target_clip.TranscribeAudio()
-        else:
-            result = target_clip.TranscribeAudio(use_speaker_detection)
-        if result:
-            return f"Successfully started audio transcription for clip '{clip_name}'"
-        else:
-            return f"Failed to start audio transcription for clip '{clip_name}'"
-    except Exception as e:
-        return f"Error during audio transcription: {str(e)}"
-
-
-@mcp.tool()
-def clear_transcription(clip_name: str) -> str:
-    """Clear audio transcription for a clip.
-    
-    Args:
-        clip_name: Name of the clip to clear transcription from
-    """
-    pm, current_project = get_current_project()
-    if not current_project:
-        return "Error: No project currently open"
-    
-    media_pool = current_project.GetMediaPool()
-    if not media_pool:
-        return "Error: Failed to get Media Pool"
-    
-    # Find the clip by name (lazy walk; stops at the first match)
-    clips = iter_all_media_pool_clips(media_pool)
-    target_clip = None
-
-    for clip in clips:
-        if clip.GetName() == clip_name:
-            target_clip = clip
-            break
-    
-    if not target_clip:
-        return f"Error: Clip '{clip_name}' not found in Media Pool"
-    
-    try:
-        result = target_clip.ClearTranscription()
-        if result:
-            return f"Successfully cleared audio transcription for clip '{clip_name}'"
-        else:
-            return f"Failed to clear audio transcription for clip '{clip_name}'"
-    except Exception as e:
-        return f"Error clearing audio transcription: {str(e)}"
-
-
-@mcp.tool()
-def get_clip_metadata(clip_id: str, metadata_type: str = "") -> Dict[str, Any]:
-    """Get metadata for a Media Pool clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        metadata_type: Specific metadata key, or empty for all metadata.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    if metadata_type:
-        result = clip.GetMetadata(metadata_type)
-    else:
-        result = clip.GetMetadata()
-    return {"clip_id": clip_id, "metadata": result if result else {}}
-
-
-@mcp.tool()
-def set_clip_metadata(clip_id: str, metadata: Dict[str, str]) -> Dict[str, Any]:
-    """Set metadata on a Media Pool clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        metadata: Dict of metadata key-value pairs to set.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    result = clip.SetMetadata(metadata)
-    return {"success": bool(result)}
-
-
-@mcp.tool()
-def get_clip_third_party_metadata(clip_id: str, metadata_key: str = "") -> Dict[str, Any]:
-    """Get third-party metadata for a clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        metadata_key: Specific key, or empty for all.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    if metadata_key:
-        result = clip.GetThirdPartyMetadata(metadata_key)
-    else:
-        result = clip.GetThirdPartyMetadata()
-    return {"clip_id": clip_id, "third_party_metadata": result if result else {}}
-
-
-@mcp.tool()
-def set_clip_third_party_metadata(clip_id: str, metadata: Dict[str, str]) -> Dict[str, Any]:
-    """Set third-party metadata on a clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        metadata: Dict of metadata key-value pairs.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    result = clip.SetThirdPartyMetadata(metadata)
-    return {"success": bool(result)}
-
-
-@mcp.tool()
-def get_clip_media_id(clip_id: str) -> Dict[str, Any]:
-    """Get the media ID for a clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    media_id = clip.GetMediaId()
-    return {"clip_id": clip_id, "media_id": media_id}
-
-
-@mcp.tool()
-def add_clip_marker(clip_id: str, frame_id: int, color: str, name: str, note: str = "", duration: int = 1, custom_data: str = "") -> Dict[str, Any]:
-    """Add a marker to a Media Pool clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        frame_id: Frame number for the marker.
-        color: Marker color (Blue, Cyan, Green, Yellow, Red, Pink, Purple, Fuchsia, Rose, Lavender, Sky, Mint, Lemon, Sand, Cocoa, Cream).
-        name: Marker name.
-        note: Marker note. Default: empty.
-        duration: Marker duration in frames. Default: 1.
-        custom_data: Custom data string. Default: empty.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    result = clip.AddMarker(frame_id, color, name, note, duration, custom_data)
-    return {"success": bool(result)}
-
-
-@mcp.tool()
-def get_clip_markers(clip_id: str) -> Dict[str, Any]:
-    """Get all markers on a Media Pool clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    markers = clip.GetMarkers()
-    return {"clip_id": clip_id, "markers": markers if markers else {}}
-
-
-@mcp.tool()
-def get_clip_marker_by_custom_data(clip_id: str, custom_data: str) -> Dict[str, Any]:
-    """Get a marker by its custom data string.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        custom_data: Custom data string to search for.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    marker = clip.GetMarkerByCustomData(custom_data)
-    return {"marker": marker if marker else {}}
-
-
-@mcp.tool()
-def update_clip_marker_custom_data(clip_id: str, frame_id: int, custom_data: str) -> Dict[str, Any]:
-    """Update the custom data of a clip marker.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        frame_id: Frame number of the marker.
-        custom_data: New custom data string.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    result = clip.UpdateMarkerCustomData(frame_id, custom_data)
-    return {"success": bool(result)}
-
-
-@mcp.tool()
-def get_clip_marker_custom_data(clip_id: str, frame_id: int) -> Dict[str, Any]:
-    """Get the custom data of a clip marker at a specific frame.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        frame_id: Frame number of the marker.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    data = clip.GetMarkerCustomData(frame_id)
-    return {"frame_id": frame_id, "custom_data": data if data else ""}
-
-
-@mcp.tool()
-def delete_clip_markers_by_color(clip_id: str, color: str) -> Dict[str, Any]:
-    """Delete all markers of a specific color on a clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        color: Color of markers to delete. Use '' to delete all.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    result = clip.DeleteMarkersByColor(color)
-    return {"success": bool(result)}
-
-
-@mcp.tool()
-def delete_clip_marker_at_frame(clip_id: str, frame_id: int) -> Dict[str, Any]:
-    """Delete a marker at a specific frame on a clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        frame_id: Frame number of the marker to delete.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    result = clip.DeleteMarkerAtFrame(frame_id)
-    return {"success": bool(result)}
-
-
-@mcp.tool()
-def delete_clip_marker_by_custom_data(clip_id: str, custom_data: str) -> Dict[str, Any]:
-    """Delete a marker by its custom data string.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        custom_data: Custom data string of the marker to delete.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    result = clip.DeleteMarkerByCustomData(custom_data)
-    return {"success": bool(result)}
-
-
-@mcp.tool()
-def add_clip_flag(clip_id: str, color: str) -> Dict[str, Any]:
-    """Add a flag to a Media Pool clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        color: Flag color (Blue, Cyan, Green, Yellow, Red, Pink, Purple, Fuchsia, Rose, Lavender, Sky, Mint, Lemon, Sand, Cocoa, Cream).
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    result = clip.AddFlag(color)
-    return {"success": bool(result)}
-
-
-@mcp.tool()
-def get_clip_flag_list(clip_id: str) -> Dict[str, Any]:
-    """Get list of flags on a clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    flags = clip.GetFlagList()
-    return {"clip_id": clip_id, "flags": flags if flags else []}
-
-
-@mcp.tool()
-def clear_clip_flags(clip_id: str, color: str = "") -> Dict[str, Any]:
-    """Clear flags on a clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        color: Specific color to clear, or empty for all colors.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    result = clip.ClearFlags(color)
-    return {"success": bool(result)}
-
-
-@mcp.tool()
-def get_clip_color(clip_id: str) -> Dict[str, Any]:
-    """Get the clip color of a Media Pool item.
-
-    Args:
-        clip_id: Unique ID of the clip.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    color = clip.GetClipColor()
-    return {"clip_id": clip_id, "clip_color": color if color else ""}
-
-
-@mcp.tool()
-def set_clip_color(clip_id: str, color: str) -> Dict[str, Any]:
-    """Set the clip color of a Media Pool item.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        color: Color name (Orange, Apricot, Yellow, Lime, Olive, Green, Teal, Navy, Blue, Purple, Violet, Pink, Tan, Beige, Brown, Chocolate).
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    result = clip.SetClipColor(color)
-    return {"success": bool(result)}
-
-
-@mcp.tool()
-def clear_clip_color(clip_id: str) -> Dict[str, Any]:
-    """Clear the clip color of a Media Pool item.
-
-    Args:
-        clip_id: Unique ID of the clip.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    result = clip.ClearClipColor()
-    return {"success": bool(result)}
-
-
-@mcp.tool()
-def set_clip_property(clip_id: str, property_name: str, property_value: str) -> Dict[str, Any]:
-    """Set a property on a Media Pool clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        property_name: Property name (e.g. 'Clip Name', 'Comments', 'Description').
-        property_value: Value to set.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    result = clip.SetClipProperty(property_name, property_value)
-    return {"success": bool(result)}
-
-
-@mcp.tool()
-def get_clip_property(clip_id: str, property_name: str = "") -> Dict[str, Any]:
-    """Get a property of a Media Pool clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        property_name: Property name, or empty for all properties.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    if property_name:
-        result = clip.GetClipProperty(property_name)
-    else:
-        result = clip.GetClipProperty()
-    return {"clip_id": clip_id, "property": result if result else {}}
-
-
-@mcp.tool()
-def set_media_pool_clip_name(clip_id: str, new_name: str) -> Dict[str, Any]:
-    """Rename a Media Pool clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        new_name: New clip name.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    missing = _requires_method(clip, "SetName", "20.2")
-    if missing:
-        return missing
-    result = clip.SetName(new_name)
-    return {"success": bool(result), "name": new_name}
-
-
-@mcp.tool()
-def link_clip_proxy_media(clip_id: str, proxy_path: str) -> Dict[str, Any]:
-    """Link proxy media to a clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        proxy_path: Absolute path to the proxy media file.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    result = clip.LinkProxyMedia(proxy_path)
-    return {"success": bool(result)}
-
-
-@mcp.tool()
-def link_clip_full_resolution_media(clip_id: str, full_res_media_path: str) -> Dict[str, Any]:
-    """Link full resolution media to a proxy clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        full_res_media_path: Absolute path to the full resolution media file.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    missing = _requires_method(clip, "LinkFullResolutionMedia", "20.0")
-    if missing:
-        return missing
-    result = clip.LinkFullResolutionMedia(full_res_media_path)
-    return {"success": bool(result)}
-
-
-@mcp.tool()
-def unlink_clip_proxy_media(clip_id: str) -> Dict[str, Any]:
-    """Unlink proxy media from a clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    result = clip.UnlinkProxyMedia()
-    return {"success": bool(result)}
-
-
-@mcp.tool()
-def replace_media_pool_clip(clip_id: str, new_file_path: str) -> Dict[str, Any]:
-    """Replace a clip with a new media file.
-
-    Args:
-        clip_id: Unique ID of the clip to replace.
-        new_file_path: Absolute path to the new media file.
-    """
-    project, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    result = clip.ReplaceClip(new_file_path)
-    response: Dict[str, Any] = {"success": bool(result)}
-    if result:
-        registry = _invalidate_analysis_registry_for_clip(
-            project, clip, reason="replace_media_pool_clip"
-        )
-        if registry is not None:
-            response["analysis_registry_invalidation"] = registry
-    return response
-
-
-@mcp.tool()
-def replace_media_pool_clip_preserve_sub_clip(clip_id: str, file_path: str) -> Dict[str, Any]:
-    """Replace a clip's underlying media while preserving subclip extents.
-
-    Args:
-        clip_id: Unique ID of the clip to replace.
-        file_path: Absolute path to the replacement media file.
-    """
-    project, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    missing = _requires_method(clip, "ReplaceClipPreserveSubClip", "20.0")
-    if missing:
-        return missing
-    result = clip.ReplaceClipPreserveSubClip(file_path)
-    response: Dict[str, Any] = {"success": bool(result)}
-    if result:
-        registry = _invalidate_analysis_registry_for_clip(
-            project, clip, reason="replace_media_pool_clip_preserve_sub_clip"
-        )
-        if registry is not None:
-            response["analysis_registry_invalidation"] = registry
-    return response
-
-
-@mcp.tool()
-def monitor_clip_growing_file(clip_id: str) -> Dict[str, Any]:
-    """Monitor a growing media file for the given Media Pool clip."""
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    missing = _requires_method(clip, "MonitorGrowingFile", "20.0")
-    if missing:
-        return missing
-    result = clip.MonitorGrowingFile()
-    return {"success": bool(result)}
-
-
-@mcp.tool()
-def get_clip_unique_id_by_name(clip_name: str) -> Dict[str, Any]:
-    """Find a clip by name and return its unique ID.
-
-    Args:
-        clip_name: Name of the clip to find.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-
-    def search(folder):
-        for clip in (folder.GetClipList() or []):
-            if clip.GetName() == clip_name:
-                return clip
-        for sub in (folder.GetSubFolderList() or []):
-            found = search(sub)
-            if found:
-                return found
-        return None
-
-    clip = search(mp.GetRootFolder())
-    if clip:
-        return {"name": clip.GetName(), "unique_id": clip.GetUniqueId()}
-    return {"error": f"Clip '{clip_name}' not found"}
-
-
-@mcp.tool()
-def transcribe_clip_audio(clip_id: str) -> Dict[str, Any]:
-    """Transcribe audio for a specific clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    result = clip.TranscribeAudio()
-    return {"success": bool(result)}
-
-
-@mcp.tool()
-def clear_clip_transcription(clip_id: str) -> Dict[str, Any]:
-    """Clear transcription for a specific clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    result = clip.ClearTranscription()
-    return {"success": bool(result)}
-
-
-@mcp.tool()
-def get_clip_audio_mapping(clip_id: str) -> Dict[str, Any]:
-    """Get audio mapping for a clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    mapping = clip.GetAudioMapping()
-    return {"clip_id": clip_id, "audio_mapping": mapping if mapping else ""}
-
-
-@mcp.tool()
-def get_clip_mark_in_out(clip_id: str) -> Dict[str, Any]:
-    """Get mark in/out points for a clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    result = clip.GetMarkInOut()
-    return {"clip_id": clip_id, "mark_in_out": result if result else {}}
-
-
-@mcp.tool()
-def set_clip_mark_in_out(clip_id: str, mark_in: int, mark_out: int) -> Dict[str, Any]:
-    """Set mark in/out points for a clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        mark_in: Mark in frame number.
-        mark_out: Mark out frame number.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    result = clip.SetMarkInOut(mark_in, mark_out)
-    return {"success": bool(result)}
-
-
-@mcp.tool()
-def clear_clip_mark_in_out(clip_id: str) -> Dict[str, Any]:
-    """Clear mark in/out points for a clip.
-
-    Args:
-        clip_id: Unique ID of the clip.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    result = clip.ClearMarkInOut()
-    return {"success": bool(result)}
-
-
-_MARKER_COLORS = [
-    "Blue", "Cyan", "Green", "Yellow", "Red", "Pink", "Purple", "Fuchsia",
-    "Rose", "Lavender", "Sky", "Mint", "Lemon", "Sand", "Cocoa", "Cream",
-]
-
-
-@mcp.tool()
-def perform_clip_audio_classification(clip_id: str) -> Dict[str, Any]:
-    """Classify a clip's audio into categories and subcategories (Resolve 21+).
-
-    Args:
-        clip_id: Unique ID of the clip.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    if not hasattr(clip, "PerformAudioClassification"):
-        return {"error": "PerformAudioClassification requires DaVinci Resolve 21+"}
-    return {"success": bool(clip.PerformAudioClassification())}
-
-
-@mcp.tool()
-def clear_clip_audio_classification(clip_id: str) -> Dict[str, Any]:
-    """Clear a clip's audio classification (Resolve 21+).
-
-    Args:
-        clip_id: Unique ID of the clip.
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    if not hasattr(clip, "ClearAudioClassification"):
-        return {"error": "ClearAudioClassification requires DaVinci Resolve 21+"}
-    return {"success": bool(clip.ClearAudioClassification())}
-
-
-@mcp.tool()
-def analyze_clip_for_intellisearch(clip_id: str, identify_faces: bool = False, is_better_mode: bool = False) -> Dict[str, Any]:
-    """Run IntelliSearch analysis on a clip (Resolve 21+, requires AI IntelliSearch Extra).
-
-    Args:
-        clip_id: Unique ID of the clip.
-        identify_faces: Whether to identify faces.
-        is_better_mode: Use Better mode (vs Faster).
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    if not hasattr(clip, "AnalyzeForIntellisearch"):
-        return {"error": "AnalyzeForIntellisearch requires DaVinci Resolve 21+"}
-    return {"success": bool(clip.AnalyzeForIntellisearch(bool(identify_faces), bool(is_better_mode)))}
-
-
-@mcp.tool()
-def analyze_clip_for_slate(clip_id: str, marker_color: str = "Blue") -> Dict[str, Any]:
-    """Run Slate analysis on a clip (Resolve 21+, requires AI Slate ID Extra).
-
-    Args:
-        clip_id: Unique ID of the clip.
-        marker_color: Marker color for detected slates (Blue, Cyan, Green, Yellow, Red, Pink,
-            Purple, Fuchsia, Rose, Lavender, Sky, Mint, Lemon, Sand, Cocoa, Cream).
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    if not hasattr(clip, "AnalyzeForSlate"):
-        return {"error": "AnalyzeForSlate requires DaVinci Resolve 21+"}
-    if marker_color not in _MARKER_COLORS:
-        return {"error": f"Invalid marker_color '{marker_color}'. Valid: {', '.join(_MARKER_COLORS)}"}
-    return {"success": bool(clip.AnalyzeForSlate(marker_color))}
-
-
-@mcp.tool()
-def remove_clip_motion_blur(clip_id: str, deblur_option: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
-    """Render a motion-deblurred copy of a clip (Resolve 21+).
-
-    Creates a NEW media file; the source clip is not modified.
-
-    Args:
-        clip_id: Unique ID of the clip.
-        deblur_option: Settings dict (FileName, Format, Codec, EncodingProfile,
-            UseExtremeMode, UseMarkInMarkOut, RenderAtSourceRes, UseMoreGpuMemory).
-    """
-    _, mp, err = _get_mp()
-    if err:
-        return err
-    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
-    if not clip:
-        return {"error": f"Clip {clip_id} not found"}
-    if not hasattr(clip, "RemoveMotionBlur"):
-        return {"error": "RemoveMotionBlur requires DaVinci Resolve 21+"}
-    new_clip = clip.RemoveMotionBlur(deblur_option or {})
-    if not new_clip:
-        return {"success": False}
-    return {"success": True, "new": new_clip.GetName(), "new_id": new_clip.GetUniqueId()}