{
  "version": 1,
  "tools": [
    {
      "name": "media_generate_image",
      "description": "Generate or edit images using AI. Supports text-to-image generation and image editing with source images. Saves results into the workspace and returns their file paths; present a result to the user by embedding its path in your reply as ![description](vellum://workspace/<path>).",
      "category": "media",
      "risk": "low",
      "input_schema": {
        "type": "object",
        "properties": {
          "prompt": {
            "type": "string",
            "description": "A text description of the image to generate or the edits to apply"
          },
          "mode": {
            "type": "string",
            "enum": ["generate", "edit"],
            "description": "Whether to generate a new image or edit an existing one (default: generate)"
          },
          "source_paths": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "File paths to source images in the workspace (for edit mode)"
          },
          "model": {
            "type": "string",
            "description": "Model tier alias (fast | quality | openai) or a concrete model ID. If omitted, uses the user's configured preference. Unknown values return an error listing currently available models."
          },
          "variants": {
            "type": "number",
            "description": "Number of image variants to generate (1-4, default: 1)"
          }
        },
        "required": ["prompt"]
      },
      "executor": "tools/media-generate-image.ts",
      "execution_target": "host"
    }
  ]
}