Component Communication Observation V1¶
Source schema: doc/schemas/component-communication-observation.v1.schema.json
Host-stamped observation of one registered communication boundary stage.
Governing Basis¶
Project Lineage¶
Fields¶
| Field | Required | Shape | Description |
|---|---|---|---|
schema |
yes |
const: component-communication-observation.v1 |
|
schema/v |
yes |
const: 1 |
|
observation/id |
yes |
ref: #/$defs/ref |
|
observation/generation |
yes |
ref: #/$defs/ref |
|
observation/cursor |
yes |
integer | |
occurred/at |
yes |
ref: #/$defs/timestamp |
|
observed/at |
yes |
ref: #/$defs/timestamp |
|
node/ref |
yes |
ref: #/$defs/ref |
|
boundary/id |
yes |
ref: #/$defs/ref |
|
boundary/kind |
yes |
enum: channel-json, host-capability, middleware-passage, peer-session, room-carrier, http-boundary, component-private |
|
stage |
yes |
ref: #/$defs/stage |
|
evidence |
yes |
ref: #/$defs/evidence |
|
source |
yes |
ref: #/$defs/endpoint |
|
target |
yes |
ref: #/$defs/endpoint |
|
message/ref |
no |
ref: #/$defs/ref |
|
operation |
yes |
string | |
transport/session-ref |
no |
ref: #/$defs/ref |
|
transport/sequence |
no |
integer | |
causal/context-ref |
no |
ref: #/$defs/ref |
|
causal/context-digest |
no |
ref: #/$defs/digest |
|
correlation/id |
no |
ref: #/$defs/ref |
|
payload |
yes |
ref: #/$defs/payload |
Definitions¶
| Definition | Shape | Description |
|---|---|---|
ref |
string | |
digest |
string | |
timestamp |
string | |
stage |
enum: egress-admitted, egress-failed, ingress-admitted, ingress-refused, completed, timed-out, canceled |
|
endpoint |
object | |
evidence |
unspecified | |
adapter |
enum: channel-json-session, middleware-passage, host-capability-dispatch, peer-session, room-carrier, http-boundary, component-report |
|
capture |
object | |
payload |
object |
Conditional Rules¶
Rule 1¶
When:
{
"required": [
"transport/sequence"
]
}
Then:
{
"required": [
"transport/session-ref"
]
}
Rule 2¶
When:
{
"required": [
"causal/context-ref"
]
}
Then:
{
"required": [
"causal/context-digest"
]
}
Field Semantics¶
schema¶
- Required:
yes - Shape: const:
component-communication-observation.v1
schema/v¶
- Required:
yes - Shape: const:
1
observation/id¶
- Required:
yes - Shape: ref:
#/$defs/ref
observation/generation¶
- Required:
yes - Shape: ref:
#/$defs/ref
observation/cursor¶
- Required:
yes - Shape: integer
occurred/at¶
- Required:
yes - Shape: ref:
#/$defs/timestamp
observed/at¶
- Required:
yes - Shape: ref:
#/$defs/timestamp
node/ref¶
- Required:
yes - Shape: ref:
#/$defs/ref
boundary/id¶
- Required:
yes - Shape: ref:
#/$defs/ref
boundary/kind¶
- Required:
yes - Shape: enum:
channel-json,host-capability,middleware-passage,peer-session,room-carrier,http-boundary,component-private
stage¶
- Required:
yes - Shape: ref:
#/$defs/stage
evidence¶
- Required:
yes - Shape: ref:
#/$defs/evidence
source¶
- Required:
yes - Shape: ref:
#/$defs/endpoint
target¶
- Required:
yes - Shape: ref:
#/$defs/endpoint
message/ref¶
- Required:
no - Shape: ref:
#/$defs/ref
operation¶
- Required:
yes - Shape: string
transport/session-ref¶
- Required:
no - Shape: ref:
#/$defs/ref
transport/sequence¶
- Required:
no - Shape: integer
causal/context-ref¶
- Required:
no - Shape: ref:
#/$defs/ref
causal/context-digest¶
- Required:
no - Shape: ref:
#/$defs/digest
correlation/id¶
- Required:
no - Shape: ref:
#/$defs/ref
payload¶
- Required:
yes - Shape: ref:
#/$defs/payload
Definition Semantics¶
$defs.ref¶
- Shape: string
$defs.digest¶
- Shape: string
$defs.timestamp¶
- Shape: string
$defs.stage¶
- Shape: enum:
egress-admitted,egress-failed,ingress-admitted,ingress-refused,completed,timed-out,canceled
$defs.endpoint¶
- Shape: object
$defs.evidence¶
- Shape: unspecified
$defs.adapter¶
- Shape: enum:
channel-json-session,middleware-passage,host-capability-dispatch,peer-session,room-carrier,http-boundary,component-report
$defs.capture¶
- Shape: object
$defs.payload¶
- Shape: object