Skip to content

output-event

Generated reference page for spec/v1/schemas/events/output-event.json.

Metadata

  • Type: JSON Schema
  • Source: spec/v1/schemas/events/output-event.json
  • Raw: View Raw

Summary

Source

json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://agent-service.spec/v1/schemas/events/output-event.json",
  "$defs": {
    "OutputEventType": {
      "type": "string",
      "enum": [
        "run.status.changed",
        "message.delta",
        "message.completed",
        "reasoning.delta",
        "reasoning.completed",
        "tool_call.delta",
        "tool_call.completed",
        "tool_result",
        "artifact.updated",
        "interaction.requested",
        "interaction.updated",
        "interaction.responded",
        "state.updated"
      ]
    },
    "OutputEvent": {
      "type": "object",
      "additionalProperties": false,
      "required": ["type", "eventId", "createdAt"],
      "properties": {
        "type": {
          "$ref": "#/$defs/OutputEventType"
        },
        "eventId": {
          "$ref": "../common/identity.json#/$defs/eventId"
        },
        "threadId": {
          "$ref": "../common/identity.json#/$defs/threadId"
        },
        "messageId": {
          "$ref": "../common/identity.json#/$defs/messageId"
        },
        "toolCallId": {
          "$ref": "../common/identity.json#/$defs/opaqueId"
        },
        "callableAlias": {
          "type": "string"
        },
        "calledResourceType": {
          "$ref": "../common/enums.json#/$defs/taskResourceType"
        },
        "childRunId": {
          "$ref": "../common/identity.json#/$defs/runId"
        },
        "providerOrgId": {
          "$ref": "../common/identity.json#/$defs/orgId"
        },
        "artifactId": {
          "$ref": "../common/identity.json#/$defs/artifactId"
        },
        "interactionId": {
          "$ref": "../common/identity.json#/$defs/interactionId"
        },
        "status": {
          "$ref": "../common/enums.json#/$defs/taskStatus"
        },
        "visibility": {
          "$ref": "../common/enums.json#/$defs/eventVisibility"
        },
        "audience": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "captureMode": {
          "$ref": "../common/otel.json#/$defs/ContentCaptureMode"
        },
        "content": {},
        "delta": {},
        "payload": {},
        "result": {},
        "error": {
          "type": "string"
        },
        "blockedReason": {
          "$ref": "../common/enums.json#/$defs/taskBlockedReason"
        },
        "prompt": {
          "$ref": "../resources/interaction-request.json#/$defs/InteractionPrompt"
        },
        "payloadSchema": {
          "type": "object",
          "additionalProperties": true
        },
        "options": {
          "type": "array",
          "items": {
            "$ref": "../resources/interaction-request.json#/$defs/InteractionOption"
          }
        },
        "response": {
          "$ref": "../resources/interaction-request.json#/$defs/InteractionResponse"
        },
        "metadata": {
          "type": "object",
          "additionalProperties": true
        },
        "createdAt": {
          "$ref": "../common/identity.json#/$defs/timestamp"
        }
      }
    },
    "SequencedOutputEnvelope": {
      "type": "object",
      "additionalProperties": false,
      "required": ["runId", "sequence", "event"],
      "properties": {
        "runId": {
          "$ref": "../common/identity.json#/$defs/runId"
        },
        "threadId": {
          "$ref": "../common/identity.json#/$defs/threadId"
        },
        "sequence": {
          "$ref": "../common/identity.json#/$defs/sequence"
        },
        "event": {
          "$ref": "#/$defs/OutputEvent"
        }
      }
    },
    "StreamKeepalive": {
      "type": "object",
      "additionalProperties": false,
      "required": ["type", "cursor"],
      "properties": {
        "type": {
          "const": "KEEPALIVE"
        },
        "cursor": {
          "$ref": "../common/identity.json#/$defs/cursor"
        }
      }
    },
    "RunStreamTerminal": {
      "type": "object",
      "additionalProperties": false,
      "required": ["type", "runId", "status"],
      "properties": {
        "type": {
          "const": "TERMINAL"
        },
        "runId": {
          "$ref": "../common/identity.json#/$defs/runId"
        },
        "status": {
          "$ref": "../common/enums.json#/$defs/taskStatus"
        }
      }
    }
  }
}

白皮书与规范内容以仓库真源为准。