{
  "name": "github-issues",
  "version": "0.1.1",
  "description": "Read and update GitHub issues using a compact, agent-friendly action surface.",
  "files": [
    "dist/"
  ],
  "entrypoint": {
    "args": [
      "dist/index.js"
    ],
    "command": "node",
    "timeout_ms": 30000
  },
  "environment": {
    "vars": {
      "GITHUB_TOKEN": {
        "required": true,
        "description": "GitHub personal access token or app token used for API requests."
      },
      "GITHUB_API_BASE_URL": {
        "default": "https://api.github.com",
        "required": false,
        "description": "Optional GitHub API base URL. Defaults to https://api.github.com."
      }
    }
  },
  "inputs": {
    "type": "object",
    "required": [
      "action",
      "owner",
      "repo"
    ],
    "properties": {
      "body": {
        "type": "string",
        "description": "Issue body or comment body, depending on the action."
      },
      "repo": {
        "type": "string",
        "description": "GitHub repository name."
      },
      "owner": {
        "type": "string",
        "description": "GitHub repository owner or organization."
      },
      "state": {
        "enum": [
          "open",
          "closed"
        ],
        "type": "string",
        "description": "Issue state for list or update actions."
      },
      "title": {
        "type": "string",
        "description": "Issue title for create actions."
      },
      "action": {
        "enum": [
          "list_issues",
          "get_issue",
          "create_issue",
          "comment_issue",
          "update_issue_state"
        ],
        "type": "string",
        "description": "GitHub issue action to perform."
      },
      "labels": {
        "type": "array",
        "items": {
          "type": "string",
          "description": "One GitHub issue label."
        },
        "description": "Issue labels for create actions."
      },
      "per_page": {
        "type": "integer",
        "default": 20,
        "maximum": 100,
        "minimum": 1,
        "description": "Maximum number of issues to return for list actions."
      },
      "issue_number": {
        "type": "integer",
        "minimum": 1,
        "description": "Issue number for get, comment, or update actions."
      }
    },
    "additionalProperties": false
  },
  "outputs": {
    "oneOf": [
      {
        "type": "object",
        "required": [
          "ok",
          "action",
          "repository",
          "metadata"
        ],
        "properties": {
          "ok": {
            "const": true,
            "description": "True when the GitHub API call succeeded."
          },
          "issue": {
            "type": "object",
            "description": "Normalized issue returned by get, create, or update actions.",
            "additionalProperties": true
          },
          "action": {
            "type": "string",
            "description": "Action that was executed."
          },
          "issues": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "One normalized GitHub issue.",
              "additionalProperties": true
            },
            "description": "Normalized issue list returned by list actions."
          },
          "comment": {
            "type": "object",
            "description": "Normalized comment returned by comment actions.",
            "additionalProperties": true
          },
          "metadata": {
            "type": "object",
            "description": "Additional request metadata such as pagination or state.",
            "additionalProperties": true
          },
          "repository": {
            "type": "string",
            "description": "Repository in owner/repo form."
          }
        },
        "additionalProperties": false
      },
      {
        "type": "object",
        "required": [
          "ok",
          "error"
        ],
        "properties": {
          "ok": {
            "const": false,
            "description": "False when validation or the GitHub API call failed."
          },
          "error": {
            "type": "object",
            "required": [
              "code",
              "message"
            ],
            "properties": {
              "code": {
                "type": "string",
                "description": "Stable machine-readable error code."
              },
              "details": {
                "type": "object",
                "description": "Optional structured context about the failure.",
                "additionalProperties": true
              },
              "message": {
                "type": "string",
                "description": "Human-readable explanation of the failure."
              }
            },
            "description": "Structured error returned by the tool.",
            "additionalProperties": true
          }
        },
        "additionalProperties": false
      }
    ]
  },
  "readme": "README.md",
  "license": {
    "spdx": "MIT"
  },
  "runtime": {
    "type": "node",
    "version": "20"
  }
}