videobook 0.0.0-stage → 0.2.0

package/dist/tools/commands.js

@@ -0,0 +1,1666 @@
+import { z } from "zod";
+import { bookManager } from "../engine.js";
+import { APPLICATION_COMMANDS } from "./application-commands.js";
+import { VIDEO_EDITING_COMMANDS, canonicalizeCommands, } from "./video-editing-command-contract.js";
+const CANONICAL_COMMANDS = [
+    ...VIDEO_EDITING_COMMANDS,
+    {
+        command: "/post",
+        description: "Post a video or image asset to X (Twitter), now or scheduled",
+        example: "/post @hero-clip Check this out!",
+        category: "action",
+        icon: "Share2",
+        size: "default",
+        variant: "blue",
+        chevron: "right",
+        params: [
+            { name: "asset_ref", type: "string", required: false, description: "Asset to post (video or image artifact id)" },
+            { name: "text", type: "string", required: false, description: "Post title (max 280 chars, or 25,000 with X Premium; the confirm sheet asks for it when omitted)" },
+        ],
+        uiAction: "open_post_composer",
+    },
+    {
+        command: "/character",
+        description: "Create a character folder",
+        example: "/character bob",
+        category: "action",
+        icon: "User",
+        size: "default",
+        variant: "pink",
+        chevron: "right",
+        params: [
+            { name: "args", type: "string[]", required: true, description: "Name of the character OR one or more image artifact ids" },
+        ],
+        mcpTool: { tool: "create_character", autoInject: ["book_id"] },
+    },
+    {
+        command: "/crop",
+        description: "Crop video or image to a 16:9, 9:16, or 1:1 region (visually place the box, then re-render)",
+        example: "/crop @a1 9:16",
+        category: "context_menu",
+        icon: "Crop",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Video or image asset to crop" },
+            { name: "ratio", type: "string", required: false, description: "Initial ratio: 16:9 | 9:16 | 1:1" },
+        ],
+        uiAction: "open_crop",
+    },
+    {
+        command: "/invert",
+        description: "In-place inverts an image asset (negates colors)",
+        example: "/invert @a1",
+        category: "context_menu",
+        icon: "ImageOff",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Image asset to invert" },
+        ],
+        mcpTool: { tool: "invert_image", autoInject: ["book_id"] },
+    },
+    {
+        command: "/pad",
+        description: "Add a whole-second video tail with black frames and silence",
+        example: "/pad @a1 2s",
+        category: "context_menu",
+        icon: "SquareSquare",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Video asset to pad" },
+            { name: "padding", type: "string", required: true, description: "Padding duration (e.g. 2s)" },
+        ],
+        mcpTool: { tool: "pad_video", autoInject: ["book_id"] },
+    },
+    {
+        command: "/keywords",
+        description: "Animate transcript keywords in face-safe open space, or omit words for automatic selection",
+        example: "/keywords @a1 Multicultural Revolution Success",
+        category: "action",
+        icon: "Sparkles",
+        size: "default",
+        variant: "violet",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Video asset with a timed transcript" },
+            { name: "inputs", type: "string[]", required: false, description: "Exact transcript words, or: on [max] [linger] | off" },
+        ],
+        mcpTool: { tool: "animate_keywords", adapter: "keywords", autoInject: ["book_id"] },
+    },
+    {
+        command: "/download",
+        description: "Download video from URL",
+        example: "/download https://youtube.com/watch?v=abc123",
+        category: "action",
+        icon: "Download",
+        size: "lg",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "url", type: "string", required: true, description: "Video URL (YouTube, Twitter/X, Instagram, TikTok, etc.)" },
+            { name: "start_time", type: "string", required: false, description: "Requested start time metadata (e.g. '30', '1:30', '2m20s')" },
+            { name: "end_time", type: "string", required: false, description: "Requested end time metadata (e.g. '60', '2:00', '3m')" },
+            { name: "full", type: "boolean", required: false, description: "Deprecated; downloads are always full" },
+        ],
+        mcpTool: { tool: "download_video", autoInject: ["book_id"] },
+    },
+    {
+        command: "/upload",
+        description: "Upload a file",
+        example: "/upload",
+        category: "action",
+        icon: "Upload",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [],
+        uiAction: "open_upload",
+    },
+    {
+        command: "/inbox",
+        description: "View generations inbox",
+        example: "/inbox",
+        category: "action",
+        icon: "Mailbox",
+        size: "default",
+        variant: "default",
+        chevron: "down",
+        params: [],
+        uiAction: "open_inbox",
+    },
+    {
+        command: "/activity",
+        description: "View project activity log",
+        example: "/activity",
+        category: "action",
+        icon: "History",
+        size: "default",
+        variant: "zinc",
+        chevron: "down",
+        params: [],
+        uiAction: "open_status",
+        aliases: ["/status"],
+    },
+    {
+        command: "/copy",
+        description: "Copy asset name",
+        example: "/copy @hero-intro",
+        category: "context_menu",
+        icon: "ClipboardCopy",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Asset whose name to copy" },
+        ],
+        uiAction: "copy_clipboard",
+    },
+    {
+        command: "/folder",
+        description: "Show asset folder",
+        example: "/folder @a1",
+        category: "context_menu",
+        icon: "FolderOpen",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Asset to open folder for" },
+        ],
+        mcpTool: { tool: "export_asset_file", autoInject: ["book_id"], injectParams: { to: "finder" } },
+    },
+    {
+        command: "/describe",
+        description: "Describe image into a reproduction-ready prompt",
+        example: "/describe @a1",
+        category: "context_menu",
+        icon: "ScanEye",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Image asset to describe" },
+        ],
+        mcpTool: { tool: "describe_image", autoInject: ["book_id"] },
+    },
+    {
+        command: "/suggest-cuts",
+        description: "Suggest video trims for pacing and transitions, using dialogue when available",
+        example: "/suggest-cuts @a1",
+        category: "context_menu",
+        icon: "Scissors",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Video asset to analyze" },
+        ],
+        mcpTool: { tool: "suggest_cuts", autoInject: ["book_id"] },
+    },
+    {
+        command: "/recover",
+        description: "Recover an asset stuck in the failed state (clears the error, keeps the media)",
+        example: "/recover @a1",
+        category: "context_menu",
+        icon: "RotateCcw",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Failed asset to recover" },
+        ],
+        mcpTool: { tool: "recover_asset", autoInject: ["book_id"] },
+    },
+    {
+        command: "/doctor",
+        description: "Diagnose project health across all asset types (broken + stuck assets). Add an asset and 'fix' to restore that asset to its last usable state.",
+        example: "/doctor   ·   /doctor @a1 fix",
+        category: "action",
+        icon: "Stethoscope",
+        size: "default",
+        variant: "emerald",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: false, description: "Asset to diagnose; required to fix (artifact id or grid address such as @a1). Omit for a full project scan." },
+            { name: "fix", type: "boolean", required: false, description: "Restore the asset to its last usable state before the current error. Requires asset_id." },
+        ],
+        mcpTool: { tool: "doctor", autoInject: ["book_id"] },
+    },
+    {
+        command: "/analyze-jokes",
+        description: "Identify the jokes in a clip's transcript, classified by type",
+        example: "/analyze-jokes @a1",
+        category: "context_menu",
+        icon: "Laugh",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Video asset with an ElevenLabs transcript to analyze" },
+        ],
+        mcpTool: { tool: "analyze_jokes", autoInject: ["book_id"] },
+    },
+    {
+        command: "/suggest-sfx",
+        description: "Suggest sound-effect placements for a video",
+        example: "/suggest-sfx @a1",
+        category: "context_menu",
+        icon: "Volume2",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Video asset to analyze" },
+        ],
+        mcpTool: { tool: "suggest_sfx", autoInject: ["book_id"] },
+    },
+    {
+        command: "/apply-sfx",
+        description: "Generate an ElevenLabs sound effect and mix it into a video in place",
+        example: "/apply-sfx @a1 2.5 whoosh fast cinematic transition whoosh",
+        category: "action",
+        icon: "Volume2",
+        size: "default",
+        variant: "emerald",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Video artifact to modify in place" },
+            { name: "timestamp", type: "number", required: true, description: "Seconds into the video where the effect starts" },
+            { name: "type", type: "string", required: true, description: "Short effect type such as whoosh, impact, or ding" },
+            { name: "description", type: "string", required: true, description: "Description of the sound effect to generate" },
+        ],
+        mcpTool: { tool: "apply_sfx", adapter: "apply_sfx", autoInject: ["book_id"] },
+    },
+    {
+        command: "/notebook",
+        description: "Open a project Notebook — a workflow of prompt, image, and video steps. Opens the existing notebook when present; creates 'scratch' by default.",
+        example: "/notebook scratch",
+        category: "action",
+        icon: "NotebookPen",
+        size: "default",
+        variant: "emerald",
+        chevron: "right",
+        params: [
+            { name: "name", type: "string", required: false, description: "Notebook name. Omit to open the current/default notebook, or create 'scratch' if none exist." },
+        ],
+        uiAction: "open_notebook",
+    },
+    {
+        command: "/goal",
+        description: "Build a portrait video in Cinematic or IG Influencer style; choose format, delivery, camera and light before the frame, then review each stage",
+        example: "/goal @a1 as an IG influencer, GRWM morning routine",
+        category: "action",
+        icon: "Wand2",
+        size: "lg",
+        variant: "violet",
+        chevron: "right",
+        params: [{ name: "brief", type: "string", required: false, description: "Mention the character image cells, then describe the video, clip count and duration. Omit to show the current goal." }],
+        uiAction: "start_goal",
+        exposure: "ui",
+    },
+    {
+        command: "/music-video",
+        description: "Open the full-screen music-video editor with a required master soundtrack",
+        example: "/music-video @a1",
+        category: "action",
+        icon: "AudioWaveform",
+        size: "lg",
+        variant: "violet",
+        chevron: "right",
+        params: [
+            { name: "audio_ref", type: "string", required: true, description: "Ready audio artifact or notebook address used as the master soundtrack" },
+        ],
+        uiAction: "open_music_video",
+        exposure: "ui",
+    },
+    {
+        command: "/alive",
+        description: "Open the full-screen alive captions studio: stacked, frame-aware subtitles timed to the vocals",
+        example: "/alive @c4",
+        category: "action",
+        icon: "captions",
+        size: "lg",
+        variant: "emerald",
+        chevron: "right",
+        params: [
+            { name: "asset_ref", type: "string", required: true, description: "Video artifact or notebook address with a timed transcript" },
+        ],
+        uiAction: "open_alive_captions",
+        exposure: "ui",
+    },
+    {
+        command: "/notebooks",
+        description: "List first-class notebooks in the current project",
+        example: "/notebooks",
+        category: "action",
+        icon: "BookOpen",
+        size: "default",
+        variant: "emerald",
+        chevron: "down",
+        params: [],
+        mcpTool: { tool: "list_notebooks", autoInject: ["book_id"] },
+    },
+    {
+        command: "/save",
+        description: "Save the active notebook as a new revision",
+        example: "/save",
+        category: "action",
+        icon: "Save",
+        size: "default",
+        variant: "emerald",
+        chevron: "right",
+        params: [],
+        uiAction: "save_notebook",
+    },
+    {
+        command: "/run",
+        description: "Save and run the active notebook",
+        example: "/run",
+        category: "action",
+        icon: "Play",
+        size: "lg",
+        variant: "emerald",
+        chevron: "right",
+        params: [],
+        uiAction: "run_notebook",
+    },
+    {
+        command: "/prompt-new",
+        description: "Create a reusable prompt entity",
+        example: "/prompt-new hero-portrait cinematic astronaut portrait",
+        category: "action",
+        icon: "MessageSquareText",
+        size: "default",
+        variant: "emerald",
+        chevron: "right",
+        params: [
+            { name: "name", type: "string", required: true, description: "Prompt entity name" },
+            { name: "prompt", type: "string", required: false, description: "Reusable prompt text" },
+        ],
+        mcpTool: { tool: "create_entity", autoInject: ["book_id"], injectParams: { kind: "prompt" } },
+    },
+    {
+        command: "/character-new",
+        description: "Create a reusable Videobook character entity",
+        example: "/character-new luna calm lunar gardener",
+        category: "action",
+        icon: "UserRound",
+        size: "default",
+        variant: "pink",
+        chevron: "right",
+        params: [
+            { name: "name", type: "string", required: true, description: "Character entity name" },
+            { name: "prompt", type: "string", required: false, description: "Reusable character prompt" },
+        ],
+        mcpTool: { tool: "create_entity", autoInject: ["book_id"], injectParams: { kind: "character" } },
+    },
+    {
+        command: "/scene-new",
+        description: "Create a reusable scene entity",
+        example: "/scene-new moon-garden silver greenhouse at night",
+        category: "action",
+        icon: "Film",
+        size: "default",
+        variant: "violet",
+        chevron: "right",
+        params: [
+            { name: "name", type: "string", required: true, description: "Scene entity name" },
+            { name: "prompt", type: "string", required: false, description: "Reusable scene prompt" },
+        ],
+        mcpTool: { tool: "create_entity", autoInject: ["book_id"], injectParams: { kind: "scene" } },
+    },
+    {
+        command: "/entities",
+        description: "Open the reusable entity library",
+        example: "/entities",
+        category: "action",
+        icon: "Library",
+        size: "default",
+        variant: "emerald",
+        chevron: "down",
+        params: [],
+        uiAction: "open_entities",
+    },
+    {
+        command: "/jobs",
+        description: "Open persistent jobs for the current project",
+        example: "/jobs",
+        category: "action",
+        icon: "Activity",
+        size: "default",
+        variant: "zinc",
+        chevron: "down",
+        params: [],
+        uiAction: "open_jobs",
+    },
+    {
+        command: "/revisions",
+        description: "Open forward-only project revision history",
+        example: "/revisions",
+        category: "action",
+        icon: "History",
+        size: "default",
+        variant: "zinc",
+        chevron: "down",
+        params: [],
+        uiAction: "open_revisions",
+    },
+    {
+        command: "/storage",
+        description: "Open DoltLite and content-store diagnostics",
+        example: "/storage",
+        category: "action",
+        icon: "Database",
+        size: "default",
+        variant: "zinc",
+        chevron: "down",
+        params: [],
+        uiAction: "open_diagnostics",
+    },
+    {
+        command: "/sync",
+        description: "Publish pending content-addressed objects",
+        example: "/sync",
+        category: "action",
+        icon: "RefreshCw",
+        size: "default",
+        variant: "zinc",
+        chevron: "right",
+        params: [],
+        mcpTool: { tool: "storage_sync" },
+    },
+    {
+        command: "/providers",
+        description: "Open provider credentials and routing settings",
+        example: "/providers",
+        category: "action",
+        icon: "Settings",
+        size: "default",
+        variant: "zinc",
+        chevron: "down",
+        params: [],
+        uiAction: "open_provider_keys",
+    },
+    {
+        command: "/diagnostics",
+        description: "Open MCP, catalog, CAS, and publication diagnostics",
+        example: "/diagnostics",
+        category: "action",
+        icon: "CircleDot",
+        size: "default",
+        variant: "zinc",
+        chevron: "down",
+        params: [],
+        uiAction: "open_diagnostics",
+    },
+    {
+        command: "/detect-scenes",
+        description: "Run ffmpeg scdet over a video asset and report natural visual break candidates (camera cuts + motion-settle points).",
+        example: "/detect-scenes @a1",
+        category: "context_menu",
+        icon: "Scissors",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "source_asset_id", type: "string", required: true, description: "Video artifact id inside the project" },
+        ],
+        mcpTool: { tool: "detect_scenes", autoInject: ["book_id"] },
+    },
+    {
+        command: "/rename-all",
+        description: "Bulk-rename video/image assets with an explicit dry run: GPT-5.5 proposes descriptive names from each asset's stored context, you edit them in a side-by-side preview, then confirm to apply (updates timeline slots, OSG metadata, and plan/.plan.json references).",
+        example: "/rename-all",
+        category: "action",
+        icon: "Tags",
+        size: "default",
+        variant: "blue",
+        chevron: "right",
+        params: [],
+        uiAction: "open_rename_all",
+    },
+    {
+        command: "/edit-cold-open",
+        description: "Review an AI-selected highlight, then create a copy with the highlight followed by the full original clip",
+        example: "/edit-cold-open @a1",
+        category: "viewer",
+        icon: "Scissors",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [{ name: "asset_ref", type: "string", required: false, description: "Source video; defaults to the selected video" }],
+        uiAction: "open_cold_open",
+        exposure: "composite",
+    },
+    {
+        command: "/upload-post-to-dropbox",
+        description: "Review a Post's clip, caption and destination folder, then upload them to a private Dropbox folder",
+        example: "/upload-post-to-dropbox @b1",
+        category: "action",
+        icon: "Upload",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [{ name: "post_ref", type: "string", required: false, description: "Post cell; defaults to the selected Post" }],
+        uiAction: "open_post_dropbox",
+        exposure: "composite",
+    },
+    {
+        command: "/save-post-to-icloud",
+        description: "Review a Post's clip and caption, then save them to the shared iCloud Drive Videobook folder so they appear on iPhone",
+        example: "/save-post-to-icloud @b1",
+        category: "action",
+        icon: "Upload",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [{ name: "post_ref", type: "string", required: false, description: "Post cell; defaults to the selected Post" }],
+        uiAction: "open_post_icloud",
+        exposure: "composite",
+    },
+    {
+        command: "/watermark",
+        description: "Open the chat watermark review with a positioned QR plus a centered floating handle, live preview, and timing controls",
+        example: "/watermark @a1",
+        category: "viewer",
+        icon: "QrCode",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_ref", type: "string", required: false, description: "Video to watermark (video artifact id); defaults to the open clip" },
+        ],
+        uiAction: "open_watermark",
+        exposure: "composite",
+    },
+    {
+        command: "/qart",
+        description: "Create scan-safe color and monochrome QR mosaics from an image source",
+        example: "/qart @a1 https://example.com",
+        category: "action",
+        icon: "QrCode",
+        size: "default",
+        variant: "amber",
+        chevron: "right",
+        params: [
+            { name: "image_ref", type: "string", required: true, description: "Cover image artifact id" },
+            { name: "value", type: "string", required: true, description: "URL or text to encode in the QR" },
+        ],
+        mcpTool: { tool: "create_qart", autoInject: ["book_id"] },
+    },
+    {
+        command: "/qrbtf",
+        description: "Generate a parametric QR code in an artistic style (normal, line, dsj, bubble, func)",
+        example: "/qrbtf https://example.com normal",
+        category: "action",
+        icon: "QrCode",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "value", type: "string", required: true, description: "URL or text to encode in the QR" },
+            { name: "style", type: "string", required: false, description: "QR style: normal, line, dsj, bubble, or func (default: normal)" },
+        ],
+        mcpTool: { tool: "create_qrbtf", adapter: "qrbtf", autoInject: ["book_id"] },
+    },
+    {
+        command: "/outroqr",
+        description: "Generate a 10-second animated QR outro with bundled impact sound",
+        example: "/outroqr @a1 @a2 16:9",
+        category: "action",
+        icon: "QrCode",
+        size: "default",
+        variant: "amber",
+        chevron: "right",
+        params: [
+            { name: "inputs", type: "string[]", required: true, description: "1-4 QR images and an optional aspect ratio" },
+        ],
+        mcpTool: {
+            tool: "create_qr_outro",
+            adapter: "qr_outro",
+            autoInject: ["book_id"],
+            injectParams: { duration_seconds: 10, include_audio: true },
+        },
+    },
+    {
+        command: "/concat",
+        description: "Compose one or two image assets into a 16:9 two-slot sheet; omit the second image to leave an empty cell",
+        example: "/concat @a1 @a2",
+        category: "action",
+        icon: "Images",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "image_refs", type: "string[]", required: true, description: "One or two image artifact ids; one leaves the second slot empty" },
+        ],
+        mcpTool: { tool: "concat_images", autoInject: ["book_id"] },
+    },
+    {
+        command: "/rewrite-script",
+        description: "Rewrite a script asset in place with the full describe model",
+        example: "/rewrite-script @a1",
+        category: "context_menu",
+        icon: "RefreshCw",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Script asset to rewrite" },
+            { name: "platform", type: "string", required: false, description: "Platform preset: ig | tiktok | youtube" },
+            { name: "custom_prompt", type: "string", required: false, description: "Optional transformation instruction" },
+        ],
+        mcpTool: { tool: "rewrite_script", adapter: "rewrite_script", autoInject: ["book_id"], injectParams: { variant: "full" } },
+    },
+    {
+        command: "/tldr",
+        description: "Rewrite a script asset in place as a 1–2 sentence TLDR",
+        example: "/tldr @a1",
+        category: "context_menu",
+        icon: "Zap",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Script asset to rewrite" },
+            { name: "platform", type: "string", required: false, description: "Platform preset: ig | tiktok | youtube" },
+            { name: "custom_prompt", type: "string", required: false, description: "Optional transformation instruction" },
+        ],
+        mcpTool: { tool: "rewrite_script", adapter: "rewrite_script", autoInject: ["book_id"], injectParams: { variant: "tldr" } },
+    },
+    {
+        command: "/copy-media",
+        description: "Copy an asset's primary media file to the clipboard",
+        example: "/copy-media @hero-intro",
+        category: "context_menu",
+        icon: "ClipboardCopy",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Asset to copy to clipboard" },
+        ],
+        mcpTool: { tool: "export_asset_file", autoInject: ["book_id"], injectParams: { to: "clipboard" } },
+        aliases: ["/copy-video"],
+    },
+    {
+        command: "/export",
+        description: "Export asset to Downloads folder",
+        example: "/export @hero-intro",
+        category: "context_menu",
+        icon: "Download",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Asset to export" },
+        ],
+        mcpTool: { tool: "export_asset_file", autoInject: ["book_id"], injectParams: { to: "downloads" } },
+    },
+    {
+        command: "/duplicate",
+        description: "Duplicate an asset into an optional notebook destination",
+        example: "/duplicate @a1 @b1",
+        category: "context_menu",
+        icon: "Copy",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Asset to duplicate" },
+            { name: "new_name", type: "string", required: false, description: "Optional name for the copy", consumeRest: true },
+            { name: "destination", type: "string", required: false, description: "Optional empty destination cell from a1 through bl8" },
+        ],
+        mcpTool: {
+            tool: "duplicate_asset",
+            adapter: "duplicate",
+            autoInject: ["book_id", "notebook_id"],
+        },
+    },
+    {
+        command: "/arrange-videos-column",
+        description: "Stack all video cells into the current column starting at the selected cell; cells in the way move to free slots",
+        example: "/arrange-videos-column",
+        category: "action",
+        icon: "Columns3",
+        size: "default",
+        variant: "blue",
+        chevron: "right",
+        params: [],
+        exposure: "composite",
+    },
+    {
+        command: "/arrange-videos-row",
+        description: "Line up all video cells across the current row starting at the selected cell; cells in the way move to free slots",
+        example: "/arrange-videos-row",
+        category: "action",
+        icon: "Rows3",
+        size: "default",
+        variant: "emerald",
+        chevron: "right",
+        params: [],
+        exposure: "composite",
+    },
+    {
+        command: "/group-images",
+        description: "Gather all image cells into horizontal lines starting at the selected cell, wrapping onto the next row at the grid edge; cells in the way move to free slots",
+        example: "/group-images",
+        category: "action",
+        icon: "Images",
+        size: "default",
+        variant: "violet",
+        chevron: "right",
+        params: [],
+        exposure: "composite",
+    },
+    {
+        command: "/history",
+        description: "View asset version history",
+        example: "/history @hero-intro",
+        category: "context_menu",
+        icon: "History",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Asset to view history for" },
+        ],
+        uiAction: "show_history",
+    },
+    {
+        command: "/open",
+        description: "Open asset in viewer",
+        example: "/open @hero-intro",
+        category: "context_menu",
+        icon: "Eye",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Asset to open" },
+        ],
+        uiAction: "open_asset",
+    },
+    {
+        command: "/delete",
+        description: "Delete an asset",
+        example: "/delete @outro-clip",
+        category: "context_menu",
+        icon: "Trash2",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Asset to delete" },
+        ],
+        mcpTool: { tool: "delete_asset", autoInject: ["book_id"] },
+    },
+    {
+        command: "/rename",
+        description: "Rename an asset",
+        example: "/rename @a1 product-hero",
+        category: "context_menu",
+        icon: "Pencil",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Asset to rename" },
+            { name: "new_name", type: "string", required: true, description: "New display name" },
+        ],
+        mcpTool: { tool: "rename_asset", autoInject: ["book_id"] },
+    },
+    {
+        command: "/inject-first-frame",
+        description: "Replace frame zero of a video or final output with an image while preserving audio and timing",
+        example: "/inject-first-frame @a1 @a2",
+        category: "context_menu",
+        icon: "ImagePlus",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "target_asset_id", type: "string", required: true, description: "Target video artifact id or final" },
+            { name: "image_asset_id", type: "string", required: true, description: "Source image artifact id" },
+            { name: "orientation", type: "string", required: false, description: "For final: landscape, portrait, or square" },
+        ],
+        mcpTool: { tool: "inject_first_frame", autoInject: ["book_id"] },
+    },
+    {
+        command: "/extract-first-frame",
+        description: "Extract first frame from video as image asset",
+        example: "/extract-first-frame @a1",
+        category: "context_menu",
+        icon: "Image",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Video asset to extract from" },
+        ],
+        mcpTool: { tool: "extract_frame", autoInject: ["book_id"], injectParams: { frame: "first" } },
+    },
+    {
+        command: "/extract-last-frame",
+        description: "Extract last frame from video as image asset",
+        example: "/extract-last-frame @a1",
+        category: "context_menu",
+        icon: "Image",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Video asset to extract from" },
+        ],
+        mcpTool: { tool: "extract_frame", autoInject: ["book_id"], injectParams: { frame: "last" } },
+    },
+    {
+        command: "/extract-audio",
+        description: "Extract audio track from video as audio asset (MP3)",
+        example: "/extract-audio @a1",
+        category: "context_menu",
+        icon: "Music",
+        size: "default",
+        variant: "emerald",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Video asset to extract from" },
+        ],
+        mcpTool: { tool: "extract_audio", autoInject: ["book_id"] },
+    },
+    {
+        command: "/make-cover-song",
+        description: "Generate a rhythm-and-style-guided drums-and-strings cover with the source media's exact duration",
+        example: "/make-cover-song @a1 punchier drums and sweeping strings",
+        category: "context_menu",
+        icon: "AudioLines",
+        size: "default",
+        variant: "emerald",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Video or audio asset whose song rhythm and duration to follow" },
+            { name: "direction", type: "string", required: false, description: "Optional musical direction; defaults to instrumental drums and strings" },
+        ],
+        mcpTool: { tool: "make_cover_song", autoInject: ["book_id"] },
+        aliases: ["/replicate-song"],
+    },
+    {
+        command: "/archive",
+        description: "Archive a full video or audio asset to the global clip archive and transcribe it",
+        example: "/archive @a1 ai interview",
+        category: "context_menu",
+        icon: "Archive",
+        size: "default",
+        variant: "amber",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Video or audio asset to archive" },
+            { name: "topics", type: "string[]", required: false, description: "Optional search topic tokens to attach" },
+        ],
+        mcpTool: { tool: "archive_clip", autoInject: ["book_id"] },
+    },
+    {
+        command: "/extend-audio",
+        description: "Extend an audio asset to a longer total duration with a matching ElevenLabs continuation, creating a new audio asset",
+        example: "/extend-audio @a1 15 add outro music",
+        category: "context_menu",
+        icon: "AudioLines",
+        size: "default",
+        variant: "emerald",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Source audio artifact id" },
+            { name: "target_duration_seconds", type: "number", required: true, description: "Requested total duration in seconds" },
+            { name: "continuation_prompt", type: "string", required: false, description: "Optional free-text direction for the continuation, e.g. add outro music" },
+        ],
+        mcpTool: { tool: "extend_audio_asset", autoInject: ["book_id"] },
+    },
+    {
+        command: "/remove-sound",
+        description: "Remove a described sound from a video or audio asset in place by silencing its Scribe-tagged audio events",
+        example: "/remove-sound @a1 horse neighing",
+        category: "context_menu",
+        icon: "VolumeX",
+        size: "default",
+        variant: "emerald",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Asset to edit in-place (video or audio artifact id)" },
+            { name: "sound", type: "string", required: true, description: "Sound to remove, e.g. horse neighing" },
+        ],
+        mcpTool: { tool: "remove_sound", autoInject: ["book_id"] },
+    },
+    {
+        command: "/audio-boost",
+        description: "Boost audio volume of a video or audio asset (linear multiplier, 1.0–4.0). In-place with git versioning.",
+        example: "/audio-boost @a1 2",
+        category: "context_menu",
+        icon: "Volume2",
+        size: "default",
+        variant: "emerald",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Asset to boost (video or audio artifact id)" },
+            { name: "boost", type: "number", required: true, description: "Volume multiplier (1.0–4.0). >1 = louder." },
+        ],
+        mcpTool: { tool: "audio_boost", autoInject: ["book_id"] },
+    },
+    {
+        command: "/audio-mix",
+        description: "Mix a video or audio asset onto another at a lower volume, editing the target in-place.",
+        example: "/audio-mix @a1 @a2 30",
+        category: "context_menu",
+        icon: "AudioLines",
+        size: "default",
+        variant: "emerald",
+        chevron: "right",
+        params: [
+            { name: "target_asset_id", type: "string", required: true, description: "Asset to edit in-place (video or audio artifact id)" },
+            { name: "layer_asset_id", type: "string", required: true, description: "Asset whose audio is layered on (video or audio artifact id)" },
+            { name: "volume", type: "number", required: true, description: "Layer volume percentage (0-100)" },
+        ],
+        mcpTool: { tool: "audio_mix", autoInject: ["book_id"] },
+    },
+    {
+        command: "/replace-audio",
+        description: "Replace the audio track of a video asset with an audio asset's audio",
+        example: "/replace-audio @a1 @a2",
+        category: "context_menu",
+        icon: "Music",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Video asset whose audio is being replaced" },
+            { name: "audio_asset_id", type: "string", required: true, description: "Audio asset providing the new audio track" },
+        ],
+        mcpTool: { tool: "replace_video_audio", autoInject: ["book_id"] },
+    },
+    {
+        command: "/splice",
+        description: "Splice videos with an overlap window; use 0 to concatenate complete clips",
+        example: "/splice @a1 @a2 0",
+        category: "context_menu",
+        icon: "GitMerge",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "first_asset_id", type: "string", required: true, description: "Base video — search for the match point inside this one" },
+            { name: "second_asset_id", type: "string", required: true, description: "Continuation video — its first frame is the search target" },
+            { name: "overlap", type: "number", required: true, description: "Possible overlap in seconds; 0 means plain concatenation" },
+        ],
+        mcpTool: { tool: "splice_video", autoInject: ["book_id"] },
+    },
+    {
+        command: "/scene-concat",
+        description: "Smoothly join two video scenes, automatically aligning shared boundary audio",
+        example: "/scene-concat @a1 @a2",
+        category: "context_menu",
+        icon: "GitMerge",
+        size: "default",
+        variant: "violet",
+        chevron: "right",
+        params: [
+            { name: "first_asset_id", type: "string", required: true, description: "First video in playback order" },
+            { name: "second_asset_id", type: "string", required: true, description: "Second video in playback order" },
+            { name: "transition_seconds", type: "number", required: false, description: "Optional fixed crossfade duration; omit for automatic audio alignment" },
+        ],
+        mcpTool: { tool: "smooth_scene_concat", autoInject: ["book_id"] },
+    },
+    {
+        command: "/assign",
+        description: "Assign asset to timeline slot",
+        example: "/assign @a1 @s02",
+        category: "action",
+        icon: "LayoutGrid",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Asset to assign" },
+            { name: "slot", type: "string", required: true, description: "Timeline slot (e.g. @s01)" },
+        ],
+        mcpTool: { tool: "assign_slot", autoInject: ["book_id"] },
+    },
+    {
+        command: "/remove-slot",
+        description: "Remove a timeline slot and shift later slots left",
+        example: "/remove-slot @s02",
+        category: "action",
+        icon: "Scissors",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "slot", type: "string", required: true, description: "Stored timeline slot (e.g. @s01)" },
+        ],
+        mcpTool: { tool: "remove_timeline_slot", autoInject: ["book_id"] },
+        aliases: ["/unassign"],
+    },
+    {
+        command: "/rewrite",
+        description: "Optimize a prompt",
+        example: '/rewrite "make it more cinematic"',
+        category: "action",
+        icon: "Sparkles",
+        size: "sm",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "prompt", type: "string", required: true, description: "The prompt to rewrite" },
+        ],
+        mcpTool: { tool: "rewrite_prompt", autoInject: ["book_id"] },
+    },
+    {
+        command: "/clean-audio",
+        description: "Clean a video's audio in place with ElevenLabs while preserving vocals and key sound effects",
+        example: "/clean-audio @a1 true",
+        category: "action",
+        icon: "AudioLines",
+        size: "default",
+        variant: "emerald",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Video artifact to clean in place" },
+            { name: "add_light_music", type: "boolean", required: false, description: "Set true to add a light instrumental music bed" },
+        ],
+        mcpTool: { tool: "clean_video_audio", autoInject: ["book_id"] },
+    },
+    {
+        command: "/vocals",
+        description: "Isolate vocals from audio",
+        example: "/vocals @voiceover-main",
+        category: "action",
+        icon: "Mic",
+        size: "default",
+        variant: "emerald",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Asset to isolate vocals from" },
+        ],
+        mcpTool: { tool: "isolate_vocals", autoInject: ["book_id"] },
+    },
+    {
+        command: "/transcribe",
+        description: "Transcribe audio using ElevenLabs",
+        example: "/transcribe @a1",
+        category: "action",
+        icon: "Mic",
+        size: "default",
+        variant: "violet",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Video or audio asset to transcribe" },
+        ],
+        mcpTool: { tool: "transcribe", autoInject: ["book_id"] },
+    },
+    {
+        command: "/subs",
+        description: "Subtitle settings",
+        example: "/subs position top",
+        category: "viewer",
+        icon: "captions",
+        size: "sm",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "field", type: "string", required: true, description: "on|off|enabled|style|position|size|fontSize|color|textColor|highlight|highlightColor|stroke|strokeWidth|strokeColor|shadow|shadowBlur|shadowOpacity|language" },
+            { name: "value", type: "string", required: false, description: "Value for the field" },
+        ],
+        uiAction: "settings_subs",
+    },
+    {
+        command: "/bg",
+        description: "Background mode",
+        example: "/bg blur",
+        category: "viewer",
+        icon: "image",
+        size: "sm",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "mode", type: "string", required: true, description: "blur|black" },
+        ],
+        uiAction: "settings_bg",
+    },
+    {
+        command: "/original",
+        description: "Show original uncropped image",
+        category: "viewer",
+        icon: "image",
+        size: "sm",
+        variant: "default",
+        chevron: "right",
+        params: [],
+        uiAction: "viewer_set_original",
+    },
+    {
+        command: "/landscape",
+        description: "Show landscape crop (1920x1080)",
+        category: "viewer",
+        icon: "monitor",
+        size: "sm",
+        variant: "default",
+        chevron: "right",
+        params: [],
+        uiAction: "viewer_set_landscape",
+    },
+    {
+        command: "/portrait",
+        description: "Show portrait crop (1080x1920)",
+        category: "viewer",
+        icon: "smartphone",
+        size: "sm",
+        variant: "default",
+        chevron: "right",
+        params: [],
+        uiAction: "viewer_set_portrait",
+    },
+    {
+        command: "/info",
+        description: "Show asset metadata",
+        category: "viewer",
+        icon: "info",
+        size: "sm",
+        variant: "default",
+        chevron: "right",
+        params: [],
+        uiAction: "viewer_toggle_info",
+    },
+    {
+        command: "/settings",
+        description: "Show render settings",
+        category: "viewer",
+        icon: "settings",
+        size: "sm",
+        variant: "default",
+        chevron: "right",
+        params: [],
+        uiAction: "viewer_show_settings",
+    },
+    {
+        command: "/settings-landscape",
+        description: "Settings for landscape orientation",
+        category: "viewer",
+        icon: "monitor",
+        size: "sm",
+        variant: "default",
+        chevron: "right",
+        params: [],
+        uiAction: "settings_landscape",
+    },
+    {
+        command: "/settings-portrait",
+        description: "Settings for portrait orientation",
+        category: "viewer",
+        icon: "smartphone",
+        size: "sm",
+        variant: "default",
+        chevron: "right",
+        params: [],
+        uiAction: "settings_portrait",
+    },
+    {
+        command: "/settings-square",
+        description: "Settings for square orientation",
+        category: "viewer",
+        icon: "square",
+        size: "sm",
+        variant: "default",
+        chevron: "right",
+        params: [],
+        uiAction: "settings_square",
+    },
+    {
+        command: "/files",
+        description: "Focus file by position",
+        example: "/files 3",
+        category: "viewer",
+        icon: "file",
+        size: "sm",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "position", type: "number", required: true, description: "1-based file position" },
+        ],
+        uiAction: "viewer_focus_file",
+    },
+    // ── Book management commands ──
+    {
+        command: "/books",
+        description: "Open the book selector dropdown",
+        example: "/books",
+        category: "project",
+        icon: "FolderOpen",
+        size: "default",
+        variant: "zinc",
+        chevron: "down",
+        params: [],
+        uiAction: "open_projects",
+    },
+    // ── Layout / navigation commands ──
+    {
+        command: "/close",
+        description: "Close the active viewer, panel, or browser and return to the idle screen",
+        example: "/close",
+        category: "action",
+        icon: "X",
+        size: "sm",
+        variant: "zinc",
+        chevron: "right",
+        params: [],
+        uiAction: "close_viewer",
+    },
+    {
+        command: "/collapse",
+        description: "Close the project selector (left), chat controls (right), or both",
+        example: "/collapse left",
+        category: "action",
+        icon: "PanelLeftClose",
+        size: "sm",
+        variant: "zinc",
+        chevron: "right",
+        params: [
+            { name: "side", type: "string", required: false, description: "left | right | both (default both)" },
+        ],
+        uiAction: "sidebar_collapse",
+    },
+    {
+        command: "/expand",
+        description: "Open the project selector (left), chat controls (right), or both",
+        example: "/expand right",
+        category: "action",
+        icon: "PanelLeftOpen",
+        size: "sm",
+        variant: "zinc",
+        chevron: "right",
+        params: [
+            { name: "side", type: "string", required: false, description: "left | right | both (default both)" },
+        ],
+        uiAction: "sidebar_expand",
+    },
+    {
+        command: "/sort",
+        description: "Browse project media by creation date",
+        example: "/sort oldest",
+        category: "action",
+        icon: "ArrowUpDown",
+        size: "sm",
+        variant: "zinc",
+        chevron: "right",
+        params: [
+            { name: "order", type: "string", required: false, description: "newest | oldest (default newest)" },
+        ],
+        uiAction: "sidebar_sort",
+    },
+    {
+        command: "/keys",
+        description: "Open the provider API keys / settings screen",
+        example: "/keys",
+        category: "action",
+        icon: "KeyRound",
+        size: "default",
+        variant: "zinc",
+        chevron: "down",
+        params: [],
+        uiAction: "open_provider_keys",
+    },
+    {
+        command: "/archive-browse",
+        description: "Open the clip archive browser, optionally with an initial search",
+        example: "/archive-browse interview",
+        category: "action",
+        icon: "ArchiveRestore",
+        size: "default",
+        variant: "amber",
+        chevron: "down",
+        params: [
+            { name: "query", type: "string", required: false, description: "Initial search query" },
+        ],
+        uiAction: "open_archive",
+    },
+    // ── Timeline audio lane commands ──
+    {
+        command: "/audio-add",
+        description: "Add an audio asset to the timeline audio lane (times in seconds)",
+        example: "/audio-add @a1 2 10",
+        category: "action",
+        icon: "AudioLines",
+        size: "default",
+        variant: "emerald",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Audio artifact id" },
+            { name: "start", type: "number", required: false, description: "Start position in seconds (default 0)" },
+            { name: "duration", type: "number", required: false, description: "Duration in seconds (default full clip)" },
+        ],
+        uiAction: "timeline_audio_add",
+    },
+    {
+        command: "/audio-move",
+        description: "Move a timeline audio clip to a new start position (seconds)",
+        example: "/audio-move @a1 5",
+        category: "action",
+        icon: "AudioLines",
+        size: "default",
+        variant: "emerald",
+        chevron: "right",
+        params: [
+            { name: "audio_ref", type: "string", required: true, description: "Timeline audio clip (audio artifact id or clip id)" },
+            { name: "start", type: "number", required: true, description: "New start position in seconds" },
+        ],
+        uiAction: "timeline_audio_move",
+    },
+    {
+        command: "/audio-remove",
+        description: "Remove an audio clip from the timeline audio lane",
+        example: "/audio-remove @a1",
+        category: "action",
+        icon: "AudioLines",
+        size: "default",
+        variant: "emerald",
+        chevron: "right",
+        params: [
+            { name: "audio_ref", type: "string", required: true, description: "Timeline audio clip (audio artifact id or clip id)" },
+        ],
+        uiAction: "timeline_audio_remove",
+    },
+    {
+        command: "/audio-set",
+        description: "Update a timeline audio clip: volume (0-100), fade-in or fade-out (ms)",
+        example: "/audio-set @a1 volume 80",
+        category: "action",
+        icon: "AudioLines",
+        size: "default",
+        variant: "emerald",
+        chevron: "right",
+        params: [
+            { name: "audio_ref", type: "string", required: true, description: "Timeline audio clip (audio artifact id or clip id)" },
+            { name: "field", type: "string", required: true, description: "volume | fade-in | fade-out" },
+            { name: "value", type: "number", required: true, description: "volume 0-100, fades in ms" },
+        ],
+        uiAction: "timeline_audio_update",
+    },
+    // ── Video op commands ──
+    {
+        command: "/reverse",
+        description: "Reverse video playback (play backwards)",
+        example: "/reverse @a1",
+        category: "context_menu",
+        icon: "Rewind",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Video asset to reverse" },
+        ],
+        mcpTool: { tool: "reverse_video", autoInject: ["book_id"] },
+    },
+    {
+        command: "/speed",
+        description: "Change video playback speed (0.25-4.0x) or exact duration (e.g. 8.32s)",
+        example: "/speed @a1 8.32s",
+        category: "context_menu",
+        icon: "Gauge",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Video asset to retime" },
+            { name: "speed", type: "string", required: true, description: "Speed multiplier (2) or target duration (8.32s)" },
+        ],
+        mcpTool: { tool: "change_video_speed", adapter: "change_speed", autoInject: ["book_id"] },
+    },
+    {
+        command: "/timewarp",
+        description: "Retime one scene while compensating the rest of the picture and preserving the original audio and duration",
+        example: "/timewarp @a1 0-4.2s 1.5x",
+        category: "context_menu",
+        icon: "Gauge",
+        size: "default",
+        variant: "violet",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Video asset to timewarp" },
+            { name: "range", type: "string", required: true, description: "Selected range as start-end" },
+            { name: "factor", type: "string", required: true, description: "Duration multiplier from 0.25x to 4x" },
+        ],
+        mcpTool: { tool: "timewarp_video", adapter: "timewarp", autoInject: ["book_id"] },
+    },
+    {
+        command: "/sync-audio",
+        description: "Smoothly retime video action to match fixed original-audio cues at multiple anchors",
+        example: "/sync-audio @a1 3s=England; 6s=America",
+        category: "context_menu",
+        icon: "Gauge",
+        size: "default",
+        variant: "violet",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Video asset to synchronize" },
+            { name: "mappings", type: "string", required: true, description: "Semicolon-separated video-time=audio-cue-or-time anchors" },
+        ],
+        mcpTool: { tool: "sync_video_to_audio", adapter: "sync_audio", autoInject: ["book_id"] },
+    },
+    {
+        command: "/split",
+        description: "Open the interactive splitter for a notebook video, optionally seeded with cut times",
+        example: "/split @a1 at 15s, 28.5s",
+        category: "action",
+        icon: "Scissors",
+        size: "default",
+        variant: "violet",
+        chevron: "right",
+        params: [
+            { name: "cell", type: "string", required: true, description: "Notebook video cell to split (grid address such as @a1)" },
+            { name: "split_spec", type: "string", required: false, description: "Optional comma-separated cut times; defaults to the midpoint" },
+        ],
+        exposure: "composite",
+    },
+    {
+        command: "/split-clip",
+        description: "Split a canonical-sequence clip at an exact sequence frame",
+        example: "/split-clip @clip-id 45",
+        category: "action",
+        icon: "Scissors",
+        size: "default",
+        variant: "violet",
+        chevron: "right",
+        params: [
+            { name: "clip_id", type: "string", required: true, description: "Canonical-sequence clip ID" },
+            { name: "sequence_frame", type: "number", required: true, description: "Frame where the clip should split" },
+        ],
+        exposure: "composite",
+    },
+    {
+        command: "/export-to",
+        description: "Export an asset into a different project",
+        example: "/export-to @a1 other-project",
+        category: "context_menu",
+        icon: "FolderOutput",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Asset to export" },
+            { name: "target_project", type: "string", required: true, description: "Target book name" },
+            { name: "new_name", type: "string", required: false, description: "Optional name for the exported asset" },
+        ],
+        mcpTool: { tool: "export_asset_to_project", autoInject: ["book_id"] },
+    },
+    {
+        command: "/skeleton",
+        description: "Review an AI pose skeleton guide generated from a reference image",
+        example: "/skeleton @a1",
+        category: "context_menu",
+        icon: "PersonStanding",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "asset_id", type: "string", required: true, description: "Image artifact id" },
+        ],
+        uiAction: "extract_skeleton",
+    },
+    {
+        command: "/archive-restore",
+        description: "Restore archived clips into the current project by archive ID",
+        example: "/archive-restore arc-abc123 arc-def456",
+        category: "action",
+        icon: "ArchiveRestore",
+        size: "default",
+        variant: "amber",
+        chevron: "right",
+        params: [
+            { name: "archive_ids", type: "string[]", required: true, description: "One or more archive IDs to restore" },
+        ],
+        mcpTool: { tool: "restore_archive_clips", autoInject: ["book_id"] },
+    },
+    // ── Activity commands ──
+    {
+        command: "/rewind",
+        description: "Rewind the project to a previous commit (no hash opens the activity log to pick one)",
+        example: "/rewind 4f3a2b1",
+        category: "action",
+        icon: "History",
+        size: "default",
+        variant: "zinc",
+        chevron: "right",
+        params: [
+            { name: "commit_hash", type: "string", required: false, description: "Git commit hash or unique prefix (min 7 chars) from /activity (omit to browse)" },
+        ],
+        uiAction: "rewind_activity",
+    },
+    {
+        command: "/clear-failed",
+        description: "Clean up failed work: delete failed-generation husks and clear error badges from assets that already have media",
+        example: "/clear-failed",
+        category: "action",
+        icon: "Trash2",
+        size: "default",
+        variant: "zinc",
+        chevron: "right",
+        params: [],
+        mcpTool: { tool: "clean_failed_assets", autoInject: ["book_id"] },
+    },
+    // ── Character / voice commands ──
+    {
+        command: "/voices",
+        description: "Browse ElevenLabs voices in the speak preview",
+        example: "/voices",
+        category: "action",
+        icon: "Mic",
+        size: "default",
+        variant: "pink",
+        chevron: "down",
+        params: [],
+        uiAction: "speak_preview",
+    },
+    {
+        command: "/say",
+        description: "Generate speech audio from text with ElevenLabs",
+        example: "/say welcome back everyone",
+        category: "context_menu",
+        icon: "Mic",
+        size: "default",
+        variant: "pink",
+        chevron: "right",
+        params: [
+            { name: "prompt", type: "string", required: true, description: "Text to speak" },
+        ],
+        mcpTool: { tool: "generate_audio", autoInject: ["book_id"], injectParams: { model: "kie:elevenlabs/text-to-speech-turbo-2-5" } },
+    },
+    {
+        command: "/speak",
+        description: "Generate ElevenLabs speech into the notebook from the inline voice preview",
+        example: "/speak welcome back everyone",
+        category: "action",
+        icon: "Mic",
+        size: "default",
+        variant: "pink",
+        chevron: "right",
+        params: [{ name: "text", type: "string", required: false, description: "Text to synthesize" }],
+        uiAction: "speak_preview",
+    },
+    // ── X connect command ──
+    {
+        command: "/connect-x",
+        description: "Connect your X (Twitter) account via browser OAuth",
+        example: "/connect-x",
+        category: "action",
+        icon: "Share2",
+        size: "default",
+        variant: "blue",
+        chevron: "right",
+        params: [],
+        uiAction: "x_connect",
+    },
+    // ── Timeline player command ──
+    {
+        command: "/play",
+        description: "Open the timeline player at a slot (default: first filled slot)",
+        example: "/play @s02",
+        category: "action",
+        icon: "Play",
+        size: "default",
+        variant: "default",
+        chevron: "right",
+        params: [
+            { name: "slot", type: "string", required: false, description: "Timeline slot (e.g. @s01)" },
+        ],
+        uiAction: "open_slot_player",
+    },
+];
+export function getCanonicalCommands() {
+    return canonicalizeCommands([...CANONICAL_COMMANDS, ...APPLICATION_COMMANDS]);
+}
+function commandSummary(command) {
+    return {
+        command: command.command,
+        description: command.description,
+        ...(command.aliases?.length ? { aliases: command.aliases } : {}),
+        ...(command.mcpTool ? { runs: `tool:${command.mcpTool.tool}` } : command.uiAction ? { runs: `ui:${command.uiAction}` } : {}),
+    };
+}
+export function commandsDef(books = bookManager, reservedActionNames = () => []) {
+    return {
+        name: "slash_commands",
+        description: "List the UI slash commands as command, description, aliases and the tool or UI action each runs; detail full returns the complete records the app renders (params, examples, icons).",
+        scope: "global",
+        schema: {
+            detail: z.enum(["summary", "full"]).optional(),
+        },
+        handler: async (args) => {
+            const commands = [...CANONICAL_COMMANDS, ...APPLICATION_COMMANDS];
+            const reserved = new Set([...commands.flatMap((command) => [command.command, ...(command.aliases ?? [])]), ...reservedActionNames()]
+                .map((name) => name.toLowerCase()));
+            await books.ready();
+            for (const book of books.list()) {
+                if (reserved.has(`/${book.name}`.toLowerCase()))
+                    continue;
+                commands.push({
+                    command: `/${book.name}`,
+                    description: `Switch to book ${book.name}`,
+                    category: "project",
+                    icon: "FolderOpen",
+                    size: "default",
+                    variant: "default",
+                    chevron: "down",
+                    params: [],
+                    uiAction: "switch_book",
+                });
+            }
+            const canonical = canonicalizeCommands(commands);
+            const payload = args.detail === "full" ? canonical : canonical.map(commandSummary);
+            return {
+                content: [{ type: "text", text: JSON.stringify(payload) }],
+            };
+        },
+    };
+}