{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/commentary-dev/json-schema/commentary-dev-agent-inbox-entry-schema.json",
  "title": "AgentInboxEntry",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/commentary-dev-inbox-api-openapi.yml#/components/schemas/AgentInboxEntry",
  "type": "object",
  "additionalProperties": true,
  "properties": {
    "notification": {
      "anyOf": [
        {
          "$ref": "#/$defs/WorkspaceNotificationContext"
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional authorized context for new built-in workspace notifications. Legacy and custom Interactions are unchanged."
    }
  },
  "$defs": {
    "WorkspaceNotificationContext": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "version",
        "intent",
        "kind",
        "title",
        "summary",
        "recipientReason",
        "nextStep",
        "actionLabel",
        "href",
        "actorName",
        "excerpt",
        "location",
        "resultCount"
      ],
      "properties": {
        "version": {
          "const": 2
        },
        "intent": {
          "type": "string",
          "enum": [
            "action",
            "information"
          ]
        },
        "kind": {
          "type": "string",
          "enum": [
            "review_requested",
            "revision_ready",
            "comment",
            "reply",
            "mention",
            "thread_reopened",
            "thread_resolved",
            "review_status",
            "submission_failed",
            "submission_completed",
            "sync_failed",
            "sync_recovered",
            "refresh_failed",
            "form_responses",
            "form_blocked",
            "form_recovered",
            "evaluation_ready",
            "research_results",
            "evidence_failed",
            "evidence_recovered",
            "assignment",
            "reassigned",
            "approval_blocked",
            "policy_approval",
            "webhook_failed",
            "job_failed",
            "responsibility_changed",
            "request_completed"
          ]
        },
        "title": {
          "type": "string"
        },
        "summary": {
          "type": "string"
        },
        "recipientReason": {
          "type": "string"
        },
        "nextStep": {
          "type": [
            "string",
            "null"
          ]
        },
        "actionLabel": {
          "type": "string"
        },
        "href": {
          "type": "string"
        },
        "actorName": {
          "type": "string"
        },
        "excerpt": {
          "type": [
            "string",
            "null"
          ]
        },
        "location": {
          "type": [
            "string",
            "null"
          ]
        },
        "resultCount": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0
        }
      }
    }
  }
}