Agent External Runtime Turn Request v1

Source schema: doc/schemas/agent.external-runtime.turn-request.v1.schema.json

Fields

Field	Required	Shape	Description
schema	yes	const: agent.external-runtime.turn-request.v1
turn/ref	yes	ref: #/$defs/ref
mode	yes	enum: start, continue
binding/ref	yes	ref: #/$defs/ref
binding/digest	yes	ref: #/$defs/digest
agent/id	yes	ref: #/$defs/ref
passage/ref	yes	ref: #/$defs/ref
passage/no	yes	integer
kind	yes	enum: draft, critique, revision, final
parent-product/refs	yes	array
input/parts	yes	array
input/digest	yes	ref: #/$defs/digest
instruction/hash	yes	ref: #/$defs/digest
prompt-policy/ref	yes	ref: #/$defs/ref
output-schema/ref	yes	ref: #/$defs/ref
visibility	yes	enum: private, operator, shared
classification	yes	ref: classification.v1.schema.json
budget/reservation	yes	ref: #/$defs/finite-budget
observation	no	ref: #/$defs/observation
idempotency/key	yes	ref: #/$defs/ref
deadline/at	yes	string
admitted/at	yes	string
admitted/by	yes	ref: #/$defs/ref

Definitions

Definition	Shape	Description
ref	string
digest	string
positive-safe-integer	integer
finite-budget	object
input-part	unspecified
observation	object
reason-code	enum: completed, policy-denied, binding-missing, binding-stale, binding-mismatch, binding-expired, binding-revoked, profile-disabled, profile-mismatch, budget-exhausted, usage-missing, usage-malformed, usage-overflow, usage-conflict, session-fence-mismatch, session-lost, event-malformed, event-duplicate, event-reordered, event-oversized, event-unauthorized, event-stale, event-timeout, tool-not-admitted, approval-not-admitted, provider-unavailable, cancelled, unknown

Conditional Rules

Rule 1

When:

{
  "properties": {
    "mode": {
      "const": "start"
    }
  }
}

Then:

{
  "not": {
    "required": [
      "observation"
    ]
  }
}

Rule 2

When:

{
  "properties": {
    "mode": {
      "const": "continue"
    }
  }
}

Then:

{
  "required": [
    "observation"
  ]
}

Field Semantics

schema

• Required: yes
• Shape: const: agent.external-runtime.turn-request.v1

turn/ref

• Required: yes
• Shape: ref: #/$defs/ref

mode

• Required: yes
• Shape: enum: start, continue

binding/ref

• Required: yes
• Shape: ref: #/$defs/ref

binding/digest

• Required: yes
• Shape: ref: #/$defs/digest

agent/id

• Required: yes
• Shape: ref: #/$defs/ref

passage/ref

• Required: yes
• Shape: ref: #/$defs/ref

passage/no

• Required: yes
• Shape: integer

kind

• Required: yes
• Shape: enum: draft, critique, revision, final

parent-product/refs

• Required: yes
• Shape: array

input/parts

• Required: yes
• Shape: array

input/digest

• Required: yes
• Shape: ref: #/$defs/digest

instruction/hash

• Required: yes
• Shape: ref: #/$defs/digest

prompt-policy/ref

• Required: yes
• Shape: ref: #/$defs/ref

output-schema/ref

• Required: yes
• Shape: ref: #/$defs/ref

visibility

• Required: yes
• Shape: enum: private, operator, shared

classification

• Required: yes
• Shape: ref: classification.v1.schema.json

budget/reservation

• Required: yes
• Shape: ref: #/$defs/finite-budget

observation

• Required: no
• Shape: ref: #/$defs/observation

idempotency/key

• Required: yes
• Shape: ref: #/$defs/ref

deadline/at

• Required: yes
• Shape: string

admitted/at

• Required: yes
• Shape: string

admitted/by

• Required: yes
• Shape: ref: #/$defs/ref

Definition Semantics

$defs.ref

• Shape: string

$defs.digest

• Shape: string

$defs.positive-safe-integer

• Shape: integer

$defs.finite-budget

• Shape: object

$defs.input-part

• Shape: unspecified

$defs.observation

• Shape: object

$defs.reason-code

• Shape: enum: completed, policy-denied, binding-missing, binding-stale, binding-mismatch, binding-expired, binding-revoked, profile-disabled, profile-mismatch, budget-exhausted, usage-missing, usage-malformed, usage-overflow, usage-conflict, session-fence-mismatch, session-lost, event-malformed, event-duplicate, event-reordered, event-oversized, event-unauthorized, event-stale, event-timeout, tool-not-admitted, approval-not-admitted, provider-unavailable, cancelled, unknown