Reference
Contract limits
Generated field-size, numeric, and pattern constraints from Pydantic schemas.
These limits protect the current public and persisted boundary. Infrastructure and measured performance budgets are documented separately because they are not Pydantic field constraints.
Field constraints
| Model | Field | Type | Constraint |
|---|---|---|---|
| AgentEvent | attempt_id | AttemptId | pattern ^att_[0-9a-f]{32}$ |
| AgentEvent | event_id | EventId | pattern ^eve_[0-9a-f]{32}$ |
| AgentEvent | provider_sequence | integer | minimum 0 |
| ApprovalEvent | attempt_id | AttemptId | pattern ^att_[0-9a-f]{32}$ |
| ApprovalEvent | decision | pending | approved | denied | expired | values pending, approved, denied, expired |
| ApprovalEvent | event_id | EventId | pattern ^eve_[0-9a-f]{32}$ |
| ApprovalEvent | event_type | approval.requested | approval.resolved | values approval.requested, approval.resolved |
| ApprovalEvent | provider_sequence | integer | minimum 0 |
| ArtifactManifest | artifact_id | ArtifactId | pattern ^art_[0-9a-f]{32}$ |
| ArtifactManifest | digest | string | pattern ^sha256:[0-9a-f]{64}$ |
| ArtifactManifest | media_type | string | minimum length 1; maximum length 255 |
| ArtifactManifest | producing_attempt_id | AttemptId | pattern ^att_[0-9a-f]{32}$ |
| ArtifactManifest | project_id | ProjectId | pattern ^prj_[0-9a-f]{32}$ |
| ArtifactManifest | size_bytes | integer | minimum 0 |
| ArtifactManifest | storage_key | string | minimum length 1; maximum length 1024 |
| ArtifactManifest | workspace_id | WorkspaceId | pattern ^wsp_[0-9a-f]{32}$ |
| ArtifactPublishedEvent | artifact_id | ArtifactId | pattern ^art_[0-9a-f]{32}$ |
| ArtifactPublishedEvent | attempt_id | AttemptId | pattern ^att_[0-9a-f]{32}$ |
| ArtifactPublishedEvent | event_id | EventId | pattern ^eve_[0-9a-f]{32}$ |
| ArtifactPublishedEvent | event_type | artifact.published | fixed value artifact.published |
| ArtifactPublishedEvent | provider_sequence | integer | minimum 0 |
| AttemptLifecycleEvent | attempt_id | AttemptId | pattern ^att_[0-9a-f]{32}$ |
| AttemptLifecycleEvent | event_id | EventId | pattern ^eve_[0-9a-f]{32}$ |
| AttemptLifecycleEvent | event_type | attempt.queued | attempt.provisioning | attempt.started | attempt.paused | attempt.resumed | attempt.completed | attempt.failed | attempt.cancelled | values attempt.queued, attempt.provisioning, attempt.started, attempt.paused, attempt.resumed, attempt.completed, attempt.failed, attempt.cancelled |
| AttemptLifecycleEvent | provider_sequence | integer | minimum 0 |
| CheckpointCreatedEvent | attempt_id | AttemptId | pattern ^att_[0-9a-f]{32}$ |
| CheckpointCreatedEvent | event_id | EventId | pattern ^eve_[0-9a-f]{32}$ |
| CheckpointCreatedEvent | event_type | checkpoint.created | fixed value checkpoint.created |
| CheckpointCreatedEvent | provider_sequence | integer | minimum 0 |
| ClaimProposedEvent | attempt_id | AttemptId | pattern ^att_[0-9a-f]{32}$ |
| ClaimProposedEvent | claim_id | ClaimId | pattern ^clm_[0-9a-f]{32}$ |
| ClaimProposedEvent | event_id | EventId | pattern ^eve_[0-9a-f]{32}$ |
| ClaimProposedEvent | event_type | claim.proposed | fixed value claim.proposed |
| ClaimProposedEvent | provider_sequence | integer | minimum 0 |
| CommandAccepted | aggregate_version | integer | minimum 1 |
| CommandAccepted | command_id | CommandId | pattern ^cmd_[0-9a-f]{32}$ |
| CommandAccepted | first_event_cursor | Cursor | pattern ^c1_[A-Za-z0-9_-]{11}$ |
| CommandAccepted | status | accepted | fixed value accepted |
| CommandEnvelope | command_id | CommandId | pattern ^cmd_[0-9a-f]{32}$ |
| CommandEnvelope | idempotency_key | string | minimum length 8; maximum length 128 |
| CommandEnvelope[CreateResearchRunPayload] | command_id | CommandId | pattern ^cmd_[0-9a-f]{32}$ |
| CommandEnvelope[CreateResearchRunPayload] | idempotency_key | string | minimum length 8; maximum length 128 |
| CommandEnvelope[UpdateProjectSettingsPayload] | command_id | CommandId | pattern ^cmd_[0-9a-f]{32}$ |
| CommandEnvelope[UpdateProjectSettingsPayload] | idempotency_key | string | minimum length 8; maximum length 128 |
| CommandRejected | code | string | pattern ^[a-z][a-z0-9_.-]+$ |
| CommandRejected | command_id | CommandId | pattern ^cmd_[0-9a-f]{32}$ |
| CommandRejected | message | string | minimum length 1; maximum length 500 |
| CommandRejected | observed_version | integer | null | integer: minimum 1 |
| CommandRejected | retry_after_ms | integer | null | integer: minimum 0 |
| CommandRejected | status | rejected | fixed value rejected |
| CreateResearchRunCommand | command_id | CommandId | pattern ^cmd_[0-9a-f]{32}$ |
| CreateResearchRunCommand | idempotency_key | string | minimum length 8; maximum length 128 |
| CreateResearchRunPayload | objective | string | minimum length 12; maximum length 4000 |
| DomainEvent | aggregate_version | integer | minimum 1 |
| DomainEvent | cursor | Cursor | pattern ^c1_[A-Za-z0-9_-]{11}$ |
| DomainEvent | event_id | EventId | pattern ^eve_[0-9a-f]{32}$ |
| DomainEvent | event_type | string | pattern ^[a-z][a-z0-9_.-]+$ |
| DomainEvent | project_id | ProjectId | pattern ^prj_[0-9a-f]{32}$ |
| DomainEvent | schema_version | 1 | fixed value 1 |
| DomainEvent | workspace_id | WorkspaceId | pattern ^wsp_[0-9a-f]{32}$ |
| ErrorDetail | code | string | pattern ^[a-z][a-z0-9_.-]+$ |
| ErrorDetail | message | string | minimum length 1; maximum length 500 |
| ErrorDetail | retry_after_ms | integer | null | integer: minimum 0 |
| EventActor | type | human | system | attempt | values human, system, attempt |
| EvidenceProjection | evidence_ref_id | EvidenceRefId | pattern ^evr_[0-9a-f]{32}$ |
| EvidenceProjection | target_kind | artifact | fixed value artifact |
| HealthStatus | status | ok | fixed value ok |
| MessageEvent | attempt_id | AttemptId | pattern ^att_[0-9a-f]{32}$ |
| MessageEvent | event_id | EventId | pattern ^eve_[0-9a-f]{32}$ |
| MessageEvent | event_type | message.started | message.delta | message.completed | values message.started, message.delta, message.completed |
| MessageEvent | provider_sequence | integer | minimum 0 |
| ProjectProjection | project_id | ProjectId | pattern ^prj_[0-9a-f]{32}$ |
| ProjectProjection | version | integer | minimum 1 |
| ProjectProjection | workspace_id | WorkspaceId | pattern ^wsp_[0-9a-f]{32}$ |
| ProjectSettings | inspector_width | integer | minimum 320; maximum 480 |
| ProjectSettings | navigator_width | integer | minimum 216; maximum 384 |
| ProjectSettings | theme | system | light | dark | values system, light, dark |
| ReasoningSummaryEvent | attempt_id | AttemptId | pattern ^att_[0-9a-f]{32}$ |
| ReasoningSummaryEvent | event_id | EventId | pattern ^eve_[0-9a-f]{32}$ |
| ReasoningSummaryEvent | event_type | reasoning.summary | fixed value reasoning.summary |
| ReasoningSummaryEvent | provider_sequence | integer | minimum 0 |
| ResearchStory | latest_cursor | Cursor | pattern ^c1_[A-Za-z0-9_-]{11}$ |
| ResearchStory | plan_version_id | PlanVersionId | pattern ^pln_[0-9a-f]{32}$ |
| ResearchStory | project_id | ProjectId | pattern ^prj_[0-9a-f]{32}$ |
| ResearchStory | run_id | RunId | pattern ^run_[0-9a-f]{32}$ |
| ResearchStory | workspace_id | WorkspaceId | pattern ^wsp_[0-9a-f]{32}$ |
| SandboxCapabilities | max_cpu | integer | minimum 1 |
| SandboxCapabilities | max_memory_mib | integer | minimum 256 |
| StoryAttempt | attempt_id | AttemptId | pattern ^att_[0-9a-f]{32}$ |
| StoryAttempt | state | succeeded | fixed value succeeded |
| StoryBlock | block_id | BlockId | pattern ^blk_[0-9a-f]{32}$ |
| StoryBlock | block_revision_id | BlockRevisionId | pattern ^rev_[0-9a-f]{32}$ |
| StoryBlock | document_id | DocumentId | pattern ^doc_[0-9a-f]{32}$ |
| StoryBlock | execution_id | ExecutionId | pattern ^exe_[0-9a-f]{32}$ |
| StoryBlock | execution_output_id | ExecutionOutputId | pattern ^out_[0-9a-f]{32}$ |
| StoryClaim | claim_id | ClaimId | pattern ^clm_[0-9a-f]{32}$ |
| StoryClaim | claim_revision_id | ClaimRevisionId | pattern ^crv_[0-9a-f]{32}$ |
| StoryClaim | currentness | current | fixed value current |
| StoryClaim | evidence_ref_id | EvidenceRefId | pattern ^evr_[0-9a-f]{32}$ |
| StoryClaim | review_status | accepted | fixed value accepted |
| StoryClaim | validity | valid-for-pinned-inputs | fixed value valid-for-pinned-inputs |
| StoryTask | phase | completed | fixed value completed |
| StoryTask | task_id | TaskId | pattern ^tsk_[0-9a-f]{32}$ |
| StoryWriteup | block_revision_id | BlockRevisionId | pattern ^rev_[0-9a-f]{32}$ |
| StoryWriteup | document_id | DocumentId | pattern ^doc_[0-9a-f]{32}$ |
| TaskProposedEvent | attempt_id | AttemptId | pattern ^att_[0-9a-f]{32}$ |
| TaskProposedEvent | event_id | EventId | pattern ^eve_[0-9a-f]{32}$ |
| TaskProposedEvent | event_type | task.proposed | fixed value task.proposed |
| TaskProposedEvent | provider_sequence | integer | minimum 0 |
| ToolEvent | attempt_id | AttemptId | pattern ^att_[0-9a-f]{32}$ |
| ToolEvent | event_id | EventId | pattern ^eve_[0-9a-f]{32}$ |
| ToolEvent | event_type | tool.requested | tool.started | tool.delta | tool.completed | values tool.requested, tool.started, tool.delta, tool.completed |
| ToolEvent | provider_sequence | integer | minimum 0 |
| ToolEvent | status | requested | running | succeeded | failed | values requested, running, succeeded, failed |
| UpdateProjectSettingsCommand | command_id | CommandId | pattern ^cmd_[0-9a-f]{32}$ |
| UpdateProjectSettingsCommand | idempotency_key | string | minimum length 8; maximum length 128 |
| UpdateProjectSettingsPayload | expected_version | integer | minimum 1 |
| UsageUpdatedEvent | attempt_id | AttemptId | pattern ^att_[0-9a-f]{32}$ |
| UsageUpdatedEvent | estimated_cost_micros | integer | minimum 0 |
| UsageUpdatedEvent | event_id | EventId | pattern ^eve_[0-9a-f]{32}$ |
| UsageUpdatedEvent | event_type | usage.updated | fixed value usage.updated |
| UsageUpdatedEvent | input_tokens | integer | minimum 0 |
| UsageUpdatedEvent | output_tokens | integer | minimum 0 |
| UsageUpdatedEvent | provider_sequence | integer | minimum 0 |