action-schema.schema.json

Generated from schemas/v0.1/action-schema.schema.json ($id: https://agentworldprotocol.com/schemas/v0.1/action-schema.schema.json). Normative text: /spec/loop/actions. Every tagged example on this site is validated against this schema in CI.

An entry in world-manifest.action_schemas (spec/loop/actions, spec/loop/preemption, spec/loop/command-channels).

identifier

required

Action type name, unique per world.

json_schema

required

JSON Schema 2020-12 for params (AWP-MAN-002). Local

refs resolve against the manifest's

defs.

instant | extended | streaming

required

preemption_policy | preemption_policy[]

required

Declared policies the submitter may choose from (AWP-PRE-001).

identifier

Types sharing a group preempt one another (AWP-PRE-006).

integer

Queue depth when queue is offered (AWP-PRE-002).

boolean

Default false.

identifier

Command channel this streaming type opens (AWP-CMD-002).

integer

Per-stream watchdog for streaming types (AWP-CMD-005).

integer

Upper bound on the cancelling state for this type (AWP-LIF-010).

string

Conditional rules

[
  {
    "if": {
      "properties": {
        "duration": {
          "const": "streaming"
        }
      }
    },
    "then": {
      "required": [
        "command_channel",
        "watchdog_ms"
      ]
    },
    "else": {
      "not": {
        "anyOf": [
          {
            "required": [
              "command_channel"
            ]
          },
          {
            "required": [
              "watchdog_ms"
            ]
          }
        ]
      }
    }
  }
]

Overview

Control channel (JSON-RPC)

Frames

Schemas

Conditional rules

​Conditional rules

Conditional rules