HTTP models: CausalBudgetCostSummary – EvalsOperationReadiness
Exact OpenAPI component declarations. $ref values identify other components in the complete schema.
CausalBudgetCostSummary
Section titled “CausalBudgetCostSummary”{ "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."}CausalBudgetSummaryResponse
Section titled “CausalBudgetSummaryResponse”{ "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"}CausalBudgetUsageSummary
Section titled “CausalBudgetUsageSummary”{ "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."}CheckpointCompatibilityErrorResponse
Section titled “CheckpointCompatibilityErrorResponse”{ "properties": { "detail": { "$ref": "#/components/schemas/CheckpointCompatibilityEvidence" } }, "additionalProperties": false, "type": "object", "required": [ "detail" ], "title": "CheckpointCompatibilityErrorResponse"}CheckpointCompatibilityEvidence
Section titled “CheckpointCompatibilityEvidence”{ "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"}CitationPart
Section titled “CitationPart”{ "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."}CitationProvenance
Section titled “CitationProvenance”{ "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."}ClientGenerationContract
Section titled “ClientGenerationContract”{ "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"}CompactSessionBody
Section titled “CompactSessionBody”{ "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"}ContextualPricingRequirement
Section titled “ContextualPricingRequirement”{ "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."}ControlPlaneCapabilities
Section titled “ControlPlaneCapabilities”{ "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."}ControlPlaneMutationCapabilities
Section titled “ControlPlaneMutationCapabilities”{ "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"}ControlPlaneSurfaceCapabilities
Section titled “ControlPlaneSurfaceCapabilities”{ "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"}CostLineItem
Section titled “CostLineItem”{ "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."}DelegatedActionReference
Section titled “DelegatedActionReference”{ "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."}EnqueueSessionMessageBody
Section titled “EnqueueSessionMessageBody”{ "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"}EnvironmentLifecyclePhase
Section titled “EnvironmentLifecyclePhase”{ "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."}EnvironmentLifecyclePolicy
Section titled “EnvironmentLifecyclePolicy”{ "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."}EnvironmentsResponse
Section titled “EnvironmentsResponse”{ "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"}EvalsOperationReadiness
Section titled “EvalsOperationReadiness”{ "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."}