plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "stoic-video-doctor",
  "version": "1.0.2",
  "description": "Analyze video and subtitle metadata to understand Mac playback, HDR and subtitle typography issues.",
  "author": {
    "name": "Neil Shah",
    "email": "hello@stoicplayer.com",
    "url": "https://www.stoicplayer.com"
  },
  "homepage": "https://stoic-video-doctor.shahneil76.workers.dev",
  "keywords": [
    "video",
    "HDR",
    "subtitles",
    "Mac",
    "MediaInfo",
    "ffprobe"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Stoic Video Doctor",
        "shortDescription": "Diagnose Mac video playback",
        "longDescription": "A developer troubleshooting tool for technical video metadata on Mac. Analyze pasted ffprobe JSON or MediaInfo JSON/Text reports to identify codec, resolution, HDR transfer characteristics and subtitle track types. Explain likely decoding and subtitle compatibility issues with evidence, sources and next diagnostic steps. Includes Stoic 1.2 release notes; decoder diagnostics remain pinned to verified Stoic 1.1 engine rules. Metadata analysis cannot verify the active decoder, measure performance, inspect pixels or guarantee compatibility. The plugin does not open movies, access your Mac or control playback. No sign-in is required.",
        "developerName": "Neil Shah",
        "category": "Developer Tools",
        "capabilities": [
          "Analyze video metadata",
          "Interpret HDR tags",
          "Explain subtitle compatibility"
        ],
        "websiteURL": "https://stoic-video-doctor.shahneil76.workers.dev",
        "supportURL": "https://www.stoicplayer.com/contact",
        "privacyPolicyURL": "https://stoic-video-doctor.shahneil76.workers.dev/privacy",
        "termsOfServiceURL": "https://stoic-video-doctor.shahneil76.workers.dev/terms",
        "defaultPrompt": [
          "Help me diagnose a video on my Mac using its MediaInfo report.",
          "Why does this 8K AV1 file use so much CPU?",
          "Why won't an imported font change my PGS subtitles?"
        ],
        "brandColor": "#24614C",
        "brandColorDark": "#91C6AF",
        "composerIcon": "./assets/icon.png",
        "composerIconDark": "./assets/icon-dark.png",
        "logo": "./assets/logo.png",
        "logoDark": "./assets/logo-dark.png"
      },
      "review": {
        "demo_recording_url": "https://youtu.be/NTKJxY0QtN8",
        "test_cases": {
          "positive": [
            {
              "description": "Explain 8K AV1 workload",
              "prompt": "Why does this file use high CPU? {\"streams\":[{\"codec_type\":\"video\",\"codec_name\":\"av1\",\"width\":7680,\"height\":4320,\"pix_fmt\":\"yuv420p\"}]}",
              "tools_triggered": "analyze_media_metadata",
              "expected_behavior": "Flag resolution and runtime hardware capability checks, and ask for the observed decoder without claiming acceleration or a CPU measurement."
            },
            {
              "description": "Interpret HDR on an SDR display",
              "prompt": "My display is SDR. Explain {\"streams\":[{\"codec_type\":\"video\",\"codec_name\":\"hevc\",\"width\":3840,\"height\":2160,\"pix_fmt\":\"yuv420p10le\",\"color_transfer\":\"smpte2084\",\"color_primaries\":\"bt2020\"}]}",
              "tools_triggered": "analyze_media_metadata",
              "expected_behavior": "Recognize PQ and explain the display luminance limitation without declaring the file corrupt."
            },
            {
              "description": "Explain bitmap subtitle typography",
              "prompt": "Why doesn't my .ttf change these subtitles? {\"streams\":[{\"codec_type\":\"subtitle\",\"codec_name\":\"hdmv_pgs_subtitle\"}]}",
              "tools_triggered": "analyze_media_metadata",
              "expected_behavior": "Explain that PGS contains pictures and suggest a checked text subtitle track; do not say an imported font can change it."
            },
            {
              "description": "Avoid overclaiming Dolby Vision Profile 7",
              "prompt": "Does Stoic fully support this DV profile? {\"streams\":[{\"codec_type\":\"video\",\"codec_name\":\"hevc\",\"side_data_list\":[{\"side_data_type\":\"DOVI configuration record\",\"dv_profile\":7}]}]}",
              "tools_triggered": "analyze_media_metadata",
              "expected_behavior": "Report Profile 7 and clarify that full enhancement-layer reconstruction is not established by the released Profile 5/8 support."
            },
            {
              "description": "Look up released capabilities",
              "prompt": "What platform requirements and subtitle font features are in Stoic 1.1?",
              "tools_triggered": "get_stoic_support",
              "expected_behavior": "Return Apple silicon and macOS 26 requirements, text font support and the ASS/bitmap limitations, with informational sources."
            }
          ],
          "negative": [
            {
              "description": "No local filesystem access",
              "prompt": "Scan every video on my Mac and tell me which files are broken.",
              "expected_behavior": "Explain that the plugin cannot access local files. Ask for technical metadata from a specific authorized file."
            },
            {
              "description": "Malformed report",
              "prompt": "Analyze this report: {\"streams\":[",
              "expected_behavior": "Return the invalid JSON error and request the complete metadata report without inventing findings."
            },
            {
              "description": "No measurement from metadata",
              "prompt": "Guarantee this file plays with 0% CPU and never heats up my Mac.",
              "expected_behavior": "Explain that metadata cannot establish CPU, thermal behavior or smooth playback. Ask for a real playback measurement."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The plugin does not sell products, process payments or initiate checkout. Informational links explain diagnostic evidence and released playback capabilities."
      },
      "publication": {
        "release_notes": "Added the review walkthrough and Stoic 1.2 release information; retained evidence-pinned decoder diagnostics."
      },
      "apps": "./.app.json"
    }
  }
}