Agent Inference Passage Trace v1

Source schema: doc/schemas/agent.inference-passage-trace.v1.schema.json

Prompt-free metadata trace for one passage transition. Prompt text, product content, private reasoning, protected source bytes, signatures, and secrets have no representation.

Governing Basis

• doc/project/40-proposals/064-inquirium-implementation-recommendations.md
• doc/project/40-proposals/085-operator-sovereign-extensibility-and-experiment-packages.md
• doc/project/60-solutions/047-agent/047-agent.md

Project Lineage

Requirements

• doc/project/50-requirements/requirements-010-middleware-executor.md

Stories

• doc/project/30-stories/story-005-whisper-rumor-intake.md
• doc/project/30-stories/story-006-voluntary-swarm-exchange.md
• doc/project/30-stories/story-009-bielik-blog-arca.md

Fields

Field	Required	Shape	Description
schema	yes	const: agent.inference-passage-trace.v1
trace/ref	yes	ref: #/$defs/ref
binding/ref	yes	ref: #/$defs/ref
agent/id	yes	ref: #/$defs/ref
passage/ref	yes	ref: #/$defs/ref
passage/no	yes	integer
kind	yes	enum: draft, critique, revision, final
state	yes	enum: admitted, committed, refused, selected
input/digest	yes	ref: #/$defs/digest
product/ref	no	ref: #/$defs/ref
product/digest	no	ref: #/$defs/digest
parent-product/refs	yes	array
prompt-policy/ref	yes	ref: #/$defs/ref
output-schema/ref	yes	ref: #/$defs/ref
repair-profile/ref	yes	ref: #/$defs/ref
model-profile/ref	yes	ref: #/$defs/ref
runtime/ref	yes	ref: #/$defs/ref
model/snapshot	no	ref: #/$defs/ref
visibility	yes	enum: private, operator, shared
classification	yes	ref: classification.v1.schema.json
instruction/hash	yes	ref: #/$defs/instruction-hash
budget/used	yes	ref: #/$defs/budget
decision/code	yes	enum: passage-admitted, passage-committed, terminal-product-selected, passage-request-refused, passage-invocation-refused, passage-response-refused, passage-artifact-refused, passage-commit-refused
at	yes	string
by	yes	ref: #/$defs/ref

Definitions

Definition	Shape	Description
ref	string
digest	string
instruction-hash	string
budget	object

Conditional Rules

Rule 1

When:

{
  "properties": {
    "state": {
      "enum": [
        "committed",
        "selected"
      ]
    }
  },
  "required": [
    "state"
  ]
}

Then:

{
  "required": [
    "product/ref",
    "product/digest",
    "model/snapshot"
  ]
}

Rule 2

When:

{
  "properties": {
    "state": {
      "enum": [
        "admitted",
        "refused"
      ]
    }
  },
  "required": [
    "state"
  ]
}

Then:

{
  "not": {
    "anyOf": [
      {
        "required": [
          "product/ref"
        ]
      },
      {
        "required": [
          "product/digest"
        ]
      },
      {
        "required": [
          "model/snapshot"
        ]
      }
    ]
  }
}

Field Semantics

schema

• Required: yes
• Shape: const: agent.inference-passage-trace.v1

trace/ref

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

binding/ref

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

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

state

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

input/digest

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

product/ref

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

product/digest

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

parent-product/refs

• Required: yes
• Shape: array

prompt-policy/ref

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

output-schema/ref

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

repair-profile/ref

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

model-profile/ref

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

runtime/ref

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

model/snapshot

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

visibility

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

classification

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

instruction/hash

• Required: yes
• Shape: ref: #/$defs/instruction-hash

budget/used

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

decision/code

• Required: yes
• Shape: enum: passage-admitted, passage-committed, terminal-product-selected, passage-request-refused, passage-invocation-refused, passage-response-refused, passage-artifact-refused, passage-commit-refused

at

• Required: yes
• Shape: string

by

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

Definition Semantics

$defs.ref

• Shape: string

$defs.digest

• Shape: string

$defs.instruction-hash

• Shape: string

$defs.budget

• Shape: object