---
title: "AgentEnv contract registry"
description: "Sources: `packages/agentenv-contract/src/contractRegistry.ts`, `packages/agentenv-contract/src/versions.ts`, `packages/agentenv-contract/src/agentPlane.ts`."
engineVersion: v1.0.234
date: 2026-09-28
license: "(c) Gessa, proprietary. Cite with attribution to https://gessa.ai/docs/. Terms: https://gessa.ai/terms/."
canonical: https://gessa.ai/docs/spec/generated/agentenv-contract-registry/
---
<!-- GENERATED FILE: do not edit by hand. -->
<!-- Regenerate with `npm run gen-docs`. -->

Sources: `packages/agentenv-contract/src/contractRegistry.ts`, `packages/agentenv-contract/src/versions.ts`, `packages/agentenv-contract/src/agentPlane.ts`.

# AgentEnv contract registry

This registry publishes every versioned AgentEnv contract. There are 47 descriptors
covering 43 agentenv-owned version coordinates. Objects in the agent/connector
plane (RD-02) that carry a contentHash are content-addressed: the schema recomputes the canonical hash over
the content and rejects a stale or forged hash, so an in-place edit is tamper-evident at the contract layer.
Append-only supersession (never reusing an id) is enforced by the persistence layer (AER-R2-C).

## Descriptors

| Contract | Schema version | Owner | Binding | Source | Required fields | Refinements | JSON schema hash |
| --- | --- | --- | --- | --- | --- | --- | --- |
| `access_policy` | `agentenv.access.policy.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/accessPolicy.ts` | `accessPolicyVersion`, `grantList`, `mode`, `ownerOrgId` | `access.mode_constraints` | `sha256:2ad7de01ff186c006d22238e9d8397255931367ee1fb75b96b3cd34dbc6a7666` |
| `action_declaration` | `protocol.schema` | protocol | external_identity | `packages/agentenv-contract/src/action.ts` | `contexts`, `key`, `policy`, `processors`, `triggers`, `valueType` | None | `sha256:2b395fe6521289d449c846876d8650df8d16608fb782cc17d9be4e1e5d724774` |
| `action_intent` | `agentenv.action.intent.v0` | agentenv-contract | enclosing_version_coordinates | `packages/agentenv-contract/src/action.ts` | `actionId`, `agentId`, `clientSequence`, `episodeId`, `idempotencyKey`, `parameters`, `runId`, `tick` | None | `sha256:fbf12959fc5c1d5c65cdd9e28757621469e299fcebfa00900abaa60bf1a48365` |
| `action_mask` | `agentenv.action.mask.v1` | agentenv-contract | enclosing_version_coordinates | `packages/agentenv-contract/src/action.ts` | `allowedActionIds`, `budgetRemaining`, `cooldownsRemaining`, `rejectionReasonsByActionId`, `tick` | `action_mask.allowed_rejected_disjoint` | `sha256:38593a6999ff5ad3c1cb45c4c888938c023b62699055407063785472443f690a` |
| `action_policy_reject_reason` | `protocol.schema` | protocol | external_identity | `packages/agentenv-contract/src/action.ts` | None | None | `sha256:1c3a75c94a43126a90a8c65df6bf5709c0665d6f232486698afea4cf713db761` |
| `action_result` | `agentenv.action.result.v0` | agentenv-contract | enclosing_version_coordinates | `packages/agentenv-contract/src/action.ts` | `accepted`, `authoritativeEventRefs`, `stateDeltaRefs` | `action_result.accepted_rejected_exclusive` | `sha256:42a15a0f9dcf7a612e22b81f45c877637c191aa18255f89bc4518c2532f23b58` |
| `agent_budget` | `agentenv.agent.budget.v0` | agentenv-contract | enclosing_version_coordinates | `packages/agentenv-contract/src/agentBudget.ts` | `killSwitch`, `maxConcurrentChildren`, `maxProviderCalls`, `maxUsd`, `timeoutMs` | None | `sha256:d98fd7033bf665a2c4fc543c31dbd4d87439c04a51113df25e85d26d16ab3d02` |
| `agent_definition` | `agentenv.agent.definition.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/agentPlane.ts` | `agentDefinitionId`, `agentDefinitionVersion`, `currentRevisionRef`, `displayName`, `orgId`, `revisionRefs`, `workspaceId` | `agent_definition.revision_uniqueness`, `agent_definition.current_revision_membership` | `sha256:dbccaf16ad49e706357d7132d4230d135ea8663ce4f755ca98aeaa4f22df6e71` |
| `agent_revision` | `agentenv.agent.revision.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/agentPlane.ts` | `agentDefinitionId`, `agentRevisionId`, `agentRevisionVersion`, `budget`, `capabilityDeclarationRef`, `connectorRevisionRefs`, `contentHash`, `harnessRevisionRef`, `workspaceId` | `agent_revision.content_hash_integrity`, `agent_revision.connector_uniqueness` | `sha256:a4b3c65673917edc9d112c06fe5ad8295e7c529467b3473a95f470e186ffb2ad` |
| `aiplayer_component` | `agentenv.component.ai_player.v0` | agentenv-contract | enclosing_version_coordinates | `packages/agentenv-contract/src/aiplayerComponent.ts` | `actionPolicyRef`, `benchmarkEligibility`, `brainRef`, `budgetRef`, `enabled`, `observationPolicyRef`, `profileRef`, `reportingMode`, `rewardPolicyRef`, `sensorModeRef` | None | `sha256:aded436bf3bdd72a85d2a68ba7de85bb55b285d52bc21be4d3262a53277a4e02` |
| `aiplayer_playtest_report` | `agentenv.aiplayer.playtest_report.v0` | agentenv-contract | nested_full_coordinates | `packages/agentenv-contract/src/aiplayerPlaytestReport.ts` | `actionCoverage`, `agentId`, `brainRef`, `budgetRef`, `budgetUsage`, `endedAt`, `episodeId`, `findings`, `profileRef`, `replay`, `replayLink`, `reportId`, `reportVersion`, `runId`, `score`, `sensorModeRef`, `startedAt` | `aiplayer_report.time_order`, `aiplayer_report.replay_identity`, `aiplayer_report.replay_link`, `aiplayer_report.action_accounting` | `sha256:5013c7a266e289b7731991ae796fea5ecc2b74113e5fcc8eda788f52d2fbd193` |
| `benchmark_eligibility` | `agentenv.benchmark.eligibility.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/common.ts` | `benchmarkEligibilityVersion`, `reasonCodes`, `requiresHumanParity`, `status` | `benchmark.eligible_reason_integrity` | `sha256:d395fbad08ec40b0b6f49114f4a8666becd216d58d608585726bae960085d229` |
| `benchmark_release_registry` | `agentenv.registry.benchmark_release.v2` | agentenv-contract | literal_field | `packages/agentenv-contract/src/registries/catalogs.ts` | `entries`, `registryHash`, `registryVersion` | `registry.hash_integrity` | `sha256:c1202523ea7834b417a0e7f789915ce8024ca4b62252782bb723762cd8663b10` |
| `brain_registry` | `agentenv.registry.brain.v2` | agentenv-contract | literal_field | `packages/agentenv-contract/src/registries/catalogs.ts` | `entries`, `registryHash`, `registryVersion` | `registry.hash_integrity` | `sha256:ca15abbb32ce88fa0159ce873c9d0149fb535793fcb8c733bd6c018444697b09` |
| `calibration_report` | `agentenv.calibration.report.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/calibrationReport.ts` | `benchmarkReleaseId`, `calibrationReportVersion`, `costPerCalibratedTaskUsd`, `difficultyBand`, `environmentId`, `failureTaxonomy`, `humanBaseline`, `outOfBandFlag`, `passAtK`, `predeclaredConfidenceStandard`, `redTeamSummary`, `referenceAgentRevisions`, `referenceBrains`, `referenceModels`, `replayRefs`, `scorecardRefs`, `seeds`, `successRate`, `taskId`, `versionCoordinates` | `calibration.reference_uniqueness`, `calibration.redteam_integrity`, `calibration.reference_revision_parity` | `sha256:523ee39e2f2a018961ba6b321a8f97c174872f3fe8ca37944b7a99871f59f38d` |
| `capability_declaration` | `agentenv.capability.declaration.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/agentPlane.ts` | `capabilityDeclarationId`, `capabilityDeclarationVersion`, `contentHash`, `egressAllowlist`, `maxToolSurface`, `networkEgress`, `toolScopes`, `workspaceId` | `capability.content_hash_integrity`, `capability.unique_scopes`, `capability.egress_coherence`, `capability.tool_surface_cap` | `sha256:3e66d6efe72d52acf295541a0bd7f5392180aa03c32c63a824a065cf14806e61` |
| `connector_revision` | `agentenv.connector.revision.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/agentPlane.ts` | `connectorRevisionId`, `connectorRevisionVersion`, `contentHash`, `credentialRef`, `endpointRef`, `mode`, `modelRef`, `workspaceId` | `connector_revision.content_hash_integrity`, `connector.mode_field_matrix`, `connector.credential_tenant_coherence` | `sha256:51eb8a4485223efc06adf8c439f225d7d3db825bd73a391a68ca613142f7610c` |
| `credential_ref` | `agentenv.credential.ref.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/agentPlane.ts` | `credentialRefId`, `credentialRefVersion`, `provider`, `vaultCoordinate`, `workspaceId` | `credential_ref.vault_coordinate_derivation` | `sha256:ae5556f17ca1eb5a3d04054cb9f00b4dbd4e9e190ea11c4a11d24bc5ea1695f8` |
| `datasheet` | `agentenv.datasheet.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/common.ts` | `datasheetVersion`, `intendedUses`, `limitations`, `outOfScopeUses`, `safetyNotes`, `summary` | None | `sha256:fa23daa4f813cf3f01b69a7a813cdb6f41857380dc1f583b6d795bcd6ba333af` |
| `environment_draft` | `agentenv.environment.draft.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/environmentDraft.ts` | `createdAt`, `draftId`, `environmentDraftVersion`, `lifecycleState`, `publishedManifestHash`, `publishedManifestRef`, `revision`, `source`, `title`, `updatedAt`, `workspaceId` | `environment_draft.published_has_release`, `environment_draft.unpublished_has_no_release` | `sha256:660207e4a17e6cafda883a3f50442c22e2e67235a9714eff63fc8d62c8860833` |
| `episode_spec` | `agentenv.episode.spec.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/episodeSpec.ts` | `allowedActionPolicies`, `allowedSensorModes`, `controlledEntityPolicy`, `episodeId`, `episodeSpecVersion`, `failureConditions`, `initialStatePolicy`, `maxTicks`, `rewardPolicyRef`, `spawnPolicy`, `successConditions`, `terminationConditions`, `tickRate`, `timeoutOutcome` | `episode.condition_identity`, `episode.policy_uniqueness` | `sha256:25c647acaf95ecc81972a74141e14ee67d50e943bd240bda666f613473eea83f` |
| `experiment` | `agentenv.experiment.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/experiment.ts` | `cells`, `costEstimateUsd`, `createdAt`, `definition`, `experimentId`, `experimentVersion`, `finalizedAt`, `lifecycleState`, `revision`, `title`, `updatedAt`, `workspaceId` | `experiment.cell_matrix_coverage`, `experiment.finalized_is_stamped`, `experiment.finalized_all_terminal`, `experiment.only_finalized_is_stamped` | `sha256:5d0e312388d1f4f3177c86f60a9f64361f3e6350e8bfa29328d42cfe5b5be5c8` |
| `exploit_suite` | `agentenv.exploit.suite.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/exploitSuite.ts` | `cases`, `exploitSuiteVersion`, `status`, `suiteHash`, `taskRevisionRef`, `versionCoordinates` | `exploit_suite.complete_coverage`, `exploit_suite.distinct_replay_per_case`, `exploit_suite.finding_completeness`, `exploit_suite.confirmed_failure_is_regression`, `exploit_suite.verdict_coherence` | `sha256:0f9ee009d1061405cd03196886decb48e32bfc1745906256e707fc85e5b63568` |
| `harness_revision` | `agentenv.harness.revision.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/agentPlane.ts` | `contentHash`, `harnessRevisionId`, `harnessRevisionVersion`, `loopCeilingTurns`, `systemPromptRef`, `toolSurfaceCap`, `workspaceId` | `harness_revision.content_hash_integrity` | `sha256:836b55de5db09dfead6362ea77573d4895593875537993a8dc57441b67343f0e` |
| `human_baseline_consent` | `gessa.agentenv.human-baseline-consent.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/humanBaseline.ts` | `adultOrGuardianConsent`, `granted`, `participantKind`, `policyVersion`, `telemetryScopes` | None | `sha256:39c968e35df07bf1de07142abf2942e8430b6e08ae745b4a950047bff696a4d3` |
| `human_baseline_record` | `gessa.agentenv.human-baseline-record.v0` | agentenv-contract | nested_full_coordinates | `packages/agentenv-contract/src/humanBaseline.ts` | `actorId`, `agentId`, `consent`, `createdAt`, `episodeId`, `expiresAt`, `organizationId`, `revision`, `runId`, `sessionId`, `startIdempotencyKey`, `startProofHash`, `status`, `taskId`, `tokenHash`, `updatedAt`, `versionCoordinates` | `human_baseline.completed_artifacts`, `human_baseline.noncompleted_artifact_exclusion`, `human_baseline.revocation_timestamp` | `sha256:a10f04b17d719417fc9e266fd007c14b8949fddc8210872c7627656015277878` |
| `lab_episode_list` | `gessa.agentenv.lab-episode-list.v0` | agentenv-contract | enclosing_version_coordinates | `packages/agentenv-contract/src/labReadModels.ts` | `items`, `runId` | None | `sha256:c9b9736be7eb0a2b6c6c30bac6544d0c2fcb7ebe664a87da4c3a056c9085df4e` |
| `lab_run_list` | `gessa.agentenv.lab-run-list.v0` | agentenv-contract | enclosing_version_coordinates | `packages/agentenv-contract/src/labReadModels.ts` | `items` | None | `sha256:b3d4709ad160e066b1c3d6c43d47dd8e44d912e5952d1135cd0b5eccdfdd0594` |
| `manifest` | `agentenv.manifest.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/manifest.ts` | `accessPolicy`, `actionPolicyRefs`, `benchmarkEligibility`, `contentCoordinates`, `datasheet`, `displayName`, `environmentId`, `episodeSpecRefs`, `manifestVersion`, `objectiveRefs`, `observationPolicyRefs`, `ownerOrgId`, `rewardPolicyRefs`, `seedPolicy`, `sensorModeRefs`, `templateRefs`, `worldRefs` | `manifest.ref_uniqueness`, `manifest.pinned_resources`, `manifest.owner_coherence`, `manifest.benchmark_objective` | `sha256:70e44be8e7dcc7dbba3db4d8fa687b2745a72900bfbaee33a3f5989c34e912e1` |
| `model_call_metadata` | `agentenv.model_call.metadata.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/modelCallMetadata.ts` | `completionTokens`, `costUsd`, `disposition`, `latencyMs`, `modelCallMetadataVersion`, `promptTokens`, `providerCalls`, `totalTokens` | `model_call.provider_call_disposition_coherence`, `model_call.token_sum_coherence` | `sha256:42a6cbf4918214950f1f7654d4b80ccfb9bb55a0bb044632de46f05ec6c401d5` |
| `observation_frame` | `agentenv.observation.frame.v1` | agentenv-contract | literal_field | `packages/agentenv-contract/src/observationFrame.ts` | `agentId`, `availableActions`, `controlledEntityId`, `coordinateSystem`, `episodeId`, `frameVersion`, `hudFacts`, `objectiveState`, `recentEvents`, `runId`, `scoreboard`, `selfState`, `sensorMode`, `tick`, `versionCoordinates`, `visibilityPolicy`, `visibleEntities` | `observation.identity_coherence`, `observation.sensor_isolation`, `observation.no_future_events` | `sha256:85a5fac10e5f72f6f27c79817d73a17d407fcbc9e234930ccc79462599b55085` |
| `pack_registry` | `agentenv.registry.pack.v2` | agentenv-contract | literal_field | `packages/agentenv-contract/src/registries/catalogs.ts` | `entries`, `registryHash`, `registryVersion` | `registry.hash_integrity` | `sha256:2e94b0d91df503659a4324c1b7c0165898d87f7936664bcfab929dcb3ffa8ce8` |
| `policy_registry` | `agentenv.registry.policy.v2` | agentenv-contract | literal_field | `packages/agentenv-contract/src/registries/catalogs.ts` | `entries`, `registryHash`, `registryVersion` | `registry.hash_integrity` | `sha256:83feddef9c4a6bffdc9116796cfeb85ce00607286a5f9fd6f88fa7dca86a3568` |
| `profile_registry` | `agentenv.registry.profile.v2` | agentenv-contract | literal_field | `packages/agentenv-contract/src/registries/catalogs.ts` | `entries`, `registryHash`, `registryVersion` | `registry.hash_integrity` | `sha256:c5a48e63dc94cb197a57102fa8b69e1f62dd5d9da94e38cdcf4e064a674d987f` |
| `public_release` | `gessa.agentenv.public-release.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/publicSurface.ts` | `brandDecision`, `generatedAt`, `humanBaseline`, `leaderboard`, `releaseHash`, `releaseId`, `releaseNotes`, `releaseVersion`, `runtimeProofReplays`, `sourceCalibrationReleaseHash`, `tasks` | None | `sha256:ae228a31dc200c8780313a4f410b0ede840aab3d489fa49e640a54c341521980` |
| `public_replay` | `gessa.agentenv.public-replay.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/publicSurface.ts` | `coordinates`, `frames`, `projectionHash`, `replayId`, `replayVersion`, `slug`, `sourceArtifactHash`, `sourceCorpusEntryId`, `sourceReplayHash`, `tickRange`, `title` | `public_replay.tick_range_coverage`, `public_replay.strict_tick_order` | `sha256:0249f613507836f4cbc474c7f6759e54ff03d42900b776e016a1f84f1a55a567` |
| `replay_receipt` | `agentenv.replay.receipt.v0` | agentenv-contract | nested_full_coordinates | `packages/agentenv-contract/src/replayReceipt.ts` | `createdAt`, `episodeId`, `eventLogHash`, `exportRefs`, `finalStateHash`, `initialStateHash`, `objectiveTraceHash`, `playbackUrl`, `replayHash`, `replayId`, `rewardTraceHash`, `runId`, `versionCoordinates` | None | `sha256:ac2738aa92dfea45b2d07289ab6baefbdb8b236dba3e246d486668e348350577` |
| `reward_policy` | `agentenv.reward.policy.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/rewardPolicy.ts` | `antiFarmingRules`, `caps`, `exploitTestRefs`, `objectiveTermRefs`, `rewardPolicyId`, `rewardPolicyVersion`, `scriptedRewardNodeRefs`, `terminalBonus`, `weights` | `reward_policy.term_ref_integrity` | `sha256:792946dbcf0d86641b36aecee49030c6c2917f5f0181f7cbd6d750eb0c1cee1b` |
| `reward_trace` | `agentenv.reward.trace.v0` | agentenv-contract | enclosing_version_coordinates | `packages/agentenv-contract/src/rewardPolicy.ts` | `agentId`, `episodeId`, `objectiveStateRef`, `rewardPolicyVersion`, `runId`, `stateHash`, `terms`, `tick`, `totalReward` | `reward_trace.sum_integrity` | `sha256:1a8e9cdf918e8df2c6f4a5b16ababa26d6dbb1325b37daf4aa97e9645bacfa8f` |
| `scorecard` | `agentenv.scorecard.v0` | agentenv-contract | nested_full_coordinates | `packages/agentenv-contract/src/scorecard.ts` | `benchmarkReleaseId`, `brainRef`, `calibrationReleaseRef`, `completionTicks`, `costUsd`, `environmentId`, `experimentId`, `findingsRef`, `metricAnchors`, `modelRef`, `objectiveTraceRef`, `provenance`, `replayRef`, `rewardEventCount`, `rewardTraceRef`, `scorecardId`, `scorecardVersion`, `seed`, `success`, `taskId`, `terminalState`, `totalReward`, `versionCoordinates` | `scorecard.terminal_success_coherence`, `scorecard.metric_tick_coverage` | `sha256:3f8c7f78d3f8d303197f20291dac8b86b9c885b7766d060bca7a0d3ef41eeebd` |
| `seed_policy` | `agentenv.seed.policy.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/manifest.ts` | `mode`, `seedPolicyVersion` | `seed_policy.mode_constraints` | `sha256:4fdb9e6c13cd2549a832fe529180b0b3be299d7efd2b757043ce894bbeb96149` |
| `sensor_mode_registry` | `agentenv.registry.sensor_mode.v2` | agentenv-contract | literal_field | `packages/agentenv-contract/src/registries/catalogs.ts` | `entries`, `registryHash`, `registryVersion` | `registry.hash_integrity`, `sensor.human_parity_boundary`, `sensor.pixel_deferred` | `sha256:b7dcbfd637229f72f12c836a84eac8182b6fa346f8da4851ef1e20c24cac3d7d` |
| `snapshot_transform` | `protocol.schema` | protocol | external_identity | `packages/agentenv-contract/src/common.ts` | `position`, `rotation`, `scale` | None | `sha256:60f68fe2ef133864973ffdce1f2df414e1398be226dd6d9302050c3e62640033` |
| `snapshot_vec3` | `protocol.schema` | protocol | external_identity | `packages/agentenv-contract/src/common.ts` | `x`, `y`, `z` | None | `sha256:b466852d0f445ebf3b71f408eb92da6ec4a16412a2b1b2e1d12a62581137bd5b` |
| `trajectory_row` | `agentenv.trajectory.row.v1` | agentenv-contract | literal_field | `packages/agentenv-contract/src/trajectoryRow.ts` | `actionIntent`, `actionResult`, `agentId`, `episodeId`, `nextObservationRef`, `objectiveState`, `replayId`, `rewardTraceRef`, `runId`, `terminalState`, `tick`, `trajectorySchemaVersion`, `versionCoordinates` | `trajectory.observation_xor`, `trajectory.identity_coherence` | `sha256:340309862345032de2072602ac488501ea8a991d5d1c9d781cdd7f0458db4f57` |
| `validation_report` | `agentenv.validation.report.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/validationReport.ts` | `checkedAt`, `checks`, `passed`, `reportHash`, `targetDraftId`, `targetManifestHash`, `validationReportVersion` | `validation_report.complete_coverage`, `validation_report.no_duplicate_checks`, `validation_report.verdict_coherence` | `sha256:6b3f8479745ccf146531e4a94d3cacd3325afe46e738d154db7b342b88ca70a6` |
| `version_coordinate` | `agentenv.contract.v0` | agentenv-contract | literal_field | `packages/agentenv-contract/src/versionCoordinate.ts` | `actionPolicyVersion`, `contentVersion`, `contractVersion`, `engineRuntimeVersion`, `environmentVersion`, `manifestHash`, `observationSchemaVersion`, `rewardPolicyVersion`, `seed`, `sensorModeVersion` | None | `sha256:4a4529f3308c2da0863ca5af5b38d3d53c2f7115951fe5e96d02bccb55565ebf` |

## Agentenv-owned version coordinates

| Coordinate | Version | Binding | Source |
| --- | --- | --- | --- |
| `agentenv.access_policy` | `agentenv.access.policy.v0` | literal_field | `packages/agentenv-contract/src/accessPolicy.ts` |
| `agentenv.action_intent` | `agentenv.action.intent.v0` | enclosing_version_coordinates | `packages/agentenv-contract/src/action.ts` |
| `agentenv.action_mask` | `agentenv.action.mask.v1` | enclosing_version_coordinates | `packages/agentenv-contract/src/action.ts` |
| `agentenv.action_result` | `agentenv.action.result.v0` | enclosing_version_coordinates | `packages/agentenv-contract/src/action.ts` |
| `agentenv.agent_budget` | `agentenv.agent.budget.v0` | enclosing_version_coordinates | `packages/agentenv-contract/src/agentBudget.ts` |
| `agentenv.agent_definition` | `agentenv.agent.definition.v0` | literal_field | `packages/agentenv-contract/src/agentPlane.ts` |
| `agentenv.agent_revision` | `agentenv.agent.revision.v0` | literal_field | `packages/agentenv-contract/src/agentPlane.ts` |
| `agentenv.aiplayer_component` | `agentenv.component.ai_player.v0` | enclosing_version_coordinates | `packages/agentenv-contract/src/aiplayerComponent.ts` |
| `agentenv.aiplayer_playtest_report` | `agentenv.aiplayer.playtest_report.v0` | nested_full_coordinates | `packages/agentenv-contract/src/aiplayerPlaytestReport.ts` |
| `agentenv.benchmark_eligibility` | `agentenv.benchmark.eligibility.v0` | literal_field | `packages/agentenv-contract/src/common.ts` |
| `agentenv.benchmark_release_registry` | `agentenv.registry.benchmark_release.v2` | literal_field | `packages/agentenv-contract/src/registries/catalogs.ts` |
| `agentenv.brain_registry` | `agentenv.registry.brain.v2` | literal_field | `packages/agentenv-contract/src/registries/catalogs.ts` |
| `agentenv.calibration_report` | `agentenv.calibration.report.v0` | literal_field | `packages/agentenv-contract/src/calibrationReport.ts` |
| `agentenv.capability_declaration` | `agentenv.capability.declaration.v0` | literal_field | `packages/agentenv-contract/src/agentPlane.ts` |
| `agentenv.connector_revision` | `agentenv.connector.revision.v0` | literal_field | `packages/agentenv-contract/src/agentPlane.ts` |
| `agentenv.contract` | `agentenv.contract.v0` | literal_field | `packages/agentenv-contract/src/versionCoordinate.ts` |
| `agentenv.credential_ref` | `agentenv.credential.ref.v0` | literal_field | `packages/agentenv-contract/src/agentPlane.ts` |
| `agentenv.datasheet` | `agentenv.datasheet.v0` | literal_field | `packages/agentenv-contract/src/common.ts` |
| `agentenv.environment_draft` | `agentenv.environment.draft.v0` | literal_field | `packages/agentenv-contract/src/environmentDraft.ts` |
| `agentenv.episode_spec` | `agentenv.episode.spec.v0` | literal_field | `packages/agentenv-contract/src/episodeSpec.ts` |
| `agentenv.experiment` | `agentenv.experiment.v0` | literal_field | `packages/agentenv-contract/src/experiment.ts` |
| `agentenv.exploit_suite` | `agentenv.exploit.suite.v0` | literal_field | `packages/agentenv-contract/src/exploitSuite.ts` |
| `agentenv.harness_revision` | `agentenv.harness.revision.v0` | literal_field | `packages/agentenv-contract/src/agentPlane.ts` |
| `agentenv.human_baseline_consent` | `gessa.agentenv.human-baseline-consent.v0` | literal_field | `packages/agentenv-contract/src/humanBaseline.ts` |
| `agentenv.human_baseline_record` | `gessa.agentenv.human-baseline-record.v0` | nested_full_coordinates | `packages/agentenv-contract/src/humanBaseline.ts` |
| `agentenv.lab_episode_list` | `gessa.agentenv.lab-episode-list.v0` | enclosing_version_coordinates | `packages/agentenv-contract/src/labReadModels.ts` |
| `agentenv.lab_run_list` | `gessa.agentenv.lab-run-list.v0` | enclosing_version_coordinates | `packages/agentenv-contract/src/labReadModels.ts` |
| `agentenv.manifest` | `agentenv.manifest.v0` | literal_field | `packages/agentenv-contract/src/manifest.ts` |
| `agentenv.model_call_metadata` | `agentenv.model_call.metadata.v0` | literal_field | `packages/agentenv-contract/src/modelCallMetadata.ts` |
| `agentenv.observation_frame` | `agentenv.observation.frame.v1` | literal_field | `packages/agentenv-contract/src/observationFrame.ts` |
| `agentenv.pack_registry` | `agentenv.registry.pack.v2` | literal_field | `packages/agentenv-contract/src/registries/catalogs.ts` |
| `agentenv.policy_registry` | `agentenv.registry.policy.v2` | literal_field | `packages/agentenv-contract/src/registries/catalogs.ts` |
| `agentenv.profile_registry` | `agentenv.registry.profile.v2` | literal_field | `packages/agentenv-contract/src/registries/catalogs.ts` |
| `agentenv.public_release` | `gessa.agentenv.public-release.v0` | literal_field | `packages/agentenv-contract/src/publicSurface.ts` |
| `agentenv.public_replay` | `gessa.agentenv.public-replay.v0` | literal_field | `packages/agentenv-contract/src/publicSurface.ts` |
| `agentenv.replay_receipt` | `agentenv.replay.receipt.v0` | nested_full_coordinates | `packages/agentenv-contract/src/replayReceipt.ts` |
| `agentenv.reward_policy` | `agentenv.reward.policy.v0` | literal_field | `packages/agentenv-contract/src/rewardPolicy.ts` |
| `agentenv.reward_trace` | `agentenv.reward.trace.v0` | enclosing_version_coordinates | `packages/agentenv-contract/src/rewardPolicy.ts` |
| `agentenv.scorecard` | `agentenv.scorecard.v0` | nested_full_coordinates | `packages/agentenv-contract/src/scorecard.ts` |
| `agentenv.seed_policy` | `agentenv.seed.policy.v0` | literal_field | `packages/agentenv-contract/src/manifest.ts` |
| `agentenv.sensor_mode_registry` | `agentenv.registry.sensor_mode.v2` | literal_field | `packages/agentenv-contract/src/registries/catalogs.ts` |
| `agentenv.trajectory_row` | `agentenv.trajectory.row.v1` | literal_field | `packages/agentenv-contract/src/trajectoryRow.ts` |
| `agentenv.validation_report` | `agentenv.validation.report.v0` | literal_field | `packages/agentenv-contract/src/validationReport.ts` |

## Connector transport modes (RD-02)

One shared connector interface; the two custom endpoints stay distinct (a model endpoint keeps the
Gessa harness, an agent action endpoint hands the customer the observation and takes back an intent).

| Mode |
| --- |
| `managed-inference` |
| `vaulted-BYOK` |
| `custom-OpenAI-compatible-model-endpoint` |
| `customer-agent-action-endpoint` |
| `external-pull-worker` |
| `scripted-reference` |