awoooi/docs/schemas/ai_agent_telegram_receipt_approval_package_v1.schema.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://awoooi.wooo.work/schemas/ai_agent_telegram_receipt_approval_package_v1.schema.json",
  "title": "AI Agent Telegram Receipt Approval Package",
  "type": "object",
  "required": [
    "schema_version",
    "generated_at",
    "program_status",
    "telegram_truth",
    "receipt_package",
    "receipt_gates",
    "receipt_lanes",
    "retry_contract",
    "approval_boundaries",
    "display_redaction_contract",
    "rollups"
  ],
  "properties": {
    "schema_version": {
      "const": "ai_agent_telegram_receipt_approval_package_v1"
    },
    "generated_at": {
      "type": "string"
    },
    "program_status": {
      "type": "object",
      "required": [
        "overall_completion_percent",
        "current_task_id",
        "next_task_id",
        "read_only_mode",
        "runtime_authority"
      ],
      "properties": {
        "overall_completion_percent": { "type": "integer" },
        "current_priority": { "type": "string" },
        "current_task_id": { "const": "P2-403E" },
        "next_task_id": { "const": "P2-403F" },
        "read_only_mode": { "const": true },
        "runtime_authority": { "const": "approval_package_only_no_telegram_send" },
        "status_note": { "type": "string" }
      },
      "additionalProperties": false
    },
    "telegram_truth": {
      "type": "object",
      "properties": {
        "telegram_send_allowed": { "const": false },
        "gateway_queue_write_allowed": { "const": false },
        "direct_bot_api_allowed": { "const": false },
        "receiver_route_change_allowed": { "const": false },
        "runtime_worker_allowed": { "const": false },
        "live_queued_receipt_count": { "const": 0 },
        "live_delivered_receipt_count": { "const": 0 },
        "live_acknowledged_receipt_count": { "const": 0 },
        "live_failed_receipt_count": { "const": 0 },
        "live_retry_count": { "const": 0 },
        "truth_note": { "type": "string" }
      },
      "additionalProperties": false
    },
    "receipt_package": {
      "type": "object",
      "required": [
        "required_fields",
        "forbidden_fields",
        "owner_review_required",
        "retry_policy_required",
        "delivery_receipt_required"
      ],
      "properties": {
        "required_fields": { "type": "array", "items": { "type": "string" } },
        "forbidden_fields": { "type": "array", "items": { "type": "string" } },
        "owner_review_required": { "const": true },
        "retry_policy_required": { "const": true },
        "delivery_receipt_required": { "const": true },
        "operator_meaning": { "type": "string" }
      },
      "additionalProperties": false
    },
    "receipt_gates": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["gate_id", "display_name", "owner_agent", "status", "required_evidence", "blocked_runtime_action"],
        "properties": {
          "gate_id": { "type": "string" },
          "display_name": { "type": "string" },
          "owner_agent": { "enum": ["openclaw", "hermes", "nemotron"] },
          "status": { "type": "string" },
          "required_evidence": { "type": "string" },
          "blocked_runtime_action": { "type": "string" }
        },
        "additionalProperties": false
      }
    },
    "receipt_lanes": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["lane_id", "display_name", "target_surface", "status", "owner_agent", "review_owner", "required_review"],
        "properties": {
          "lane_id": { "type": "string" },
          "display_name": { "type": "string" },
          "target_surface": { "type": "string" },
          "status": { "type": "string" },
          "owner_agent": { "enum": ["openclaw", "hermes", "nemotron"] },
          "review_owner": { "type": "string" },
          "required_review": { "type": "string" }
        },
        "additionalProperties": false
      }
    },
    "retry_contract": {
      "type": "object",
      "required": ["retry_required", "retry_steps"],
      "properties": {
        "retry_required": { "const": true },
        "retry_steps": { "type": "array", "items": { "type": "string" } }
      },
      "additionalProperties": false
    },
    "approval_boundaries": {
      "type": "object",
      "additionalProperties": { "const": false }
    },
    "display_redaction_contract": {
      "type": "object",
      "properties": {
        "redaction_required": { "const": true },
        "raw_payload_display_allowed": { "const": false },
        "private_reasoning_display_allowed": { "const": false },
        "secret_value_display_allowed": { "const": false },
        "allowed_frontend_content": { "type": "array", "items": { "type": "string" } },
        "forbidden_frontend_content": { "type": "array", "items": { "type": "string" } },
        "frontend_display_policy": { "type": "string" }
      },
      "additionalProperties": false
    },
    "rollups": {
      "type": "object",
      "required": [
        "receipt_gate_count",
        "receipt_lane_count",
        "approval_required_gate_ids",
        "blocked_runtime_action_count",
        "required_field_count",
        "forbidden_field_count",
        "live_receipt_count_total"
      ],
      "properties": {
        "receipt_gate_count": { "type": "integer" },
        "receipt_lane_count": { "type": "integer" },
        "approval_required_gate_ids": { "type": "array", "items": { "type": "string" } },
        "blocked_runtime_action_count": { "type": "integer" },
        "required_field_count": { "type": "integer" },
        "forbidden_field_count": { "type": "integer" },
        "live_receipt_count_total": { "const": 0 }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}