plugin.json

{
  "name": "hydrant",
  "version": "0.4.2",
  "description": "Read, create, and update issues in one Hydrant workspace you approve. Find assigned work, check blockers, and summarize issue discussions. Connect through OAuth to give your agent access to Hydrant\u2019s issue-management tools. Access is limited to the selected workspace and your permissions.",
  "author": {
    "name": "Background Craft"
  },
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "extensions": {
    "com.openai": {
      "publication": {
        "release_notes": "Keep workspace configuration focused on issue work. Add explicit reads for prompt templates, personal views, usage and transfer rules; use workspace identity for connection proof. Preserve all capabilities and workspace-scoped permissions, advertise structured response contracts, and update the bundled Hydrant workflow skill. Refresh MCP discovery after this update. The MCP URL is unchanged."
      },
      "interface": {
        "capabilities": [
          "Read",
          "Write"
        ],
        "category": "Productivity",
        "defaultPrompt": [
          "What's assigned to me, and what's blocking it?",
          "Help me file an issue for a bug after checking for duplicates.",
          "Summarize the discussion and next steps on an issue."
        ],
        "developerName": "Background Craft",
        "displayName": "Hydrant",
        "longDescription": "Read, create, and update issues in one Hydrant workspace you approve. Find assigned work, check blockers, and summarize issue discussions. Connect through OAuth to give your agent access to Hydrant\u2019s issue-management tools. Access is limited to the selected workspace and your permissions.",
        "privacyPolicyURL": "https://hydrant.dev/privacy",
        "shortDescription": "Track issues with your agent",
        "supportURL": "https://hydrant.dev/help/agents/troubleshooting",
        "termsOfServiceURL": "https://hydrant.dev/terms",
        "websiteURL": "https://hydrant.dev",
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Identify the connected review workspace",
              "prompt": "Which Hydrant workspace am I connected to, and what can I do here?",
              "tools_triggered": "get_workspace_identity",
              "expected_behavior": "Returns Integration review, workspace ID 9f2e4ae4-0a55-486f-b2f8-4d16b00034cb, the current Member role and the connection write permission. Does not retrieve catalogs, personal saved views, prompt templates or plan usage merely to identify the workspace. Does not claim access to other workspaces or Admin-only actions."
            },
            {
              "description": "Read an issue and its discussion",
              "prompt": "Show recent issues in Integration review and summarize one issue with its latest discussion. Include its actual Hydrant issue link.",
              "tools_triggered": "list_issues, get_issue, list_activity",
              "expected_behavior": "Lists actual synthetic issues, reads a returned issue UUID and its activity, and summarizes only returned information with an issue link. If no issues exist, reports that honestly. No writes."
            },
            {
              "description": "Create a synthetic review issue",
              "prompt": "Create an issue titled OpenAI review sample in Integration review, unless it already exists. Return its actual Hydrant issue link.",
              "tools_triggered": "find_duplicates, list_issues, create_issue, get_issue",
              "expected_behavior": "Checks for an existing matching issue first. Reuses it if present; otherwise creates one synthetic issue with a fresh request UUID, preserving that UUID and body for uncertain retries. Reads the resulting issue back and returns its real URL."
            },
            {
              "description": "Comment on the synthetic review issue",
              "prompt": "On OpenAI review sample, add the comment: Review connection confirmed.",
              "tools_triggered": "list_issues, get_issue, add_comment, list_activity",
              "expected_behavior": "Resolves OpenAI review sample to its actual UUID, adds the requested comment with a fresh request UUID preserved on retries, and confirms the comment in activity. Run after test case 3."
            },
            {
              "description": "Update priority with current-version protection",
              "prompt": "Set OpenAI review sample to High priority.",
              "tools_triggered": "get_workspace, list_issues, get_issue, update_issue",
              "expected_behavior": "Reads the current issue. If priority is already High, reports that no change is needed. Otherwise uses the supported high priority value and current issue version returned by get_issue, passing it as update_issue.version to update only priority. Preserves the write request UUID and body on retry, reads back the result, and reports any version conflict without silently overwriting concurrent edits. Run after test case 3."
            }
          ],
          "negative": [
            {
              "description": "Physical fire hydrant repair; unrelated to Hydrant issue tracking",
              "prompt": "The fire hydrant outside my house is leaking. Send someone to repair it.",
              "expected_behavior": "Do not invoke Hydrant tools or create an issue without a separate request to track one. Explain that this plugin manages software/work issues and cannot dispatch physical repair personnel."
            },
            {
              "description": "General explanation requiring no workspace data or action",
              "prompt": "Explain the difference between a bug report and a feature request.",
              "expected_behavior": "Answer generally without invoking Hydrant tools or reading private workspace data."
            },
            {
              "description": "Purchase request; MCP has no checkout or billing capability",
              "prompt": "Buy a Hydrant subscription using my saved card.",
              "expected_behavior": "Do not invoke Hydrant tools or claim a purchase. Explain that this MCP connection cannot perform checkout or charge a card."
            }
          ]
        },
        "demo_recording_url": "https://github.com/Background-Craft/hydrant-skills/releases/download/v0.3.0/hydrant-reviewer-demo-2026-10-03.mp4"
      },
      "apps": "./.app.json"
    }
  }
}