chore: atualização geral

2026-08-19 16:35:29 -04:00
parent 8fca456ceb
commit e7748c2c58
66 changed files with 13037 additions and 4237 deletions
@@ -0,0 +1,110 @@
+"""Live (macOS) — tool schemas and handlers.
+
+Extracted from server.py; see Engine/docs/03_SERVER_TOOLS.md for the tool catalog.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Sequence
+
+from mcp.types import TextContent, Tool
+
+from server_tools._shared import (
+    _text_result,
+    _validate_filepath,
+    _validate_output_path,
+    generate_output_path,
+)
+
+TOOLS = [
+            Tool(
+                name="push_to_fcp",
+                description="LIVE: send an FCPXML file into the running Final Cut Pro with zero clicks (official Open Document Apple event). Creates/targets a library via import-options. Launches FCP if needed. macOS-only; first use triggers an Automation permission prompt. For true zero-click, pass a library_location ending in .fcpbundle (a new path is auto-created); omitting it makes FCP show a modal library picker.",
+                inputSchema={
+                    "type": "object",
+                    "properties": {
+                        "filepath": {"type": "string", "description": "Path to FCPXML file or .fcpxmld bundle to import"},
+                        "library_location": {"type": "string", "description": "Target .fcpbundle library path (auto-created if it doesn't exist; the extension is normalized to .fcpbundle). Omit to import into the active library, but note FCP then shows a modal 'Open Library' picker that blocks until answered"},
+                        "suppress_warnings": {"type": "boolean", "description": "Suppress non-fatal import warning dialogs", "default": True},
+                        "copy_assets": {"type": "boolean", "description": "Copy media into the library (true) or link in place (false). Omit for FCP default"},
+                    },
+                    "required": ["filepath"]
+                }
+            ),
+            Tool(
+                name="list_fcp_libraries",
+                description="LIVE: enumerate the running Final Cut Pro's open libraries, events, and projects via Apple's read-only scripting dictionary. Refuses to launch FCP unless allow_launch is true. macOS-only.",
+                inputSchema={
+                    "type": "object",
+                    "properties": {
+                        "allow_launch": {"type": "boolean", "description": "Launch FCP if it isn't running", "default": False},
+                    },
+                }
+            ),
+]
+
+
+async def handle_push_to_fcp(arguments: dict) -> Sequence[TextContent]:
+    from fcpxml.live import push_to_fcp
+
+    filepath = _validate_filepath(arguments["filepath"], ('.fcpxml', '.fcpxmld'))
+
+    # Flat files get an options-injected sibling copy (never touch the
+    # original); the copy path goes through the same write sandbox as
+    # every other derived output.
+    import_copy = None
+    if Path(filepath).suffix.lower() == '.fcpxml':
+        anchor = str(Path(filepath).resolve().parent)
+        import_copy = _validate_output_path(
+            generate_output_path(filepath, "_import"), anchor_dir=anchor
+        )
+
+    result = push_to_fcp(
+        filepath,
+        library_location=arguments.get("library_location"),
+        suppress_warnings=arguments.get("suppress_warnings", True),
+        copy_assets=arguments.get("copy_assets"),
+        import_copy_path=import_copy,
+    )
+    lines = [
+        f"Sent to Final Cut Pro: {result['sent']}",
+        f"FCP {'was launched' if result['launched_fcp'] else 'was already running'} — "
+        f"import happens in-app (libraries/events are created or merged per import-options).",
+    ]
+    if arguments.get("library_location"):
+        lines.append(f"Target library: {arguments['library_location']}")
+    lines.append(
+        "Note: Apple offers no programmatic export — to round-trip edits "
+        "back, use File > Export XML in FCP."
+    )
+    return _text_result("\n".join(lines))
+
+
+async def handle_list_fcp_libraries(arguments: dict) -> Sequence[TextContent]:
+    from fcpxml.live import list_fcp_libraries
+
+    try:
+        libraries = list_fcp_libraries(
+            allow_launch=arguments.get("allow_launch", False)
+        )
+    except RuntimeError as exc:
+        return _text_result(str(exc))
+
+    if not libraries:
+        return _text_result("Final Cut Pro is running but reports no open libraries.")
+
+    lines = [f"Open libraries in Final Cut Pro ({len(libraries)}):", ""]
+    for lib in libraries:
+        lines.append(f"📚 {lib['name']}")
+        for event in lib["events"]:
+            lines.append(f"  └─ {event['name']}")
+            for proj in event["projects"]:
+                lines.append(f"      • {proj}")
+    return _text_result("\n".join(lines))
+
+
+HANDLERS = {
+    "push_to_fcp": handle_push_to_fcp,
+    "list_fcp_libraries": handle_list_fcp_libraries,
+}