Skip to content

Agent Inference Passage Product v1

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

A metadata-only structured intermediate or final product. Retained bytes are addressed through an artifact ref and digest, never carried inline.

Governing Basis

Project Lineage

Requirements

Stories

Fields

Field Required Shape Description
schema yes const: agent.inference-passage-product.v1
product/ref yes ref: #/$defs/ref
product/digest yes ref: #/$defs/digest
passage/ref yes ref: #/$defs/ref
binding/ref yes ref: #/$defs/ref
agent/id yes ref: #/$defs/ref
kind yes enum: draft, critique, revision, final
parent-product/refs yes array
content/digest yes ref: #/$defs/digest
content/size-bytes yes integer
artifact/ref no ref: #/$defs/ref
retained yes boolean
output-schema/ref yes ref: #/$defs/ref
model/snapshot yes ref: #/$defs/ref
budget/used yes ref: #/$defs/budget
visibility yes enum: private, operator, shared
classification yes ref: classification.v1.schema.json
committed/at yes string
committed/by yes ref: #/$defs/ref

Definitions

Definition Shape Description
ref string
digest string
budget object

Conditional Rules

Rule 1

When:

{
  "properties": {
    "retained": {
      "const": true
    }
  },
  "required": [
    "retained"
  ]
}

Then:

{
  "required": [
    "artifact/ref"
  ]
}

Field Semantics

schema

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

product/ref

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

product/digest

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

passage/ref

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

binding/ref

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

agent/id

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

kind

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

parent-product/refs

  • Required: yes
  • Shape: array

content/digest

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

content/size-bytes

  • Required: yes
  • Shape: integer

artifact/ref

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

retained

  • Required: yes
  • Shape: boolean

output-schema/ref

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

model/snapshot

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

budget/used

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

visibility

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

classification

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

committed/at

  • Required: yes
  • Shape: string

committed/by

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

Definition Semantics

$defs.ref

  • Shape: string

$defs.digest

  • Shape: string

$defs.budget

  • Shape: object