Skip to content

Daemon NSE Offer Resolution Trace v1

Source schema: doc/schemas/daemon.nse-offer-resolution-trace.v1.schema.json

Prompt-free host trace for one opaque NSE offer resolution attempt.

Governing Basis

Project Lineage

Fields

Field Required Shape Description
schema yes const: daemon.nse-offer-resolution-trace.v1
schema/v yes const: 1
recorded-at yes string
offer/ref yes ref: #/$defs/ref
invocation/ref yes unspecified Exact invocation reference only after the registry found an entry and authorized its caller; null for pre-registry, unknown-offer, foreign-caller, or unavailable-registry refusals.
offer/digest yes unspecified Exact offer digest only after the registry found an entry and authorized its caller; null for pre-registry, unknown-offer, foreign-caller, or unavailable-registry refusals.
hook/id yes string
caller/ref yes string
lookup/status yes enum: not-inspected, registry-unavailable, unknown-offer, foreign-caller, matched Host-operator diagnostic that is never included in the caller decision projection. matched permits bound entry metadata; foreign-caller remains caller-visible only as identifier/invalid; not-inspected means a pre-registry hook allowlist refusal.
step/id yes unspecified
producer/refs yes array
evidence/count yes integer
status yes enum: admitted, refused
refusal/code yes unspecified

Definitions

Definition Shape Description
digest string
ref string

Conditional Rules

Rule 1

When:

{
  "properties": {
    "status": {
      "const": "admitted"
    }
  }
}

Then:

{
  "properties": {
    "invocation/ref": {
      "type": "string"
    },
    "offer/digest": {
      "$ref": "#/$defs/digest"
    },
    "refusal/code": {
      "type": "null"
    }
  }
}

Rule 2

When:

{
  "properties": {
    "status": {
      "const": "refused"
    }
  }
}

Then:

{
  "properties": {
    "refusal/code": {
      "$ref": "operator-extension-refusal-code.v1.schema.json"
    }
  }
}

Field Semantics

schema

  • Required: yes
  • Shape: const: daemon.nse-offer-resolution-trace.v1

schema/v

  • Required: yes
  • Shape: const: 1

recorded-at

  • Required: yes
  • Shape: string

offer/ref

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

invocation/ref

  • Required: yes
  • Shape: unspecified

Exact invocation reference only after the registry found an entry and authorized its caller; null for pre-registry, unknown-offer, foreign-caller, or unavailable-registry refusals.

offer/digest

  • Required: yes
  • Shape: unspecified

Exact offer digest only after the registry found an entry and authorized its caller; null for pre-registry, unknown-offer, foreign-caller, or unavailable-registry refusals.

hook/id

  • Required: yes
  • Shape: string

caller/ref

  • Required: yes
  • Shape: string

lookup/status

  • Required: yes
  • Shape: enum: not-inspected, registry-unavailable, unknown-offer, foreign-caller, matched

Host-operator diagnostic that is never included in the caller decision projection. matched permits bound entry metadata; foreign-caller remains caller-visible only as identifier/invalid; not-inspected means a pre-registry hook allowlist refusal.

step/id

  • Required: yes
  • Shape: unspecified

producer/refs

  • Required: yes
  • Shape: array

evidence/count

  • Required: yes
  • Shape: integer

status

  • Required: yes
  • Shape: enum: admitted, refused

refusal/code

  • Required: yes
  • Shape: unspecified

Definition Semantics

$defs.digest

  • Shape: string

$defs.ref

  • Shape: string