imgflow.taoliapp.com

{
  "name": "add_image_from_url",
  "kind": "act",
  "impl": "imperative",
  "description": "Adds an image to this page's compression queue from a URL and compression starts automatically. Accepts https:// URLs from hosts that allow cross-origin fetch, or data: URLs (no CORS restriction). Monitor progress with get_compression_status.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "url": {
        "type": "string",
        "description": "Image URL. Must be https:// (host must allow cross-origin fetch) or a data: URL."
      },
      "name": {
        "type": "string",
        "description": "Optional file name for the queued image, with extension if known."
      }
    },
    "required": [
      "url"
    ]
  },
  "page": "/"
}

{
  "name": "set_compression_settings",
  "kind": "act",
  "impl": "imperative",
  "description": "Configures image compression: output format or multiple export formats, quality (1-100) or target size in KB, max pixel dimension, ICC preservation, PNG quantization. Pass start:true to re-queue the current images with these settings and begin compressing.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "format": {
        "type": "string",
        "enum": [
          "original",
          "auto",
          "jpeg",
          "webp",
          "avif",
          "png",
          "jxl"
        ],
        "description": "Primary output format. original/auto keeps each input's format; others convert."
      },
      "targetFormats": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "jpeg",
            "webp",
            "avif",
            "png",
            "jxl"
          ]
        },
        "description": "Export formats; each image is compressed once per format. Sets format to the first entry."
      },
      "mode": {
        "type": "string",
        "enum": [
          "smart",
          "quality",
          "target"
        ],
        "description": "smart = automatic per-image quality ladder; quality = encode at a quality level; target = hit targetKB per image."
      },
      "quality": {
        "type": "number",
        "description": "Encoder quality 1-100. Applies to the lossy format in effect (webp when format is original/auto). Ignored in target mode."
      },
      "targetKB": {
        "type": "number",
        "description": "Target size per image in kilobytes (mode=target)."
      },
      "maxEdge": {
        "type": "number",
        "enum": [
          0,
          2048,
          2560,
          4096
        ],
        "description": "Shrink so the longest edge is at most this many pixels. 0 keeps original size."
      },
      "keepIcc": {
        "type": "boolean",
        "description": "Keep embedded ICC color profiles."
      },
      "pngQuantize": {
        "type": "boolean",
        "description": "Quantize PNG output to reduce size (may reduce quality)."
      },
      "start": {
        "type": "boolean",
        "description": "Re-queue current images with the new settings and start compressing now."
      }
    }
  },
  "page": "/"
}

{
  "name": "get_compression_status",
  "kind": "answer",
  "impl": "imperative",
  "description": "Returns the compression queue: running flag, counts by status, total bytes saved, per-image results (first 8), and the current compression settings.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "download_image",
  "kind": "act",
  "impl": "imperative",
  "description": "Downloads one finished image to the browser's default download folder. Match by exact or partial file name.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "name": {
        "type": "string",
        "description": "File name of the finished image to download (exact or substring match)."
      }
    },
    "required": [
      "name"
    ]
  },
  "page": "/"
}

{
  "name": "download_all_results",
  "kind": "act",
  "impl": "imperative",
  "description": "Downloads all finished images as a single ZIP archive to the browser's default download folder.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "reset_queue",
  "kind": "act",
  "impl": "imperative",
  "description": "Clears all images and results from the queue. Use before adding a new batch of images.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}