Skip to content

Agent External Runtime Profile v1

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

Fields

Field Required Shape Description
schema yes const: agent.external-runtime.profile.v1
profile/ref yes ref: #/$defs/ref
profile/generation yes ref: #/$defs/positive-safe-integer
driver/variant yes ref: #/$defs/ref
driver/version yes ref: #/$defs/ref
transport/class yes enum: in-process, supervised-process, local-socket, remote
auth/class yes enum: none, operator-session, api-credential, workload-identity
principal/snapshot-ref no ref: #/$defs/ref
session/scope yes const: agent-runtime-binding
session/persistence yes enum: ephemeral, adapter-restart, remote
retention/class yes enum: none, operator-policy, provider-policy
egress/classes yes array
tool/mode yes enum: deny-all, mediated
usage/fidelity yes enum: authoritative, host-measured, estimated, unavailable
event/ordering yes const: strict-sequence
supports yes object
limits yes object
created/at yes string
created/by yes ref: #/$defs/ref

Definitions

Definition Shape Description
ref string
positive-safe-integer integer
## Field Semantics

schema

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

profile/ref

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

profile/generation

  • Required: yes
  • Shape: ref: #/$defs/positive-safe-integer

driver/variant

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

driver/version

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

transport/class

  • Required: yes
  • Shape: enum: in-process, supervised-process, local-socket, remote

auth/class

  • Required: yes
  • Shape: enum: none, operator-session, api-credential, workload-identity

principal/snapshot-ref

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

session/scope

  • Required: yes
  • Shape: const: agent-runtime-binding

session/persistence

  • Required: yes
  • Shape: enum: ephemeral, adapter-restart, remote

retention/class

  • Required: yes
  • Shape: enum: none, operator-policy, provider-policy

egress/classes

  • Required: yes
  • Shape: array

tool/mode

  • Required: yes
  • Shape: enum: deny-all, mediated

usage/fidelity

  • Required: yes
  • Shape: enum: authoritative, host-measured, estimated, unavailable

event/ordering

  • Required: yes
  • Shape: const: strict-sequence

supports

  • Required: yes
  • Shape: object

limits

  • Required: yes
  • Shape: object

created/at

  • Required: yes
  • Shape: string

created/by

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

Definition Semantics

$defs.ref

  • Shape: string

$defs.positive-safe-integer

  • Shape: integer