tool-schemas.json

{
  "generatedAt": "2026-04-21T11:13:20.013Z",
  "toolCount": 60,
  "agentCount": 11,
  "agents": {
    "canvasManager": 4,
    "composer": 2,
    "contentManager": 5,
    "elevenlabs": 4,
    "ingestManager": 2,
    "memoryManager": 9,
    "promptManager": 9,
    "searchManager": 3,
    "storageManager": 6,
    "taskManager": 11,
    "webTools": 5
  },
  "tools": [
    {
      "agent": "canvasManager",
      "tool": "list",
      "description": "List canvas files in the vault with node/edge counts",
      "command": "canvas list",
      "usage": "canvas list [--folder <folder>] [--recursive]",
      "arguments": [
        {
          "name": "folder",
          "flag": "--folder",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Folder to search (default: vault root). Example: \"projects/diagrams\" (string)"
        },
        {
          "name": "recursive",
          "flag": "--recursive",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Search subfolders (default: true) (boolean)"
        }
      ],
      "examples": [
        "canvas list --folder \"folder-value\""
      ]
    },
    {
      "agent": "canvasManager",
      "tool": "read",
      "description": "Read the structure of a canvas file (nodes and edges)",
      "command": "canvas read",
      "usage": "canvas read <path>",
      "arguments": [
        {
          "name": "path",
          "flag": "--path",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Path to the canvas file (with or without .canvas extension) (string)"
        }
      ],
      "examples": [
        "canvas read \"path-value\""
      ]
    },
    {
      "agent": "canvasManager",
      "tool": "update",
      "description": "Modify an EXISTING canvas file. Replaces nodes and/or edges arrays. Fails if canvas does not exist - use canvasManager.write to create new canvases.",
      "command": "canvas update",
      "usage": "canvas update <path> [--nodes <nodes>] [--edges <edges>]",
      "arguments": [
        {
          "name": "path",
          "flag": "--path",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Path to the existing canvas file (with or without .canvas extension) (string)"
        },
        {
          "name": "nodes",
          "flag": "--nodes",
          "type": "array<object>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Full nodes array (replaces existing nodes). Omit to keep existing nodes. (Array of an object)"
        },
        {
          "name": "edges",
          "flag": "--edges",
          "type": "array<object>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Full edges array (replaces existing edges). Omit to keep existing edges. (Array of an object)"
        }
      ],
      "examples": [
        "canvas update \"path-value\" --nodes \"value-1,value-2\" --edges \"value-1,value-2\""
      ]
    },
    {
      "agent": "canvasManager",
      "tool": "write",
      "description": "Create a NEW canvas file. Fails if canvas already exists - use canvasManager.update to modify existing canvases.",
      "command": "canvas write",
      "usage": "canvas write <path> [--nodes <nodes>] [--edges <edges>]",
      "arguments": [
        {
          "name": "path",
          "flag": "--path",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Path for the new canvas file (with or without .canvas extension) (string)"
        },
        {
          "name": "nodes",
          "flag": "--nodes",
          "type": "array<object>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Initial nodes. Each node needs: type (text/file/link/group), x, y, width, height. IDs auto-generated if missing. (Array of an object)"
        },
        {
          "name": "edges",
          "flag": "--edges",
          "type": "array<object>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Initial edges connecting nodes (Array of an object)"
        }
      ],
      "examples": [
        "canvas write \"path-value\" --nodes \"value-1,value-2\" --edges \"value-1,value-2\""
      ]
    },
    {
      "agent": "composer",
      "tool": "compose",
      "description": "Merge multiple vault files of the same type into a single output. Supports markdown (.md), PDF (.pdf), and audio (.mp3, .wav, .ogg, .webm). Audio supports concat (sequential) and mix (layered tracks with volume/fade) modes. Note: WebM audio encoding runs at real-time speed (encoding time equals audio duration).",
      "command": "composer compose",
      "usage": "composer compose [--files <files>] <format> <outputPath> [--separator <separator>] [--include-headers] [--header-level <headerLevel>] [--frontmatter-handling <frontmatterHandling>] [--max-file-size-mb <maxFileSizeMb>] [--max-total-size-mb <maxTotalSizeMb>] [--audio-mode <audioMode>] [--tracks <tracks>] [--output-format <outputFormat>] [--duration <duration>] [--overwrite]",
      "arguments": [
        {
          "name": "files",
          "flag": "--files",
          "type": "array<string>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Vault-relative paths of files to compose. All files must be the same type. Required for concat mode (default). (Array of a string)"
        },
        {
          "name": "format",
          "flag": "--format",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Output format. Determines which composer handles the operation. (One of: [\"markdown\", \"pdf\", \"audio\"])"
        },
        {
          "name": "outputPath",
          "flag": "--output-path",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Vault-relative path for the output file. Parent directories are created automatically. (string)"
        },
        {
          "name": "separator",
          "flag": "--separator",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Markdown only: separator between file sections. Default: \"\\n---\\n\" (string)"
        },
        {
          "name": "includeHeaders",
          "flag": "--include-headers",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Markdown only: prepend each file's name as a heading. Default: false (boolean)"
        },
        {
          "name": "headerLevel",
          "flag": "--header-level",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Markdown only: heading level for file headers. Default: 2 (One of: [1, 2, 3, 4, 5, 6])"
        },
        {
          "name": "frontmatterHandling",
          "flag": "--frontmatter-handling",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Markdown only: how to handle YAML frontmatter. \"first\" keeps only the first file's frontmatter. \"merge\" shallow-merges all. \"strip\" removes all. Default: \"first\" (One of: [\"first\", \"merge\", \"strip\"])"
        },
        {
          "name": "maxFileSizeMb",
          "flag": "--max-file-size-mb",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Per-file size limit in MB. Default: 50 (number)"
        },
        {
          "name": "maxTotalSizeMb",
          "flag": "--max-total-size-mb",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Aggregate size limit for all input files in MB. Default: 200 (number)"
        },
        {
          "name": "audioMode",
          "flag": "--audio-mode",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Audio only: \"concat\" joins files sequentially. \"mix\" layers tracks with individual volume/offset/fade. Default: \"concat\" (One of: [\"concat\", \"mix\"])"
        },
        {
          "name": "tracks",
          "flag": "--tracks",
          "type": "array<object>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Audio mix mode only: track definitions with per-track volume, offset, and fade controls. (Array of an object)"
        },
        {
          "name": "outputFormat",
          "flag": "--output-format",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Audio only: output encoding format. Default: \"wav\" (One of: [\"wav\", \"mp3\", \"webm\"])"
        },
        {
          "name": "duration",
          "flag": "--duration",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Audio only: total output duration in seconds. Trims if shorter than composed audio. Default: full duration. (number)"
        },
        {
          "name": "overwrite",
          "flag": "--overwrite",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] If true, overwrite existing file at outputPath. Default: false (boolean)"
        }
      ],
      "examples": [
        "composer compose --files \"value-1,value-2\" \"format-value\" \"outputPath-value\" --separator \"separator-value\" --header-level 1 --frontmatter-handling \"frontmatterHandling-value\" --max-file-size-mb 1 --max-total-size-mb 1 --audio-mode \"audioMode-value\" --tracks \"value-1,value-2\" --output-format \"outputFormat-value\" --duration 1"
      ]
    },
    {
      "agent": "composer",
      "tool": "listFormats",
      "description": "List supported composition formats, their file extensions, and platform availability.",
      "command": "composer list-formats",
      "usage": "composer list-formats",
      "arguments": [],
      "examples": [
        "composer list-formats"
      ]
    },
    {
      "agent": "contentManager",
      "tool": "insert",
  "description": "Insert new content into a note at a specific position. Does not modify existing content — use replace for that.",
  "command": "content insert",
  "usage": "content insert --path <path> --content <content> --start-line <startLine>",
  "arguments": [
    {
      "name": "path",
      "flag": "--path",
      "type": "string",
      "required": true,
      "positional": false,
      "description": "[REQUIRED] Path to the note to modify (e.g. \"folder/note.md\"). Do not include a leading slash. (string)"
    },
    {
      "name": "content",
      "flag": "--content",
      "type": "string",
      "required": true,
      "positional": false,
      "description": "[REQUIRED] The text to insert into the note. For multi-line content, use newline characters (\\n). This content is added without modifying any existing text. (string)"
    },
    {
      "name": "startLine",
      "flag": "--start-line",
      "type": "number",
      "required": true,
      "positional": false,
      "description": "[REQUIRED] Where to insert the content (1-indexed). Use -1 to append to the end of the note. Use 1 to prepend at the beginning. Any other number inserts before that line, pushing existing content down. (number)"
    }
  ],
  "examples": [
    "content insert --path \"path-value\" --content \"content-value\" --start-line 1"
  ]
    },
    {
      "agent": "contentManager",
      "tool": "read",
      "description": "Read content from a file with line range",
      "command": "content read",
      "usage": "content read <path> <startLine> [--end-line <endLine>]",
      "arguments": [
        {
          "name": "path",
          "flag": "--path",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Path to the file to read (string)"
        },
        {
          "name": "startLine",
          "flag": "--start-line",
          "type": "number",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Start line (1-based), REQUIRED - forces intentional positioning. Use 1 to read from beginning. (number)"
        },
        {
          "name": "endLine",
          "flag": "--end-line",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] End line (1-based, inclusive). If omitted, reads to end of file. (number)"
        }
      ],
      "examples": [
        "content read \"path-value\" 1 --end-line 1"
      ]
    },
    {
      "agent": "contentManager",
      "tool": "replace",
  "description": "Replace or delete existing content in a note. Validates that the content at the specified lines matches before making changes. If the content has moved, returns the new line numbers.",
  "command": "content replace",
  "usage": "content replace --path <path> --old-content <oldContent> --new-content <newContent> --start-line <startLine> --end-line <endLine>",
  "arguments": [
    {
      "name": "path",
      "flag": "--path",
      "type": "string",
      "required": true,
      "positional": false,
      "description": "[REQUIRED] Path to the note to modify (e.g. \"folder/note.md\"). Do not include a leading slash. (string)"
    },
    {
      "name": "oldContent",
      "flag": "--old-content",
      "type": "string",
      "required": true,
      "positional": false,
      "description": "[REQUIRED] The exact text currently at lines startLine through endLine that you want to replace. This is validated before any changes are made — if the content at those lines doesn't match, the tool will search the entire note to find where your content actually is and tell you the correct line numbers. To delete content, set newContent to an empty string. (string)"
    },
    {
      "name": "newContent",
      "flag": "--new-content",
      "type": "string",
      "required": true,
      "positional": false,
      "description": "[REQUIRED] The text to replace oldContent with. Set to an empty string to delete the content at the specified lines. (string)"
    },
    {
      "name": "startLine",
      "flag": "--start-line",
      "type": "number",
      "required": true,
      "positional": false,
      "description": "[REQUIRED] The line number (1-indexed) where oldContent begins. Required — ensures the correct occurrence is targeted when identical content appears multiple times in a note. (number)"
    },
    {
      "name": "endLine",
      "flag": "--end-line",
      "type": "number",
      "required": true,
      "positional": false,
      "description": "[REQUIRED] The line number (1-indexed) where oldContent ends (inclusive). Required — defines the exact range to validate and replace. (number)"
    }
  ],
  "examples": [
    "content replace --path \"path-value\" --old-content \"oldContent-value\" --new-content \"newContent-value\" --start-line 1 --end-line 1"
  ]
    },
    {
      "agent": "contentManager",
      "tool": "setProperty",
      "description": "Set a frontmatter property on a note. Supports \"replace\" (default) and \"merge\" (array union with dedup) modes.",
      "command": "content set-property",
      "usage": "content set-property <path> <property> <value> [--mode <mode>]",
      "arguments": [
        {
          "name": "path",
          "flag": "--path",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Path to the note file (string)"
        },
        {
          "name": "property",
          "flag": "--property",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Frontmatter property name (e.g. \"tags\", \"aliases\", \"status\") (string)"
        },
        {
          "name": "value",
          "flag": "--value",
          "type": "unknown",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Value to set. Can be a string, number, boolean, or array of strings."
        },
        {
          "name": "mode",
          "flag": "--mode",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] How to apply the value. 'replace' overwrites (default). 'merge' performs array union with dedup for list fields; equivalent to replace for scalars. (One of: [\"replace\", \"merge\"])"
        }
      ],
      "examples": [
        "content set-property \"path-value\" \"property-value\" \"value-value\" --mode \"mode-value\""
      ]
    },
    {
      "agent": "contentManager",
      "tool": "write",
      "description": "Create a new file or overwrite existing file",
      "command": "content write",
      "usage": "content write <path> <content> [--overwrite]",
      "arguments": [
        {
          "name": "path",
          "flag": "--path",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Path to the file to create or overwrite (string)"
        },
        {
          "name": "content",
          "flag": "--content",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Content to write to the file (string)"
        },
        {
          "name": "overwrite",
          "flag": "--overwrite",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Overwrite if file exists (default: false) (boolean)"
        }
      ],
      "examples": [
        "content write \"path-value\" \"content-value\""
      ]
    },
    {
      "agent": "elevenlabs",
      "tool": "generateMusic",
      "description": "Generate music from a text prompt describing genre, mood, instruments, tempo, and lyrics. Saves audio to vault.",
      "command": "elevenlabs generate-music",
      "usage": "elevenlabs generate-music <prompt> [--music-length-ms <musicLengthMs>] [--output-path <outputPath>] [--output-format <outputFormat>] [--force-instrumental]",
      "arguments": [
        {
          "name": "prompt",
          "flag": "--prompt",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Text description of the music to generate. Can define genre, mood, instruments, vocals, tempo, structure, and lyrics (max 4100 chars). Do NOT reference copyrighted artists or lyrics. (string)"
        },
        {
          "name": "musicLengthMs",
          "flag": "--music-length-ms",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Length of the song in milliseconds (3000-600000, i.e. 3s to 10min). If omitted, the model chooses based on the prompt. (number)"
        },
        {
          "name": "outputPath",
          "flag": "--output-path",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Output file path in vault (default: audio/music-{timestamp}.mp3) (string)"
        },
        {
          "name": "outputFormat",
          "flag": "--output-format",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Audio format (default: mp3_44100_128). Options: mp3_22050_32, mp3_44100_64, mp3_44100_128, mp3_44100_192 (string)"
        },
        {
          "name": "forceInstrumental",
          "flag": "--force-instrumental",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] If true, guarantees instrumental output with no vocals (default: false) (boolean)"
        }
      ],
      "examples": [
        "elevenlabs generate-music \"prompt-value\" --music-length-ms 1 --output-path \"outputPath-value\" --output-format \"outputFormat-value\""
      ]
    },
    {
      "agent": "elevenlabs",
      "tool": "listVoices",
      "description": "List available ElevenLabs voices with their IDs, names, and categories.",
      "command": "elevenlabs list-voices",
      "usage": "elevenlabs list-voices [--category <category>]",
      "arguments": [
        {
          "name": "category",
          "flag": "--category",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Filter by category: premade, cloned, generated, professional (One of: [\"premade\", \"cloned\", \"generated\", \"professional\"])"
        }
      ],
      "examples": [
        "elevenlabs list-voices --category \"category-value\""
      ]
    },
    {
      "agent": "elevenlabs",
      "tool": "soundEffects",
      "description": "Generate cinematic sound effects from text descriptions (e.g., \"thunder rolling across a mountain valley\").",
      "command": "elevenlabs sound-effects",
      "usage": "elevenlabs sound-effects <prompt> [--duration-seconds <durationSeconds>] [--prompt-influence <promptInfluence>] [--output-path <outputPath>]",
      "arguments": [
        {
          "name": "prompt",
          "flag": "--prompt",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Text description of the sound effect to generate (e.g., \"ocean waves crashing on rocks\") (string)"
        },
        {
          "name": "durationSeconds",
          "flag": "--duration-seconds",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Duration in seconds (0.5-30). If omitted, optimal duration is guessed from prompt. (number)"
        },
        {
          "name": "promptInfluence",
          "flag": "--prompt-influence",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] How closely to follow the text prompt (0.0-1.0) (number)"
        },
        {
          "name": "outputPath",
          "flag": "--output-path",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Output file path in vault (default: audio/sfx-{timestamp}.mp3) (string)"
        }
      ],
      "examples": [
        "elevenlabs sound-effects \"prompt-value\" --duration-seconds 1 --prompt-influence 1 --output-path \"outputPath-value\""
      ]
    },
    {
      "agent": "elevenlabs",
      "tool": "textToSpeech",
      "description": "Convert text to speech audio using ElevenLabs voices. Saves MP3 to vault.",
      "command": "elevenlabs text-to-speech",
      "usage": "elevenlabs text-to-speech <prompt> [--voice-id <voiceId>] [--model-id <modelId>] [--output-path <outputPath>] [--stability <stability>] [--similarity-boost <similarityBoost>]",
      "arguments": [
        {
          "name": "prompt",
          "flag": "--prompt",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Text prompt to convert to speech. Supports dialogue tags like [fearful], [whispered], etc. (string)"
        },
        {
          "name": "voiceId",
          "flag": "--voice-id",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] ElevenLabs voice ID (use listVoices to find IDs). Defaults to Sarah. (string)"
        },
        {
          "name": "modelId",
          "flag": "--model-id",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Model ID. Options: eleven_multilingual_v2 (default), eleven_turbo_v2 (faster), eleven_monolingual_v1 (string)"
        },
        {
          "name": "outputPath",
          "flag": "--output-path",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Output file path in vault (default: audio/tts-{timestamp}.mp3) (string)"
        },
        {
          "name": "stability",
          "flag": "--stability",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Voice stability 0.0-1.0 (default: 0.5) (number)"
        },
        {
          "name": "similarityBoost",
          "flag": "--similarity-boost",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Voice similarity boost 0.0-1.0 (default: 0.75) (number)"
        }
      ],
      "examples": [
        "elevenlabs text-to-speech \"prompt-value\" --voice-id \"voiceId-value\" --model-id \"modelId-value\" --output-path \"outputPath-value\" --stability 1 --similarity-boost 1"
      ]
    },
    {
      "agent": "ingestManager",
      "tool": "ingest",
      "description": "Ingest a PDF or audio file into a structured markdown note. PDF: text extraction (default) or vision OCR. Audio: speech transcription using explicit ingest-supported models. Output note created alongside the original file.",
      "command": "ingest ingest",
      "usage": "ingest ingest <filePath> [--mode <mode>] [--ocr-provider <ocrProvider>] [--ocr-model <ocrModel>]",
      "arguments": [
        {
          "name": "filePath",
          "flag": "--file-path",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Path to the file to ingest (PDF, DOCX, PPTX, XLSX, or audio). Relative to vault root. (string)"
        },
        {
          "name": "mode",
          "flag": "--mode",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] PDF processing mode only. \"text\" = free text extraction (default). \"vision\" = OCR via LLM vision (requires ocrProvider + ocrModel). (One of: [\"text\", \"vision\"])"
        },
        {
          "name": "ocrProvider",
          "flag": "--ocr-provider",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Provider for vision-based OCR (e.g., \"openai\", \"anthropic\", \"google\", \"ollama\"). Required when mode=\"vision\". (string)"
        },
        {
          "name": "ocrModel",
          "flag": "--ocr-model",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Model for vision-based OCR (e.g., \"gpt-4o\", \"claude-sonnet-4-6\"). Required when mode=\"vision\". (string)"
        }
      ],
      "examples": [
        "ingest ingest \"filePath-value\" --mode \"mode-value\" --ocr-provider \"ocrProvider-value\" --ocr-model \"ocrModel-value\""
      ]
    },
    {
      "agent": "ingestManager",
      "tool": "listCapabilities",
      "description": "List available OCR models and audio transcription models that the ingest pipeline supports. Use before ingest to discover valid provider/model options.",
      "command": "ingest list-capabilities",
      "usage": "ingest list-capabilities",
      "arguments": [],
      "examples": [
        "ingest list-capabilities"
      ]
    },
    {
      "agent": "memoryManager",
      "tool": "archiveWorkspace",
      "description": "Archive a workspace (soft delete). Workspace will be hidden from lists but can be restored.",
      "command": "memory archive-workspace",
      "usage": "memory archive-workspace <name> [--restore]",
      "arguments": [
        {
          "name": "name",
          "flag": "--name",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Name of the workspace to archive or restore (REQUIRED) (string)"
        },
        {
          "name": "restore",
          "flag": "--restore",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] If true, restores the workspace from archive. If false/omitted, archives the workspace. (boolean)"
        }
      ],
      "examples": [
        "memory archive-workspace \"name-value\""
      ]
    },
    {
      "agent": "memoryManager",
      "tool": "createState",
      "description": "Create a state with restoration context for later resumption",
      "command": "memory create-state",
      "usage": "memory create-state <name> <conversationContext> <activeTask> --active-files <activeFiles> --next-steps <nextSteps> [--tags <tags>]",
      "arguments": [
        {
          "name": "name",
          "flag": "--name",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Short descriptive title for this save point (string)"
        },
        {
          "name": "conversationContext",
          "flag": "--conversation-context",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Detailed markdown summary enabling seamless resumption. Structure with headings:\n\n## Original Request\nWhat the user asked for and their goal\n\n## Key Decisions Made\n- Decision and reasoning\n- Decision and reasoning\n\n## Important Context\nBackground info, constraints, or discoveries from the conversation\n\n## Current Status\nWhat is complete, what is in progress, any blockers (string)"
        },
        {
          "name": "activeTask",
          "flag": "--active-task",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] The specific task in progress when saving (string)"
        },
        {
          "name": "activeFiles",
          "flag": "--active-files",
          "type": "array<string>",
          "required": true,
          "positional": false,
          "description": "[REQUIRED] File paths being edited or referenced (Array of a string)"
        },
        {
          "name": "nextSteps",
          "flag": "--next-steps",
          "type": "array<string>",
          "required": true,
          "positional": false,
          "description": "[REQUIRED] Specific action items to resume work, in priority order (Array of a string)"
        },
        {
          "name": "tags",
          "flag": "--tags",
          "type": "array<string>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Optional tags for categorization (Array of a string)"
        }
      ],
      "examples": [
        "memory create-state \"name-value\" \"conversationContext-value\" \"activeTask-value\" --active-files \"[\\\"docs/plan.md\\\",\\\"src/main.ts\\\"]\" --next-steps \"[\\\"Create checkpoint\\\",\\\"Start refactor\\\"]\" --tags \"[\\\"checkpoint\\\",\\\"refactor\\\"]\""
      ]
    },
    {
      "agent": "memoryManager",
      "tool": "createWorkspace",
      "description": "Create a new workspace with structured context data",
      "command": "memory create-workspace",
      "usage": "memory create-workspace <name> <description> <rootFolder> <purpose> [--workflows <workflows>] [--key-files <keyFiles>] [--preferences <preferences>] [--dedicated-agent-id <dedicatedAgentId>] [--related-folders <relatedFolders>] [--related-files <relatedFiles>] [--key-file-instructions <keyFileInstructions>]",
      "arguments": [
        {
          "name": "name",
          "flag": "--name",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Workspace name (string)"
        },
        {
          "name": "description",
          "flag": "--description",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Brief description of the workspace purpose (string)"
        },
        {
          "name": "rootFolder",
          "flag": "--root-folder",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Root folder path for this workspace (string)"
        },
        {
          "name": "purpose",
          "flag": "--purpose",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Overall purpose and goals for this workspace (string)"
        },
        {
          "name": "workflows",
          "flag": "--workflows",
          "type": "array<object>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Workflows for different situations. Each workflow may also bind a prompt and schedule. (Array of an object) [min items: 1]"
        },
        {
          "name": "keyFiles",
          "flag": "--key-files",
          "type": "array<string>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Key file paths for quick reference (Array of a string)"
        },
        {
          "name": "preferences",
          "flag": "--preferences",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] User preferences or workspace settings (string)"
        },
        {
          "name": "dedicatedAgentId",
          "flag": "--dedicated-agent-id",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] ID of dedicated prompt for this workspace (string)"
        },
        {
          "name": "relatedFolders",
          "flag": "--related-folders",
          "type": "array<string>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Related folder paths (Array of a string)"
        },
        {
          "name": "relatedFiles",
          "flag": "--related-files",
          "type": "array<string>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Related file paths (Array of a string)"
        },
        {
          "name": "keyFileInstructions",
          "flag": "--key-file-instructions",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Instructions for working with key files (string)"
        }
      ],
      "examples": [
        "memory create-workspace \"name-value\" \"description-value\" \"rootFolder-value\" \"purpose-value\" --workflows \"value-1,value-2\" --key-files \"value-1,value-2\" --preferences \"preferences-value\" --dedicated-agent-id \"dedicatedAgentId-value\" --related-folders \"value-1,value-2\" --related-files \"value-1,value-2\" --key-file-instructions \"keyFileInstructions-value\""
      ]
    },
    {
      "agent": "memoryManager",
      "tool": "listStates",
      "description": "List states with optional filtering and sorting",
      "command": "memory list-states",
      "usage": "memory list-states [--include-archived] [--tags <tags>] [--page <page>] [--page-size <pageSize>] [--order <order>]",
      "arguments": [
        {
          "name": "includeArchived",
          "flag": "--include-archived",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Include archived states (default: false) (boolean)"
        },
        {
          "name": "tags",
          "flag": "--tags",
          "type": "array<string>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Filter by tags (Array of a string)"
        },
        {
          "name": "page",
          "flag": "--page",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Page number for pagination (0-indexed, default: 0) (number) [min: 0]"
        },
        {
          "name": "pageSize",
          "flag": "--page-size",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Number of items per page (default: all items if not specified) (number) [min: 1]"
        },
        {
          "name": "order",
          "flag": "--order",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Sort order by creation date (default: desc) (One of: [\"asc\", \"desc\"])"
        }
      ],
      "examples": [
        "memory list-states --tags \"value-1,value-2\" --page 1 --page-size 1 --order \"order-value\""
      ]
    },
    {
      "agent": "memoryManager",
      "tool": "listWorkspaces",
      "description": "List available workspaces with filters and sorting",
      "command": "memory list-workspaces",
      "usage": "memory list-workspaces [--include-archived] [--sort-by <sortBy>] [--order <order>] [--limit <limit>]",
      "arguments": [
        {
          "name": "includeArchived",
          "flag": "--include-archived",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Include archived workspaces (default: false) (boolean)"
        },
        {
          "name": "sortBy",
          "flag": "--sort-by",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Field to sort workspaces by (One of: [\"name\", \"created\", \"lastAccessed\"])"
        },
        {
          "name": "order",
          "flag": "--order",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Sort order (ascending or descending) (One of: [\"asc\", \"desc\"])"
        },
        {
          "name": "limit",
          "flag": "--limit",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Maximum number of workspaces to return (number)"
        }
      ],
      "examples": [
        "memory list-workspaces --sort-by \"sortBy-value\" --order \"order-value\" --limit 1"
      ]
    },
    {
      "agent": "memoryManager",
      "tool": "loadState",
      "description": "Load a saved state and optionally create a continuation session with restored context",
      "command": "memory load-state",
      "usage": "memory load-state <name>",
      "arguments": [
        {
          "name": "name",
          "flag": "--name",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Name of the state to load (REQUIRED). Use listStates to see available states. (string)"
        }
      ],
      "examples": [
        "memory load-state \"name-value\""
      ]
    },
    {
      "agent": "memoryManager",
      "tool": "loadWorkspace",
      "description": "Load a workspace by ID and restore context and state",
      "command": "memory load-workspace",
      "usage": "memory load-workspace <id> [--limit <limit>] [--recursive]",
      "arguments": [
        {
          "name": "id",
          "flag": "--id",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Workspace ID or name to load (REQUIRED). Accepts either the unique workspace ID or the workspace name. (string)"
        },
        {
          "name": "limit",
          "flag": "--limit",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Optional limit for sessions, states, and recentActivity returned (default: 5) (number) [min: 1, max: 20]"
        },
        {
          "name": "recursive",
          "flag": "--recursive",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Show full recursive file structure (true) or top-level folders only (false). Default: false (top-level only, folders marked with trailing /) (boolean)"
        }
      ],
      "examples": [
        "memory load-workspace \"id-value\" --limit 1"
      ]
    },
    {
      "agent": "memoryManager",
      "tool": "runWorkflow",
      "description": "Run a workflow immediately and create a fresh conversation for it.",
      "command": "memory run-workflow",
      "usage": "memory run-workflow [--workflow-id <workflowId>] [--workflow-name <workflowName>] [--open-in-chat]",
      "arguments": [
        {
          "name": "workflowId",
          "flag": "--workflow-id",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Workflow ID to run. (string)"
        },
        {
          "name": "workflowName",
          "flag": "--workflow-name",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Workflow name to run if workflowId is not known. (string)"
        },
        {
          "name": "openInChat",
          "flag": "--open-in-chat",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Open and focus the new conversation in chat. Defaults to false for tool-driven runs. (boolean)"
        }
      ],
      "examples": [
        "memory run-workflow --workflow-id \"workflowId-value\" --workflow-name \"workflowName-value\""
      ]
    },
    {
      "agent": "memoryManager",
      "tool": "updateWorkspace",
      "description": "Update workspace properties. Pass only fields to change - others remain unchanged.",
      "command": "memory update-workspace",
      "usage": "memory update-workspace [--name <name>] [--description <description>] [--root-folder <rootFolder>] [--purpose <purpose>] [--workflows <workflows>] [--key-files <keyFiles>] [--preferences <preferences>] [--dedicated-agent-id <dedicatedAgentId>]",
      "arguments": [
        {
          "name": "name",
          "flag": "--name",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] New workspace name (optional) (string)"
        },
        {
          "name": "description",
          "flag": "--description",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] New workspace description (optional) (string)"
        },
        {
          "name": "rootFolder",
          "flag": "--root-folder",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] New root folder path (optional, will create if needed) (string)"
        },
        {
          "name": "purpose",
          "flag": "--purpose",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] New workspace purpose (optional, updates context.purpose) (string)"
        },
        {
          "name": "workflows",
          "flag": "--workflows",
          "type": "array<object>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] New workflows array (optional, replaces context.workflows) (Array of an object)"
        },
        {
          "name": "keyFiles",
          "flag": "--key-files",
          "type": "array<string>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] New key files array (optional, replaces context.keyFiles) (Array of a string)"
        },
        {
          "name": "preferences",
          "flag": "--preferences",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] New preferences text (optional, updates context.preferences) (string)"
        },
        {
          "name": "dedicatedAgentId",
          "flag": "--dedicated-agent-id",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] ID of custom agent to set as workspace dedicated agent (optional, updates context.dedicatedAgent). Pass empty string to remove dedicated agent. (string)"
        }
      ],
      "examples": [
        "memory update-workspace --name \"name-value\" --description \"description-value\" --root-folder \"rootFolder-value\" --purpose \"purpose-value\" --workflows \"[{\\\"name\\\":\\\"Weekly Review\\\",\\\"description\\\":\\\"Run weekly workspace review\\\"}]\" --key-files \"[\\\"docs/plan.md\\\",\\\"reports/q4.md\\\"]\" --preferences \"preferences-value\" --dedicated-agent-id \"dedicatedAgentId-value\""
      ]
    },
    {
      "agent": "promptManager",
      "tool": "archivePrompt",
      "description": "Archive a custom prompt by disabling it (preserves configuration for restoration)",
      "command": "prompt archive-prompt",
      "usage": "prompt archive-prompt <name>",
      "arguments": [
        {
          "name": "name",
          "flag": "--name",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Name or ID of the prompt to archive. Prompt will be disabled but configuration preserved for restoration via updatePrompt. (string) [min length: 1]"
        }
      ],
      "examples": [
        "prompt archive-prompt \"name-value\""
      ]
    },
    {
      "agent": "promptManager",
      "tool": "createPrompt",
      "description": "Create a new custom prompt",
      "command": "prompt create-prompt",
      "usage": "prompt create-prompt <name> <description> <prompt> [--is-enabled]",
      "arguments": [
        {
          "name": "name",
          "flag": "--name",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Name of the prompt (must be unique) (string) [min length: 1, max length: 100]"
        },
        {
          "name": "description",
          "flag": "--description",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Description of what this prompt does (string) [min length: 1, max length: 500]"
        },
        {
          "name": "prompt",
          "flag": "--prompt",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] The actual prompt text/persona (string) [min length: 1]"
        },
        {
          "name": "isEnabled",
          "flag": "--is-enabled",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Whether the prompt is enabled (boolean)"
        }
      ],
      "examples": [
        "prompt create-prompt \"name-value\" \"description-value\" \"prompt-value\""
      ]
    },
    {
      "agent": "promptManager",
      "tool": "executePrompts",
      "description": "Execute one or more LLM prompts. For single: pass one item. For multiple: supports sequencing (sequence: 0,1,2), parallel groups, and result forwarding (includePreviousResults: true).",
      "command": "prompt execute-prompts",
      "usage": "prompt execute-prompts --prompts <prompts> [--merge-responses]",
      "arguments": [
        {
          "name": "prompts",
          "flag": "--prompts",
          "type": "array<object>",
          "required": true,
          "positional": false,
          "description": "[REQUIRED] Array of text and/or image generation requests to execute in batch (Array of an object) [min items: 1, max items: 100]"
        },
        {
          "name": "mergeResponses",
          "flag": "--merge-responses",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Whether to merge all responses into a single result (boolean)"
        }
      ],
      "examples": [
        "prompt execute-prompts --prompts '[{\"agentId\":\"researcher\",\"prompt\":\"Summarize Docs/brief.md in 3 bullets.\"}]'"
      ]
    },
    {
      "agent": "promptManager",
      "tool": "generateImage",
      "description": "Generate images using Google Nano Banana models (direct or via OpenRouter). Supports reference images for style/composition guidance.",
      "command": "prompt generate-image",
      "usage": "prompt generate-image <prompt> [--provider <provider>] [--model <model>] [--aspect-ratio <aspectRatio>] [--number-of-images <numberOfImages>] [--image-size <imageSize>] [--reference-images <referenceImages>] <savePath>",
      "arguments": [
        {
          "name": "prompt",
          "flag": "--prompt",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Text prompt describing the image to generate (string) [min length: 1, max length: 32000]"
        },
        {
          "name": "provider",
          "flag": "--provider",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] AI provider (default: google). Available: google, openrouter (One of: [\"google\", \"openrouter\"])"
        },
        {
          "name": "model",
          "flag": "--model",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Image generation model (default: gemini-2.5-flash-image). Available: gemini-2.5-flash-image, gemini-3-pro-image-preview, gemini-3.1-flash-image-preview, gpt-5-image, flux-2-pro, flux-2-flex (One of: [\"gemini-2.5-flash-image\", \"gemini-3-pro-image-preview\", \"gemini-3.1-flash-image-preview\", \"gpt-5-image\", \"flux-2-pro\", \"flux-2-flex\"])"
        },
        {
          "name": "aspectRatio",
          "flag": "--aspect-ratio",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Aspect ratio for the generated image (One of: [\"1:1\", \"2:3\", \"3:2\", \"3:4\", \"4:3\", \"4:5\", \"5:4\", \"9:16\", \"16:9\", \"21:9\", \"1:4\", \"4:1\", \"1:8\", \"8:1\"])"
        },
        {
          "name": "numberOfImages",
          "flag": "--number-of-images",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Number of images to generate (1-4) (number) [min: 1, max: 4]"
        },
        {
          "name": "imageSize",
          "flag": "--image-size",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Image resolution. 512px only for gemini-3.1-flash-image-preview. 4K available for gemini-3-pro-image-preview and gemini-3.1-flash-image-preview (One of: [\"512px\", \"1K\", \"2K\", \"4K\"])"
        },
        {
          "name": "referenceImages",
          "flag": "--reference-images",
          "type": "array<string>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Reference images for style/composition. Max 3 for 2.5-flash, max 14 for 3-pro (Array of a string) [max items: 14]"
        },
        {
          "name": "savePath",
          "flag": "--save-path",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Vault-relative path for the image. Extension may change based on API response format. (string) [pattern: ^[^/].*\\.(png|jpg|jpeg|webp)$]"
        }
      ],
      "examples": [
        "prompt generate-image \"prompt-value\" --provider \"provider-value\" --model \"model-value\" --aspect-ratio \"aspectRatio-value\" --number-of-images 1 --image-size \"imageSize-value\" --reference-images \"value-1,value-2\" \"savePath-value\""
      ]
    },
    {
      "agent": "promptManager",
      "tool": "getPrompt",
      "description": "Get a custom prompt for persona adoption - does NOT execute tasks automatically",
      "command": "prompt get-prompt",
      "usage": "prompt get-prompt [--id <id>] [--name <name>]",
      "arguments": [
        {
          "name": "id",
          "flag": "--id",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Unique ID or name of the prompt to retrieve for persona adoption (will try ID first, then name) (string)"
        },
        {
          "name": "name",
          "flag": "--name",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Name of the prompt to retrieve for persona adoption (string)"
        }
      ],
      "examples": [
        "prompt get-prompt --id \"id-value\" --name \"name-value\""
      ]
    },
    {
      "agent": "promptManager",
      "tool": "listModels",
      "description": "List available LLM models grouped by provider",
      "command": "prompt list-models",
      "usage": "prompt list-models",
      "arguments": [],
      "examples": [
        "prompt list-models"
      ]
    },
    {
      "agent": "promptManager",
      "tool": "listPrompts",
      "description": "List all custom prompts",
      "command": "prompt list-prompts",
      "usage": "prompt list-prompts [--enabled-only] [--include-archived]",
      "arguments": [
        {
          "name": "enabledOnly",
          "flag": "--enabled-only",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] If true, only return enabled prompts (boolean)"
        },
        {
          "name": "includeArchived",
          "flag": "--include-archived",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] If true, include archived (disabled) prompts in results. Default false filters out archived prompts. (boolean)"
        }
      ],
      "examples": [
        "prompt list-prompts"
      ]
    },
    {
      "agent": "promptManager",
      "tool": "subagent",
      "description": "Spawn an autonomous subagent to work on a task in the background.\n\nThe subagent runs independently, using tools as needed, until it completes.\nResults appear as a tool result when the subagent finishes.\n\nUse for:\n- Deep research tasks requiring multiple searches\n- Analysis tasks that need file reading and processing\n- Complex operations you want to run in parallel\n\nThe subagent has access to all tools via getTools.\n\nTo continue a subagent that hit max iterations, provide continueBranchId.",
      "command": "prompt sub",
      "usage": "prompt sub <task> [-- <agent>] [--tools <tools>] [--context-files <contextFiles>] [--max-iterations <maxIterations>] [--continue-branch-id <continueBranchId>]",
      "arguments": [
        {
          "name": "task",
          "flag": "--task",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Clear description of what the subagent should accomplish (string)"
        },
        {
          "name": "agent",
          "flag": "--",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Optional custom agent/persona name to use (string)"
        },
        {
          "name": "tools",
          "flag": "--tools",
          "type": "object",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Hand off specific tools to the subagent. Format: { \"agentName\": [\"tool1\", \"tool2\"] }. Tool schemas are pre-filled in subagent system prompt so it can use useTool directly without calling getTools first. (object)"
        },
        {
          "name": "contextFiles",
          "flag": "--context-files",
          "type": "array<string>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] File paths to read - content will be included in the subagent context (Array of a string)"
        },
        {
          "name": "maxIterations",
          "flag": "--max-iterations",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Maximum iterations before pausing (default: 10) (number)"
        },
        {
          "name": "continueBranchId",
          "flag": "--continue-branch-id",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Branch ID to continue from max_iterations state (string)"
        }
      ],
      "examples": [
        "prompt sub \"task-value\" -- \"agent-value\" --tools '{\"key\":\"value\"}' --context-files \"value-1,value-2\" --max-iterations 1 --continue-branch-id \"continueBranchId-value\""
      ]
    },
    {
      "agent": "promptManager",
      "tool": "updatePrompt",
      "description": "Update an existing custom prompt",
      "command": "prompt update-prompt",
      "usage": "prompt update-prompt <id> [--name <name>] [--description <description>] [--prompt <prompt>] [--is-enabled]",
      "arguments": [
        {
          "name": "id",
          "flag": "--id",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Unique ID of the prompt to update (string) [min length: 1]"
        },
        {
          "name": "name",
          "flag": "--name",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] New name for the prompt (must be unique) (string) [min length: 1, max length: 100]"
        },
        {
          "name": "description",
          "flag": "--description",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] New description for the prompt (string) [min length: 1, max length: 500]"
        },
        {
          "name": "prompt",
          "flag": "--prompt",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] New prompt text/persona (string) [min length: 1]"
        },
        {
          "name": "isEnabled",
          "flag": "--is-enabled",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Whether the prompt is enabled (boolean)"
        }
      ],
      "examples": [
        "prompt update-prompt \"id-value\" --name \"name-value\" --description \"description-value\" --prompt \"prompt-value\""
      ]
    },
    {
      "agent": "searchManager",
      "tool": "searchContent",
      "description": "Search vault files. Set semantic=true for AI-powered conceptual search using local embeddings (best for concepts/related ideas), or semantic=false for keyword/fuzzy search (best for exact matches). Semantic search is desktop-only and becomes available once the embedding system initializes in the background (first run may take longer while the model downloads).",
      "command": "search search-content",
      "usage": "search search-content <query> [--semantic] [--limit <limit>] [--include-content] [--snippet-length <snippetLength>] [--paths <paths>]",
      "arguments": [
        {
          "name": "query",
          "flag": "--query",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Search query to find files and content. (string)"
        },
        {
          "name": "semantic",
          "flag": "--semantic",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] true = AI-powered conceptual search (desktop only, best for concepts/related ideas). false = keyword/fuzzy search (default, best for exact matches). (boolean)"
        },
        {
          "name": "limit",
          "flag": "--limit",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Maximum number of results to return (default: 10) (number) [min: 1, max: 50]"
        },
        {
          "name": "includeContent",
          "flag": "--include-content",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] For keyword search only: include content snippets (default: true). Ignored for semantic search. (boolean)"
        },
        {
          "name": "snippetLength",
          "flag": "--snippet-length",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] For keyword search only: length of content snippets (default: 200). Ignored for semantic search. (number) [min: 50, max: 1000]"
        },
        {
          "name": "paths",
          "flag": "--paths",
          "type": "array<string>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Restrict search to specific folder paths. Supports glob patterns. (Array of a string)"
        }
      ],
      "examples": [
        "search search-content \"query-value\" --limit 1 --snippet-length 1 --paths \"[\\\"Projects\\\",\\\"Q4\\\"]\""
      ]
    },
    {
      "agent": "searchManager",
      "tool": "searchDirectory",
      "description": "FOCUSED directory search with REQUIRED paths parameter. Search for files and/or folders within specific directory paths using fuzzy matching and optional workspace context. Requires: query (search terms) and paths (directory paths to search - cannot be empty).",
      "command": "search search-directory",
      "usage": "search search-directory <query> --paths <paths> [--search-type <searchType>] [--file-types <fileTypes>] [--depth <depth>] [--pattern <pattern>] [--date-range <dateRange>] [--limit <limit>] [--include-content]",
      "arguments": [
        {
          "name": "query",
          "flag": "--query",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Search term to find in file/folder names and paths. Fuzzy matching is automatic. (string) [min length: 1]"
        },
        {
          "name": "paths",
          "flag": "--paths",
          "type": "array<string>",
          "required": true,
          "positional": false,
          "description": "[REQUIRED] Directory paths to search within. Supports glob patterns. Use [\"/\"] for entire vault. (Array of a string) [min items: 1]"
        },
        {
          "name": "searchType",
          "flag": "--search-type",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] What to search for: \"files\", \"folders\", or \"both\" (One of: [\"files\", \"folders\", \"both\"])"
        },
        {
          "name": "fileTypes",
          "flag": "--file-types",
          "type": "array<string>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Filter by file extensions without dots (Array of a string)"
        },
        {
          "name": "depth",
          "flag": "--depth",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Maximum directory depth to search (1-10) (number) [min: 1, max: 10]"
        },
        {
          "name": "pattern",
          "flag": "--pattern",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Regular expression pattern to filter paths (string)"
        },
        {
          "name": "dateRange",
          "flag": "--date-range",
          "type": "object",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Filter results by modification date range (object)"
        },
        {
          "name": "limit",
          "flag": "--limit",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Maximum number of results (1-100) (number) [min: 1, max: 100]"
        },
        {
          "name": "includeContent",
          "flag": "--include-content",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Include content snippets from files (boolean)"
        }
      ],
      "examples": [
        "search search-directory \"query-value\" --paths \"[\\\"Docs\\\",\\\"Runbooks\\\"]\" --search-type \"searchType-value\" --file-types \"[\\\"md\\\",\\\"txt\\\"]\" --depth 1 --pattern \"pattern-value\" --date-range '{\"key\":\"value\"}' --limit 1"
      ]
    },
    {
      "agent": "searchManager",
      "tool": "searchMemory",
      "description": "Search workspace memory for past conversations, tool execution history, and workspace state snapshots.\n\nTWO MODES:\n- Discovery (default): Search all memory across a workspace. Best for finding past discussions, tool usage, or workspace context.\n- Scoped (provide sessionId): Search within a specific session and get surrounding message context around each match. Best for recovering what happened in a particular session.\n\nTIPS:\n- Use natural language queries for conversations (e.g., \"how did we implement auth?\").\n- Use specific terms for tool history (e.g., agent or tool names).\n- Narrow results with memoryTypes if you know what you're looking for.\n- Use sessionId + windowSize to get full context around a match.\n\nREQUIRES: query. Optional: workspaceId (defaults to global workspace if omitted; available from your useTools context, or use MemoryManager listWorkspaces).",
      "command": "search search-memory",
      "usage": "search search-memory <query> [--memory-types <memoryTypes>] [--window-size <windowSize>] [--date-range <dateRange>] [--limit <limit>] [--tool-call-filters <toolCallFilters>] [--search-method <searchMethod>]",
      "arguments": [
        {
          "name": "query",
          "flag": "--query",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] What to search for. Use natural language for conversations ('how did we handle auth?') or specific terms for tool history ('contentManager read'). Examples: 'authentication implementation', 'database migration error', 'what tools were used for file editing' (string) [min length: 1]"
        },
        {
          "name": "memoryTypes",
          "flag": "--memory-types",
          "type": "array<string>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Which memory to search. 'conversations' = past chat Q&A pairs, 'traces' = tool execution history, 'states' = workspace snapshots. Defaults to all three. Narrow to specific types if you know what you need. (Array of a string)"
        },
        {
          "name": "windowSize",
          "flag": "--window-size",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Number of conversation turns before/after each match to include. Default 3. Only used in scoped mode (when sessionId is provided). (number) [min: 1, max: 20]"
        },
        {
          "name": "dateRange",
          "flag": "--date-range",
          "type": "object",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Filter results by date range (object)"
        },
        {
          "name": "limit",
          "flag": "--limit",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Maximum number of results to return (number) [min: 1, max: 100]"
        },
        {
          "name": "toolCallFilters",
          "flag": "--tool-call-filters",
          "type": "object",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Additional filters for tool call traces (object)"
        },
        {
          "name": "searchMethod",
          "flag": "--search-method",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] How to match results. 'mixed' (default, recommended) combines approaches for best coverage. 'semantic' prioritizes meaning-based matching. 'exact' requires literal keyword matches. (One of: [\"semantic\", \"exact\", \"mixed\"])"
        }
      ],
      "examples": [
        "search search-memory \"query-value\" --memory-types \"value-1,value-2\" --window-size 1 --date-range '{\"key\":\"value\"}' --limit 1 --tool-call-filters '{\"key\":\"value\"}' --search-method \"searchMethod-value\""
      ]
    },
    {
      "agent": "storageManager",
      "tool": "archive",
      "description": "Safely archive a file or folder (moves to .archive/ with timestamp)",
      "command": "storage archive",
      "usage": "storage archive <path>",
      "arguments": [
        {
          "name": "path",
          "flag": "--path",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Path to file or folder to archive (string)"
        }
      ],
      "examples": [
        "storage archive \"path-value\""
      ]
    },
    {
      "agent": "storageManager",
      "tool": "copy",
      "description": "Duplicate a file",
      "command": "storage copy",
      "usage": "storage copy <path> <newPath> [--overwrite]",
      "arguments": [
        {
          "name": "path",
          "flag": "--path",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Source file path (string)"
        },
        {
          "name": "newPath",
          "flag": "--new-path",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Destination path for the copy (string)"
        },
        {
          "name": "overwrite",
          "flag": "--overwrite",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Overwrite if destination exists (default: false) (boolean)"
        }
      ],
      "examples": [
        "storage copy \"path-value\" \"newPath-value\""
      ]
    },
    {
      "agent": "storageManager",
      "tool": "createFolder",
      "description": "Create a new folder in the vault",
      "command": "storage create-folder",
      "usage": "storage create-folder <path>",
      "arguments": [
        {
          "name": "path",
          "flag": "--path",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Path of the folder to create (REQUIRED) (string)"
        }
      ],
      "examples": [
        "storage create-folder \"path-value\""
      ]
    },
    {
      "agent": "storageManager",
      "tool": "list",
      "description": "List contents of a directory",
      "command": "storage list",
      "usage": "storage list [--path <path>] [--filter <filter>]",
      "arguments": [
        {
          "name": "path",
          "flag": "--path",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Directory path (optional). Use empty string (\"\"), \"/\" or \".\" for vault root. Defaults to vault root. (string)"
        },
        {
          "name": "filter",
          "flag": "--filter",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Optional filter pattern. Supports glob patterns (* for any chars, ? for single char) or regular expressions. Examples: \"*deep*\", \"test*\", \".*regex.*\" (string)"
        }
      ],
      "examples": [
        "storage list --path \"path-value\" --filter \"filter-value\""
      ]
    },
    {
      "agent": "storageManager",
      "tool": "move",
      "description": "Move or rename a file or folder",
      "command": "storage move",
      "usage": "storage move <path> <newPath> [--overwrite]",
      "arguments": [
        {
          "name": "path",
          "flag": "--path",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Source path (file or folder) (string)"
        },
        {
          "name": "newPath",
          "flag": "--new-path",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Destination path (string)"
        },
        {
          "name": "overwrite",
          "flag": "--overwrite",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Overwrite if destination exists (default: false) (boolean)"
        }
      ],
      "examples": [
        "storage move \"path-value\" \"newPath-value\""
      ]
    },
    {
      "agent": "storageManager",
      "tool": "open",
      "description": "Open a file in the editor",
      "command": "storage open",
      "usage": "storage open <path> [--mode <mode>] [--focus]",
      "arguments": [
        {
          "name": "path",
          "flag": "--path",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Path to the file to open (string)"
        },
        {
          "name": "mode",
          "flag": "--mode",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Where to open the file (tab, split, window, or current) (One of: [\"tab\", \"split\", \"window\", \"current\"])"
        },
        {
          "name": "focus",
          "flag": "--focus",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Whether to focus the opened file (boolean)"
        }
      ],
      "examples": [
        "storage open \"path-value\" --mode \"mode-value\""
      ]
    },
    {
      "agent": "taskManager",
      "tool": "archiveProject",
      "description": "Archive a project by setting its status to 'archived' (soft-delete). The project and its tasks remain queryable but are excluded from active listings. Requires a projectId (from createProject or listProjects).",
      "command": "task archive-project",
      "usage": "task archive-project <projectId>",
      "arguments": [
        {
          "name": "projectId",
          "flag": "--project-id",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Project ID to archive (REQUIRED — from createProject or listProjects) (string)"
        }
      ],
      "examples": [
        "task archive-project \"projectId-value\""
      ]
    },
    {
      "agent": "taskManager",
      "tool": "createProject",
      "description": "Create a new project within a workspace. Projects organize tasks and must have a unique name per workspace. Requires a workspaceId (from loadWorkspace or createWorkspace). Returns the new projectId.",
      "command": "task create-project",
      "usage": "task create-project <name> [--description <description>] [--metadata <metadata>]",
      "arguments": [
        {
          "name": "name",
          "flag": "--name",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Project name (REQUIRED — must be unique within the workspace) (string)"
        },
        {
          "name": "description",
          "flag": "--description",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Project description (optional) (string)"
        },
        {
          "name": "metadata",
          "flag": "--metadata",
          "type": "object",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Custom metadata key-value pairs (optional) (object)"
        }
      ],
      "examples": [
        "task create-project \"name-value\" --description \"description-value\" --metadata '{\"key\":\"value\"}'"
      ]
    },
    {
      "agent": "taskManager",
      "tool": "createTask",
      "description": "Create a task within a project. Requires a projectId (from createProject or listProjects). Supports optional priority (critical/high/medium/low), assignee, dueDate, tags, dependsOn[] for DAG edges (cycles rejected), parentTaskId for subtask nesting, and linkedNotes[] for vault note links. Returns the new taskId.",
      "command": "task create-task",
      "usage": "task create-task <projectId> <title> [--description <description>] [--parent-task-id <parentTaskId>] [--priority <priority>] [--due-date <dueDate>] [--assignee <assignee>] [--tags <tags>] [--depends-on <dependsOn>] [--linked-notes <linkedNotes>] [--metadata <metadata>]",
      "arguments": [
        {
          "name": "projectId",
          "flag": "--project-id",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Project ID to create the task in (REQUIRED — from createProject or listProjects) (string)"
        },
        {
          "name": "title",
          "flag": "--title",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Task title (REQUIRED) (string)"
        },
        {
          "name": "description",
          "flag": "--description",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Task description (optional) (string)"
        },
        {
          "name": "parentTaskId",
          "flag": "--parent-task-id",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Parent task ID to nest this task under as a subtask (optional — from createTask or listTasks) (string)"
        },
        {
          "name": "priority",
          "flag": "--priority",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Task priority (default: medium) (One of: [\"critical\", \"high\", \"medium\", \"low\"])"
        },
        {
          "name": "dueDate",
          "flag": "--due-date",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Due date as Unix timestamp in milliseconds (e.g., Date.now() + 86400000 for tomorrow) (number)"
        },
        {
          "name": "assignee",
          "flag": "--assignee",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Assignee name or identifier (optional) (string)"
        },
        {
          "name": "tags",
          "flag": "--tags",
          "type": "array<string>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Tags for categorization (optional) (Array of a string)"
        },
        {
          "name": "dependsOn",
          "flag": "--depends-on",
          "type": "array<string>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Task IDs this task depends on — creates DAG edges. Task cannot start until all dependencies are done. Cycles are rejected with an error. (Array of a string)"
        },
        {
          "name": "linkedNotes",
          "flag": "--linked-notes",
          "type": "array<string>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Vault note paths to link to this task (link type defaults to reference) (Array of a string)"
        },
        {
          "name": "metadata",
          "flag": "--metadata",
          "type": "object",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Custom metadata key-value pairs (optional) (object)"
        }
      ],
      "examples": [
        "task create-task \"projectId-value\" \"title-value\" --description \"description-value\" --parent-task-id \"parentTaskId-value\" --priority \"priority-value\" --due-date 1 --assignee \"assignee-value\" --tags \"value-1,value-2\" --depends-on \"value-1,value-2\" --linked-notes \"value-1,value-2\" --metadata '{\"key\":\"value\"}'"
      ]
    },
    {
      "agent": "taskManager",
      "tool": "linkNote",
      "description": "Create or remove a bidirectional link between a vault note and a task. Link types: reference (related note), output (task produces this note), input (task consumes this note). Use action=unlink to remove an existing link.",
      "command": "task link-note",
      "usage": "task link-note <taskId> <notePath> [--link-type <linkType>] [--action <action>]",
      "arguments": [
        {
          "name": "taskId",
          "flag": "--task-id",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Task ID to link the note to (REQUIRED — from createTask or listTasks) (string)"
        },
        {
          "name": "notePath",
          "flag": "--note-path",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Vault note path, e.g. \"folder/note.md\" (REQUIRED) (string)"
        },
        {
          "name": "linkType",
          "flag": "--link-type",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Type of link (default: reference). reference=related note, output=task produces this note, input=task consumes this note (One of: [\"reference\", \"output\", \"input\"])"
        },
        {
          "name": "action",
          "flag": "--action",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Action to perform (default: link) (One of: [\"link\", \"unlink\"])"
        }
      ],
      "examples": [
        "task link-note \"taskId-value\" \"notePath-value\" --link-type \"linkType-value\" --action \"action-value\""
      ]
    },
    {
      "agent": "taskManager",
      "tool": "listProjects",
      "description": "List projects in a workspace with optional status filter (active/completed/archived). Returns paginated project objects with id, name, description, status, and timestamps. Use to discover projectIds for task operations.",
      "command": "task list-projects",
      "usage": "task list-projects [--status <status>] [--page <page>] [--page-size <pageSize>]",
      "arguments": [
        {
          "name": "status",
          "flag": "--status",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Filter by project status (One of: [\"active\", \"completed\", \"archived\"])"
        },
        {
          "name": "page",
          "flag": "--page",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Page number (0-indexed, default: 0) (number) [min: 0]"
        },
        {
          "name": "pageSize",
          "flag": "--page-size",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Items per page (default: 20) (number) [min: 1, max: 100]"
        }
      ],
      "examples": [
        "task list-projects --status \"status-value\" --page 1 --page-size 1"
      ]
    },
    {
      "agent": "taskManager",
      "tool": "listTasks",
      "description": "List tasks in a project with optional filters for status (todo/in_progress/done/cancelled), priority, assignee, and parentTaskId. Returns paginated task objects with full metadata including dependencies and timestamps.",
      "command": "task list-tasks",
      "usage": "task list-tasks <projectId> [--status <status>] [--priority <priority>] [--assignee <assignee>] [--parent-task-id <parentTaskId>] [--include-subtasks] [--sort-by <sortBy>] [--sort-order <sortOrder>] [--page <page>] [--page-size <pageSize>]",
      "arguments": [
        {
          "name": "projectId",
          "flag": "--project-id",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Project ID (REQUIRED — from createProject or listProjects) (string)"
        },
        {
          "name": "status",
          "flag": "--status",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Filter by task status (One of: [\"todo\", \"in_progress\", \"done\", \"cancelled\"])"
        },
        {
          "name": "priority",
          "flag": "--priority",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Filter by priority (One of: [\"critical\", \"high\", \"medium\", \"low\"])"
        },
        {
          "name": "assignee",
          "flag": "--assignee",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Filter by assignee (string)"
        },
        {
          "name": "parentTaskId",
          "flag": "--parent-task-id",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Filter by parent task (subtasks of this task) (string)"
        },
        {
          "name": "includeSubtasks",
          "flag": "--include-subtasks",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Include subtasks in results (default: true) (boolean)"
        },
        {
          "name": "sortBy",
          "flag": "--sort-by",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Sort field (default: updated) (One of: [\"created\", \"updated\", \"priority\", \"title\", \"dueDate\"])"
        },
        {
          "name": "sortOrder",
          "flag": "--sort-order",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Sort direction (default: desc) (One of: [\"asc\", \"desc\"])"
        },
        {
          "name": "page",
          "flag": "--page",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Page number (0-indexed, default: 0) (number) [min: 0]"
        },
        {
          "name": "pageSize",
          "flag": "--page-size",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Items per page (default: 20) (number) [min: 1, max: 100]"
        }
      ],
      "examples": [
        "task list-tasks \"projectId-value\" --status \"status-value\" --priority \"priority-value\" --assignee \"assignee-value\" --parent-task-id \"parentTaskId-value\" --sort-by \"sortBy-value\" --sort-order \"sortOrder-value\" --page 1 --page-size 1"
      ]
    },
    {
      "agent": "taskManager",
      "tool": "moveTask",
      "description": "Move a task to a different project within the same workspace, or change its parent task (set parentTaskId to nest as subtask, null to make top-level). Requires a taskId (from createTask or listTasks).",
      "command": "task move-task",
      "usage": "task move-task <taskId> [--project-id <projectId>] [--parent-task-id <parentTaskId>]",
      "arguments": [
        {
          "name": "taskId",
          "flag": "--task-id",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Task ID to move (REQUIRED — from createTask or listTasks) (string)"
        },
        {
          "name": "projectId",
          "flag": "--project-id",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Target project ID to move the task to (from createProject or listProjects — must be in the same workspace) (string)"
        },
        {
          "name": "parentTaskId",
          "flag": "--parent-task-id",
          "type": "unknown",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] New parent task ID (null to make top-level, string to nest under another task) (string | null)"
        }
      ],
      "examples": [
        "task move-task \"taskId-value\" --project-id \"projectId-value\" --parent-task-id \"parentTaskId-value\""
      ]
    },
    {
      "agent": "taskManager",
      "tool": "openTasks",
      "description": "Open the native Task Board workspace view in Obsidian. Optional filters let you preselect a workspace, project, or search query before the board is shown.",
      "command": "task open-tasks",
      "usage": "task open-tasks [--project-id <projectId>] [--search <search>] [--mode <mode>]",
      "arguments": [
        {
          "name": "projectId",
          "flag": "--project-id",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Optional project ID to preselect in the board filter. (string)"
        },
        {
          "name": "search",
          "flag": "--search",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Optional search query to prefill in the board search input. (string)"
        },
        {
          "name": "mode",
          "flag": "--mode",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Where to open the task board view. (One of: [\"tab\", \"split\", \"current\", \"sidebar\"])"
        }
      ],
      "examples": [
        "task open-tasks --project-id \"projectId-value\" --search \"search-value\" --mode \"mode-value\""
      ]
    },
    {
      "agent": "taskManager",
      "tool": "queryTasks",
      "description": "DAG-aware queries on a project's tasks. Three query types: nextActions returns tasks ready to start (status=todo and all dependencies done), blockedTasks returns tasks waiting on incomplete dependencies with their blocker details, dependencyTree returns the full upstream/downstream dependency graph for a specific task. Requires projectId; dependencyTree also requires taskId.",
      "command": "task query-tasks",
      "usage": "task query-tasks <projectId> <query> [--task-id <taskId>]",
      "arguments": [
        {
          "name": "projectId",
          "flag": "--project-id",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Project ID to query (REQUIRED — from createProject or listProjects) (string)"
        },
        {
          "name": "query",
          "flag": "--query",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Query type (REQUIRED). nextActions: tasks with status=todo whose dependencies are all done — these are ready to start. blockedTasks: tasks waiting on incomplete dependencies, returned with their blocker details. dependencyTree: full upstream/downstream dependency graph for a specific task (requires taskId). (One of: [\"nextActions\", \"blockedTasks\", \"dependencyTree\"])"
        },
        {
          "name": "taskId",
          "flag": "--task-id",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Task ID (REQUIRED for dependencyTree query — from createTask or listTasks) (string)"
        }
      ],
      "examples": [
        "task query-tasks \"projectId-value\" \"query-value\" --task-id \"taskId-value\""
      ]
    },
    {
      "agent": "taskManager",
      "tool": "updateProject",
      "description": "Update a project's name, description, status (active/completed/archived), or custom metadata. Requires a projectId (from createProject or listProjects).",
      "command": "task update-project",
      "usage": "task update-project <projectId> [--name <name>] [--description <description>] [--status <status>] [--metadata <metadata>]",
      "arguments": [
        {
          "name": "projectId",
          "flag": "--project-id",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Project ID to update (REQUIRED — from createProject or listProjects) (string)"
        },
        {
          "name": "name",
          "flag": "--name",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] New project name (string)"
        },
        {
          "name": "description",
          "flag": "--description",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] New project description (string)"
        },
        {
          "name": "status",
          "flag": "--status",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] New project status (One of: [\"active\", \"completed\", \"archived\"])"
        },
        {
          "name": "metadata",
          "flag": "--metadata",
          "type": "object",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Custom metadata to merge (object)"
        }
      ],
      "examples": [
        "task update-project \"projectId-value\" --name \"name-value\" --description \"description-value\" --status \"status-value\" --metadata '{\"key\":\"value\"}'"
      ]
    },
    {
      "agent": "taskManager",
      "tool": "updateTask",
      "description": "Update task fields (title, description, status, priority, dueDate, assignee, tags), manage DAG dependencies (addDependencies/removeDependencies), and manage note links (addNoteLinks/removeNoteLinks). Dependency additions are validated for cycles. Requires a taskId (from createTask or listTasks).",
      "command": "task update-task",
      "usage": "task update-task <taskId> [--title <title>] [--description <description>] [--status <status>] [--priority <priority>] [--due-date <dueDate>] [--assignee <assignee>] [--tags <tags>] [--add-dependencies <addDependencies>] [--remove-dependencies <removeDependencies>] [--add-note-links <addNoteLinks>] [--remove-note-links <removeNoteLinks>] [--metadata <metadata>]",
      "arguments": [
        {
          "name": "taskId",
          "flag": "--task-id",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Task ID to update (REQUIRED — from createTask or listTasks) (string)"
        },
        {
          "name": "title",
          "flag": "--title",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] New task title (string)"
        },
        {
          "name": "description",
          "flag": "--description",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] New task description (string)"
        },
        {
          "name": "status",
          "flag": "--status",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] New task status (setting to done auto-records completedAt timestamp) (One of: [\"todo\", \"in_progress\", \"done\", \"cancelled\"])"
        },
        {
          "name": "priority",
          "flag": "--priority",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] New task priority (One of: [\"critical\", \"high\", \"medium\", \"low\"])"
        },
        {
          "name": "dueDate",
          "flag": "--due-date",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] New due date as Unix timestamp in milliseconds (e.g., Date.now() + 86400000 for tomorrow) (number)"
        },
        {
          "name": "assignee",
          "flag": "--assignee",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] New assignee name or identifier (string)"
        },
        {
          "name": "tags",
          "flag": "--tags",
          "type": "array<string>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Replace entire tags array with these values (Array of a string)"
        },
        {
          "name": "addDependencies",
          "flag": "--add-dependencies",
          "type": "array<string>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Task IDs to add as DAG dependencies — this task cannot start until these are done. Cycles are rejected with an error. (Array of a string)"
        },
        {
          "name": "removeDependencies",
          "flag": "--remove-dependencies",
          "type": "array<string>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Task IDs to remove from this task's dependencies (Array of a string)"
        },
        {
          "name": "addNoteLinks",
          "flag": "--add-note-links",
          "type": "array<object>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Vault notes to link to this task (Array of an object)"
        },
        {
          "name": "removeNoteLinks",
          "flag": "--remove-note-links",
          "type": "array<string>",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Vault note paths to unlink from this task (Array of a string)"
        },
        {
          "name": "metadata",
          "flag": "--metadata",
          "type": "object",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Custom metadata to merge (keys are merged, not replaced) (object)"
        }
      ],
      "examples": [
        "task update-task \"taskId-value\" --title \"title-value\" --description \"description-value\" --status \"status-value\" --priority \"priority-value\" --due-date 1 --assignee \"assignee-value\" --tags \"value-1,value-2\" --add-dependencies \"value-1,value-2\" --remove-dependencies \"value-1,value-2\" --add-note-links \"value-1,value-2\" --remove-note-links \"value-1,value-2\" --metadata '{\"key\":\"value\"}'"
      ]
    },
    {
      "agent": "webTools",
      "tool": "capturePagePdf",
      "description": "Print the current Web Viewer page to PDF and save it to the vault. Desktop only.",
      "command": "web-tools capture-page-pdf",
      "usage": "web-tools capture-page-pdf [--url <url>] [--mode <mode>] <outputPath> [--timeout-ms <timeoutMs>] [--settle-ms <settleMs>]",
      "arguments": [
        {
          "name": "url",
          "flag": "--url",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Optional URL to open in Web Viewer before capturing. (string)"
        },
        {
          "name": "mode",
          "flag": "--mode",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Where to open the Web Viewer tab when url is provided. (One of: [\"tab\", \"split\", \"window\", \"current\"])"
        },
        {
          "name": "outputPath",
          "flag": "--output-path",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Destination PDF path in the vault. Required so the caller explicitly chooses where the document is saved. (string)"
        },
        {
          "name": "timeoutMs",
          "flag": "--timeout-ms",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Maximum time to wait for page load. (number)"
        },
        {
          "name": "settleMs",
          "flag": "--settle-ms",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Extra delay after page load before printing. (number)"
        }
      ],
      "examples": [
        "web-tools capture-page-pdf --url \"url-value\" --mode \"mode-value\" \"outputPath-value\" --timeout-ms 1 --settle-ms 1"
      ]
    },
    {
      "agent": "webTools",
      "tool": "capturePagePng",
      "description": "Capture the current Web Viewer page as a PNG image and save it to the vault. Desktop only.",
      "command": "web-tools capture-page-png",
      "usage": "web-tools capture-page-png [--url <url>] [--mode <mode>] <outputPath> [--timeout-ms <timeoutMs>] [--settle-ms <settleMs>]",
      "arguments": [
        {
          "name": "url",
          "flag": "--url",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Optional URL to open in Web Viewer before capturing. (string)"
        },
        {
          "name": "mode",
          "flag": "--mode",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Where to open the Web Viewer tab when url is provided. (One of: [\"tab\", \"split\", \"window\", \"current\"])"
        },
        {
          "name": "outputPath",
          "flag": "--output-path",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Destination PNG path in the vault. Required so the caller explicitly chooses where the image is saved. (string)"
        },
        {
          "name": "timeoutMs",
          "flag": "--timeout-ms",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Maximum time to wait for page load. (number)"
        },
        {
          "name": "settleMs",
          "flag": "--settle-ms",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Extra delay after page load before capturing. (number)"
        }
      ],
      "examples": [
        "web-tools capture-page-png --url \"url-value\" --mode \"mode-value\" \"outputPath-value\" --timeout-ms 1 --settle-ms 1"
      ]
    },
    {
      "agent": "webTools",
      "tool": "captureToMarkdown",
      "description": "Save the active Web Viewer page to the vault as Markdown using Obsidian Web Viewer. Desktop only.",
      "command": "web-tools capture-to-markdown",
      "usage": "web-tools capture-to-markdown [--url <url>] [--mode <mode>] <outputPath> [--timeout-ms <timeoutMs>] [--settle-ms <settleMs>]",
      "arguments": [
        {
          "name": "url",
          "flag": "--url",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Optional URL to open in Web Viewer before capturing. If omitted, captures the active Web Viewer tab. (string)"
        },
        {
          "name": "mode",
          "flag": "--mode",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Where to open the Web Viewer tab when url is provided. (One of: [\"tab\", \"split\", \"window\", \"current\"])"
        },
        {
          "name": "outputPath",
          "flag": "--output-path",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] Destination note path in the vault. Required so the caller explicitly chooses where the Markdown capture is saved. (string)"
        },
        {
          "name": "timeoutMs",
          "flag": "--timeout-ms",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Maximum time to wait for page load and note creation. (number)"
        },
        {
          "name": "settleMs",
          "flag": "--settle-ms",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Extra delay after page load before invoking Save to vault. (number)"
        }
      ],
      "examples": [
        "web-tools capture-to-markdown --url \"url-value\" --mode \"mode-value\" \"outputPath-value\" --timeout-ms 1 --settle-ms 1"
      ]
    },
    {
      "agent": "webTools",
      "tool": "extractLinks",
      "description": "Extract links from the current Web Viewer page. Desktop only.",
      "command": "web-tools extract-links",
      "usage": "web-tools extract-links [--url <url>] [--mode <mode>] [--max-links <maxLinks>] [--timeout-ms <timeoutMs>] [--settle-ms <settleMs>]",
      "arguments": [
        {
          "name": "url",
          "flag": "--url",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Optional URL to open in Web Viewer before extracting links. (string)"
        },
        {
          "name": "mode",
          "flag": "--mode",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Where to open the Web Viewer tab when url is provided. (One of: [\"tab\", \"split\", \"window\", \"current\"])"
        },
        {
          "name": "maxLinks",
          "flag": "--max-links",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Maximum number of links to return. (number)"
        },
        {
          "name": "timeoutMs",
          "flag": "--timeout-ms",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Maximum time to wait for page load. (number)"
        },
        {
          "name": "settleMs",
          "flag": "--settle-ms",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Extra delay after page load before extracting links. (number)"
        }
      ],
      "examples": [
        "web-tools extract-links --url \"url-value\" --mode \"mode-value\" --max-links 1 --timeout-ms 1 --settle-ms 1"
      ]
    },
    {
      "agent": "webTools",
      "tool": "openWebpage",
      "description": "Open a webpage in Obsidian Web Viewer. Desktop only.",
      "command": "web-tools open-webpage",
      "usage": "web-tools open-webpage <url> [--mode <mode>] [--focus] [--timeout-ms <timeoutMs>] [--settle-ms <settleMs>]",
      "arguments": [
        {
          "name": "url",
          "flag": "--url",
          "type": "string",
          "required": true,
          "positional": true,
          "description": "[REQUIRED] The webpage URL to open in Obsidian Web Viewer. (string)"
        },
        {
          "name": "mode",
          "flag": "--mode",
          "type": "string",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Where to open the Web Viewer tab. (One of: [\"tab\", \"split\", \"window\", \"current\"])"
        },
        {
          "name": "focus",
          "flag": "--focus",
          "type": "boolean",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Whether to focus the Web Viewer tab after opening it. (boolean)"
        },
        {
          "name": "timeoutMs",
          "flag": "--timeout-ms",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Maximum time to wait for the page to load. (number)"
        },
        {
          "name": "settleMs",
          "flag": "--settle-ms",
          "type": "number",
          "required": false,
          "positional": false,
          "description": "[OPTIONAL] Extra delay after load before returning, to allow client-side rendering to settle. (number)"
        }
      ],
      "examples": [
        "web-tools open-webpage \"url-value\" --mode \"mode-value\" --timeout-ms 1 --settle-ms 1"
      ]
    }
  ]
}