HTTP models: EvalsReadiness – KnowledgeVisibility
Exact OpenAPI component declarations. $ref values identify other components in the complete schema.
EvalsReadiness
Section titled “EvalsReadiness”{ "properties": { "captured_evaluation": { "$ref": "#/components/schemas/EvalsOperationReadiness" }, "catalog_read": { "$ref": "#/components/schemas/EvalsOperationReadiness" }, "catalog_write": { "$ref": "#/components/schemas/EvalsOperationReadiness" }, "captured_result_persistence": { "$ref": "#/components/schemas/EvalsOperationReadiness" }, "scenario_conversion": { "$ref": "#/components/schemas/EvalsOperationReadiness" }, "fresh_launch": { "$ref": "#/components/schemas/EvalsOperationReadiness" }, "cancellation": { "$ref": "#/components/schemas/EvalsOperationReadiness" }, "comparison": { "$ref": "#/components/schemas/EvalsOperationReadiness" }, "reports": { "$ref": "#/components/schemas/EvalsOperationReadiness" } }, "additionalProperties": false, "type": "object", "required": [ "captured_evaluation", "catalog_read", "catalog_write", "captured_result_persistence", "scenario_conversion", "fresh_launch", "cancellation", "comparison", "reports" ], "title": "EvalsReadiness", "description": "Independent availability of the Evals product workflows."}{ "properties": { "type": { "anyOf": [ { "$ref": "#/components/schemas/EventType" }, { "type": "string" } ], "title": "Type" }, "session_id": { "type": "string", "title": "Session Id" }, "interaction_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Interaction Id" }, "id": { "type": "string", "maxLength": 512, "title": "Id" }, "timestamp": { "type": "string", "format": "date-time", "title": "Timestamp" }, "agent_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Name" }, "environment_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Environment Name" }, "workflow_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Workflow Name" }, "tool_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tool Name" }, "payload": { "additionalProperties": true, "type": "object", "title": "Payload" } }, "additionalProperties": false, "type": "object", "required": [ "type", "session_id" ], "title": "Event", "description": "Append-only runtime event.\n\nEvents are the common language between terminal output, dashboard views,\npersistent sessions, webhooks, and hosted-platform adapters."}EventOrder
Section titled “EventOrder”{ "type": "string", "enum": [ "sequence_asc", "sequence_desc" ], "title": "EventOrder"}EventSideEffectHealthResponse
Section titled “EventSideEffectHealthResponse”{ "properties": { "durable": { "$ref": "#/components/schemas/PersistedEventSideEffectHealth" }, "recovery_loop": { "anyOf": [ { "$ref": "#/components/schemas/EventSideEffectRecoveryLoop" }, { "type": "null" } ] } }, "type": "object", "required": [ "durable" ], "title": "EventSideEffectHealthResponse"}EventSideEffectRecoveryLoop
Section titled “EventSideEffectRecoveryLoop”{ "properties": { "scope": { "type": "string", "const": "process_local_reset_on_restart", "title": "Scope", "default": "process_local_reset_on_restart" }, "state": { "type": "string", "enum": [ "configured", "running", "stopped" ], "title": "State", "default": "configured" }, "started_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Started At" }, "last_sweep_started_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Sweep Started At" }, "last_sweep_completed_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Sweep Completed At" }, "last_success_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Success At" }, "last_delivered_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Last Delivered Count" }, "last_duration_seconds": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Last Duration Seconds" }, "interval_seconds": { "type": "number", "title": "Interval Seconds" }, "batch_limit": { "type": "integer", "title": "Batch Limit" }, "last_success_saturated": { "type": "boolean", "title": "Last Success Saturated", "default": false }, "consecutive_failures": { "type": "integer", "title": "Consecutive Failures", "default": 0 }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Error" }, "last_error_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Error At" }, "sweep_attempts": { "type": "integer", "title": "Sweep Attempts", "default": 0 }, "sweep_successes": { "type": "integer", "title": "Sweep Successes", "default": 0 }, "sweep_failures": { "type": "integer", "title": "Sweep Failures", "default": 0 }, "delivered_rows": { "type": "integer", "title": "Delivered Rows", "default": 0 }, "saturated_batches": { "type": "integer", "title": "Saturated Batches", "default": 0 } }, "type": "object", "required": [ "interval_seconds", "batch_limit" ], "title": "EventSideEffectRecoveryLoop"}EventType
Section titled “EventType”{ "type": "string", "enum": [ "workspace.checkpoint.updated", "server.mutation.accepted", "recovery.plan.item.executed", "session.started", "session.resumed", "session.completed", "session.failed", "session.interrupted", "session.delegated_action.updated", "session.interruption_cascade_retry_requested", "session.interruption_cascade_completed", "session.interruption_cascade_failed", "session.awaiting_user_input", "session.checkpointed", "session.forked", "session.export.published", "session.export.released", "session.export.retired", "session.limit_reached", "session.message.queued", "session.message.delivered", "session.message.withdrawn", "session.message.quarantined", "session.message.stale", "session.message.expired", "session.model.switched", "session.execution_profile.decided", "session.execution_profile.rejected", "session.run_fenced", "turn.completed", "interaction.started", "interaction.resumed", "interaction.paused", "interaction.completed", "interaction.failed", "interaction.interrupted", "budget.checked", "budget.limit_reached", "budget.reserved", "budget.reconciled", "budget.reservation_failed", "budget.reservation_released", "credential.proxy.checked", "credential.mode.selected", "egress.grant.minted", "egress.grant.revoked", "egress.request.authorized", "egress.request.denied", "egress.authority.requested", "egress.authority.authorized", "egress.authority.installing", "egress.authority.activated", "egress.authority.refused", "egress.authority.ambiguous", "mcp.manifest.checked", "mcp.manifest.blocked", "task.created", "task.started", "task.completed", "task.failed", "task.cancelled", "task.interrupted_handoff", "task.completion_result.resolved", "model.started", "model.text.delta", "model.thinking.delta", "model.hosted_tool_call", "model.citation", "model.completed", "model.auxiliary.attempt_started", "model.auxiliary.attempt_settled", "model.error", "model.http_cleanup", "model.retry", "model.attempt_discarded", "model.failover.selected", "model.failover.exhausted", "provider.operation.starting", "provider.operation.started", "provider.operation.progress", "provider.operation.cancel_requested", "provider.operation.cancel_resolved", "provider.operation.reconnect_scheduled", "provider.operation.reconnect_started", "provider.operation.recovery_required", "provider.operation.resolved", "provider.operation.reconciled", "request.footprint.recorded", "tool.exposure.recorded", "tool.grant.issued", "tool.grant.reused", "tool.grant.reconstructed", "tool.grant.expired", "tool.grant.revoked", "tool.grant.fork_reset", "tool.reference.consumed", "tool.reference.rejoined", "tool.reference.rejected", "structured_output.validated", "structured_output.validating", "structured_output.failed", "structured_output.retry", "context.compaction.started", "context.compaction.completed", "context.compaction.failed", "context.counted", "context.count.failed", "context.count.reconciled", "context.pressure.estimated", "context.pressure.reconciled", "context.overflow.detected", "context.overflow.recovering", "context.overflow.failed", "memory.recall.started", "memory.recall.completed", "memory.recall.failed", "memory.recall.admitted", "environment.binding.started", "environment.binding.completed", "environment.binding.failed", "environment.binding.finalize_started", "environment.binding.finalize_completed", "environment.binding.finalize_failed", "environment.factory.started", "environment.factory.completed", "environment.factory.failed", "environment.lifecycle.progress", "environment.lifecycle.transition", "environment.deferred", "environment.materialization.started", "environment.materialization.completed", "environment.materialization.failed", "workspace.revision.observed", "workspace.mutation.recorded", "workspace.observation.finalized", "hook.started", "hook.completed", "hook.failed", "tool.call.started", "tool.call.completed", "tool.call.failed", "tool.effect.reconciliation.observed", "tool.effect.outcome_unknown", "tool.effect.cleanup.observed", "tool.effect.reconciliation.started", "tool.effect.reconciliation.conflict", "tool.effect.receipt.validated", "tool.call.blocked", "tool.call.approval_requested", "tool.call.approved", "tool.call.approval_denied", "tool.call.approval_expired", "workflow.started", "workflow.step.started", "workflow.step.completed", "workflow.completed", "memory.search", "runner.exec.started", "runner.exec.completed", "runtime.sink.failed", "runtime.interaction_transition.acknowledgement_failed" ], "title": "EventType"}ExecutionProfileAdoptionBody
Section titled “ExecutionProfileAdoptionBody”{ "properties": { "idempotency_key": { "type": "string", "maxLength": 256, "minLength": 1, "pattern": "^[^\\x00]+$", "title": "Idempotency Key" }, "reason": { "type": "string", "maxLength": 4096, "minLength": 1, "pattern": "^[^\\x00]+$", "title": "Reason" }, "requested_by": { "anyOf": [ { "$ref": "#/components/schemas/ResolutionActor" }, { "type": "null" } ] } }, "additionalProperties": false, "type": "object", "required": [ "idempotency_key", "reason" ], "title": "ExecutionProfileAdoptionBody"}FilePart
Section titled “FilePart”{ "properties": { "type": { "type": "string", "const": "file", "title": "Type", "default": "file" }, "attachment": { "additionalProperties": true, "type": "object", "title": "Attachment" } }, "additionalProperties": false, "type": "object", "required": [ "attachment" ], "title": "FilePart", "description": "User-supplied file input (image or document) for a multimodal request.\n\n`attachment` carries a JSON-safe `cayu.file_attachment.v1` payload\nreferencing a stored artifact \u2014 never file bytes. The runtime resolves the\nartifact from the active ArtifactStore immediately before each provider\nrequest, exactly like tool-result attachments."}HTTPValidationError
Section titled “HTTPValidationError”{ "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError"}HealthResponse
Section titled “HealthResponse”{ "properties": { "ok": { "type": "boolean", "title": "Ok" } }, "additionalProperties": false, "type": "object", "required": [ "ok" ], "title": "HealthResponse"}HostedToolCallPart
Section titled “HostedToolCallPart”{ "properties": { "type": { "type": "string", "const": "hosted_tool_call", "title": "Type", "default": "hosted_tool_call" }, "hosted_tool": { "type": "string", "const": "web_search", "title": "Hosted Tool", "default": "web_search" }, "call_id": { "type": "string", "maxLength": 512, "title": "Call Id" }, "status": { "type": "string", "enum": [ "completed", "incomplete", "failed", "outcome_unknown" ], "title": "Status" }, "action": { "anyOf": [ { "$ref": "#/components/schemas/WebSearchAction" }, { "type": "null" } ] }, "provider_name": { "type": "string", "maxLength": 128, "title": "Provider Name" }, "model": { "type": "string", "maxLength": 512, "title": "Model" }, "model_step_id": { "type": "string", "title": "Model Step Id" }, "model_attempt_id": { "type": "string", "title": "Model Attempt Id" } }, "additionalProperties": false, "type": "object", "required": [ "call_id", "status", "provider_name", "model", "model_step_id", "model_attempt_id" ], "title": "HostedToolCallPart", "description": "Terminal provider-hosted execution evidence in an assistant transcript."}HumanReviewCall
Section titled “HumanReviewCall”{ "properties": { "tool_call_id": { "type": "string", "maxLength": 512, "title": "Tool Call Id" }, "tool_name": { "type": "string", "maxLength": 512, "title": "Tool Name" }, "on_grant": { "type": "string", "enum": [ "eligible", "denied", "withheld" ], "title": "On Grant" } }, "additionalProperties": false, "type": "object", "required": [ "tool_call_id", "tool_name", "on_grant" ], "title": "HumanReviewCall"}HumanReviewContext
Section titled “HumanReviewContext”{ "properties": { "recipient": { "type": "string", "maxLength": 512, "minLength": 1, "title": "Recipient" }, "tenant": { "anyOf": [ { "type": "string", "maxLength": 512, "minLength": 1 }, { "type": "null" } ], "title": "Tenant" }, "purpose": { "type": "string", "maxLength": 128, "minLength": 1, "title": "Purpose" } }, "additionalProperties": false, "type": "object", "required": [ "recipient", "purpose" ], "title": "HumanReviewContext", "description": "Verified recipient supplied by trusted SDK code or server authentication."}HumanReviewField
Section titled “HumanReviewField”{ "properties": { "label": { "type": "string", "maxLength": 128, "minLength": 1, "title": "Label" }, "text": { "type": "string", "maxLength": 4096, "minLength": 1, "title": "Text" } }, "additionalProperties": false, "type": "object", "required": [ "label", "text" ], "title": "HumanReviewField", "description": "Untrusted plain text selected by the application policy."}HumanReviewReference
Section titled “HumanReviewReference”{ "properties": { "context": { "$ref": "#/components/schemas/HumanReviewContext" }, "policy_version": { "type": "string", "maxLength": 128, "minLength": 1, "title": "Policy Version" }, "content_tag": { "type": "string", "pattern": "^[0-9a-f]{64}$", "title": "Content Tag" } }, "additionalProperties": false, "type": "object", "required": [ "context", "policy_version", "content_tag" ], "title": "HumanReviewReference", "description": "Opaque content binding; conveys no authority to execute or resolve."}HumanReviewView
Section titled “HumanReviewView”{ "properties": { "status": { "type": "string", "enum": [ "permitted", "redacted", "unavailable" ], "title": "Status" }, "guidance": { "type": "string", "enum": [ "Review all calls before deciding.", "Review content is withheld; contact the application owner or deny the action.", "No current review is available; refresh pending interactions.", "This recovery gate cannot authorize execution; use explicit blocked recovery." ], "title": "Guidance" }, "session_id": { "type": "string", "title": "Session Id" }, "interaction_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Interaction Id" }, "tool_round_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tool Round Id" }, "tool_call_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tool Call Id" }, "kind": { "anyOf": [ { "type": "string", "enum": [ "user_input", "tool_approval" ] }, { "type": "null" } ], "title": "Kind" }, "calls": { "items": { "$ref": "#/components/schemas/HumanReviewCall" }, "type": "array", "title": "Calls", "default": [] }, "fields": { "items": { "$ref": "#/components/schemas/HumanReviewField" }, "type": "array", "title": "Fields", "default": [] }, "reference": { "anyOf": [ { "$ref": "#/components/schemas/HumanReviewReference" }, { "type": "null" } ] }, "display_format": { "type": "string", "const": "html_escaped_text", "title": "Display Format", "default": "html_escaped_text" } }, "additionalProperties": false, "type": "object", "required": [ "status", "guidance", "session_id" ], "title": "HumanReviewView", "description": "Protected response. All display fields are HTML-escaped untrusted text.\n\nThis response has no generic event, trace, transcript or export contract."}InteractionStatus
Section titled “InteractionStatus”{ "type": "string", "enum": [ "active", "paused", "completed", "failed", "interrupted" ], "title": "InteractionStatus"}InterruptSessionBody
Section titled “InterruptSessionBody”{ "properties": { "reason": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ], "title": "Reason" }, "metadata": { "additionalProperties": true, "type": "object", "title": "Metadata" }, "requested_by": { "anyOf": [ { "$ref": "#/components/schemas/ResolutionActor" }, { "type": "null" } ] } }, "type": "object", "title": "InterruptSessionBody"}InvocationOriginTrust
Section titled “InvocationOriginTrust”{ "type": "string", "enum": [ "server_verified", "host_asserted", "unattributed" ], "title": "InvocationOriginTrust", "description": "How Cayu obtained the root invocation identity."}KnowledgeVisibility
Section titled “KnowledgeVisibility”{ "type": "string", "enum": [ "global", "organization", "project", "workspace", "user", "session", "task" ], "title": "KnowledgeVisibility"}