Skip to content

HTTP models: CausalBudgetCostSummary – EvalsOperationReadiness

Exact OpenAPI component declarations. $ref values identify other components in the complete schema.

{
"properties": {
"causal_budget_id": {
"type": "string",
"title": "Causal Budget Id"
},
"session_ids": {
"items": {
"type": "string"
},
"type": "array",
"title": "Session Ids"
},
"session_count": {
"type": "integer",
"minimum": 0.0,
"title": "Session Count",
"default": 0
},
"currency": {
"type": "string",
"title": "Currency"
},
"model_steps": {
"type": "integer",
"minimum": 0.0,
"title": "Model Steps"
},
"priced_model_steps": {
"type": "integer",
"minimum": 0.0,
"title": "Priced Model Steps"
},
"unpriced_model_steps": {
"type": "integer",
"minimum": 0.0,
"title": "Unpriced Model Steps"
},
"auxiliary_attempts": {
"type": "integer",
"minimum": 0.0,
"title": "Auxiliary Attempts",
"default": 0
},
"unpriced_auxiliary_attempts": {
"type": "integer",
"minimum": 0.0,
"title": "Unpriced Auxiliary Attempts",
"default": 0
},
"missing_usage_model_steps": {
"type": "integer",
"minimum": 0.0,
"title": "Missing Usage Model Steps",
"default": 0
},
"missing_pricing_model_steps": {
"type": "integer",
"minimum": 0.0,
"title": "Missing Pricing Model Steps",
"default": 0
},
"unsupported_pricing_model_steps": {
"type": "integer",
"minimum": 0.0,
"title": "Unsupported Pricing Model Steps",
"default": 0
},
"total_cost": {
"type": "string",
"pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
"title": "Total Cost"
},
"line_items": {
"items": {
"$ref": "#/components/schemas/CostLineItem"
},
"type": "array",
"title": "Line Items"
},
"session_costs": {
"items": {
"$ref": "#/components/schemas/SessionCostSummary"
},
"type": "array",
"title": "Session Costs"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"causal_budget_id",
"currency",
"model_steps",
"priced_model_steps",
"unpriced_model_steps",
"total_cost"
],
"title": "CausalBudgetCostSummary",
"description": "Estimated cost for all sessions sharing one causal budget id."
}
{
"properties": {
"causal_budget_id": {
"type": "string",
"title": "Causal Budget Id"
},
"session_count": {
"type": "integer",
"minimum": 0.0,
"title": "Session Count"
},
"sessions": {
"items": {
"$ref": "#/components/schemas/ApiSessionSummaryItem"
},
"type": "array",
"title": "Sessions"
},
"usage": {
"$ref": "#/components/schemas/CausalBudgetUsageSummary"
},
"cost": {
"$ref": "#/components/schemas/CausalBudgetCostSummary"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"causal_budget_id",
"session_count",
"sessions",
"usage",
"cost"
],
"title": "CausalBudgetSummaryResponse"
}
{
"properties": {
"causal_budget_id": {
"type": "string",
"title": "Causal Budget Id"
},
"session_ids": {
"items": {
"type": "string"
},
"type": "array",
"title": "Session Ids"
},
"session_count": {
"type": "integer",
"maximum": 9.223372036854776e+18,
"minimum": 0.0,
"title": "Session Count",
"default": 0
},
"model_steps": {
"type": "integer",
"maximum": 9.223372036854776e+18,
"minimum": 0.0,
"title": "Model Steps",
"default": 0
},
"unmeasured_model_attempts": {
"type": "integer",
"maximum": 9.223372036854776e+18,
"minimum": 0.0,
"title": "Unmeasured Model Attempts",
"default": 0
},
"tool_calls": {
"type": "integer",
"maximum": 9.223372036854776e+18,
"minimum": 0.0,
"title": "Tool Calls",
"default": 0
},
"provider_names": {
"items": {
"type": "string"
},
"type": "array",
"title": "Provider Names"
},
"models": {
"items": {
"type": "string"
},
"type": "array",
"title": "Models"
},
"usage": {
"$ref": "#/components/schemas/AggregateUsageMetrics"
},
"session_summaries": {
"items": {
"$ref": "#/components/schemas/SessionUsageSummary"
},
"type": "array",
"title": "Session Summaries"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"causal_budget_id"
],
"title": "CausalBudgetUsageSummary",
"description": "Usage totals for all sessions sharing one causal budget id."
}
{
"properties": {
"detail": {
"$ref": "#/components/schemas/CheckpointCompatibilityEvidence"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"detail"
],
"title": "CheckpointCompatibilityErrorResponse"
}
{
"properties": {
"checkpoint_kind": {
"type": "string",
"const": "root",
"title": "Checkpoint Kind"
},
"observed_version": {
"anyOf": [
{
"type": "integer",
"minimum": 1.0
},
{
"type": "null"
}
],
"title": "Observed Version"
},
"reason": {
"type": "string",
"enum": [
"invalid_root_checkpoint",
"invalid_checkpoint_schema_version",
"checkpoint_schema_version_too_new",
"checkpoint_schema_version_too_old"
],
"title": "Reason"
},
"recovery_disposition": {
"type": "string",
"const": "cannot_migrate",
"title": "Recovery Disposition"
},
"resumable_in_place": {
"type": "boolean",
"const": false,
"title": "Resumable In Place"
},
"session_id": {
"type": "string",
"title": "Session Id"
},
"supported_max_version": {
"type": "integer",
"minimum": 1.0,
"title": "Supported Max Version"
},
"supported_min_version": {
"type": "integer",
"minimum": 1.0,
"title": "Supported Min Version"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"checkpoint_kind",
"observed_version",
"reason",
"recovery_disposition",
"resumable_in_place",
"session_id",
"supported_max_version",
"supported_min_version"
],
"title": "CheckpointCompatibilityEvidence"
}
{
"properties": {
"type": {
"type": "string",
"const": "citation",
"title": "Type",
"default": "citation"
},
"citation_type": {
"type": "string",
"const": "url_citation",
"title": "Citation Type",
"default": "url_citation"
},
"url": {
"type": "string",
"maxLength": 4096,
"title": "Url"
},
"title": {
"anyOf": [
{
"type": "string",
"maxLength": 1024
},
{
"type": "null"
}
],
"title": "Title"
},
"start_index": {
"anyOf": [
{
"type": "integer",
"minimum": 0.0
},
{
"type": "null"
}
],
"title": "Start Index"
},
"end_index": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0.0
},
{
"type": "null"
}
],
"title": "End Index"
},
"provenance": {
"$ref": "#/components/schemas/CitationProvenance"
},
"model_step_id": {
"type": "string",
"title": "Model Step Id"
},
"model_attempt_id": {
"type": "string",
"title": "Model Attempt Id"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"url",
"provenance",
"model_step_id",
"model_attempt_id"
],
"title": "CitationPart",
"description": "Provider-neutral citation annotation over assistant text."
}
{
"properties": {
"provider_name": {
"type": "string",
"maxLength": 128,
"title": "Provider Name"
},
"hosted_tool": {
"type": "string",
"const": "web_search",
"title": "Hosted Tool",
"default": "web_search"
},
"untrusted_external_evidence": {
"type": "boolean",
"const": true,
"title": "Untrusted External Evidence",
"default": true
}
},
"additionalProperties": false,
"type": "object",
"required": [
"provider_name"
],
"title": "CitationProvenance",
"description": "Trust label for provider-hosted citation evidence."
}
{
"properties": {
"openapi_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Openapi Url",
"default": "/openapi.json"
},
"supported_targets": {
"items": {
"type": "string",
"enum": [
"typescript",
"python"
]
},
"type": "array",
"title": "Supported Targets",
"default": [
"typescript",
"python"
]
},
"source_of_truth": {
"type": "string",
"const": "openapi",
"title": "Source Of Truth",
"default": "openapi"
}
},
"additionalProperties": false,
"type": "object",
"title": "ClientGenerationContract"
}
{
"properties": {
"idempotency_key": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"pattern": "^[^\\x00]+$",
"title": "Idempotency Key"
},
"expected_run_epoch": {
"type": "integer",
"minimum": 0.0,
"title": "Expected Run Epoch"
},
"expected_transcript_cursor": {
"type": "integer",
"minimum": 0.0,
"title": "Expected Transcript Cursor"
},
"instructions": {
"anyOf": [
{
"type": "string",
"maxLength": 32768,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Instructions"
},
"limits": {
"$ref": "#/components/schemas/RunLimits"
},
"budget_limits": {
"items": {
"$ref": "#/components/schemas/BudgetLimit"
},
"type": "array",
"title": "Budget Limits"
},
"requested_by": {
"anyOf": [
{
"$ref": "#/components/schemas/ResolutionActor"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false,
"type": "object",
"required": [
"idempotency_key",
"expected_run_epoch",
"expected_transcript_cursor"
],
"title": "CompactSessionBody"
}
{
"properties": {
"provider_name": {
"type": "string",
"title": "Provider Name"
},
"dimensions": {
"items": {
"type": "string"
},
"type": "array",
"title": "Dimensions"
},
"requires_cache_write_ttls": {
"type": "boolean",
"title": "Requires Cache Write Ttls",
"default": false
}
},
"additionalProperties": false,
"type": "object",
"required": [
"provider_name",
"dimensions"
],
"title": "ContextualPricingRequirement",
"description": "Commercial constraints every contextual price for one provider must declare."
}
{
"properties": {
"cayu_version": {
"anyOf": [
{
"type": "string",
"maxLength": 128
},
{
"type": "null"
}
],
"title": "Cayu Version"
},
"configured_store_roles": {
"items": {
"type": "string",
"enum": [
"session",
"task",
"knowledge",
"artifact"
]
},
"type": "array",
"maxItems": 4,
"title": "Configured Store Roles"
},
"actor": {
"anyOf": [
{
"$ref": "#/components/schemas/ServerContractActor"
},
{
"type": "null"
}
]
},
"surfaces": {
"$ref": "#/components/schemas/ControlPlaneSurfaceCapabilities"
},
"mutations": {
"$ref": "#/components/schemas/ControlPlaneMutationCapabilities"
},
"evals_readiness": {
"$ref": "#/components/schemas/EvalsReadiness"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"cayu_version",
"configured_store_roles",
"actor",
"surfaces",
"mutations",
"evals_readiness"
],
"title": "ControlPlaneCapabilities",
"description": "Server-authoritative discovery metadata for the Cayu control plane.\n\nThis projection is presentation metadata rather than an authorization\ntoken. Every underlying route continues to enforce its configured access\ndependency and runtime preconditions."
}
{
"properties": {
"session_execution": {
"$ref": "#/components/schemas/CapabilityOperation"
},
"session_interruption": {
"$ref": "#/components/schemas/CapabilityOperation"
},
"provider_operation_resolution": {
"$ref": "#/components/schemas/CapabilityOperation"
},
"pending_action_resolution": {
"$ref": "#/components/schemas/CapabilityOperation"
},
"session_annotations": {
"$ref": "#/components/schemas/CapabilityOperation"
},
"task_lifecycle": {
"$ref": "#/components/schemas/CapabilityOperation"
},
"knowledge_review": {
"$ref": "#/components/schemas/CapabilityOperation"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"session_execution",
"session_interruption",
"provider_operation_resolution",
"pending_action_resolution",
"session_annotations",
"task_lifecycle",
"knowledge_review"
],
"title": "ControlPlaneMutationCapabilities"
}
{
"properties": {
"dashboard": {
"$ref": "#/components/schemas/OptionalSurfaceCapability"
},
"workflow": {
"anyOf": [
{
"$ref": "#/components/schemas/OptionalSurfaceCapability"
},
{
"type": "null"
}
]
},
"browser_recordings": {
"anyOf": [
{
"$ref": "#/components/schemas/OptionalSurfaceCapability"
},
{
"type": "null"
}
]
},
"session_follow": {
"anyOf": [
{
"$ref": "#/components/schemas/OptionalSurfaceCapability"
},
{
"type": "null"
}
]
},
"tasks": {
"$ref": "#/components/schemas/OptionalSurfaceCapability"
},
"reviewed_knowledge": {
"$ref": "#/components/schemas/OptionalSurfaceCapability"
},
"artifacts": {
"$ref": "#/components/schemas/OptionalSurfaceCapability"
},
"usage": {
"$ref": "#/components/schemas/OptionalSurfaceCapability"
},
"pricing": {
"$ref": "#/components/schemas/OptionalSurfaceCapability"
},
"evaluation_promotion": {
"$ref": "#/components/schemas/OptionalSurfaceCapability"
},
"evals": {
"$ref": "#/components/schemas/OptionalSurfaceCapability"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"dashboard",
"tasks",
"reviewed_knowledge",
"artifacts",
"usage",
"pricing",
"evaluation_promotion",
"evals"
],
"title": "ControlPlaneSurfaceCapabilities"
}
{
"properties": {
"model_step": {
"type": "integer",
"minimum": 0.0,
"title": "Model Step"
},
"auxiliary_attempt": {
"type": "boolean",
"title": "Auxiliary Attempt",
"default": false
},
"execution_profile_fingerprint": {
"anyOf": [
{
"type": "string",
"maxLength": 64
},
{
"type": "null"
}
],
"title": "Execution Profile Fingerprint"
},
"provider_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Provider Name"
},
"requested_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Requested Model"
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Model"
},
"billing_identity": {
"anyOf": [
{
"$ref": "#/components/schemas/BillingIdentity"
},
{
"type": "null"
}
]
},
"pricing_provider_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Pricing Provider Name"
},
"pricing_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Pricing Model"
},
"pricing_match": {
"anyOf": [
{
"type": "string",
"enum": [
"exact",
"prefix",
"resource_mapping"
]
},
{
"type": "null"
}
],
"title": "Pricing Match"
},
"pricing_provenance": {
"anyOf": [
{
"$ref": "#/components/schemas/Provenance"
},
{
"type": "null"
}
]
},
"pricing_effective_from": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
],
"title": "Pricing Effective From"
},
"pricing_effective_through": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
],
"title": "Pricing Effective Through"
},
"pricing_tier_max_input_tokens": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Pricing Tier Max Input Tokens"
},
"priced": {
"type": "boolean",
"title": "Priced"
},
"currency": {
"type": "string",
"title": "Currency"
},
"input_tokens": {
"type": "integer",
"minimum": 0.0,
"title": "Input Tokens"
},
"output_tokens": {
"type": "integer",
"minimum": 0.0,
"title": "Output Tokens"
},
"cache_read_input_tokens": {
"type": "integer",
"minimum": 0.0,
"title": "Cache Read Input Tokens"
},
"cache_write_input_tokens": {
"type": "integer",
"minimum": 0.0,
"title": "Cache Write Input Tokens"
},
"cache_write_5m_input_tokens": {
"type": "integer",
"minimum": 0.0,
"title": "Cache Write 5M Input Tokens",
"default": 0
},
"cache_write_1h_input_tokens": {
"type": "integer",
"minimum": 0.0,
"title": "Cache Write 1H Input Tokens",
"default": 0
},
"cache_write_unknown_ttl_input_tokens": {
"type": "integer",
"minimum": 0.0,
"title": "Cache Write Unknown Ttl Input Tokens",
"default": 0
},
"web_search_calls": {
"type": "integer",
"minimum": 0.0,
"title": "Web Search Calls",
"default": 0
},
"web_search_outcome_unknown": {
"type": "integer",
"minimum": 0.0,
"title": "Web Search Outcome Unknown",
"default": 0
},
"uncached_input_tokens": {
"type": "integer",
"minimum": 0.0,
"title": "Uncached Input Tokens"
},
"input_cost": {
"type": "string",
"pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
"title": "Input Cost"
},
"output_cost": {
"type": "string",
"pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
"title": "Output Cost"
},
"cache_read_input_cost": {
"type": "string",
"pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
"title": "Cache Read Input Cost"
},
"cache_write_input_cost": {
"type": "string",
"pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
"title": "Cache Write Input Cost"
},
"web_search_cost": {
"type": "string",
"pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
"title": "Web Search Cost",
"default": "0"
},
"total_cost": {
"type": "string",
"pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
"title": "Total Cost"
},
"unpriced_reason": {
"anyOf": [
{
"type": "string",
"enum": [
"missing_usage",
"missing_pricing",
"unsupported_pricing"
]
},
{
"type": "null"
}
],
"title": "Unpriced Reason"
},
"missing_pricing_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Missing Pricing Reason"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"model_step",
"priced",
"currency",
"input_tokens",
"output_tokens",
"cache_read_input_tokens",
"cache_write_input_tokens",
"uncached_input_tokens",
"input_cost",
"output_cost",
"cache_read_input_cost",
"cache_write_input_cost",
"total_cost"
],
"title": "CostLineItem",
"description": "Estimated cost for one model attempt or standalone hosted resource evidence."
}
{
"properties": {
"child_session_id": {
"type": "string",
"title": "Child Session Id"
},
"action_kind": {
"type": "string",
"enum": [
"tool_approval",
"user_input",
"delegated_action"
],
"title": "Action Kind"
},
"action_id": {
"type": "string",
"title": "Action Id"
},
"status": {
"type": "string",
"const": "waiting_on_child_action",
"title": "Status",
"default": "waiting_on_child_action"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"child_session_id",
"action_kind",
"action_id"
],
"title": "DelegatedActionReference",
"description": "Bounded discovery of a child-owned action; not resolution authority."
}
{
"properties": {
"idempotency_key": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"title": "Idempotency Key"
},
"content": {
"type": "string",
"maxLength": 983040,
"minLength": 1,
"title": "Content"
},
"message": {
"anyOf": [
{
"$ref": "#/components/schemas/Message"
},
{
"type": "null"
}
]
},
"delivery_mode": {
"$ref": "#/components/schemas/SessionMessageDeliveryMode"
},
"requested_by": {
"anyOf": [
{
"$ref": "#/components/schemas/ResolutionActor"
},
{
"type": "null"
}
]
},
"conditions": {
"$ref": "#/components/schemas/SessionMessageConditions"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"idempotency_key",
"content",
"delivery_mode"
],
"title": "EnqueueSessionMessageBody"
}
{
"type": "string",
"enum": [
"ownership_admission",
"factory_provisioning",
"factory_reconnect",
"source_observation",
"staging_admission",
"archive_preparation",
"transfer",
"target_materialization",
"execution_ready_publication",
"final_source_observation",
"final_target_observation",
"copy_back_conflict_preflight",
"copy_back_publication",
"environment_release",
"retained_cleanup"
],
"title": "EnvironmentLifecyclePhase",
"description": "Content-free phases shared by factories, bindings, and cleanup."
}
{
"properties": {
"lifecycle_timeout_seconds": {
"type": "number",
"maximum": 86400.0,
"exclusiveMinimum": 0.0,
"title": "Lifecycle Timeout Seconds",
"default": 3600.0
},
"phase_timeout_seconds": {
"additionalProperties": {
"type": "number"
},
"type": "object",
"title": "Phase Timeout Seconds"
},
"progress_min_interval_seconds": {
"type": "number",
"maximum": 60.0,
"minimum": 0.0,
"title": "Progress Min Interval Seconds",
"default": 0.25
},
"max_progress_events": {
"type": "integer",
"maximum": 1024.0,
"minimum": 32.0,
"title": "Max Progress Events",
"default": 128
}
},
"additionalProperties": false,
"type": "object",
"title": "EnvironmentLifecyclePolicy",
"description": "Finite lifecycle, phase, and progress-volume ceilings for one environment."
}
{
"properties": {
"environments": {
"items": {
"$ref": "#/components/schemas/ApiEnvironmentSummary"
},
"type": "array",
"title": "Environments"
},
"total_count": {
"type": "integer",
"minimum": 0.0,
"title": "Total Count"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"environments",
"total_count"
],
"title": "EnvironmentsResponse"
}
{
"properties": {
"state": {
"type": "string",
"enum": [
"ready",
"gated",
"unsupported"
],
"title": "State"
},
"reason_code": {
"anyOf": [
{
"type": "string",
"enum": [
"evaluation_promotion_not_configured",
"terminal_evidence_not_supported",
"session_lineage_not_supported",
"eval_store_not_configured",
"eval_target_not_configured",
"captured_result_persistence_not_available",
"scenario_v2_not_available"
]
},
{
"type": "null"
}
],
"title": "Reason Code"
}
},
"additionalProperties": false,
"type": "object",
"required": [
"state",
"reason_code"
],
"title": "EvalsOperationReadiness",
"description": "Discovery state for one Evals product operation.\n\nReadiness is presentation metadata, not an authorization grant. Underlying\nroutes continue to enforce authentication, mutation policy, and runtime\npreconditions."
}