Decision contracts

Implementation: IMPLEMENTED (contract) · SHADOW (decision runtime) · Exposure: INTERNAL · PUBLIC (docs). See status labels.


Architecture	Frozen schema in Kernel ABI 1.0.0; every component that crosses this boundary validates against it.
Implemented today	Schema; the decision runtime runs in shadow.
Active path	Partial. One primitive has passed its calibration gate and acts within a daily budget when live mode is on.
Public exposure	No. Not reachable by an external developer.

Decision requests and results, backend, readout and calibration profiles.

Architecture contract

Source: spec/Contracts/kernel/v1/schemas/decision.schema.json ($id https://schemas.allternit.com/kernel/1.0.0/decision.schema.json). The schema is normative; the tables below are generated from it and match it field for field. Receivers fail closed on unknown enum values and unknown required fields. See Kernel contracts. Definitions: Candidate · DecisionRequestV1 · DecisionResultV1 · DecisionDeploymentUnitV1 · DecisionBackendProfileV1 · DecisionReadoutProfileV1 · DecisionCalibrationManifestV1 · ArtifactRecordV1

Current implementation

A frozen contract is a specification. Whether a component implements it is stated in the status block above and in the linked architecture pages, not implied by the contract existing.

Availability

The contract is published as part of ABI package 1.0.0 (Implementation: IMPLEMENTED · Exposure: PUBLIC, as documentation). Component status: Implementation IMPLEMENTED (contract) · SHADOW (decision runtime) · Exposure INTERNAL · PUBLIC (docs).

Developer relevance

Validate anything you produce or consume against this schema before it crosses a boundary. Related pages: Decision runtime, Calibration. All contracts: Kernel contracts reference.

Definitions

Candidate

Field	Type	Required
`candidate_id`	Id	yes
`label`	string \| null	no
`payload`		no
`is_unknown`	boolean	no
`extensions`	ExtensionMap	no

No other properties are accepted.

DecisionRequestV1

Field	Type	Required
`envelope`	AbiEnvelopeV1 & object	yes
`operation`	enum: `BELIEF`, `CHOICE`, `SCORE`, `RANK`, `SUBSET`, `ESTIMATE`, `GATE`, `VERIFY`, `PAIR_SCORE`	yes
`state_projection_ref`	Id	yes
`instructions`	string	yes
`question_id`	Id \| null	no
`decision_bank_id`	Id	yes
`candidates`	array of Candidate	no
`scale`	array of string	no
`constraints`	array of object	no
`calibration_domain`	string \| null	no
`threshold_profile_id`	Id \| null	no
`max_latency_ms`	integer \| null	no
`latency_class`	enum: `REALTIME`, `INTERACTIVE`, `BACKGROUND`, `BATCH` \| null	no
`extensions`	ExtensionMap	no

No other properties are accepted.

DecisionResultV1

Field	Type	Required
`envelope`	AbiEnvelopeV1 & object	yes
`operation`	enum: `BELIEF`, `CHOICE`, `SCORE`, `RANK`, `SUBSET`, `ESTIMATE`, `GATE`, `VERIFY`, `PAIR_SCORE`	yes
`answer`		yes
`probabilities`	map of number \| null	no
`confidence`	number	yes
`confidence_semantics`	enum: `CALIBRATED`, `RELATIVE_SET`, `UNCALIBRATED`	yes
`calibration_level_served`	enum: `RAW`, `L0`, `L1`, `L2`, `NONE`	yes
`calibration_id`	Id \| null	no
`calibration_fingerprint`	ContentHash \| null	no
`feasible`	boolean \| null	no
`constraint_violations`	array of object	no
`evidence_refs`	array of EvidenceRef	yes
`backend_id`	Id \| null	no
`model_impl`	ComponentIdentity \| null	no
`threshold_action`	enum: `AUTO`, `REVIEW`, `ESCALATE`, `REJECT`	yes
`latency_ms`	number	yes
`abstained`	boolean	no
`extensions`	ExtensionMap	no

No other properties are accepted.

DecisionDeploymentUnitV1

Field	Type	Required
`schema_id`	`"allternit.kernel.DecisionDeploymentUnitV1"`	yes
`schema_version`	string	yes
`model_ref`	Id	yes
`model_revision`	string	yes
`tokenizer_id`	string	yes
`quantization`	string	yes
`runtime_backend`	string	yes
`readout_point`	string \| null	yes
`schema_hash`	ContentHash	yes
`candidate_set_hash`	ContentHash	yes
`calibration_artifact_id`	Id \| null	yes
`threshold_profile`	Id	yes
`extensions`	ExtensionMap	no

No other properties are accepted.

DecisionBackendProfileV1

Field	Type	Required
`schema_id`	`"allternit.kernel.DecisionBackendProfileV1"`	yes
`schema_version`	string	yes
`backend_id`	Id	yes
`kind`	enum: `rules`, `schema_encoder`, `contrastive_ranker`, `decoder_readout`, `specialist`, `remote_api`	yes
`decision_modes`	array of enum: `BELIEF`, `CHOICE`, `SCORE`, `RANK`, `SUBSET`, `ESTIMATE`, `GATE`, `VERIFY`, `PAIR_SCORE`	yes
`probability_semantics`	enum: `CALIBRATED`, `RELATIVE_SET`, `UNCALIBRATED`	yes
`state_cacheability`	boolean	no
`candidate_cacheability`	boolean	no
`candidate_count_curve`	array of object	no
`max_candidates`	integer \| null	no
`max_state_tokens`	integer \| null	no
`domain_heads`	array of Id	no
`fine_tune_support`	boolean	no
`calibration_profile`	object \| null	no
`trust_location`	enum: `LOCAL`, `PRIVATE_REMOTE`, `PUBLIC_REMOTE`	yes
`deployment_unit_id`	Id \| null	no
`latency_class`	enum: `REALTIME`, `INTERACTIVE`, `BACKGROUND`, `BATCH` \| null	no
`extensions`	ExtensionMap	no

No other properties are accepted.

DecisionReadoutProfileV1

Field	Type	Required
`schema_id`	`"allternit.kernel.DecisionReadoutProfileV1"`	yes
`schema_version`	string	yes
`profile_id`	Id	yes
`backend_id`	Id	yes
`readout_kind`	enum: `RAW_LOGIT`, `DEBIASED_LOGIT`, `CALIBRATED_LOGIT`, `HIDDEN_STATE_HEAD`, `CONTRASTIVE`, `SCHEMA_ENCODER`	yes
`source_layer`	integer \| null	no
`early_exit_supported`	boolean	no
`question_id`	Id	yes
`schema_hash`	ContentHash	yes
`candidate_set_hash`	ContentHash \| null	no
`calibration_level`	enum: `RAW`, `L0`, `L1`, `L2`, `AUTO`	yes
`calibration_artifact_id`	Id \| null	no
`head_artifact_id`	Id \| null	no
`confidence_semantics`	enum: `CALIBRATED`, `RELATIVE_SET`, `UNCALIBRATED`	no
`max_options`	integer \| null	no
`extensions`	ExtensionMap	no

No other properties are accepted.

DecisionCalibrationManifestV1

Field	Type	Required
`schema_id`	`"allternit.kernel.DecisionCalibrationManifestV1"`	yes
`schema_version`	string	yes
`manifest_id`	Id	yes
`primitive_id`	PrimitiveId	yes
`scope`	object	yes
`scope.backend_id`	Id	yes
`scope.model_ref`	Id	yes
`scope.model_revision`	string	yes
`scope.tokenizer_id`	string	yes
`scope.quantization`	string	yes
`scope.runtime_backend`	string	yes
`scope.question_id`	Id	yes
`scope.candidate_schema_hash`	ContentHash	yes
`scope.candidate_set_hash`	ContentHash	yes
`scope.threshold_profile`	Id	yes
`scope.readout_point`	string \| null	no
`scope_fingerprint`	ContentHash	yes
`metrics`	object	yes
`metrics.ece`	number \| null	yes
`metrics.brier`	number \| null	yes
`metrics.nll`	number \| null	yes
`metrics.accuracy`	number \| null	yes
`metrics.f1`	number \| null	yes
`metrics.coverage_at_risk`	number \| null	yes
`metrics.flip_sensitivity`	number \| null	yes
`metrics.order_sensitivity`	number \| null	yes
`held_out`	object	yes
`held_out.n`	integer	yes
`held_out.ci_level`	number	yes
`held_out.ci_method`	string	yes
`held_out.ece_upper_bound`	number	yes
`held_out.auto_act_n`	integer	yes
`held_out.auto_act_error_rate`	number	yes
`held_out.auto_act_error_upper_bound`	number	yes
`held_out.dataset_ref`	Id \| null	no
`coverage_region`	object	no
`gate`	object	yes
`gate.ece_max`	`0.05`	yes
`gate.auto_act_error_max`	`0.05`	yes
`gate.reversible_only`	`true`	yes
`gate.passed`	boolean	yes
`gate.agreement_with_other_model_used`	`false`	no
`created_at`	Timestamp	no
`extensions`	ExtensionMap	no

No other properties are accepted.

ArtifactRecordV1

Field	Type	Required
`schema_id`	`"allternit.kernel.ArtifactRecordV1"`	yes
`schema_version`	string	yes
`artifact_id`	Id	yes
`kind`	enum: `decision_readout_profile`, `decision_head`, `calibration_manifest`, `adapter`, `routing_profile`	yes
`content_hash`	ContentHash	yes
`scope_fingerprint`	ContentHash	yes
`metadata`	object	no
`payload_ref`	string \| null	no
`created_at`	Timestamp	yes
`extensions`	ExtensionMap	no

No other properties are accepted.

Get Started

Allternit Factory

Workspace workflows

Architecture

Work Runtime

Cognitive Runtime

Context & Memory

Tools & Execution

Verification & Safety

Observability & Evaluation

Kernel Contracts

Build on Allternit

Operations

Reference

Core Concepts

Gizzi Code CLI

Tools & ACI

Security & Enterprise

Admin API

BYOC Runtime

Surfaces

CI CD

Guides

Cookbooks

Release Notes

Architecture contract

Current implementation

Availability

Developer relevance

Definitions

Candidate

DecisionRequestV1

DecisionResultV1

DecisionDeploymentUnitV1

DecisionBackendProfileV1

DecisionReadoutProfileV1

DecisionCalibrationManifestV1

ArtifactRecordV1

​Architecture contract

​Current implementation

​Availability

​Developer relevance

​Definitions

​Candidate

​DecisionRequestV1

​DecisionResultV1

​DecisionDeploymentUnitV1

​DecisionBackendProfileV1

​DecisionReadoutProfileV1

​DecisionCalibrationManifestV1

​ArtifactRecordV1

Architecture contract

Current implementation

Availability

Developer relevance

Definitions

Candidate

DecisionRequestV1

DecisionResultV1

DecisionDeploymentUnitV1

DecisionBackendProfileV1

DecisionReadoutProfileV1

DecisionCalibrationManifestV1

ArtifactRecordV1