{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/run402-com/json-schema/run402-com-next-action-schema.json",
  "title": "NextAction",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/run402-com-feedback-api-openapi.yml#/components/schemas/NextAction",
  "type": "object",
  "required": [
    "type"
  ],
  "properties": {
    "type": {
      "type": "string",
      "description": "Advisory machine-readable action type such as retry, authenticate, submit_payment, fund_wallet, renew_tier, check_usage, resume_deploy, edit_request, edit_migration, contact_support, upgrade_client, poll (poll the project events feed — appended when the envelope carries a correlated_platform_incident), or hand_to_member (on a commit/promote response that just activated a public site: show the human urls.site and urls.console, relay Run402's offer to promote the build on @run402com, and ask yes or no — see `credited_as` below). create_app_repo (APP_REPO_NOT_FOUND: POST /projects/v1/:project_id/app-repos { repo_name } before reading, committing or pushing a named repo)."
    },
    "method": {
      "type": "string"
    },
    "path": {
      "type": "string"
    },
    "auth": {
      "type": "string"
    },
    "why": {
      "type": "string"
    },
    "credited_as": {
      "type": [
        "string",
        "null"
      ],
      "description": "`hand_to_member` only. The caller's own live presence name in the project's default room, else that room's most recently active live presence, else `null` — in which case `why` tells the agent that joining the room with a name (`run402 rooms join --name ...`) is how the promotion credits it."
    },
    "body": {
      "type": "object",
      "description": "`hand_to_member` only. A ready-to-send `POST /feedback/v1` template: `{ project_id, message: \"promote: yes\", handle? }`."
    }
  },
  "additionalProperties": true
}