> ## Documentation Index > Fetch the complete documentation index at: https://docs.checkfu.com/llms.txt > Use this file to discover all available pages before exploring further. # Drive a Session with a client event > Appends one client event to the Session, which is how work is made to happen: user.message starts a turn or steers a running one, user.interrupt ends the… ## OpenAPI ````yaml /openapi.json post /v1/sessions/{id}/events openapi: 3.1.0 info: title: Checkfu API version: '2026-08-31' description: >- Authentication is declared per operation: API-key, runtime, or connector bearer; Automation signature; or credential-free pairing redemption. Every general Checkfu REST request requires the dated `Checkfu-Version` header (one of: 2026-08-31); the three MCP JSON-RPC transports use `MCP-Protocol-Version`, A2A uses `A2A-Version`, and the provider OAuth callback carries neither Checkfu header. API keys resolve one Workspace without a request selector; authenticated responses identify it with `Checkfu-Workspace-Id`. servers: - url: https://api.checkfu.com security: - bearerAuth: [] tags: - name: organizations - name: sourceRepositories - name: tenants - name: workspaces - name: principals - name: principalGroups - name: principalAccessCredentials - name: apiKeys - name: agents - name: harnessRuntime - name: permissionAssignments - name: actionPolicies - name: files - name: memoryStores - name: modelCredentials - name: modelRoutingProfiles - name: toolSources - name: skills - name: skillSources - name: agentBlueprints - name: skillProposals - name: instructionProposals - name: catalog - name: managedTools - name: concepts - name: support - name: connections - name: connectionVaults - name: connectionAssignments - name: connectedRuntimes - name: fileTrees - name: collaboration - name: automationGraphs - name: automations - name: actionApprovals - name: standingApprovals - name: workloadReviewPolicies - name: usage - name: models - name: outcomes - name: budgets - name: billing - name: sessions - name: audit - name: sessionExports - name: runs - name: runnerPools - name: transcripts - name: sessionWatches - name: sessionCapsules - name: sessionTrajectories - name: webhookEndpoints - name: integrationGateway - name: workEnvironments - name: computers - name: computerScreens - name: computerBrowserObservations - name: computerBrowserActions - name: environments - name: computerHeadlessOperations - name: vaults - name: apiMcp - name: a2a paths: /v1/sessions/{id}/events: post: tags: - sessions summary: Drive a Session with a client event description: >- Appends one client event to the Session, which is how work is made to happen: `user.message` starts a turn or steers a running one, `user.interrupt` ends the current turn without making the Session terminal, `user.custom_tool_result` returns the result of a parked Custom tool by its `tool_use_id`, completing the parked Run and starting a fresh continuation Run, `user.question_answer` answers one active `agent.question`, `user.define_outcome` attaches a rubric-graded definition of done and `system.message` appends privileged system context that applies to the accompanying turn and every later one. System context is governed: it is control-plane authority, so a `runner` credential is refused before the Session is even looked up; it is refused when the Session's admitted model route cannot carry a mid-conversation system turn (an Anthropic route takes `system` as a top-level parameter only, so there is no position for one); it never replaces the agent definition's system prompt, which stays frozen and a Session carries at most 16 of them, because unlike conversation this context is never condensed away and something has to bound it. It appends without starting a turn — a Run already in flight keeps its frozen spec and the next one reads the instruction. A `user.message` `content` is a plain string or an array of typed content blocks (the CMA shape, adopted as-is): text blocks, image blocks with `base64`/`url`/`file` sources (png/jpeg/gif/webp) and document blocks with `base64` (PDF)/`text`/`url`/`file` sources plus optional `title` and `context`. Content blocks are model-visible input, never a second mount system. Inline images, PDFs and text documents render at the trusted model gateway in the exact provider dialect and typed user history survives later Runs. A message carries at most 32 blocks and inline sources are byte-capped per block and per message (1 MiB). `url` sources are fetched platform-side only where the operator has configured a content-fetch allowlist: https only, to an allowlisted public DNS host, carrying no userinfo and no explicit port, following no redirect and refused with a named reason where a deployment configures none; `file` sources are admitted by snapshotting the referenced File's bytes into the message's own inline content at admission, so the stored event binds to the snapshot — deleting the original File never affects the stored event, its later-Turn replay or the stream — and a File whose inline snapshot exceeds the byte caps is refused with a named reason. A new idempotency receipt binds the pre-snapshot authored event to the first admitted snapshot: an exact `Idempotency-Key` retry returns that stored event before a second File read or URL fetch, including after the original File is deleted, while changing the authored source under the same key conflicts before source access. Receipts written before this version retain compatibility by rebuilding the admitted event before their legacy comparison. A ZDR Workspace refuses block content entirely, exactly as it refuses attachments and a model wire dialect that cannot carry a block type refuses at admission as `runtime.harness_incompatible`, never as a provider-shaped runtime error. A block-carrying message sent while a Run is active always begins the next Run rather than being flattened into the native mid-run channel. Every payload carries `authored_by` and `caused_by` attribution; an `Idempotency-Key` retry returns the first stored event instead of starting a second turn. The response is the stored event envelope — read settlement from the ledger or the stream, never from response timing. A command sent in the wrong state or answering the wrong tool call or Question, is refused as an invalid transition without advancing the Session. Checkfu support posture: alpha; hosted. Required evidence journey: session-turn. Deployment-specific readiness and the latest proven release are available from GET /v1/support/capabilities. operationId: sessions.driveSession parameters: - name: id in: path schema: $ref: '#/components/schemas/SessionId' required: true - name: checkfu-version in: header schema: type: string enum: - '2026-08-31' required: true - name: idempotency-key in: header schema: type: string allOf: - maxLength: 255 required: false requestBody: content: application/json: schema: anyOf: - type: object properties: type: type: string enum: - user.message payload: type: object properties: content: $ref: '#/components/schemas/Union_70' attachments: type: array items: type: string connected_runtime: $ref: '#/components/schemas/ConnectedRuntimeId' run_delivery: type: string enum: - next_run prompt_integrity_disposition: type: string enum: - accepted_normalization - preserved_original host_context: type: object properties: source: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ data: $ref: '#/components/schemas/HostContextData' required: - source - data additionalProperties: false caused_by: $ref: '#/components/schemas/Objects_360' collaboration_space_id: $ref: '#/components/schemas/CollaborationSpaceId' required: - content - caused_by additionalProperties: false required: - type - payload additionalProperties: false - type: object properties: type: type: string enum: - system.message payload: type: object properties: content: type: string allOf: - minLength: 1 - maxLength: 8192 caused_by: $ref: '#/components/schemas/Objects_360' collaboration_space_id: $ref: '#/components/schemas/CollaborationSpaceId' required: - content - caused_by additionalProperties: false required: - type - payload additionalProperties: false - type: object properties: type: type: string enum: - user.interrupt payload: type: object properties: target_event: $ref: '#/components/schemas/EventId' mode: type: string enum: - cooperative caused_by: $ref: '#/components/schemas/Objects_360' collaboration_space_id: $ref: '#/components/schemas/CollaborationSpaceId' required: - caused_by additionalProperties: false required: - type - payload additionalProperties: false - type: object properties: type: type: string enum: - user.custom_tool_result payload: type: object properties: tool_use_id: type: string result: $ref: '#/components/schemas/JsonValue' caused_by: $ref: '#/components/schemas/Objects_360' collaboration_space_id: $ref: '#/components/schemas/CollaborationSpaceId' required: - tool_use_id - result - caused_by additionalProperties: false required: - type - payload additionalProperties: false - type: object properties: type: type: string enum: - user.tool_confirmation payload: $ref: '#/components/schemas/ApiUserToolConfirmationPayload' required: - type - payload additionalProperties: false - type: object properties: type: type: string enum: - user.question_answer payload: type: object properties: question: $ref: '#/components/schemas/QuestionId' answers: $ref: '#/components/schemas/ManagedQuestionAnswers' prompt_integrity_disposition: type: string enum: - accepted_normalization - preserved_original caused_by: $ref: '#/components/schemas/Objects_360' collaboration_space_id: $ref: '#/components/schemas/CollaborationSpaceId' required: - question - answers - caused_by additionalProperties: false required: - type - payload additionalProperties: false - type: object properties: type: type: string enum: - user.define_outcome payload: $ref: '#/components/schemas/ApiDefineOutcomeEvaluators' required: - type - payload additionalProperties: false required: true responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/Union_371' headers: checkfu-workspace-id: description: The Workspace resolved from the authenticated bearer credential. required: true schema: $ref: '#/components/schemas/WorkspaceId' '400': description: Typed Checkfu wire error content: application/json: schema: $ref: '#/components/schemas/SessionDriveBadRequestError' '401': description: Typed Checkfu wire error content: application/json: schema: type: object required: - error properties: error: type: object required: - type - message - more properties: type: type: string enum: - auth.invalid_key message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#auth-invalid-key description: >- Stable public documentation and remedy for this error type. additionalProperties: false additionalProperties: false '403': description: >- The organization, tenant, or workspace backing this key is administratively disabled. | Deployment governance or retention policy denied the request. content: application/json: schema: anyOf: - type: object required: - error properties: error: type: object properties: type: type: string enum: - auth.disabled_tenancy message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#auth-disabled-tenancy description: >- Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false additionalProperties: false - $ref: '#/components/schemas/PolicyDeniedError' '404': description: >- The requested resource does not exist in the resolved deployment boundary. content: application/json: schema: $ref: '#/components/schemas/ValidationNotFoundError' '409': description: >- The request conflicts with the resource's current state. | The operation is illegal for the resource's current lifecycle state. | Session history required by the operation has been removed or is unavailable. | An idempotent mutation conflicts with a completed or in-progress request for the same key. content: application/json: schema: anyOf: - $ref: '#/components/schemas/ValidationConflictError' - $ref: '#/components/schemas/RuntimeInvalidTransitionError' - $ref: '#/components/schemas/RuntimeSessionHistoryUnavailableError' - $ref: '#/components/schemas/IdempotencyConflictError' '422': description: >- No model candidate satisfies the deployment's routing constraints. | The harness does not satisfy the required protocol or capability set. content: application/json: schema: anyOf: - $ref: '#/components/schemas/ModelNoEligibleModelError' - $ref: '#/components/schemas/RuntimeHarnessIncompatibleError' '429': description: Typed Checkfu wire error headers: retry-after: description: >- Delay in seconds for rate limits or deployment quotas with a known release or UTC reset boundary required: false schema: type: integer minimum: 1 content: application/json: schema: type: object required: - error properties: error: type: object required: - type - message - more properties: type: type: string enum: - budget.exceeded message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#budget-exceeded description: >- Stable public documentation and remedy for this error type. additionalProperties: false additionalProperties: false '500': description: >- An unexpected internal failure occurred; the message contains an opaque incident reference. content: application/json: schema: $ref: '#/components/schemas/RuntimeInternalError' '503': description: >- Authorization could not be evaluated. Retry the same request. | No eligible Runner can currently claim the work. | Platform-managed model credentials are temporarily unavailable. content: application/json: schema: anyOf: - $ref: '#/components/schemas/AuthorizationUnavailableError' - $ref: '#/components/schemas/RuntimeRunnerUnavailableError' - $ref: '#/components/schemas/ModelPlatformSupplyUnavailableError' security: - bearerAuth: [] components: schemas: SessionId: type: string pattern: ^sess_[0-9a-f]{32}$ Union_70: anyOf: - type: string - $ref: '#/components/schemas/MessageContentBlocks' ConnectedRuntimeId: type: string pattern: ^crt_[0-9a-f]{32}$ HostContextData: type: object additionalProperties: type: string allOf: - maxLength: 4096 allOf: - propertyNames: type: string allOf: - minLength: 1 - maxLength: 128 Objects_360: type: object properties: kind: type: string enum: - api request_id: type: string allOf: - minLength: 1 - maxLength: 512 required: - kind additionalProperties: false CollaborationSpaceId: type: string pattern: ^cspace_[0-9a-f]{32}$ EventId: type: string pattern: ^evt_[0-9a-f]{32}$ JsonValue: description: >- A value in the JSON data model: null, boolean, finite number, string, array, or object. ApiUserToolConfirmationPayload: type: object properties: tool_use_id: type: string allOf: - minLength: 1 - maxLength: 256 result: type: string enum: - allow - deny deny_message: type: string allOf: - minLength: 1 - maxLength: 8192 caused_by: $ref: '#/components/schemas/Objects_360' collaboration_space_id: $ref: '#/components/schemas/CollaborationSpaceId' required: - tool_use_id - result - caused_by additionalProperties: false QuestionId: type: string pattern: ^qst_[0-9a-f]{32}$ ManagedQuestionAnswers: type: array items: type: object properties: id: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[A-Za-z0-9_-]+$ values: type: array items: type: string allOf: - minLength: 1 - maxLength: 4096 allOf: - minItems: 1 - maxItems: 32 required: - id - values additionalProperties: false allOf: - minItems: 1 - maxItems: 4 ApiDefineOutcomeEvaluators: type: object properties: description: type: string allOf: - minLength: 1 - maxLength: 4096 rubric: type: string allOf: - minLength: 1 - maxLength: 65536 max_iterations: type: integer allOf: - minimum: 1 maximum: 20 deliverables: $ref: '#/components/schemas/CurrentOutcomeDeliverablesDistinctPaths' report: type: object properties: extraction: type: string enum: - json - model outputs: $ref: '#/components/schemas/OutcomeReportDistinctOutputKeys' required: - extraction - outputs additionalProperties: false verifier: type: object properties: command: type: array items: type: string allOf: - minLength: 1 allOf: - minItems: 1 - maxItems: 64 reward_format: type: string enum: - reward_text - reward_json pass_threshold: type: number allOf: - minimum: 0 maximum: 1 required: - command - reward_format - pass_threshold additionalProperties: false check: type: object properties: evaluation: $ref: '#/components/schemas/Objects_93' rule: $ref: '#/components/schemas/Union_194' required: - evaluation - rule additionalProperties: false feedback_on_false: type: string allOf: - minLength: 1 - maxLength: 1024 caused_by: $ref: '#/components/schemas/Objects_360' collaboration_space_id: $ref: '#/components/schemas/CollaborationSpaceId' required: - description - rubric - caused_by additionalProperties: false Union_371: anyOf: - $ref: '#/components/schemas/Objects_170' - $ref: '#/components/schemas/Objects_172' - $ref: '#/components/schemas/Objects_174' - $ref: '#/components/schemas/Objects_176' - $ref: '#/components/schemas/Objects_177' - $ref: '#/components/schemas/Objects_179' - $ref: '#/components/schemas/Objects_180' - $ref: '#/components/schemas/Objects_181' - $ref: '#/components/schemas/Objects_184' - $ref: '#/components/schemas/Objects_186' - $ref: '#/components/schemas/Objects_188' - $ref: '#/components/schemas/Objects_190' - $ref: '#/components/schemas/Objects_191' - $ref: '#/components/schemas/Objects_193' - $ref: '#/components/schemas/Objects_195' - $ref: '#/components/schemas/Objects_197' - $ref: '#/components/schemas/Objects_199' - $ref: '#/components/schemas/Objects_201' - $ref: '#/components/schemas/Objects_203' - $ref: '#/components/schemas/Objects_205' - $ref: '#/components/schemas/Objects_207' - $ref: '#/components/schemas/Objects_209' - $ref: '#/components/schemas/Objects_211' - $ref: '#/components/schemas/Objects_213' - $ref: '#/components/schemas/Objects_215' - $ref: '#/components/schemas/Objects_217' - $ref: '#/components/schemas/Objects_229' - $ref: '#/components/schemas/Objects_231' - $ref: '#/components/schemas/Objects_233' - $ref: '#/components/schemas/Objects_235' - $ref: '#/components/schemas/Objects_237' - $ref: '#/components/schemas/Objects_239' - $ref: '#/components/schemas/Objects_241' - $ref: '#/components/schemas/Objects_243' - $ref: '#/components/schemas/Objects_245' - $ref: '#/components/schemas/Objects_247' - $ref: '#/components/schemas/Objects_249' - $ref: '#/components/schemas/Objects_250' - $ref: '#/components/schemas/Objects_252' - $ref: '#/components/schemas/Objects_254' - $ref: '#/components/schemas/Objects_255' - $ref: '#/components/schemas/Objects_257' - $ref: '#/components/schemas/Objects_259' - $ref: '#/components/schemas/Objects_262' - $ref: '#/components/schemas/Objects_264' - $ref: '#/components/schemas/Objects_266' - $ref: '#/components/schemas/Objects_267' - $ref: '#/components/schemas/Objects_271' - $ref: '#/components/schemas/Objects_273' - $ref: '#/components/schemas/Objects_275' - $ref: '#/components/schemas/Objects_277' - $ref: '#/components/schemas/Objects_278' - $ref: '#/components/schemas/Objects_280' - $ref: '#/components/schemas/Objects_282' - $ref: '#/components/schemas/Objects_284' - $ref: '#/components/schemas/Objects_286' - $ref: '#/components/schemas/Objects_289' - $ref: '#/components/schemas/Objects_291' - $ref: '#/components/schemas/Objects_294' - $ref: '#/components/schemas/Objects_296' - $ref: '#/components/schemas/Objects_298' - $ref: '#/components/schemas/Objects_300' - $ref: '#/components/schemas/Objects_302' - $ref: '#/components/schemas/Objects_304' - $ref: '#/components/schemas/Objects_306' - $ref: '#/components/schemas/Objects_308' - $ref: '#/components/schemas/Objects_310' - $ref: '#/components/schemas/Objects_312' - $ref: '#/components/schemas/Objects_314' - $ref: '#/components/schemas/Objects_316' - $ref: '#/components/schemas/Objects_318' - $ref: '#/components/schemas/Objects_320' - $ref: '#/components/schemas/Objects_322' - $ref: '#/components/schemas/Objects_324' - $ref: '#/components/schemas/Objects_326' - $ref: '#/components/schemas/Objects_328' - $ref: '#/components/schemas/Objects_330' - $ref: '#/components/schemas/Objects_332' - $ref: '#/components/schemas/Objects_334' - $ref: '#/components/schemas/Objects_336' - $ref: '#/components/schemas/Objects_338' - $ref: '#/components/schemas/Objects_340' - $ref: '#/components/schemas/Objects_342' - $ref: '#/components/schemas/Objects_345' - $ref: '#/components/schemas/Objects_347' - $ref: '#/components/schemas/Objects_349' - $ref: '#/components/schemas/Objects_351' - $ref: '#/components/schemas/Objects_353' - $ref: '#/components/schemas/Objects_354' - $ref: '#/components/schemas/Objects_355' - $ref: '#/components/schemas/Objects_357' WorkspaceId: type: string pattern: ^wrkspc_[0-9a-f]{32}$ SessionDriveBadRequestError: anyOf: - $ref: '#/components/schemas/ValidationMalformedError' - $ref: '#/components/schemas/ValidationPromptIntegrityReviewRequiredError' description: >- A Session drive request was malformed or requires explicit prompt-integrity review. PolicyDeniedError: type: object properties: error: type: object properties: type: type: string enum: - policy.denied message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#policy-denied description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: Deployment governance or retention policy denied the request. ValidationNotFoundError: type: object properties: error: type: object properties: type: type: string enum: - validation.not_found message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#validation-not-found description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- The requested resource does not exist in the resolved deployment boundary. ValidationConflictError: type: object properties: error: type: object properties: type: type: string enum: - validation.conflict message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#validation-conflict description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: The request conflicts with the resource's current state. RuntimeInvalidTransitionError: type: object properties: error: type: object properties: type: type: string enum: - runtime.invalid_transition message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#runtime-invalid-transition description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: The operation is illegal for the resource's current lifecycle state. RuntimeSessionHistoryUnavailableError: type: object properties: error: type: object properties: type: type: string enum: - runtime.session_history_unavailable message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#runtime-session-history-unavailable description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- Session history required by the operation has been removed or is unavailable. IdempotencyConflictError: anyOf: - $ref: '#/components/schemas/ValidationIdempotencyConflictError' - $ref: '#/components/schemas/ValidationIdempotencyInProgressError' description: >- An idempotent mutation conflicts with a completed or in-progress request for the same key. ModelNoEligibleModelError: type: object properties: error: type: object properties: type: type: string enum: - model.no_eligible_model message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#model-no-eligible-model description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: No model candidate satisfies the deployment's routing constraints. RuntimeHarnessIncompatibleError: type: object properties: error: type: object properties: type: type: string enum: - runtime.harness_incompatible message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#runtime-harness-incompatible description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: The harness does not satisfy the required protocol or capability set. RuntimeInternalError: type: object properties: error: type: object properties: type: type: string enum: - runtime.internal message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#runtime-internal description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- An unexpected internal failure occurred; the message contains an opaque incident reference. AuthorizationUnavailableError: type: object properties: error: type: object properties: type: type: string enum: - auth.authorization_unavailable message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#auth-authorization-unavailable description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: Authorization could not be evaluated. Retry the same request. RuntimeRunnerUnavailableError: type: object properties: error: type: object properties: type: type: string enum: - runtime.runner_unavailable message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#runtime-runner-unavailable description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: No eligible Runner can currently claim the work. ModelPlatformSupplyUnavailableError: type: object properties: error: type: object properties: type: type: string enum: - model.platform_supply_unavailable message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#model-platform-supply-unavailable description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: Platform-managed model credentials are temporarily unavailable. MessageContentBlocks: type: array items: anyOf: - type: object properties: type: type: string enum: - text text: $ref: '#/components/schemas/MessageContentPlainTextData' required: - type - text additionalProperties: false - type: object properties: type: type: string enum: - image source: anyOf: - type: object properties: type: type: string enum: - base64 media_type: type: string enum: - image/png - image/jpeg - image/gif - image/webp data: $ref: '#/components/schemas/MessageContentBase64Data' required: - type - media_type - data additionalProperties: false - type: object properties: type: type: string enum: - url url: type: string allOf: - minLength: 1 - maxLength: 2048 required: - type - url additionalProperties: false - type: object properties: type: type: string enum: - file file_id: $ref: '#/components/schemas/FileId' required: - type - file_id additionalProperties: false required: - type - source additionalProperties: false - type: object properties: type: type: string enum: - document source: anyOf: - type: object properties: type: type: string enum: - base64 media_type: type: string enum: - application/pdf data: $ref: '#/components/schemas/MessageContentBase64Data' required: - type - media_type - data additionalProperties: false - type: object properties: type: type: string enum: - text media_type: type: string enum: - text/plain data: $ref: '#/components/schemas/MessageContentPlainTextData' required: - type - media_type - data additionalProperties: false - type: object properties: type: type: string enum: - url url: type: string allOf: - minLength: 1 - maxLength: 2048 required: - type - url additionalProperties: false - type: object properties: type: type: string enum: - file file_id: $ref: '#/components/schemas/FileId' required: - type - file_id additionalProperties: false title: type: string allOf: - minLength: 1 - maxLength: 1024 context: type: string allOf: - minLength: 1 - maxLength: 4096 required: - type - source additionalProperties: false allOf: - minItems: 1 - maxItems: 32 CurrentOutcomeDeliverablesDistinctPaths: type: array items: type: string pattern: ^\/\S+$ allOf: - minItems: 1 - maxItems: 32 - uniqueItems: true description: Outcome deliverables with distinct paths OutcomeReportDistinctOutputKeys: type: array items: anyOf: - type: object properties: key: type: string pattern: ^[a-z][a-z0-9_]{0,49}$ title: type: string allOf: - minLength: 1 - maxLength: 200 description: type: string allOf: - minLength: 1 - maxLength: 4096 type: type: string enum: - string acceptance: type: object properties: kind: type: string enum: - one_of values: $ref: >- #/components/schemas/OutcomeReportDistinctStringAcceptanceValues required: - kind - values additionalProperties: false required: - key - title - type additionalProperties: false - type: object properties: key: type: string pattern: ^[a-z][a-z0-9_]{0,49}$ title: type: string allOf: - minLength: 1 - maxLength: 200 description: type: string allOf: - minLength: 1 - maxLength: 4096 type: type: string enum: - integer acceptance: $ref: '#/components/schemas/OutcomeReportNumericAcceptanceRange' required: - key - title - type additionalProperties: false - type: object properties: key: type: string pattern: ^[a-z][a-z0-9_]{0,49}$ title: type: string allOf: - minLength: 1 - maxLength: 200 description: type: string allOf: - minLength: 1 - maxLength: 4096 type: type: string enum: - number acceptance: $ref: '#/components/schemas/OutcomeReportNumericAcceptanceRange' required: - key - title - type additionalProperties: false - type: object properties: key: type: string pattern: ^[a-z][a-z0-9_]{0,49}$ title: type: string allOf: - minLength: 1 - maxLength: 200 description: type: string allOf: - minLength: 1 - maxLength: 4096 type: type: string enum: - boolean acceptance: type: object properties: kind: type: string enum: - equals value: type: boolean required: - kind - value additionalProperties: false required: - key - title - type additionalProperties: false allOf: - minItems: 1 - maxItems: 32 - x-checkfu-distinct-output-keys: true description: Outcome Report outputs with distinct keys Objects_93: type: object properties: schema_version: type: number enum: - 1 model_routing_profile_key: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ tier: $ref: '#/components/schemas/Union_132' timeout_ms: type: number allOf: - minimum: 100 - maximum: 30000 questions: $ref: '#/components/schemas/TypedCheckQuestions' required: - schema_version - model_routing_profile_key - questions additionalProperties: false Union_194: anyOf: - $ref: '#/components/schemas/CheckBooleanRuleThresholds' - $ref: '#/components/schemas/Objects_94' - $ref: '#/components/schemas/CheckScoreTailRuleThresholds' - type: object properties: type: type: string enum: - all rules: type: array items: anyOf: - $ref: '#/components/schemas/CheckBooleanRuleThresholds' - $ref: '#/components/schemas/Objects_94' - $ref: '#/components/schemas/CheckScoreTailRuleThresholds' allOf: - minItems: 1 - maxItems: 8 required: - type - rules additionalProperties: false Objects_170: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - user.message payload: $ref: '#/components/schemas/Objects_171' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_172: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - user.interrupt payload: $ref: '#/components/schemas/Objects_173' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_174: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - user.custom_tool_result payload: $ref: '#/components/schemas/Objects_175' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_176: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - user.tool_confirmation payload: $ref: '#/components/schemas/UserToolConfirmationPayload' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_177: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - user.question_answer payload: $ref: '#/components/schemas/Objects_178' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_179: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - user.define_outcome payload: $ref: '#/components/schemas/DefineOutcomeEvaluators' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_180: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - agent.message payload: $ref: '#/components/schemas/Union_329' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_181: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - message.screened payload: $ref: '#/components/schemas/Objects_182' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_184: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - agent.thinking payload: $ref: '#/components/schemas/Objects_185' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_186: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - agent.tool_use payload: $ref: '#/components/schemas/Objects_187' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_188: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - agent.tool_progress payload: $ref: '#/components/schemas/Objects_189' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_190: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - agent.tool_result payload: $ref: '#/components/schemas/AgentToolResultPayload' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_191: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - agent.question payload: $ref: '#/components/schemas/Objects_192' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_193: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - agent.subagent_started payload: $ref: '#/components/schemas/Objects_194' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_195: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - agent.subagent_completed payload: $ref: '#/components/schemas/Objects_196' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_197: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.status_pending payload: $ref: '#/components/schemas/Objects_198' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_199: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.status_provisioning payload: $ref: '#/components/schemas/Objects_200' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_201: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.status_running payload: $ref: '#/components/schemas/Objects_202' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_203: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.status_reconciling payload: $ref: '#/components/schemas/Objects_204' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_205: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.status_waiting payload: $ref: '#/components/schemas/Objects_206' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_207: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.status_idle payload: $ref: '#/components/schemas/Objects_208' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_209: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.status_paused payload: $ref: '#/components/schemas/Objects_210' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_211: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.status_completed payload: $ref: '#/components/schemas/Objects_212' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_213: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.status_failed payload: $ref: '#/components/schemas/Objects_214' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_215: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.status_canceled payload: $ref: '#/components/schemas/Objects_216' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_217: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 54 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.admitted payload: $ref: '#/components/schemas/Union_332' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_229: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.forked payload: $ref: '#/components/schemas/Objects_230' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_231: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.updated payload: $ref: '#/components/schemas/Objects_232' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_233: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.title_updated payload: $ref: '#/components/schemas/Objects_234' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_235: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.metadata_updated payload: $ref: '#/components/schemas/Objects_236' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_237: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - system.message payload: $ref: '#/components/schemas/Objects_238' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_239: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.archived payload: $ref: '#/components/schemas/Objects_240' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_241: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.resources_resolved payload: $ref: '#/components/schemas/Objects_242' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_243: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.compacted payload: $ref: '#/components/schemas/Objects_244' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_245: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.context_condensed payload: $ref: '#/components/schemas/Objects_246' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_247: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - memory.mount_resolved payload: $ref: '#/components/schemas/Objects_248' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_249: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - memory.accessed payload: $ref: '#/components/schemas/Union_363' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_250: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - memory.change_checkpointed payload: $ref: '#/components/schemas/Objects_251' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_252: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - memory.proposal_created payload: $ref: '#/components/schemas/Objects_253' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_254: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - memory.proposal_resolved payload: $ref: '#/components/schemas/MemoryProposalResolvedPayload' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_255: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - memory.curated payload: $ref: '#/components/schemas/Objects_256' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_257: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - memory.redacted payload: $ref: '#/components/schemas/Objects_258' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_259: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - wire.call payload: $ref: '#/components/schemas/Objects_260' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_262: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - exec.tool_invocation payload: $ref: '#/components/schemas/Objects_263' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_264: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - model.routed payload: $ref: '#/components/schemas/Objects_265' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_266: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - model.usage_recorded payload: $ref: '#/components/schemas/ModelUsageRecordedEvidence' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_267: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 46 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.created payload: $ref: '#/components/schemas/Objects_268' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_271: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 53 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.created payload: $ref: '#/components/schemas/Objects_272' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_273: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.created payload: $ref: '#/components/schemas/Objects_274' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_275: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.created payload: $ref: '#/components/schemas/Objects_276' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_277: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.started payload: $ref: '#/components/schemas/Union_364' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_278: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 56 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.started payload: $ref: '#/components/schemas/Objects_279' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_280: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.claim_denied payload: $ref: '#/components/schemas/Objects_281' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_282: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.start_timed_out payload: $ref: '#/components/schemas/Objects_283' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_284: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.attempt_requeued payload: $ref: '#/components/schemas/Objects_285' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_286: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.requires_action payload: $ref: '#/components/schemas/RunRequiresActionSetContainsWait' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_289: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.action_authorized payload: $ref: '#/components/schemas/Objects_290' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_291: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 55 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.requires_action payload: $ref: '#/components/schemas/Objects_292' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_294: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 55 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.action_authorized payload: $ref: '#/components/schemas/Objects_295' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_296: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.resumed payload: $ref: '#/components/schemas/Objects_297' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_298: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.completed payload: $ref: '#/components/schemas/Objects_299' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_300: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 56 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.completed payload: $ref: '#/components/schemas/Objects_301' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_302: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.failed payload: $ref: '#/components/schemas/Objects_303' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_304: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 56 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.failed payload: $ref: '#/components/schemas/Objects_305' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_306: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.canceled payload: $ref: '#/components/schemas/Objects_307' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_308: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.budget_reached payload: $ref: '#/components/schemas/Objects_309' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_310: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.input_delivered payload: $ref: '#/components/schemas/Objects_311' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_312: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - run.lifecycle_hook payload: $ref: '#/components/schemas/Objects_313' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_314: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - action_approval.pending payload: $ref: '#/components/schemas/Objects_315' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_316: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 55 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - action_approval.pending payload: $ref: '#/components/schemas/Objects_317' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_318: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - action_approval.resolved payload: $ref: '#/components/schemas/Objects_319' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_320: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - outcome.evaluation_started payload: $ref: '#/components/schemas/Objects_321' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_322: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - outcome.evaluation_completed payload: $ref: '#/components/schemas/Objects_323' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_324: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - flow_review.requested payload: $ref: '#/components/schemas/Objects_325' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_326: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - flow_review.started payload: $ref: '#/components/schemas/Objects_327' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_328: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - flow_review.completed payload: $ref: '#/components/schemas/Objects_329' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_330: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - flow_review.unavailable payload: $ref: '#/components/schemas/Objects_331' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_332: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - watch.created payload: $ref: '#/components/schemas/Objects_333' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_334: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - watch.updated payload: $ref: '#/components/schemas/Objects_335' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_336: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - watch.removed payload: $ref: '#/components/schemas/Objects_337' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_338: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - watch.woken payload: $ref: '#/components/schemas/Objects_339' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_340: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - watch.suppressed payload: $ref: '#/components/schemas/Objects_341' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_342: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - file_tree.writeback_captured payload: $ref: '#/components/schemas/Objects_343' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_345: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - file_tree.writeback_started payload: $ref: '#/components/schemas/Objects_346' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_347: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - file_tree.writeback_no_changes payload: $ref: '#/components/schemas/Objects_348' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_349: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - file_tree.writeback_succeeded payload: $ref: '#/components/schemas/Objects_350' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_351: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - file_tree.writeback_conflicted payload: $ref: '#/components/schemas/Objects_352' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_353: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - file_tree.writeback_failed payload: $ref: '#/components/schemas/Union_367' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_354: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: $ref: '#/components/schemas/SpanEventType' payload: $ref: '#/components/schemas/JsonValue' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_355: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.capture_acknowledged payload: $ref: '#/components/schemas/Objects_356' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false Objects_357: type: object properties: id: $ref: '#/components/schemas/EventId' seq: type: integer exclusiveMinimum: 0 schema_version: type: number enum: - 52 created_at: type: string attested: type: boolean enum: - true type: type: string enum: - session.delivery_ambiguous payload: $ref: '#/components/schemas/Objects_358' required: - id - seq - schema_version - created_at - type - payload additionalProperties: false ValidationMalformedError: type: object properties: error: type: object properties: type: type: string enum: - validation.malformed message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#validation-malformed description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- The request could not be decoded or violated a declared input constraint. ValidationPromptIntegrityReviewRequiredError: type: object properties: error: type: object properties: type: type: string enum: - validation.prompt_integrity_review_required message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#validation-prompt-integrity-review-required description: Stable public documentation and remedy for this error type. review: type: object properties: analyzer_version: type: string enum: - unicode-17.0.0-uts39-r32-checkfu-1 normalized: type: string findings: type: array items: $ref: '#/components/schemas/Union_324' allOf: - minItems: 1 - maxItems: 256 required: - analyzer_version - normalized - findings additionalProperties: false required: - type - message - more - review additionalProperties: false required: - error additionalProperties: false description: The request contains deceptive Unicode and requires an explicit review. ValidationIdempotencyConflictError: type: object properties: error: type: object properties: type: type: string enum: - validation.idempotency_conflict message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#validation-idempotency-conflict description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: The Idempotency-Key is already bound to a different request. ValidationIdempotencyInProgressError: type: object properties: error: type: object properties: type: type: string enum: - validation.idempotency_in_progress message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#validation-idempotency-in-progress description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- An identical idempotent request is still in progress and may be retried later. MessageContentPlainTextData: type: string allOf: - minLength: 1 MessageContentBase64Data: type: string allOf: - minLength: 1 - maxLength: 1048576 FileId: type: string pattern: ^file_[0-9a-f]{32}$ OutcomeReportDistinctStringAcceptanceValues: type: array items: type: string allOf: - minItems: 1 - maxItems: 32 - uniqueItems: true description: distinct accepted string values OutcomeReportNumericAcceptanceRange: type: object properties: kind: type: string enum: - range minimum: type: number maximum: type: number required: - kind additionalProperties: false allOf: - anyOf: - required: - minimum - required: - maximum x-checkfu-numeric-acceptance-range: true description: a non-empty numeric range whose minimum does not exceed its maximum Union_132: type: string enum: - default - planning - tool_loop TypedCheckQuestions: type: array items: anyOf: - type: object properties: key: $ref: '#/components/schemas/CheckQuestionKey' type: type: string enum: - boolean instructions: type: string allOf: - minLength: 1 - maxLength: 4096 true_description: $ref: '#/components/schemas/CheckDescription' false_description: $ref: '#/components/schemas/CheckDescription' required: - key - type - instructions additionalProperties: false - type: object properties: key: $ref: '#/components/schemas/CheckQuestionKey' type: type: string enum: - choice instructions: type: string allOf: - minLength: 1 - maxLength: 4096 options: $ref: '#/components/schemas/CheckChoiceOptions' required: - key - type - instructions - options additionalProperties: false - type: object properties: key: $ref: '#/components/schemas/CheckQuestionKey' type: type: string enum: - score instructions: type: string allOf: - minLength: 1 - maxLength: 4096 levels: $ref: '#/components/schemas/CheckScoreLevels' required: - key - type - instructions - levels additionalProperties: false allOf: - minItems: 1 - maxItems: 8 CheckBooleanRuleThresholds: type: object properties: type: type: string enum: - boolean question_key: $ref: '#/components/schemas/CheckQuestionKey' expected: type: boolean false_max: type: number allOf: - minimum: 0 - maximum: 1 true_min: type: number allOf: - minimum: 0 - maximum: 1 required: - type - question_key - expected - false_max - true_min additionalProperties: false Objects_94: type: object properties: type: type: string enum: - choice_matches question_key: $ref: '#/components/schemas/CheckQuestionKey' option_keys: $ref: '#/components/schemas/CheckChoiceMatchesOptions' min_probability: type: number allOf: - minimum: 0 - maximum: 1 min_margin: type: number allOf: - minimum: 0 - maximum: 1 required: - type - question_key - option_keys - min_probability - min_margin additionalProperties: false CheckScoreTailRuleThresholds: type: object properties: type: type: string enum: - score_tail question_key: $ref: '#/components/schemas/CheckQuestionKey' at_or_above_level: type: integer minimum: 0 false_max: type: number allOf: - minimum: 0 - maximum: 1 true_min: type: number allOf: - minimum: 0 - maximum: 1 required: - type - question_key - at_or_above_level - false_max - true_min additionalProperties: false Objects_171: type: object properties: content: $ref: '#/components/schemas/Union_70' attachments: type: array items: type: string prompt_integrity: type: object properties: analyzer_version: type: string enum: - unicode-17.0.0-uts39-r32-checkfu-1 disposition: $ref: '#/components/schemas/Union_323' original_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ findings: type: array items: $ref: '#/components/schemas/Union_324' allOf: - minItems: 1 - maxItems: 256 required: - analyzer_version - disposition - original_digest - findings additionalProperties: false connected_runtime: $ref: '#/components/schemas/ConnectedRuntimeId' run_delivery: type: string enum: - next_run host_context: type: object properties: source: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ data: $ref: '#/components/schemas/HostContextData' required: - source - data additionalProperties: false authored_by: $ref: '#/components/schemas/Union_327' caused_by: $ref: '#/components/schemas/Union_272' collaboration_space_id: $ref: '#/components/schemas/CollaborationSpaceId' required: - content - authored_by - caused_by additionalProperties: false Objects_173: type: object properties: target_event: $ref: '#/components/schemas/EventId' mode: type: string enum: - cooperative authored_by: $ref: '#/components/schemas/Union_327' caused_by: $ref: '#/components/schemas/Union_272' collaboration_space_id: $ref: '#/components/schemas/CollaborationSpaceId' required: - authored_by - caused_by additionalProperties: false Objects_175: type: object properties: tool_use_id: type: string result: $ref: '#/components/schemas/JsonValue' authored_by: $ref: '#/components/schemas/Union_327' caused_by: $ref: '#/components/schemas/Union_272' collaboration_space_id: $ref: '#/components/schemas/CollaborationSpaceId' required: - tool_use_id - result - authored_by - caused_by additionalProperties: false UserToolConfirmationPayload: type: object properties: tool_use_id: type: string allOf: - minLength: 1 - maxLength: 256 result: type: string enum: - allow - deny deny_message: type: string allOf: - minLength: 1 - maxLength: 8192 authored_by: $ref: '#/components/schemas/Union_327' caused_by: $ref: '#/components/schemas/Union_272' collaboration_space_id: $ref: '#/components/schemas/CollaborationSpaceId' required: - tool_use_id - result - authored_by - caused_by additionalProperties: false Objects_178: type: object properties: question: $ref: '#/components/schemas/QuestionId' answers: $ref: '#/components/schemas/ManagedQuestionAnswers' prompt_integrity: type: object properties: analyzer_version: type: string enum: - unicode-17.0.0-uts39-r32-checkfu-1 disposition: $ref: '#/components/schemas/Union_323' original_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ findings: type: array items: $ref: '#/components/schemas/Union_324' allOf: - minItems: 1 - maxItems: 256 required: - analyzer_version - disposition - original_digest - findings additionalProperties: false authored_by: $ref: '#/components/schemas/Union_327' caused_by: $ref: '#/components/schemas/Union_272' collaboration_space_id: $ref: '#/components/schemas/CollaborationSpaceId' required: - question - answers - authored_by - caused_by additionalProperties: false DefineOutcomeEvaluators: type: object properties: outcome: $ref: '#/components/schemas/OutcomeId' description: $ref: '#/components/schemas/OutcomeDescription' rubric: type: string allOf: - minLength: 1 - maxLength: 65536 max_iterations: type: integer allOf: - minimum: 1 maximum: 20 deliverables: $ref: '#/components/schemas/CurrentOutcomeDeliverablesDistinctPaths' report: type: object properties: extraction: type: string enum: - json - model outputs: $ref: '#/components/schemas/OutcomeReportDistinctOutputKeys' required: - extraction - outputs additionalProperties: false verifier: type: object properties: command: type: array items: type: string allOf: - minLength: 1 allOf: - minItems: 1 - maxItems: 64 reward_format: type: string enum: - reward_text - reward_json pass_threshold: type: number allOf: - minimum: 0 maximum: 1 required: - command - reward_format - pass_threshold additionalProperties: false check: type: object properties: evaluation: $ref: '#/components/schemas/Objects_93' rule: $ref: '#/components/schemas/Union_194' required: - evaluation - rule additionalProperties: false feedback_on_false: type: string allOf: - minLength: 1 - maxLength: 1024 authored_by: $ref: '#/components/schemas/Union_327' caused_by: $ref: '#/components/schemas/Union_272' collaboration_space_id: $ref: '#/components/schemas/CollaborationSpaceId' required: - outcome - description - rubric - authored_by - caused_by additionalProperties: false Union_329: anyOf: - type: object properties: content: type: string subagent: $ref: '#/components/schemas/SubagentId' required: - content additionalProperties: false - type: object properties: withheld: type: object properties: content_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ reason: type: string enum: - screen_block - screen_failed required: - content_digest - reason additionalProperties: false subagent: $ref: '#/components/schemas/SubagentId' required: - withheld additionalProperties: false Objects_182: type: object properties: verdict: type: string enum: - pass - block withheld_reason: type: string enum: - screen_block - screen_failed reason: type: string allOf: - maxLength: 512 content_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ route: $ref: '#/components/schemas/Objects_183' usage: $ref: '#/components/schemas/Objects_77' subagent: $ref: '#/components/schemas/SubagentId' required: - verdict - content_digest additionalProperties: false Objects_185: type: object properties: content: type: string subagent: $ref: '#/components/schemas/SubagentId' required: - content additionalProperties: false Objects_187: type: object properties: tool_use_id: type: string tool: $ref: '#/components/schemas/Union_331' args: $ref: '#/components/schemas/JsonValue' provider_tool_name: $ref: '#/components/schemas/ProviderToolName' subagent: $ref: '#/components/schemas/SubagentId' required: - tool_use_id - tool - args additionalProperties: false Objects_189: type: object properties: tool_use_id: type: string output: $ref: '#/components/schemas/NativeToolProgressOutput' subagent: $ref: '#/components/schemas/SubagentId' required: - tool_use_id - output additionalProperties: false AgentToolResultPayload: type: object properties: tool_use_id: type: string result: $ref: '#/components/schemas/JsonValue' error: $ref: '#/components/schemas/Objects_35' subagent: $ref: '#/components/schemas/SubagentId' required: - tool_use_id additionalProperties: false Objects_192: type: object properties: question: $ref: '#/components/schemas/QuestionId' items: $ref: '#/components/schemas/ManagedQuestionItems' required: - question - items additionalProperties: false Objects_194: type: object properties: subagent: $ref: '#/components/schemas/SubagentId' name: type: string allOf: - minLength: 1 description: type: string parent_subagent: $ref: '#/components/schemas/SubagentId' tool_use_id: type: string required: - subagent - name additionalProperties: false Objects_196: type: object properties: subagent: $ref: '#/components/schemas/SubagentId' disposition: type: string enum: - completed - failed - canceled - lost required: - subagent - disposition additionalProperties: false Objects_198: type: object properties: status: type: string enum: - pending required: - status additionalProperties: false Objects_200: type: object properties: status: type: string enum: - provisioning required: - status additionalProperties: false Objects_202: type: object properties: status: type: string enum: - running required: - status additionalProperties: false Objects_204: type: object properties: status: type: string enum: - reconciling required: - status additionalProperties: false Objects_206: type: object properties: status: type: string enum: - waiting required: - status additionalProperties: false Objects_208: type: object properties: status: type: string enum: - idle stop_reason: $ref: '#/components/schemas/Union_278' required: - status - stop_reason additionalProperties: false Objects_210: type: object properties: status: type: string enum: - paused required: - status additionalProperties: false Objects_212: type: object properties: status: type: string enum: - completed stop_reason: $ref: '#/components/schemas/Union_278' required: - status - stop_reason additionalProperties: false Objects_214: type: object properties: status: type: string enum: - failed stop_reason: type: string enum: - error reason: $ref: '#/components/schemas/Union_74' required: - status - stop_reason - reason additionalProperties: false Objects_216: type: object properties: status: type: string enum: - canceled stop_reason: $ref: '#/components/schemas/Union_278' required: - status - stop_reason additionalProperties: false Union_332: anyOf: - $ref: '#/components/schemas/HistoricalSessionExecutionAdmission' - $ref: '#/components/schemas/SessionExecutionAdmissionHash' Objects_230: type: object properties: source_session: $ref: '#/components/schemas/SessionId' through_event: $ref: '#/components/schemas/EventId' through_sequence: type: integer exclusiveMinimum: 0 source_status: type: string enum: - pending - provisioning - running - reconciling - waiting - idle - paused - completed - failed - canceled abandoned_run: anyOf: - $ref: '#/components/schemas/RunId' - type: 'null' required: - source_session - through_event - through_sequence - source_status - abandoned_run additionalProperties: false Objects_232: type: object properties: changes: type: array items: anyOf: - type: object properties: kind: type: string enum: - definition_version_changed from_version: type: integer exclusiveMinimum: 0 to_version: type: integer exclusiveMinimum: 0 required: - kind - from_version - to_version additionalProperties: false - type: object properties: kind: type: string enum: - mount_attached mount: anyOf: - anyOf: - type: object properties: id: $ref: '#/components/schemas/MountId' kind: type: string enum: - file_tree file_tree_id: $ref: '#/components/schemas/FileTreeId' mount_path: $ref: '#/components/schemas/MountPath' version_policy: $ref: '#/components/schemas/Union_237' access: $ref: '#/components/schemas/Union_238' writeback: type: 'null' required: - id - kind - file_tree_id - mount_path - version_policy - access additionalProperties: false - type: object properties: id: $ref: '#/components/schemas/MountId' kind: type: string enum: - file_tree file_tree_id: $ref: '#/components/schemas/FileTreeId' mount_path: $ref: '#/components/schemas/MountPath' version_policy: $ref: '#/components/schemas/Union_237' access: type: string enum: - read_write writeback: $ref: '#/components/schemas/Objects_121' required: - id - kind - file_tree_id - mount_path - version_policy - access - writeback additionalProperties: false - type: object properties: id: $ref: '#/components/schemas/MountId' kind: type: string enum: - file file_id: $ref: '#/components/schemas/FileId' mount_path: $ref: '#/components/schemas/MountPath' access: type: string enum: - read_only required: - id - kind - file_id - mount_path - access additionalProperties: false - $ref: '#/components/schemas/MemoryStoreResourceBinding' required: - kind - mount additionalProperties: false - type: object properties: kind: type: string enum: - mount_detached resource_id: $ref: '#/components/schemas/MountId' required: - kind - resource_id additionalProperties: false - type: object properties: kind: type: string enum: - managed_configuration_changed agent: type: boolean budget: type: boolean vaults: type: boolean required: - kind - agent - budget - vaults additionalProperties: false - type: object properties: kind: type: string enum: - loaded_capabilities_changed loaded_capabilities: type: array items: $ref: '#/components/schemas/Objects_165' required: - kind - loaded_capabilities additionalProperties: false - type: object properties: kind: type: string enum: - selection_changed from_release_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ to_release_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - kind - from_release_hash - to_release_hash additionalProperties: false allOf: - minItems: 1 required: - changes additionalProperties: false Objects_234: type: object properties: present: type: boolean required: - present additionalProperties: false Objects_236: type: object properties: pairs: type: integer minimum: 0 required: - pairs additionalProperties: false Objects_238: type: object properties: content: type: string allOf: - minLength: 1 - maxLength: 8192 authored_by: $ref: '#/components/schemas/Union_327' caused_by: $ref: '#/components/schemas/Union_272' collaboration_space_id: $ref: '#/components/schemas/CollaborationSpaceId' required: - content - authored_by - caused_by additionalProperties: false Objects_240: anyOf: - type: object - type: array Objects_242: type: object properties: run: $ref: '#/components/schemas/RunId' resources: type: array items: anyOf: - anyOf: - type: object properties: id: $ref: '#/components/schemas/MountId' kind: type: string enum: - file_tree file_tree_id: $ref: '#/components/schemas/FileTreeId' mount_path: $ref: '#/components/schemas/MountPath' version_policy: $ref: '#/components/schemas/Union_237' version: type: integer exclusiveMinimum: 0 content_sha256: type: string pattern: ^sha256:[0-9a-f]{64}$ access: $ref: '#/components/schemas/Union_238' writeback: type: 'null' resolution: $ref: '#/components/schemas/Union_198' required: - id - kind - file_tree_id - mount_path - version_policy - version - content_sha256 - access - resolution additionalProperties: false - type: object properties: id: $ref: '#/components/schemas/MountId' kind: type: string enum: - file_tree file_tree_id: $ref: '#/components/schemas/FileTreeId' mount_path: $ref: '#/components/schemas/MountPath' version_policy: $ref: '#/components/schemas/Union_237' version: type: integer exclusiveMinimum: 0 content_sha256: type: string pattern: ^sha256:[0-9a-f]{64}$ access: type: string enum: - read_write writeback: $ref: '#/components/schemas/Objects_121' resolution: $ref: '#/components/schemas/Objects_101' required: - id - kind - file_tree_id - mount_path - version_policy - version - content_sha256 - access - writeback - resolution additionalProperties: false - type: object properties: id: $ref: '#/components/schemas/MountId' kind: type: string enum: - file file_id: $ref: '#/components/schemas/FileId' mount_path: $ref: '#/components/schemas/MountPath' access: type: string enum: - read_only sha256: type: string pattern: ^sha256:[0-9a-f]{64}$ bytes: type: integer minimum: 0 required: - id - kind - file_id - mount_path - access - sha256 - bytes additionalProperties: false - $ref: '#/components/schemas/MemoryStoreResourceBinding' - $ref: '#/components/schemas/ResolvedSkillsResourceBindingIntegrity' required: - run - resources additionalProperties: false Objects_244: type: object properties: strategy: type: string enum: - native - platform_summarize - truncate tokens_before: type: integer minimum: 0 tokens_after: type: integer minimum: 0 required: - strategy - tokens_before - tokens_after additionalProperties: false Objects_246: type: object properties: through_sequence: type: integer exclusiveMinimum: 0 condensed: type: object properties: user_messages: type: integer minimum: 0 agent_messages: type: integer minimum: 0 required: - user_messages - agent_messages additionalProperties: false kept: type: object properties: user_messages: type: integer minimum: 0 agent_messages: type: integer minimum: 0 content_length: type: integer minimum: 0 required: - user_messages - agent_messages - content_length additionalProperties: false required: - through_sequence - condensed - kept additionalProperties: false Objects_248: type: object properties: store: $ref: '#/components/schemas/MemoryStoreId' requested: $ref: '#/components/schemas/Union_240' effective: $ref: '#/components/schemas/Union_240' selection: anyOf: - type: object properties: kind: type: string enum: - ref ref: $ref: '#/components/schemas/Union_124' required: - kind - ref additionalProperties: false - type: object properties: kind: type: string enum: - version version: $ref: '#/components/schemas/MemoryVersionId' required: - kind - version additionalProperties: false instructions: type: string allOf: - minLength: 1 - maxLength: 4096 mount_path: $ref: '#/components/schemas/MountPath' required: - store - requested - effective - mount_path additionalProperties: false Union_363: anyOf: - type: object properties: store: $ref: '#/components/schemas/MemoryStoreId' version: $ref: '#/components/schemas/MemoryVersionId' method: type: string enum: - mount - search - tool detail: type: object properties: kind: type: string enum: - full documents: type: array items: type: object properties: path: $ref: '#/components/schemas/MemoryPath' content_sha256: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - path - content_sha256 additionalProperties: false allOf: - minItems: 1 required: - kind - documents additionalProperties: false required: - store - version - method - detail additionalProperties: false - type: object properties: scope: type: string enum: - mounted_stores method: type: string enum: - mount store_count: type: integer exclusiveMinimum: 0 document_count: type: integer exclusiveMinimum: 0 required: - scope - method - store_count - document_count additionalProperties: false Objects_251: type: object properties: store: $ref: '#/components/schemas/MemoryStoreId' working_ref: $ref: '#/components/schemas/Union_124' base_version: $ref: '#/components/schemas/MemoryVersionId' new_version: $ref: '#/components/schemas/MemoryVersionId' tree_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ diff_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ changed_paths: type: array items: $ref: '#/components/schemas/MemoryPath' allOf: - minItems: 1 required: - store - working_ref - base_version - new_version - tree_hash - diff_hash - changed_paths additionalProperties: false Objects_253: type: object properties: proposal: $ref: '#/components/schemas/MemoryProposalId' store: $ref: '#/components/schemas/MemoryStoreId' base_version: $ref: '#/components/schemas/MemoryVersionId' head_version: $ref: '#/components/schemas/MemoryVersionId' diff_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - proposal - store - base_version - head_version - diff_hash additionalProperties: false MemoryProposalResolvedPayload: type: object properties: proposal: $ref: '#/components/schemas/MemoryProposalId' decision: type: string enum: - approved - rejected - superseded responder: anyOf: - $ref: '#/components/schemas/Union_120' - type: 'null' canonical_version: $ref: '#/components/schemas/MemoryVersionId' required: - proposal - decision - responder additionalProperties: false Objects_256: type: object properties: run: $ref: '#/components/schemas/CurationRunId' store: $ref: '#/components/schemas/MemoryStoreId' cursor_from: type: integer minimum: 0 cursor_to: type: integer minimum: 0 source_event_count: type: integer minimum: 0 source_artifact_count: type: integer minimum: 0 output_version: $ref: '#/components/schemas/MemoryVersionId' proposal: $ref: '#/components/schemas/MemoryProposalId' required: - run - store - cursor_from - cursor_to - source_event_count - source_artifact_count additionalProperties: false Objects_258: type: object properties: store: $ref: '#/components/schemas/MemoryStoreId' operation: type: string allOf: - minLength: 1 - maxLength: 255 version_count: type: integer minimum: 0 path_count: type: integer minimum: 0 hash_count: type: integer minimum: 0 required: - store - operation - version_count - path_count - hash_count additionalProperties: false Objects_260: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' request_id: type: string allOf: - minLength: 1 - maxLength: 255 provider_call_id: anyOf: - type: string allOf: - minLength: 1 - maxLength: 255 - type: 'null' binding: type: string provider: type: string model: type: string usage: anyOf: - $ref: '#/components/schemas/Objects_77' - $ref: '#/components/schemas/Objects_159' request: type: object properties: body: $ref: '#/components/schemas/Objects_261' messages: type: array items: $ref: '#/components/schemas/Objects_261' allOf: - maxItems: 2048 required: - body - messages additionalProperties: false response: type: object properties: body: $ref: '#/components/schemas/Objects_261' frames: type: array items: $ref: '#/components/schemas/Objects_261' allOf: - maxItems: 2048 required: - body - frames additionalProperties: false request_bytes: type: integer minimum: 0 response_bytes: type: integer minimum: 0 required: - run - attempt - request_id - provider_call_id - binding - provider - model - usage - request - response - request_bytes - response_bytes additionalProperties: false Objects_263: type: object properties: run_id: $ref: '#/components/schemas/RunId' run_attempt_id: $ref: '#/components/schemas/RunAttemptId' tool_invocation_id: $ref: '#/components/schemas/ToolInvocationId' connection_id: $ref: '#/components/schemas/ConnectionId' tool_source_id: $ref: '#/components/schemas/ToolSourceId' tool_name: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ execution_backend: $ref: '#/components/schemas/Union_295' disposition: type: string enum: - completed - denied - indeterminate argument_fingerprint: type: string pattern: ^sha256:[0-9a-f]{64}$ duration_ms: type: integer minimum: 0 upgrade: type: boolean enum: - true required: - run_id - run_attempt_id - tool_invocation_id - connection_id - tool_source_id - tool_name - execution_backend - disposition - argument_fingerprint - duration_ms additionalProperties: false Objects_265: type: object properties: binding: type: string model: type: string tier: type: string reason: type: string required: - binding - model - tier - reason additionalProperties: false ModelUsageRecordedEvidence: type: object properties: run: $ref: '#/components/schemas/RunId' request_id: type: string allOf: - minLength: 1 - maxLength: 255 binding: type: string provider: type: string model: type: string input_tokens: type: integer minimum: 0 cached_input_tokens: type: integer minimum: 0 cache_write_input_tokens: type: integer minimum: 0 output_tokens: type: integer minimum: 0 reasoning_output_tokens: type: integer minimum: 0 total_tokens: type: integer minimum: 0 unit: type: string enum: - image - video_second - compute_second quantity_millionths: type: integer minimum: 0 required: - run - request_id - binding - provider - model additionalProperties: false Objects_268: type: object properties: run: $ref: '#/components/schemas/RunId' trigger: $ref: '#/components/schemas/Union_275' native_runtime: $ref: '#/components/schemas/Objects_269' collaboration_space_id: false collaboration_space_kind: $ref: '#/components/schemas/Union_111' execution_pins: false connected_runtime: false required: - run - trigger - native_runtime additionalProperties: false allOf: - anyOf: - properties: collaboration_space_id: type: 'null' collaboration_space_kind: false - properties: collaboration_space_id: type: string collaboration_space_kind: type: string enum: - root - team - channel - personal required: - collaboration_space_id - collaboration_space_kind Objects_272: type: object properties: run: $ref: '#/components/schemas/RunId' trigger: $ref: '#/components/schemas/Union_275' native_runtime: $ref: '#/components/schemas/Objects_269' collaboration_space_id: $ref: '#/components/schemas/CollaborationSpaceId' collaboration_space_kind: $ref: '#/components/schemas/Union_111' execution_pins: false connected_runtime: false required: - run - trigger - native_runtime - collaboration_space_id additionalProperties: false allOf: - anyOf: - properties: collaboration_space_id: type: 'null' collaboration_space_kind: false - properties: collaboration_space_id: type: string collaboration_space_kind: type: string enum: - root - team - channel - personal required: - collaboration_space_id - collaboration_space_kind Objects_274: type: object properties: run: $ref: '#/components/schemas/RunId' trigger: $ref: '#/components/schemas/Union_275' requested_by: $ref: '#/components/schemas/Union_107' acted_as: $ref: '#/components/schemas/PrincipalId' caused_by: $ref: '#/components/schemas/Union_272' agent_placement_id: $ref: '#/components/schemas/Union_273' collaboration_space_id: $ref: '#/components/schemas/Union_274' collaboration_space_kind: $ref: '#/components/schemas/Union_111' execution_pins: $ref: '#/components/schemas/Objects_36' connected_runtime: false native_runtime: false required: - run - trigger - requested_by - acted_as - caused_by - agent_placement_id - collaboration_space_id - execution_pins additionalProperties: false allOf: - anyOf: - properties: collaboration_space_id: type: 'null' collaboration_space_kind: false - properties: collaboration_space_id: type: string collaboration_space_kind: type: string enum: - root - team - channel - personal required: - collaboration_space_id - collaboration_space_kind Objects_276: type: object properties: run: $ref: '#/components/schemas/RunId' trigger: $ref: '#/components/schemas/Union_275' requested_by: $ref: '#/components/schemas/Union_107' acted_as: $ref: '#/components/schemas/PrincipalId' caused_by: $ref: '#/components/schemas/Union_272' agent_placement_id: $ref: '#/components/schemas/Union_273' collaboration_space_id: $ref: '#/components/schemas/Union_274' collaboration_space_kind: $ref: '#/components/schemas/Union_111' execution_pins: false native_runtime: false connected_runtime: type: object properties: kind: type: string enum: - connected protocol: type: string enum: - acp-v1 runtime: $ref: '#/components/schemas/ConnectedRuntimeId' required: - kind - protocol additionalProperties: false required: - run - trigger - requested_by - acted_as - caused_by - agent_placement_id - collaboration_space_id - connected_runtime additionalProperties: false allOf: - anyOf: - properties: collaboration_space_id: type: 'null' collaboration_space_kind: false - properties: collaboration_space_id: type: string collaboration_space_kind: type: string enum: - root - team - channel - personal required: - collaboration_space_id - collaboration_space_kind Union_364: anyOf: - type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' runner_pool: $ref: '#/components/schemas/RunnerPoolId' execution_target: $ref: '#/components/schemas/Objects_45' capability_set: $ref: '#/components/schemas/Objects_17' evidence_authority: type: string enum: - server_driver_envelope required: - run - attempt - runner_pool - execution_target - capability_set - evidence_authority additionalProperties: false - type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' connected_runtime: type: object properties: kind: type: string enum: - connected protocol: type: string enum: - acp-v1 runtime: $ref: '#/components/schemas/ConnectedRuntimeId' required: - kind - protocol additionalProperties: false evidence_authority: type: string enum: - run_capability_admission required: - run - attempt - connected_runtime - evidence_authority additionalProperties: false Objects_279: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: type: 'null' native_runtime: $ref: '#/components/schemas/Objects_270' evidence_authority: type: string enum: - native_store required: - run - attempt - native_runtime - evidence_authority additionalProperties: false Objects_281: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' reason: $ref: '#/components/schemas/RunClaimDenialReason' network_mode: $ref: '#/components/schemas/Union_19' settled: type: boolean error: type: object properties: type: type: string enum: - policy.denied message: type: string required: - type - message additionalProperties: false required: - run - attempt - reason - network_mode - settled - error additionalProperties: false Objects_283: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' error: type: object properties: type: type: string enum: - runtime.start_timeout message: type: string required: - type - message additionalProperties: false required: - run - attempt - error additionalProperties: false Objects_285: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' recovery: type: number enum: - 1 error: $ref: '#/components/schemas/Objects_35' required: - run - attempt - recovery - error additionalProperties: false RunRequiresActionSetContainsWait: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' action: anyOf: - $ref: '#/components/schemas/Objects_287' - $ref: '#/components/schemas/Objects_288' - type: object properties: kind: type: string enum: - question question: $ref: '#/components/schemas/QuestionId' items: $ref: '#/components/schemas/ManagedQuestionItems' required: - kind - question - items additionalProperties: false - type: object properties: kind: type: string enum: - outcome_evaluation outcome: $ref: '#/components/schemas/OutcomeId' iteration: type: integer minimum: 0 required: - kind - outcome - iteration additionalProperties: false cost: $ref: '#/components/schemas/Objects_139' members: $ref: '#/components/schemas/RunRequiresActionSetMembersUniqueness' required: - run - attempt - action - cost additionalProperties: false allOf: - x-checkfu-approval-set-wait: true description: a set park always carries its surfaced action member Objects_290: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' approval: $ref: '#/components/schemas/ActionApprovalId' action: $ref: '#/components/schemas/Objects_287' required: - run - attempt - approval - action additionalProperties: false Objects_292: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' action: anyOf: - $ref: '#/components/schemas/ManagedToolRunAction' - $ref: '#/components/schemas/Objects_293' cost: $ref: '#/components/schemas/Objects_139' members: false required: - run - attempt - action - cost additionalProperties: false Objects_295: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' approval: $ref: '#/components/schemas/NonBrowserActionApprovalId' action: $ref: '#/components/schemas/ManagedToolRunAction' required: - run - attempt - approval - action additionalProperties: false Objects_297: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' required: - run - attempt additionalProperties: false Objects_299: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' stop_reason: $ref: '#/components/schemas/Union_278' cost: $ref: '#/components/schemas/Objects_139' turn: type: object properties: execution: type: string enum: - shell - model_only shell_commands: type: integer allOf: - minimum: 0 - maximum: 1000000 filesystem_commands: type: integer allOf: - minimum: 0 - maximum: 1000000 mcp_calls: type: integer allOf: - minimum: 0 - maximum: 1000000 model_calls: type: integer allOf: - minimum: 0 - maximum: 1000000 wall_time_ms: type: integer allOf: - minimum: 0 - maximum: 604800000 model_transient_retries: type: integer allOf: - minimum: 0 - maximum: 1000000 model_overflow_recoveries: type: integer allOf: - minimum: 0 - maximum: 1000000 required: - execution - shell_commands - filesystem_commands - mcp_calls - model_calls - wall_time_ms additionalProperties: false required: - run - attempt - stop_reason - cost additionalProperties: false Objects_301: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: type: 'null' stop_reason: $ref: '#/components/schemas/Union_278' cost: type: 'null' turn: false evidence_authority: type: string enum: - native_store native_runtime: type: object properties: store_generation: type: string allOf: - minLength: 1 - maxLength: 256 conversation_id: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 submission_id: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 root_task_id: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 original_commit_sequence: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 answer_entry_id: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 answer_commit_sequence: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 required: - store_generation - conversation_id - submission_id - root_task_id - original_commit_sequence - answer_entry_id - answer_commit_sequence additionalProperties: false required: - run - attempt - stop_reason - cost - evidence_authority - native_runtime additionalProperties: false Objects_303: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' error: $ref: '#/components/schemas/Objects_35' required: - run - attempt - error additionalProperties: false Objects_305: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: type: 'null' error: $ref: '#/components/schemas/Objects_35' evidence_authority: type: string enum: - native_store native_runtime: $ref: '#/components/schemas/Objects_270' required: - run - attempt - error - evidence_authority - native_runtime additionalProperties: false Objects_307: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: anyOf: - $ref: '#/components/schemas/RunAttemptId' - type: 'null' reason: type: string required: - run - attempt - reason additionalProperties: false Objects_309: type: object properties: budget_id: $ref: '#/components/schemas/BudgetId' budget_version: $ref: '#/components/schemas/BudgetPositiveSafeInteger' limit: $ref: '#/components/schemas/BudgetPositiveSafeInteger' metric: $ref: '#/components/schemas/Union_207' breach_action: $ref: '#/components/schemas/BudgetBreachAction' window_started_at: $ref: '#/components/schemas/CurrentTimestamp' required: - budget_id - budget_version - limit - metric - breach_action - window_started_at additionalProperties: false Objects_311: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' event: $ref: '#/components/schemas/EventId' disposition: type: string enum: - delivered - queued - refused required: - run - attempt - event - disposition additionalProperties: false Objects_313: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' phase: $ref: '#/components/schemas/Union_83' ordinal: type: integer allOf: - minimum: 0 - exclusiveMaximum: 16 outcome: $ref: '#/components/schemas/Union_366' on_failure: $ref: '#/components/schemas/Union_84' exit_code: anyOf: - type: integer allOf: - minimum: 0 maximum: 255 - type: 'null' duration_ms: type: integer allOf: - minimum: 0 - maximum: 3600000 output: $ref: '#/components/schemas/SandboxLifecycleHookOutput' output_truncated: type: boolean required: - run - attempt - phase - ordinal - outcome - on_failure - exit_code - duration_ms - output - output_truncated additionalProperties: false Objects_315: type: object properties: approval: $ref: '#/components/schemas/ActionApprovalId' frozen_context: anyOf: - type: object properties: action_approval_type: type: string enum: - harness_tool session_id: $ref: '#/components/schemas/SessionId' run_id: $ref: '#/components/schemas/RunId' tool_use_id: $ref: '#/components/schemas/HarnessToolUseId' agent_id: $ref: '#/components/schemas/AgentId' release_number: type: integer exclusiveMinimum: 0 agent_placement_id: anyOf: - $ref: '#/components/schemas/AgentPlacementId' - type: 'null' collaboration_space_id: anyOf: - $ref: '#/components/schemas/CollaborationSpaceId' - type: 'null' tool: type: string allOf: - minLength: 1 - maxLength: 256 - pattern: ^harness:\S+$ provider_tool_name: $ref: '#/components/schemas/ProviderToolName' arguments_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ acting_principal_id: $ref: '#/components/schemas/PrincipalId' required: - action_approval_type - session_id - run_id - tool_use_id - agent_id - release_number - agent_placement_id - collaboration_space_id - tool - provider_tool_name - arguments_hash - acting_principal_id additionalProperties: false - type: object properties: connection: $ref: '#/components/schemas/ConnectionId' tool: $ref: '#/components/schemas/Union_331' arg_hash: type: string principal: $ref: '#/components/schemas/PrincipalId' required: - connection - tool - arg_hash - principal additionalProperties: false - type: object properties: kind: type: string enum: - custom_tool session: $ref: '#/components/schemas/SessionId' run: $ref: '#/components/schemas/RunId' tool_use_id: type: string agent_id: $ref: '#/components/schemas/AgentId' tool: $ref: '#/components/schemas/Union_331' arg_hash: type: string principal: $ref: '#/components/schemas/PrincipalId' required: - kind - session - run - tool_use_id - agent_id - tool - arg_hash - principal additionalProperties: false required: - approval - frozen_context additionalProperties: false Objects_317: type: object properties: approval: $ref: '#/components/schemas/NonBrowserActionApprovalId' frozen_context: $ref: '#/components/schemas/ManagedToolActionApprovalFrozenContext' required: - approval - frozen_context additionalProperties: false Objects_319: type: object properties: approval: $ref: '#/components/schemas/ActionApprovalId' tool_use_id: type: string decision: type: string enum: - approve - deny resolved_by: $ref: '#/components/schemas/Union_138' instructions: anyOf: - type: string - type: 'null' required: - approval - tool_use_id - decision - resolved_by - instructions additionalProperties: false Objects_321: type: object properties: outcome: $ref: '#/components/schemas/OutcomeId' iteration: type: integer minimum: 0 required: - outcome - iteration additionalProperties: false Objects_323: type: object properties: outcome: $ref: '#/components/schemas/OutcomeId' iteration: type: integer minimum: 0 result: $ref: '#/components/schemas/Union_159' explanation: type: string cost: $ref: '#/components/schemas/Objects_139' route: $ref: '#/components/schemas/Objects_183' input_digest: type: string report: $ref: '#/components/schemas/OutcomeReportResultStatus' required: - outcome - iteration - result - explanation - cost additionalProperties: false Objects_325: type: object properties: review: $ref: '#/components/schemas/FlowReviewId' automation: $ref: '#/components/schemas/AutomationId' firing: $ref: '#/components/schemas/AutomationFiringId' originating_event: $ref: '#/components/schemas/EventId' spec: $ref: '#/components/schemas/Objects_120' model_release: type: object properties: model_routing_profile_id: $ref: '#/components/schemas/ModelRoutingProfileId' key: type: string version: type: integer exclusiveMinimum: 0 access: type: string enum: - harness_owned routing_policy: $ref: '#/components/schemas/Union_131' eligible_candidates: type: array prefixItems: - $ref: '#/components/schemas/Objects_156' minItems: 1 items: $ref: '#/components/schemas/Objects_156' access_sources: type: array items: $ref: '#/components/schemas/Objects_41' required: - model_routing_profile_id - key - version - routing_policy - eligible_candidates additionalProperties: false required: - review - automation - firing - originating_event - spec - model_release additionalProperties: false Objects_327: type: object properties: review: $ref: '#/components/schemas/FlowReviewId' automation: $ref: '#/components/schemas/AutomationId' firing: $ref: '#/components/schemas/AutomationFiringId' session: $ref: '#/components/schemas/SessionId' originating_event: $ref: '#/components/schemas/EventId' source_run: $ref: '#/components/schemas/RunId' from_sequence: type: integer exclusiveMinimum: 0 through_sequence: type: integer exclusiveMinimum: 0 terminal_source_event: $ref: '#/components/schemas/EventId' evidence_format: type: string enum: - flow-review-evidence-v1 evidence_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - review - automation - firing - session - originating_event - source_run - from_sequence - through_sequence - terminal_source_event - evidence_format - evidence_digest additionalProperties: false Objects_329: type: object properties: review: $ref: '#/components/schemas/FlowReviewId' result: type: string enum: - passed - concerns criteria: type: array items: $ref: '#/components/schemas/Objects_142' allOf: - minItems: 1 - maxItems: 16 evidence_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ through_event_id: $ref: '#/components/schemas/EventId' route: $ref: '#/components/schemas/Objects_116' usage: $ref: '#/components/schemas/Objects_77' evaluated_at: type: string required: - review - result - criteria - evidence_digest - through_event_id - route - usage - evaluated_at additionalProperties: false Objects_331: type: object properties: review: $ref: '#/components/schemas/FlowReviewId' reason: $ref: '#/components/schemas/Union_284' required: - review - reason additionalProperties: false Objects_333: type: object properties: watch: $ref: '#/components/schemas/WatchId' required: - watch additionalProperties: false Objects_335: type: object properties: watch: $ref: '#/components/schemas/WatchId' required: - watch additionalProperties: false Objects_337: type: object properties: watch: $ref: '#/components/schemas/WatchId' required: - watch additionalProperties: false Objects_339: type: object properties: watch: $ref: '#/components/schemas/WatchId' source_state_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - watch - source_state_hash additionalProperties: false Objects_341: type: object properties: watch: $ref: '#/components/schemas/WatchId' reason: type: string enum: - duplicate - self_authored - stale_hint - unsafe_content source_state_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - watch - reason additionalProperties: false Objects_343: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' mount: $ref: '#/components/schemas/MountId' file_tree: $ref: '#/components/schemas/FileTreeId' capture: $ref: '#/components/schemas/FileTreeCaptureId' result: $ref: '#/components/schemas/Objects_344' required: - run - attempt - mount - file_tree - capture - result additionalProperties: false Objects_346: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' mount: $ref: '#/components/schemas/MountId' file_tree: $ref: '#/components/schemas/FileTreeId' capture: $ref: '#/components/schemas/FileTreeCaptureId' branch: $ref: '#/components/schemas/GitBranchName' connection: $ref: '#/components/schemas/ConnectionId' generation: type: integer exclusiveMinimum: 0 required: - run - attempt - mount - file_tree - capture - branch - connection - generation additionalProperties: false Objects_348: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' mount: $ref: '#/components/schemas/MountId' file_tree: $ref: '#/components/schemas/FileTreeId' capture: $ref: '#/components/schemas/FileTreeCaptureId' proved_at: type: string required: - run - attempt - mount - file_tree - capture - proved_at additionalProperties: false Objects_350: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' mount: $ref: '#/components/schemas/MountId' file_tree: $ref: '#/components/schemas/FileTreeId' capture: $ref: '#/components/schemas/FileTreeCaptureId' result: $ref: '#/components/schemas/Objects_344' acted_as: $ref: '#/components/schemas/PrincipalId' connection: $ref: '#/components/schemas/ConnectionId' branch: $ref: '#/components/schemas/GitBranchName' commit: type: string pattern: ^(?:[0-9a-f]{40}|[0-9a-f]{64})$ pull_request_number: type: integer exclusiveMinimum: 0 pull_request_url: type: string allOf: - pattern: ^https:\/\/\S+$ - maxLength: 2048 version: type: integer exclusiveMinimum: 0 base_version: type: integer exclusiveMinimum: 0 watch: $ref: '#/components/schemas/WatchId' signature: anyOf: - type: object properties: state: type: string enum: - signed key_id: type: string allOf: - minLength: 8 - maxLength: 64 - pattern: ^[0-9A-F]+$ required: - state - key_id additionalProperties: false - type: object properties: state: type: string enum: - skipped reason: type: string enum: - signing_unconfigured - signing_unavailable - provider_unsupported required: - state - reason additionalProperties: false required: - run - attempt - mount - file_tree - capture - result - acted_as - connection - branch - commit - pull_request_number - pull_request_url - version - base_version additionalProperties: false Objects_352: type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' mount: $ref: '#/components/schemas/MountId' file_tree: $ref: '#/components/schemas/FileTreeId' capture: $ref: '#/components/schemas/FileTreeCaptureId' result: $ref: '#/components/schemas/Objects_344' acted_as: $ref: '#/components/schemas/PrincipalId' connection: $ref: '#/components/schemas/ConnectionId' branch: $ref: '#/components/schemas/GitBranchName' reason: type: string enum: - destination_diverged - destination_unowned - pull_request_ambiguous - stale_base required: - run - attempt - mount - file_tree - capture - result - acted_as - connection - branch - reason additionalProperties: false Union_367: anyOf: - type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' mount: $ref: '#/components/schemas/MountId' file_tree: $ref: '#/components/schemas/FileTreeId' capture: $ref: '#/components/schemas/FileTreeCaptureId' reason: $ref: '#/components/schemas/Union_368' required: - run - attempt - mount - file_tree - capture - reason additionalProperties: false - type: object properties: run: $ref: '#/components/schemas/RunId' attempt: $ref: '#/components/schemas/RunAttemptId' mount: $ref: '#/components/schemas/MountId' file_tree: $ref: '#/components/schemas/FileTreeId' capture: $ref: '#/components/schemas/FileTreeCaptureId' result: $ref: '#/components/schemas/Objects_344' acted_as: $ref: '#/components/schemas/PrincipalId' connection: $ref: '#/components/schemas/ConnectionId' branch: $ref: '#/components/schemas/GitBranchName' reason: type: string enum: - authority_lost - capture_invalid - protected_path - provider_budget - provider_rejected - provider_weather_exhausted - session_ineligible required: - run - attempt - mount - file_tree - capture - result - acted_as - connection - branch - reason additionalProperties: false SpanEventType: type: string pattern: ^span\.\S+$ Objects_356: type: object properties: session_thread_id: $ref: '#/components/schemas/SessionThreadId' run: $ref: '#/components/schemas/RunId' execution_generation: type: string allOf: - minLength: 1 base_file_tree_id: anyOf: - $ref: '#/components/schemas/FileTreeId' - type: 'null' capture_sequence: type: integer exclusiveMinimum: 0 manifest_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ file_count: type: integer minimum: 0 total_bytes: type: integer minimum: 0 required: - session_thread_id - run - execution_generation - base_file_tree_id - capture_sequence - manifest_digest - file_count - total_bytes additionalProperties: false Objects_358: type: object properties: delivery: $ref: '#/components/schemas/WebhookDeliveryId' endpoint: $ref: '#/components/schemas/WebhookEndpointId' provider_coordinate: $ref: '#/components/schemas/EventId' delivery_grade: type: string enum: - at_most_once_on_ambiguity reason: type: string enum: - acknowledgement_lost required: - delivery - endpoint - provider_coordinate - delivery_grade - reason additionalProperties: false Union_324: anyOf: - type: object properties: kind: type: string enum: - mixed_script_confusable utf16_offset: type: integer minimum: 0 code_point: type: string pattern: ^U\+[0-9A-F]{4,6}$ replacement: type: string allOf: - maxLength: 5 answer_id: type: string value_index: type: integer minimum: 0 required: - kind - utf16_offset - code_point - replacement additionalProperties: false - type: object properties: kind: type: string enum: - bidirectional_control utf16_offset: type: integer minimum: 0 code_point: type: string pattern: ^U\+[0-9A-F]{4,6}$ answer_id: type: string value_index: type: integer minimum: 0 required: - kind - utf16_offset - code_point additionalProperties: false CheckQuestionKey: type: string allOf: - minLength: 1 - maxLength: 64 CheckDescription: type: string allOf: - minLength: 1 CheckChoiceOptions: type: array items: type: object properties: key: $ref: '#/components/schemas/CheckQuestionKey' description: $ref: '#/components/schemas/CheckDescription' required: - key - description additionalProperties: false allOf: - minItems: 2 - maxItems: 32 CheckScoreLevels: type: array items: $ref: '#/components/schemas/CheckDescription' allOf: - minItems: 2 - maxItems: 10 CheckChoiceMatchesOptions: type: array items: $ref: '#/components/schemas/CheckQuestionKey' allOf: - minItems: 1 Union_323: type: string enum: - accepted_normalization - preserved_original Union_327: anyOf: - $ref: '#/components/schemas/PrincipalId' - $ref: '#/components/schemas/ApiKeyId' - $ref: '#/components/schemas/AutomationId' - $ref: '#/components/schemas/AgentPlacementId' Union_272: anyOf: - anyOf: - type: object properties: kind: type: string enum: - api request_id: type: string allOf: - minLength: 1 - maxLength: 512 required: - kind additionalProperties: false - type: object properties: kind: type: string enum: - external_event external_installation_id: $ref: '#/components/schemas/CollaborationInstallationId' collaboration_space_id: $ref: '#/components/schemas/CollaborationSpaceId' external_event_id: type: string allOf: - minLength: 1 - maxLength: 512 required: - kind - external_installation_id - collaboration_space_id - external_event_id additionalProperties: false - type: object properties: kind: type: string enum: - automation automation: $ref: '#/components/schemas/AutomationId' required: - kind - automation additionalProperties: false - type: object properties: kind: type: string enum: - watch watch: $ref: '#/components/schemas/WatchId' source_state_hash: type: string allOf: - minLength: 1 - maxLength: 512 required: - kind - watch - source_state_hash additionalProperties: false - type: object properties: kind: type: string enum: - action_approval approval: $ref: '#/components/schemas/ActionApprovalId' required: - kind - approval additionalProperties: false OutcomeId: type: string pattern: ^outc_[0-9a-f]{32}$ OutcomeDescription: type: string allOf: - minLength: 1 - maxLength: 4096 description: >- A non-empty, at-most-4,096-character definition of the Outcome's done state. SubagentId: type: string pattern: ^subg_[0-9a-f]{32}$ Objects_183: type: object properties: model_routing_profile_key: type: string model: type: string tier: type: string reason: type: string access_source: $ref: '#/components/schemas/Union_226' required: - model_routing_profile_key - model - tier - reason - access_source additionalProperties: false Objects_77: type: object properties: input_tokens: type: integer minimum: 0 cached_input_tokens: type: integer minimum: 0 cache_write_input_tokens: type: integer minimum: 0 output_tokens: type: integer minimum: 0 reasoning_output_tokens: type: integer minimum: 0 total_tokens: type: integer minimum: 0 required: - input_tokens - cached_input_tokens - cache_write_input_tokens - output_tokens - reasoning_output_tokens - total_tokens additionalProperties: false Union_331: anyOf: - type: string pattern: ^conn_[0-9a-f]{32}:\S+$ - type: string pattern: ^harness:\S+$ - type: string pattern: ^mtl_[0-9a-f]{32}:mtrel_[0-9a-f]{32}$ ProviderToolName: type: string allOf: - minLength: 1 - maxLength: 256 NativeToolProgressOutput: x-checkfu-json-budget: maximumBytes: 262144 maximumDepth: 64 maximumNodes: 100000 maximumInspectionWork: 100000 x-checkfu-unicode-scalar-values: true description: native tool output bounded to 256 KiB of JSON Objects_35: type: object properties: type: $ref: '#/components/schemas/Union_74' message: type: string more: type: string pattern: ^https:\/\/docs\.checkfu\.com\/reference\/errors#[a-z0-9-]+$ required: - type - message additionalProperties: false ManagedQuestionItems: type: array items: type: object properties: id: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[A-Za-z0-9_-]+$ prompt: type: string allOf: - minLength: 1 - maxLength: 4096 header: type: string allOf: - minLength: 1 - maxLength: 4096 options: type: array items: type: object properties: label: type: string allOf: - minLength: 1 - maxLength: 4096 description: type: string allOf: - minLength: 1 - maxLength: 4096 required: - label additionalProperties: false allOf: - maxItems: 32 allow_multiple: type: boolean required: - id - prompt - options - allow_multiple additionalProperties: false allOf: - minItems: 1 - maxItems: 4 Union_278: type: string enum: - end_turn - requires_action - interrupted - retries_exhausted - max_tokens - max_turn_requests - refusal - error - budget_reached Union_74: type: string enum: - validation.malformed - validation.prompt_integrity_review_required - validation.not_found - validation.conflict - validation.idempotency_conflict - validation.idempotency_in_progress - validation.payload_too_large - validation.range_too_large - auth.invalid_key - auth.authorization_unavailable - auth.request_admission_unavailable - auth.disabled_tenancy - policy.denied - budget.exceeded - model.no_eligible_model - model.credential_rejected - model.platform_supply_unavailable - model.platform_capacity_reached - billing.entitlement_unavailable - billing.usage_limit_reached - billing.payment_required - billing.seat_activation_unavailable - memory.not_found - memory.conflict - memory.read_only - memory.invalid_path - memory.backend_unavailable - memory.curation_failed - runtime.invalid_transition - runtime.primary_thread - retention.zdr_unsupported - runtime.checkpoint_expired - runtime.session_history_unavailable - runtime.harness_unavailable - runtime.harness_failed - runtime.runner_unavailable - runtime.provider_host_unavailable - runtime.lease_lost - runtime.start_timeout - runtime.allocation_failed - runtime.allocation_not_ready - runtime.provisioning_suspended - runtime.computer_unavailable - runtime.turn_deadline_exceeded - runtime.observation_gap - runtime.observation_conflict - runtime.attestation_invalid - runtime.harness_incompatible - runtime.target_mismatch - runtime.transcript_index_unavailable - runtime.managed_tool_failed - runtime.managed_tool_canceled - runtime.internal HistoricalSessionExecutionAdmission: type: object properties: type: type: string enum: - session_execution_admission material: type: object properties: session_id: $ref: '#/components/schemas/SessionId' authentication: anyOf: - $ref: '#/components/schemas/Objects_218' - $ref: '#/components/schemas/Objects_219' - $ref: '#/components/schemas/Objects_220' workspace: $ref: '#/components/schemas/Objects_221' configuration: type: object properties: agent: type: object properties: id: $ref: '#/components/schemas/AgentId' connection_bindings: $ref: '#/components/schemas/Arrays_7' description: $ref: '#/components/schemas/Union_31' harness: $ref: '#/components/schemas/ManagedAgentsHarnessReference' mcp_servers: $ref: '#/components/schemas/Arrays_8' model: $ref: '#/components/schemas/ManagedAgentsModelConfig' name: type: string allOf: - minLength: 1 - maxLength: 255 skills: $ref: '#/components/schemas/Arrays_9' system: $ref: '#/components/schemas/Union_33' tools: $ref: '#/components/schemas/Arrays_10' browser: anyOf: - $ref: '#/components/schemas/Objects_14' - type: 'null' skill_selection: $ref: '#/components/schemas/ManagedAgentsAgentSkillSelection' type: type: string enum: - agent version: type: integer exclusiveMinimum: 0 multiagent: anyOf: - type: object properties: agents: type: array items: anyOf: - type: object properties: id: $ref: '#/components/schemas/AgentId' connection_bindings: $ref: '#/components/schemas/Arrays_7' description: $ref: '#/components/schemas/Union_31' harness: $ref: >- #/components/schemas/ManagedAgentsHarnessReference mcp_servers: $ref: '#/components/schemas/Arrays_8' model: $ref: >- #/components/schemas/ManagedAgentsModelConfig name: type: string allOf: - minLength: 1 - maxLength: 255 skills: $ref: '#/components/schemas/Arrays_9' system: $ref: '#/components/schemas/Union_33' tools: $ref: '#/components/schemas/Arrays_10' browser: anyOf: - $ref: '#/components/schemas/Objects_14' - type: 'null' skill_selection: $ref: >- #/components/schemas/ManagedAgentsAgentSkillSelection type: type: string enum: - agent version: type: integer exclusiveMinimum: 0 required: - id - connection_bindings - description - harness - mcp_servers - model - name - skills - system - tools - type - version additionalProperties: false - type: object properties: model: type: string type: type: string enum: - advisor required: - model - type additionalProperties: false type: type: string enum: - coordinator required: - agents - type additionalProperties: false - type: 'null' required: - id - connection_bindings - description - harness - mcp_servers - model - name - skills - system - tools - type - version - multiagent additionalProperties: false environment: $ref: '#/components/schemas/Environment' harness: $ref: '#/components/schemas/Union_335' workload_trust: $ref: '#/components/schemas/PublicWorkloadTrustAdmission' plane_admission: $ref: '#/components/schemas/CustomerPlaneAdmission' required: - agent - environment - harness - workload_trust additionalProperties: false delivery_screen: anyOf: - type: object properties: model_routing_profile_key: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ tier: $ref: '#/components/schemas/Union_132' instructions: type: string allOf: - minLength: 1 - maxLength: 4096 failure: type: string enum: - fail_open - fail_closed required: - model_routing_profile_key - instructions additionalProperties: false - type: object properties: evaluation: $ref: '#/components/schemas/Objects_93' rule: $ref: '#/components/schemas/Union_194' failure: type: string enum: - fail_open - fail_closed required: - evaluation - rule additionalProperties: false model_routing: $ref: '#/components/schemas/SessionModelRoutingAccessCoverage' computer_composition: $ref: '#/components/schemas/SessionComputerCompositionCustody' execution_qualification: $ref: '#/components/schemas/SessionExecutionQualificationCustody' placement_offering: $ref: '#/components/schemas/SessionPlacementOfferingCustody' placement_selection: $ref: '#/components/schemas/ManagedPlacementSelection' capture_policy_version: type: number enum: - 1 capture_policy: $ref: '#/components/schemas/Objects_227' required: - session_id - authentication - workspace - configuration - capture_policy_version - capture_policy additionalProperties: false admission_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ admitted_at: $ref: '#/components/schemas/CurrentTimestamp' required: - type - material - admission_hash - admitted_at additionalProperties: false SessionExecutionAdmissionHash: type: object properties: type: type: string enum: - session_execution_admission material: $ref: '#/components/schemas/AutomationDeliveryScreenAdmission' admission_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ admitted_at: $ref: '#/components/schemas/CurrentTimestamp' required: - type - material - admission_hash - admitted_at additionalProperties: false RunId: type: string pattern: ^run_[0-9a-f]{32}$ MountId: type: string pattern: ^mnt_[0-9a-f]{32}$ FileTreeId: type: string pattern: ^ftree_[0-9a-f]{32}$ MountPath: type: string allOf: - minLength: 2 - maxLength: 1024 Union_237: anyOf: - type: object properties: kind: type: string enum: - latest required: - kind additionalProperties: false - type: object properties: kind: type: string enum: - pinned version: type: integer exclusiveMinimum: 0 required: - kind - version additionalProperties: false - type: object properties: kind: type: string enum: - ref ref: $ref: '#/components/schemas/GitReference' required: - kind - ref additionalProperties: false Union_238: type: string enum: - read_only - read_write Objects_121: type: object properties: kind: type: string enum: - pull_request commit_message: type: string allOf: - minLength: 1 - maxLength: 4096 pull_request_title: type: string allOf: - minLength: 1 - maxLength: 256 pull_request_body: type: string allOf: - maxLength: 16384 allow_workflow_changes: type: boolean enum: - true required: - kind additionalProperties: false MemoryStoreResourceBinding: type: object properties: store: $ref: '#/components/schemas/MemoryStoreId' requested: $ref: '#/components/schemas/Union_240' effective: $ref: '#/components/schemas/Union_240' selection: $ref: '#/components/schemas/Union_242' instructions: type: string allOf: - minLength: 1 - maxLength: 4096 mount_path: $ref: '#/components/schemas/MountPath' required: - store - requested - effective additionalProperties: false description: >- Resolved Memory mount whose effective access, instructions and destination enter the Session prompt. Objects_165: type: object properties: kind: type: string enum: - tool - skill ref: type: string allOf: - minLength: 1 - maxLength: 512 required: - kind - ref additionalProperties: false Union_198: anyOf: - type: object properties: kind: type: string enum: - upload required: - kind additionalProperties: false - $ref: '#/components/schemas/Objects_101' Objects_101: type: object properties: kind: type: string enum: - git provider: type: string enum: - github repository: $ref: '#/components/schemas/GitHubRepository' ref: $ref: '#/components/schemas/GitReference' commit_sha: type: string pattern: ^(?:[0-9a-f]{40}|[0-9a-f]{64})$ tree_sha: type: string pattern: ^(?:[0-9a-f]{40}|[0-9a-f]{64})$ required: - kind - provider - repository - ref - commit_sha additionalProperties: false ResolvedSkillsResourceBindingIntegrity: type: object properties: kind: type: string enum: - skills mount_path: $ref: '#/components/schemas/MountPath' skills: type: array items: type: object properties: skill_id: $ref: '#/components/schemas/SkillId' name: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ skill_kind: $ref: '#/components/schemas/Union_147' version: type: integer exclusiveMinimum: 0 content_sha256: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - skill_id - name - skill_kind - version - content_sha256 additionalProperties: false allOf: - minItems: 1 required: - kind - mount_path - skills additionalProperties: false MemoryStoreId: type: string pattern: ^memstore_[0-9a-f]{32}$ Union_240: type: string enum: - read_only - read_write Union_124: anyOf: - type: object properties: kind: type: string enum: - canonical required: - kind additionalProperties: false - type: object properties: kind: type: string enum: - session session: $ref: '#/components/schemas/SessionId' required: - kind - session additionalProperties: false - type: object properties: kind: type: string enum: - proposal proposal: $ref: '#/components/schemas/MemoryProposalId' required: - kind - proposal additionalProperties: false - type: object properties: kind: type: string enum: - curation run: $ref: '#/components/schemas/CurationRunId' required: - kind - run additionalProperties: false MemoryVersionId: type: string pattern: ^memver_[0-9a-f]{32}$ MemoryPath: type: string allOf: - maxLength: 1024 MemoryProposalId: type: string pattern: ^mprop_[0-9a-f]{32}$ Union_120: anyOf: - type: object properties: kind: type: string enum: - principal principal: $ref: '#/components/schemas/PrincipalId' required: - kind - principal additionalProperties: false - type: object properties: kind: type: string enum: - api_key key: $ref: '#/components/schemas/ApiKeyId' required: - kind - key additionalProperties: false - type: object properties: kind: type: string enum: - session_agent session: $ref: '#/components/schemas/SessionId' agent: $ref: '#/components/schemas/AgentId' required: - kind - session - agent additionalProperties: false - type: object properties: kind: type: string enum: - curator run: $ref: '#/components/schemas/CurationRunId' required: - kind - run additionalProperties: false - type: object properties: kind: type: string enum: - platform operation: type: string enum: - import - redaction required: - kind - operation additionalProperties: false CurationRunId: type: string pattern: ^mcur_[0-9a-f]{32}$ RunAttemptId: type: string pattern: ^ratt_[0-9a-f]{32}$ Objects_159: type: object properties: unit: $ref: '#/components/schemas/Union_299' quantity_millionths: type: integer minimum: 0 required: - unit - quantity_millionths additionalProperties: false Objects_261: type: object properties: source: anyOf: - type: string enum: - openai - anthropic - google - openrouter - replay - type: string pattern: ^extension:[\s\S]*?$ byte_provenance: type: string enum: - credential_contained content_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ bytes: type: integer minimum: 0 required: - source - content_digest - bytes additionalProperties: false ToolInvocationId: type: string pattern: ^tinv_[0-9a-f]{32}$ ConnectionId: type: string pattern: ^conn_[0-9a-f]{32}$ ToolSourceId: type: string pattern: ^ts_[0-9a-f]{32}$ Union_295: type: string enum: - builtin - executor - connector Union_275: anyOf: - anyOf: - type: object properties: kind: type: string enum: - api required: - kind additionalProperties: false - type: object properties: kind: type: string enum: - automation automation: $ref: '#/components/schemas/AutomationId' required: - kind - automation additionalProperties: false - type: object properties: kind: type: string enum: - question question: $ref: '#/components/schemas/QuestionId' required: - kind - question additionalProperties: false - type: object properties: kind: type: string enum: - outcome outcome: $ref: '#/components/schemas/OutcomeId' required: - kind - outcome additionalProperties: false - type: object properties: kind: type: string enum: - watch watch: $ref: '#/components/schemas/WatchId' source_state_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - kind - watch - source_state_hash additionalProperties: false - type: object properties: kind: type: string enum: - action_approval approval: $ref: '#/components/schemas/ActionApprovalId' required: - kind - approval additionalProperties: false Objects_269: type: object properties: session_admission_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ runtime_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ original: $ref: '#/components/schemas/Objects_270' required: - session_admission_hash - runtime_hash additionalProperties: false Union_111: type: string enum: - root - team - channel - personal Union_107: anyOf: - type: object properties: kind: type: string enum: - api_key api_key: $ref: '#/components/schemas/ApiKeyId' required: - kind - api_key additionalProperties: false - type: object properties: kind: type: string enum: - principal principal: $ref: '#/components/schemas/PrincipalId' required: - kind - principal additionalProperties: false - type: object properties: kind: type: string enum: - automation automation: $ref: '#/components/schemas/AutomationId' required: - kind - automation additionalProperties: false - type: object properties: kind: type: string enum: - system name: type: string allOf: - minLength: 1 - maxLength: 512 required: - kind - name additionalProperties: false PrincipalId: type: string pattern: ^prin_[0-9a-f]{32}$ Union_273: anyOf: - $ref: '#/components/schemas/AgentPlacementId' - type: 'null' Union_274: anyOf: - $ref: '#/components/schemas/CollaborationSpaceId' - type: 'null' Objects_36: type: object properties: agent_id: $ref: '#/components/schemas/AgentId' agent_version_number: type: integer exclusiveMinimum: 0 harness_profile_id: $ref: '#/components/schemas/HarnessProfileId' harness_profile_version_number: type: integer exclusiveMinimum: 0 harness_release_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ harness_driver_version: type: string environment_id: $ref: '#/components/schemas/EnvironmentId' environment_version: type: integer exclusiveMinimum: 0 sandbox_image_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ model_routing_profile_id: $ref: '#/components/schemas/ModelRoutingProfileId' model_routing_profile_version_number: type: integer exclusiveMinimum: 0 plane_policy_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ selected_skills: type: array items: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ selected_tools: type: array items: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ instructions_sha256: type: string pattern: ^sha256:[0-9a-f]{64}$ selected_web_retrieval: $ref: '#/components/schemas/RunWebRetrievalPolicyHasTool_1' required: - agent_id - agent_version_number - harness_profile_id - harness_profile_version_number - harness_release_digest - harness_driver_version - environment_id - environment_version - sandbox_image_digest - model_routing_profile_id - model_routing_profile_version_number - plane_policy_hash - selected_skills - selected_tools - instructions_sha256 additionalProperties: false RunnerPoolId: type: string pattern: ^rpool_[0-9a-f]{32}$ Objects_45: type: object properties: provider_id: type: string allOf: - minLength: 1 - maxLength: 255 provider_revision: type: string allOf: - minLength: 1 - maxLength: 255 materialization_revision: type: string allOf: - minLength: 1 - maxLength: 255 placement: $ref: '#/components/schemas/Union_18' runtime_assurances: $ref: '#/components/schemas/Objects_8' runner_pool: $ref: '#/components/schemas/RunnerPoolId' managed_sandbox_retention: type: boolean required: - provider_id - provider_revision - materialization_revision - placement - runner_pool additionalProperties: false Objects_17: type: object properties: event_fidelity: type: string enum: - native - structured - text_only - minimal continuation: type: string enum: - in_flight - next_turn - rebuild_only checkpoint: type: string enum: - process_and_disk - disk_only - conversation_only - none approval_delivery: type: string enum: - park - snapshot_release - end_reinject - unsupported interrupt: type: string enum: - cooperative - kill_only mid_run_input: type: string enum: - native - turn_boundary_only - unsupported model_control: type: string enum: - platform_enforced - compatible - opaque - harness_owned usage_authority: type: string enum: - platform_observed - harness_reported - unknown multiagent_shared_environment: type: boolean subagents: type: string enum: - observed - flatten required: - event_fidelity - continuation - checkpoint - approval_delivery - interrupt - mid_run_input - model_control - usage_authority - multiagent_shared_environment additionalProperties: false Objects_270: type: object properties: store_generation: type: string allOf: - minLength: 1 - maxLength: 256 conversation_id: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 submission_id: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 root_task_id: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 original_commit_sequence: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 required: - store_generation - conversation_id - submission_id - root_task_id - original_commit_sequence additionalProperties: false RunClaimDenialReason: type: string enum: - placement_conformance_missing - placement_conformance_not_advertised - allowlist_security_boundary_unavailable - sandbox_policy_not_admitted - workload_review_unavailable - collaboration_space_not_authorized - workload_admission_unavailable - computer_unavailable Union_19: type: string enum: - none - allowlist - unrestricted Objects_287: type: object properties: kind: type: string enum: - custom_tool tool_use_id: type: string required: - kind - tool_use_id additionalProperties: false Objects_288: type: object properties: kind: type: string enum: - action_approval approval: $ref: '#/components/schemas/ActionApprovalId' tool_use_id: type: string on_approve: type: object properties: kind: type: string enum: - custom_tool required: - kind additionalProperties: false required: - kind - approval - tool_use_id additionalProperties: false Objects_139: type: object properties: tokens: type: integer minimum: 0 tool_calls: type: integer minimum: 0 active_ms: type: integer minimum: 0 additionalProperties: false RunRequiresActionSetMembersUniqueness: type: array items: type: object properties: approval: $ref: '#/components/schemas/NonBrowserActionApprovalId' tool_use_id: type: string allOf: - minLength: 1 required: - approval - tool_use_id additionalProperties: false allOf: - minItems: 1 - maxItems: 16 - x-checkfu-approval-set-members: true description: one park names each approval and tool use at most once ActionApprovalId: anyOf: - $ref: '#/components/schemas/NonBrowserActionApprovalId' - $ref: '#/components/schemas/BrowserActionApprovalId' description: >- an ActionApprovalId of the form approval_<32 hex chars> or bapproval_<32 hex chars> ManagedToolRunAction: type: object properties: kind: type: string enum: - managed_tool tool_invocation_id: $ref: '#/components/schemas/ToolInvocationId' tool_use_id: $ref: '#/components/schemas/HarnessToolUseId' required: - kind - tool_invocation_id - tool_use_id additionalProperties: false description: >- The compute-closed Run awaits the result of this original native purchase. Objects_293: type: object properties: kind: type: string enum: - action_approval approval: $ref: '#/components/schemas/NonBrowserActionApprovalId' tool_use_id: $ref: '#/components/schemas/HarnessToolUseId' on_approve: type: object properties: kind: type: string enum: - managed_tool tool_invocation_id: $ref: '#/components/schemas/ToolInvocationId' required: - kind - tool_invocation_id additionalProperties: false required: - kind - approval - tool_use_id - on_approve additionalProperties: false NonBrowserActionApprovalId: type: string pattern: ^approval_[0-9a-f]{32}$ BudgetId: type: string pattern: ^bgt_[0-9a-f]{32}$ BudgetPositiveSafeInteger: type: integer exclusiveMinimum: 0 Union_207: type: string enum: - model_tokens - model_spend - session_runtime_ms - web_search_requests - total_spend BudgetBreachAction: type: string enum: - block_admission - interrupt_turn - pause_session description: The decided hard-threshold action for one reached Budget cap. CurrentTimestamp: type: string allOf: - maxLength: 24 - pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$ x-checkfu-current-timestamp: true description: A canonical UTC ISO-8601 timestamp with millisecond precision. Union_83: type: string enum: - post_materialize - pre_writeback Union_366: type: string enum: - passed - failed - timed_out - slot_unavailable - skipped Union_84: type: string enum: - abort - continue SandboxLifecycleHookOutput: type: string allOf: - maxLength: 8192 HarnessToolUseId: type: string allOf: - minLength: 1 - maxLength: 256 AgentId: type: string pattern: ^agent_[0-9a-f]{32}$ AgentPlacementId: type: string pattern: ^aplace_[0-9a-f]{32}$ ManagedToolActionApprovalFrozenContext: type: object properties: kind: type: string enum: - managed_tool session: $ref: '#/components/schemas/SessionId' run: $ref: '#/components/schemas/RunId' tool_use_id: $ref: '#/components/schemas/HarnessToolUseId' tool_invocation_id: $ref: '#/components/schemas/ToolInvocationId' agent_id: $ref: '#/components/schemas/AgentId' selection: $ref: '#/components/schemas/ManagedToolSelection' arg_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ principal: $ref: '#/components/schemas/PrincipalId' required: - kind - session - run - tool_use_id - tool_invocation_id - agent_id - selection - arg_hash - principal additionalProperties: false description: >- Secret-free Session coordinates for the original native Managed Tool approval. Union_138: anyOf: - type: object properties: kind: type: string enum: - system required: - kind additionalProperties: false - type: object properties: kind: type: string enum: - api_key id: $ref: '#/components/schemas/ApiKeyId' required: - kind - id additionalProperties: false - type: object properties: kind: type: string enum: - principal id: $ref: '#/components/schemas/PrincipalId' authenticated_by: $ref: '#/components/schemas/ApiKeyId' required: - kind - id additionalProperties: false - type: object properties: kind: type: string enum: - console_user id: type: string allOf: - minLength: 1 authenticated_by: $ref: '#/components/schemas/ApiKeyId' required: - kind - id additionalProperties: false - type: object properties: kind: type: string enum: - operator id: type: string allOf: - minLength: 1 required: - kind - id additionalProperties: false Union_159: type: string enum: - satisfied - needs_revision - max_iterations_reached - failed - interrupted OutcomeReportResultStatus: type: object properties: status: type: string enum: - accepted - rejected extraction: type: string enum: - json - model outputs: type: array items: anyOf: - type: object properties: kind: type: string enum: - invalid key: type: string pattern: ^[a-z][a-z0-9_]{0,49}$ title: type: string allOf: - minLength: 1 - maxLength: 200 type: type: string enum: - string - integer - number - boolean reason: type: string enum: - source_invalid - missing - type_mismatch - not_integer accepted: type: boolean enum: - false required: - kind - key - title - type - reason - accepted additionalProperties: false - anyOf: - type: object properties: kind: type: string enum: - extracted key: type: string pattern: ^[a-z][a-z0-9_]{0,49}$ title: type: string allOf: - minLength: 1 - maxLength: 200 type: type: string enum: - string value: type: string accepted: type: boolean required: - kind - key - title - type - value - accepted additionalProperties: false - type: object properties: kind: type: string enum: - extracted key: type: string pattern: ^[a-z][a-z0-9_]{0,49}$ title: type: string allOf: - minLength: 1 - maxLength: 200 type: type: string enum: - integer value: type: integer accepted: type: boolean required: - kind - key - title - type - value - accepted additionalProperties: false - type: object properties: kind: type: string enum: - extracted key: type: string pattern: ^[a-z][a-z0-9_]{0,49}$ title: type: string allOf: - minLength: 1 - maxLength: 200 type: type: string enum: - number value: type: number accepted: type: boolean required: - kind - key - title - type - value - accepted additionalProperties: false - type: object properties: kind: type: string enum: - extracted key: type: string pattern: ^[a-z][a-z0-9_]{0,49}$ title: type: string allOf: - minLength: 1 - maxLength: 200 type: type: string enum: - boolean value: type: boolean accepted: type: boolean required: - kind - key - title - type - value - accepted additionalProperties: false allOf: - minItems: 1 - maxItems: 32 required: - status - extraction - outputs additionalProperties: false FlowReviewId: type: string pattern: ^flrev_[0-9a-f]{32}$ AutomationId: type: string pattern: ^auto_[0-9a-f]{32}$ AutomationFiringId: type: string pattern: ^afire_[0-9a-f]{32}$ Objects_120: type: object properties: model_routing_profile_key: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ tier: $ref: '#/components/schemas/Union_132' criteria: $ref: '#/components/schemas/UniqueFlowReviewCriteria' required: - model_routing_profile_key - criteria additionalProperties: false ModelRoutingProfileId: type: string pattern: ^mrp_[0-9a-f]{32}$ Union_131: type: string enum: - cheapest_sufficient - pinned - fallback Objects_156: type: object properties: tier: $ref: '#/components/schemas/Union_132' provider: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ model: type: string allOf: - minLength: 1 - maxLength: 255 context_window_tokens: type: integer exclusiveMinimum: 0 native_capabilities: anyOf: - type: object properties: version: type: number enum: - 1 wire_format: type: string enum: - openai_chat max_output_tokens: type: integer exclusiveMinimum: 0 input_modalities: type: array prefixItems: - type: string enum: - text - image minItems: 1 items: type: string enum: - text - image reasoning: type: boolean thinking_levels: $ref: '#/components/schemas/Objects_64' compatibility: type: object properties: supportsStore: type: boolean supportsDeveloperRole: type: boolean supportsReasoningEffort: type: boolean supportsUsageInStreaming: type: boolean supportsFinishReason: type: boolean maxTokensField: type: string enum: - max_tokens - max_completion_tokens requiresToolResultName: type: boolean requiresAssistantAfterToolResult: type: boolean requiresThinkingAsText: type: boolean requiresReasoningContentOnAssistantMessages: type: boolean thinkingFormat: type: string enum: - openai - openrouter - deepseek - together - zai - qwen - string-thinking - ant-ling zaiToolStream: type: boolean supportsStrictMode: type: boolean supportsOpenAIGrammarTools: type: boolean supportsMidConvoSystemMessages: type: boolean supportsMidConvoToolAdditions: type: boolean supportsThinkingTokenBudget: type: boolean thinkingTokenBudgetField: type: string enum: - thinking_token_budget - thinking_budget - thinking_budget_tokens required: - supportsStore - supportsDeveloperRole - supportsReasoningEffort - supportsUsageInStreaming - supportsFinishReason - maxTokensField - requiresToolResultName - requiresAssistantAfterToolResult - requiresThinkingAsText - requiresReasoningContentOnAssistantMessages - thinkingFormat - zaiToolStream - supportsStrictMode - supportsOpenAIGrammarTools - supportsMidConvoSystemMessages - supportsMidConvoToolAdditions - supportsThinkingTokenBudget additionalProperties: false required: - version - wire_format - max_output_tokens - input_modalities - reasoning - thinking_levels - compatibility additionalProperties: false - type: object properties: version: type: number enum: - 1 wire_format: type: string enum: - openai_responses max_output_tokens: type: integer exclusiveMinimum: 0 input_modalities: type: array prefixItems: - type: string enum: - text - image minItems: 1 items: type: string enum: - text - image reasoning: type: boolean thinking_levels: $ref: '#/components/schemas/Objects_64' compatibility: type: object properties: supportsDeveloperRole: type: boolean supportsMidConvoSystemMessages: type: boolean supportsStrictMode: type: boolean supportsOpenAIGrammarTools: type: boolean supportsAdditionalTools: type: boolean supportsToolSearch: type: boolean supportsExplicitPromptCacheMode: type: boolean supportsMaxOutputTokens: type: boolean required: - supportsDeveloperRole - supportsMidConvoSystemMessages - supportsStrictMode - supportsOpenAIGrammarTools - supportsAdditionalTools - supportsToolSearch - supportsExplicitPromptCacheMode - supportsMaxOutputTokens additionalProperties: false required: - version - wire_format - max_output_tokens - input_modalities - reasoning - thinking_levels - compatibility additionalProperties: false - type: object properties: version: type: number enum: - 1 wire_format: type: string enum: - anthropic_messages max_output_tokens: type: integer exclusiveMinimum: 0 input_modalities: type: array prefixItems: - type: string enum: - text - image minItems: 1 items: type: string enum: - text - image reasoning: type: boolean thinking_levels: $ref: '#/components/schemas/Objects_64' compatibility: type: object properties: supportsEagerToolInputStreaming: type: boolean supportsCacheControlOnTools: type: boolean supportsTemperature: type: boolean forceAdaptiveThinking: type: boolean allowEmptySignature: type: boolean supportsStrictTools: type: boolean supportsMidConvoEffort: type: boolean supportsMidConvoSystemMessages: type: boolean supportsMidConvoToolChanges: type: boolean required: - supportsEagerToolInputStreaming - supportsCacheControlOnTools - supportsTemperature - forceAdaptiveThinking - allowEmptySignature - supportsStrictTools - supportsMidConvoEffort - supportsMidConvoSystemMessages - supportsMidConvoToolChanges additionalProperties: false required: - version - wire_format - max_output_tokens - input_modalities - reasoning - thinking_levels - compatibility additionalProperties: false native_sdk_estimation: $ref: '#/components/schemas/Objects_65' effort: type: string enum: - minimal - low - medium - high - max speed: type: string enum: - standard - fast inference_geo: $ref: '#/components/schemas/Union_11' openrouter_max_price: $ref: '#/components/schemas/OpenRouterMaxPrice' required: - tier - provider - model additionalProperties: false Objects_41: type: object properties: kind: type: string enum: - workspace_credential provider: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ model_credential_id: $ref: '#/components/schemas/ModelCredentialId' model_credential_generation_id: $ref: '#/components/schemas/ModelCredentialGenerationId' required: - kind - provider - model_credential_id - model_credential_generation_id additionalProperties: false Objects_142: type: object properties: key: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$ result: type: string enum: - pass - concern - unknown explanation: type: string allOf: - maxLength: 512 event_ids: type: array items: $ref: '#/components/schemas/EventId' allOf: - maxItems: 16 required: - key - result - explanation - event_ids additionalProperties: false Objects_116: type: object properties: model_routing_profile_key: type: string model: type: string tier: type: string reason: type: string access_source: $ref: '#/components/schemas/Union_226' required: - model_routing_profile_key - model - tier - reason - access_source additionalProperties: false Union_284: type: string enum: - evidence_unavailable - evidence_unsupported - evidence_too_large - source_erased - reviewer_unavailable WatchId: type: string pattern: ^wch_[0-9a-f]{32}$ FileTreeCaptureId: type: string pattern: ^ftcap_[0-9a-f]{32}$ Objects_344: type: object properties: kind: type: string enum: - changes capture_id: $ref: '#/components/schemas/FileTreeCaptureId' manifest_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ operation_count: type: integer allOf: - exclusiveMinimum: 0 - maximum: 2048 put_count: type: integer allOf: - minimum: 0 - maximum: 1024 reserved_bytes: type: integer allOf: - minimum: 0 - maximum: 20971520 sealed_at: $ref: '#/components/schemas/FileTreeCaptureTimestamp' required: - kind - capture_id - manifest_digest - operation_count - put_count - reserved_bytes - sealed_at additionalProperties: false GitBranchName: type: string allOf: - minLength: 1 - maxLength: 255 Union_368: type: string enum: - ineligible_mount - nested_mount - listing_failed - listing_invalid - incomplete_listing - invalid_path - unsupported_entry - duplicate_path - path_conflict - file_limit - file_too_large - tree_too_large - operation_limit - read_failed - missing_body - body_size_mismatch - body_digest_mismatch - digest_unavailable - manifest_invalid - capture_unavailable - capture_invalid - authority_lost - retention_refused - transfer_unavailable SessionThreadId: type: string pattern: ^sthr_[0-9a-f]{32}$ WebhookDeliveryId: type: string pattern: ^wdel_[0-9a-f]{32}$ WebhookEndpointId: type: string pattern: ^whe_[0-9a-f]{32}$ ApiKeyId: type: string pattern: ^akey_[0-9a-f]{32}$ CollaborationInstallationId: type: string pattern: ^exti_[0-9a-f]{32}$ Union_226: anyOf: - $ref: '#/components/schemas/Objects_41' - $ref: '#/components/schemas/Objects_42' Objects_218: type: object properties: kind: type: string enum: - api_key api_key_id: $ref: '#/components/schemas/ApiKeyId' organization_id: $ref: '#/components/schemas/OrganizationId' role: $ref: '#/components/schemas/Union_15' scope: $ref: '#/components/schemas/Union_16' acted_as: $ref: '#/components/schemas/PrincipalId' required: - kind - api_key_id - organization_id - role - scope additionalProperties: false Objects_219: type: object properties: kind: type: string enum: - automation automation: $ref: '#/components/schemas/AutomationId' organization_id: $ref: '#/components/schemas/OrganizationId' created_by: $ref: '#/components/schemas/PrincipalId' acted_as: $ref: '#/components/schemas/PrincipalId' collaboration_space_id: anyOf: - $ref: '#/components/schemas/CollaborationSpaceId' - type: 'null' collaboration_space_kind: $ref: '#/components/schemas/Union_111' required: - kind - automation - organization_id - created_by - acted_as - collaboration_space_id additionalProperties: false allOf: - anyOf: - properties: collaboration_space_id: type: 'null' collaboration_space_kind: false - properties: collaboration_space_id: type: string collaboration_space_kind: type: string enum: - root - team - channel - personal required: - collaboration_space_id - collaboration_space_kind Objects_220: type: object properties: kind: type: string enum: - agent_placement agent_placement_id: $ref: '#/components/schemas/AgentPlacementId' organization_id: $ref: '#/components/schemas/OrganizationId' acted_as: $ref: '#/components/schemas/PrincipalId' collaboration_space_id: $ref: '#/components/schemas/CollaborationSpaceId' collaboration_space_kind: $ref: '#/components/schemas/Union_111' required: - kind - agent_placement_id - organization_id - acted_as - collaboration_space_id - collaboration_space_kind additionalProperties: false Objects_221: type: object properties: workspace_id: $ref: '#/components/schemas/WorkspaceId' retention_policy: $ref: '#/components/schemas/Union_333' model_provider_policy: type: object properties: denied_providers: type: array items: type: string allOf: - minLength: 1 - maxLength: 255 allOf: - maxItems: 256 - uniqueItems: true required: - denied_providers additionalProperties: false quota_policy: type: object properties: max_concurrent_runs: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 monthly_tokens: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 monthly_sandbox_seconds: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740 additionalProperties: false required: - workspace_id - retention_policy - model_provider_policy - quota_policy additionalProperties: false Arrays_7: type: array items: $ref: '#/components/schemas/ManagedAgentsConnectionBinding' allOf: - maxItems: 20 Union_31: anyOf: - type: string - type: 'null' ManagedAgentsHarnessReference: type: string allOf: - pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})(?:@(?:latest|[1-9][0-9]{0,8}))?$ description: >- a harness catalog name this deployment serves: claude-code, cline, codex, cursor, deepagents, deepseek, hermes, openclaw, openclaw-connected, opencode, pi Arrays_8: type: array items: $ref: '#/components/schemas/Union_27' ManagedAgentsModelConfig: type: object properties: id: type: string effort: anyOf: - type: object properties: type: type: string enum: - low required: - type additionalProperties: false - type: object properties: type: type: string enum: - medium required: - type additionalProperties: false - type: object properties: type: type: string enum: - high required: - type additionalProperties: false - type: object properties: type: type: string enum: - xhigh required: - type additionalProperties: false - type: object properties: type: type: string enum: - max required: - type additionalProperties: false inference_geo: type: string enum: - global - us speed: type: string enum: - standard - fast provider: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ model_credential_id: $ref: '#/components/schemas/ModelCredentialId' required: - id additionalProperties: false Arrays_9: type: array items: $ref: '#/components/schemas/Union_32' Union_33: anyOf: - type: string - type: 'null' Arrays_10: type: array items: $ref: '#/components/schemas/ManagedAgentsTool' Objects_14: type: object properties: tier: type: string enum: - isolate - chromium required: - tier additionalProperties: false ManagedAgentsAgentSkillSelection: anyOf: - type: object properties: type: type: string enum: - listed skills: type: array items: $ref: '#/components/schemas/Union_32' allOf: - minItems: 1 - maxItems: 100 required: - type - skills additionalProperties: false - type: object properties: type: type: string enum: - workspace required: - type additionalProperties: false Environment: type: object properties: id: $ref: '#/components/schemas/EnvironmentId' archived_at: anyOf: - type: string - type: 'null' config: $ref: '#/components/schemas/EnvironmentConfig' created_at: type: string description: anyOf: - type: string - type: 'null' metadata: $ref: '#/components/schemas/ResourceMetadata' name: type: string type: type: string enum: - environment updated_at: type: string scope: $ref: '#/components/schemas/EnvironmentScope' required: - id - archived_at - config - created_at - description - metadata - name - type - updated_at additionalProperties: false Union_335: anyOf: - type: object properties: origin: type: string enum: - native_sdk name: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ capability_ceiling: $ref: '#/components/schemas/Objects_17' adoption: $ref: '#/components/schemas/Objects_16' required: - origin - name - capability_ceiling - adoption additionalProperties: false - type: object properties: origin: type: string enum: - workspace_profile name: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ display_name: type: string allOf: - minLength: 1 description: type: string allOf: - minLength: 1 launch_role: $ref: '#/components/schemas/HarnessLaunchRole' tier: $ref: '#/components/schemas/Union_41' mode: type: string enum: - custom availability: type: string enum: - ready profile_id: $ref: '#/components/schemas/HarnessProfileId' profile_version: type: integer exclusiveMinimum: 0 release_id: $ref: '#/components/schemas/HarnessReleaseId' release_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ capability_ceiling: $ref: '#/components/schemas/Objects_17' adoption: type: object properties: kind: type: string enum: - oci_recipe upstream_project: type: string allOf: - minLength: 1 upstream_revision: type: string allOf: - minLength: 1 recipe: $ref: '#/components/schemas/Objects_19' image_contract: $ref: '#/components/schemas/Union_44' driver_version: type: string allOf: - minLength: 1 default_configuration: $ref: '#/components/schemas/HarnessConfiguration' configuration_schema: $ref: '#/components/schemas/Union_42' default_image: $ref: '#/components/schemas/OciImageReference' managed_adapter_release: type: object properties: engine: type: string enum: - vercel-harness-v1 harness_id: type: string enum: - claude-code - cline - codex - cursor - deepagents - deepseek - hermes - opencode - pi integration_descriptor_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - engine - harness_id - integration_descriptor_digest additionalProperties: false native_capabilities: $ref: >- #/components/schemas/HarnessNativeCapabilityAdmissionNonEmpty required: - kind - upstream_project - upstream_revision - recipe - image_contract - driver_version - default_configuration - configuration_schema - default_image additionalProperties: false required: - origin - name - display_name - description - launch_role - tier - mode - availability - profile_id - profile_version - release_id - release_digest - capability_ceiling - adoption additionalProperties: false - $ref: '#/components/schemas/Union_40' PublicWorkloadTrustAdmission: type: object properties: declaration: $ref: '#/components/schemas/Union_36' facts: $ref: '#/components/schemas/WorkloadTrustFacts' effective: $ref: '#/components/schemas/WorkloadTrust' required: - declaration - facts - effective additionalProperties: false CustomerPlaneAdmission: type: object properties: owner: type: string enum: - customer payer: type: string enum: - customer sandbox_enforcement: type: string enum: - customer_attested network_policy: type: string enum: - undeclared - declared required: - owner - payer - sandbox_enforcement - network_policy additionalProperties: false SessionModelRoutingAccessCoverage: type: object properties: original_published_profile: type: object properties: id: $ref: '#/components/schemas/ModelRoutingProfileId' version_id: $ref: '#/components/schemas/ModelRoutingProfileVersionId' version: type: integer exclusiveMinimum: 0 content_sha256: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - id - version_id - version - content_sha256 additionalProperties: false routing_policy: $ref: '#/components/schemas/Union_131' eligible_candidates: type: array prefixItems: - $ref: '#/components/schemas/Objects_222' minItems: 1 items: $ref: '#/components/schemas/Objects_222' access_intents: type: array prefixItems: - $ref: '#/components/schemas/Union_337' minItems: 1 items: $ref: '#/components/schemas/Union_337' required: - routing_policy - eligible_candidates - access_intents additionalProperties: false SessionComputerCompositionCustody: type: object properties: input: $ref: '#/components/schemas/WorkEnvironmentCompositionInput' resolution: $ref: '#/components/schemas/WorkEnvironmentCompositionResolution' execution_qualification: $ref: '#/components/schemas/SessionExecutionQualificationCustody' computer_lease: type: object properties: workspace_id: $ref: '#/components/schemas/WorkspaceId' computer_id: $ref: '#/components/schemas/ComputerId' lease_id: $ref: '#/components/schemas/ComputerLeaseId' generation: type: integer exclusiveMinimum: 0 profile_version_number: type: integer exclusiveMinimum: 0 profile_content_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ provider_requirements_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ capability_tuple_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - workspace_id - computer_id - lease_id - generation - profile_version_number - profile_content_digest - provider_requirements_digest - capability_tuple_digest additionalProperties: false attachment_policy: type: object properties: maximum_live_attachments: type: integer allOf: - exclusiveMinimum: 0 - maximum: 256 mutating_runs: type: string enum: - serialized reads: type: string enum: - serialized - concurrent required: - maximum_live_attachments - mutating_runs - reads additionalProperties: false required: - input - resolution - execution_qualification - computer_lease - attachment_policy additionalProperties: false SessionExecutionQualificationCustody: type: object properties: digest: type: string pattern: ^sha256:[0-9a-f]{64}$ statement: $ref: '#/components/schemas/SandboxExecutionQualificationStatement' required: - digest - statement additionalProperties: false SessionPlacementOfferingCustody: type: object properties: digest: type: string pattern: ^sha256:[0-9a-f]{64}$ statement: $ref: '#/components/schemas/SandboxPlacementOfferingStatement' required: - digest - statement additionalProperties: false ManagedPlacementSelection: type: object properties: order_digest: anyOf: - type: string pattern: ^sha256:[0-9a-f]{64}$ - type: 'null' availability: type: string enum: - observed - unobserved disposition: type: string enum: - preferred - overflow - failover - saturated - pinned rank: type: integer allOf: - minimum: 0 maximum: 255 passed_over: type: array items: type: object properties: placement_offering_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ reason: type: string enum: - no_live_launcher - launcher_health_below_threshold - no_ready_capacity required: - placement_offering_digest - reason additionalProperties: false allOf: - maxItems: 64 required: - order_digest - availability - disposition - rank - passed_over additionalProperties: false Objects_227: type: object properties: schema_version: type: number enum: - 1 semantic_events: type: string enum: - enabled model_io: $ref: '#/components/schemas/Union_360' tool_io: type: string enum: - bounded - artifacts surfaced_thinking: type: string enum: - none - surfaced_only workflow_artifacts: type: string enum: - none - enabled environment_evidence: $ref: '#/components/schemas/Union_361' native_continuation_capsules: type: string enum: - disabled - enabled learning_use: anyOf: - type: object properties: disposition: type: string enum: - disallowed required: - disposition additionalProperties: false - $ref: '#/components/schemas/SessionLearningGrantRetentionWindow' required: - schema_version - semantic_events - model_io - tool_io - surfaced_thinking - workflow_artifacts - environment_evidence - native_continuation_capsules - learning_use additionalProperties: false AutomationDeliveryScreenAdmission: type: object properties: session_id: $ref: '#/components/schemas/SessionId' authentication: anyOf: - $ref: '#/components/schemas/Objects_218' - $ref: '#/components/schemas/Objects_219' - $ref: '#/components/schemas/Objects_220' - $ref: '#/components/schemas/SessionPrincipalSelfActor' workspace: $ref: '#/components/schemas/Objects_221' configuration: $ref: '#/components/schemas/Objects_228' delivery_screen: anyOf: - type: object properties: model_routing_profile_key: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ tier: $ref: '#/components/schemas/Union_132' instructions: type: string allOf: - minLength: 1 - maxLength: 4096 failure: type: string enum: - fail_open - fail_closed required: - model_routing_profile_key - instructions additionalProperties: false - type: object properties: evaluation: $ref: '#/components/schemas/Objects_93' rule: $ref: '#/components/schemas/Union_194' failure: type: string enum: - fail_open - fail_closed required: - evaluation - rule additionalProperties: false model_routing: $ref: '#/components/schemas/SessionModelRoutingAccessCoverage' computer_composition: $ref: '#/components/schemas/SessionComputerCompositionCustody' execution_qualification: $ref: '#/components/schemas/SessionExecutionQualificationCustody' placement_offering: $ref: '#/components/schemas/SessionPlacementOfferingCustody' placement_selection: $ref: '#/components/schemas/ManagedPlacementSelection' capture_policy_version: type: number enum: - 1 capture_policy: $ref: '#/components/schemas/Objects_227' required: - session_id - authentication - workspace - configuration - capture_policy_version - capture_policy additionalProperties: false GitReference: type: string allOf: - minLength: 1 - maxLength: 1024 - pattern: ^\S+$ Union_242: anyOf: - type: object properties: kind: type: string enum: - ref ref: $ref: '#/components/schemas/Union_124' required: - kind - ref additionalProperties: false - type: object properties: kind: type: string enum: - version version: $ref: '#/components/schemas/MemoryVersionId' required: - kind - version additionalProperties: false GitHubRepository: type: string allOf: - pattern: ^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$ - maxLength: 202 SkillId: type: string pattern: ^skl_[0-9a-f]{32}$ Union_147: type: string enum: - instructional - executable Union_299: type: string enum: - image - video_second - compute_second HarnessProfileId: type: string pattern: ^hprof_[0-9a-f]{32}$ EnvironmentId: type: string pattern: ^env_[0-9a-f]{32}$ RunWebRetrievalPolicyHasTool_1: type: object properties: web_fetch: $ref: '#/components/schemas/EffectiveWebRetrievalPolicyHasList' web_search: $ref: '#/components/schemas/EffectiveWebRetrievalPolicyHasList' additionalProperties: false Union_18: type: string enum: - local - hosted - byoc Objects_8: type: object properties: compute_accounting: type: boolean network_isolation: type: boolean bounded_start: type: boolean bounded_cancel: type: boolean teardown: type: boolean required: - compute_accounting - network_isolation - bounded_start - bounded_cancel - teardown additionalProperties: false BrowserActionApprovalId: type: string pattern: ^bapproval_[0-9a-f]{32}$ ManagedToolSelection: type: object properties: managed_tool_id: $ref: '#/components/schemas/ManagedToolId' managed_tool_release_id: $ref: '#/components/schemas/ManagedToolReleaseId' required: - managed_tool_id - managed_tool_release_id additionalProperties: false UniqueFlowReviewCriteria: type: array items: type: object properties: key: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$ description: $ref: '#/components/schemas/FlowReviewCriterionDescription' severity: type: string enum: - low - medium - high required: - key - description - severity additionalProperties: false allOf: - minItems: 1 - maxItems: 16 Objects_64: type: object properties: 'off': $ref: '#/components/schemas/Union_135' minimal: $ref: '#/components/schemas/Union_135' low: $ref: '#/components/schemas/Union_135' medium: $ref: '#/components/schemas/Union_135' high: $ref: '#/components/schemas/Union_135' xhigh: $ref: '#/components/schemas/Union_135' max: $ref: '#/components/schemas/Union_135' required: - 'off' - minimal - low - medium - high - xhigh - max additionalProperties: false Objects_65: type: object properties: version: type: number enum: - 1 unit: type: string enum: - usd_per_million_tokens source: type: string enum: - profile_declared input: type: number minimum: 0 output: type: number minimum: 0 cache_read: type: number minimum: 0 cache_write: type: number minimum: 0 required: - version - unit - source - input - output - cache_read - cache_write additionalProperties: false Union_11: type: string enum: - global - us OpenRouterMaxPrice: type: object properties: prompt: type: number allOf: - minimum: 0 - maximum: 1000 completion: type: number allOf: - minimum: 0 - maximum: 1000 required: - prompt - completion additionalProperties: false description: >- maximum OpenRouter prompt and completion prices in USD per million tokens ModelCredentialId: type: string pattern: ^mcred_[0-9a-f]{32}$ ModelCredentialGenerationId: type: string pattern: ^mcgen_[0-9a-f]{32}$ FileTreeCaptureTimestamp: type: string allOf: - maxLength: 24 - pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$ x-checkfu-current-timestamp: true description: >- A canonical UTC ISO-8601 FileTree capture timestamp with millisecond precision. Objects_42: type: object properties: kind: type: string enum: - platform_supply provider: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ usage_entry_id: $ref: '#/components/schemas/UsageEntryId' supply_id: $ref: '#/components/schemas/PlatformSupplyId' credential_generation_id: $ref: '#/components/schemas/SupplyCredentialGenerationId' rate_card_id: $ref: '#/components/schemas/BillingRateCardId' customer_rate_card_id: $ref: '#/components/schemas/BillingRateCardId' rated_at: $ref: '#/components/schemas/PlatformModelRatedAt' required: - kind - provider - usage_entry_id - supply_id - credential_generation_id - rate_card_id - rated_at additionalProperties: false OrganizationId: type: string pattern: ^org_[0-9a-f]{32}$ Union_15: type: string enum: - root - admin - developer - runner - viewer Union_16: anyOf: - type: object properties: type: type: string enum: - organization required: - type additionalProperties: false - type: object properties: type: type: string enum: - workspace workspace_id: $ref: '#/components/schemas/WorkspaceId' required: - type - workspace_id additionalProperties: false Union_333: anyOf: - type: object properties: mode: type: string enum: - zdr required: - mode additionalProperties: false - type: object properties: mode: type: string enum: - standard default_ttl_seconds: type: integer allOf: - exclusiveMinimum: 0 - maximum: 2147483647 overrides: type: array items: type: object properties: content_class: $ref: '#/components/schemas/Union_334' ttl_seconds: type: integer allOf: - exclusiveMinimum: 0 - maximum: 2147483647 required: - content_class - ttl_seconds additionalProperties: false required: - mode additionalProperties: false ManagedAgentsConnectionBinding: type: object properties: name: type: string allOf: - minLength: 1 - maxLength: 255 connection_id: $ref: '#/components/schemas/ConnectionId' provider: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ provider_package_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ connection_revision_id: $ref: '#/components/schemas/ConnectionRevisionId' capability_snapshot_id: $ref: '#/components/schemas/CapabilitySnapshotId' capability_snapshot_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ tools: type: array items: type: object properties: name: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ digest: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - name - digest additionalProperties: false allOf: - maxItems: 1000 required: - name - connection_id - provider - provider_package_digest - connection_revision_id - capability_snapshot_id - capability_snapshot_digest - tools additionalProperties: false description: >- Read-only Connection revision, capability snapshot and selected tool digests frozen by this Agent Version; never credentials or supplier handles. Union_27: anyOf: - type: object properties: type: type: string enum: - url name: type: string allOf: - minLength: 1 - maxLength: 255 url: type: string allOf: - minLength: 1 - maxLength: 2048 required: - type - name - url additionalProperties: false - $ref: '#/components/schemas/ManagedAgentsConnectionMcpServerParams' Union_32: anyOf: - type: object properties: type: type: string enum: - anthropic skill_id: type: string version: type: string required: - type - skill_id - version additionalProperties: false - type: object properties: type: type: string enum: - custom skill_id: type: string version: type: string required: - type - skill_id - version additionalProperties: false ManagedAgentsTool: anyOf: - anyOf: - type: object properties: type: type: string enum: - agent_toolset_20260401 - computer_toolset_20260801 configs: type: array items: anyOf: - type: object properties: name: type: string enum: - bash type: type: string enum: - bash enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedAgentsPermissionPolicy' required: - name - type - enabled - permission_policy additionalProperties: false - type: object properties: name: type: string enum: - edit type: type: string enum: - edit enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedAgentsPermissionPolicy' required: - name - type - enabled - permission_policy additionalProperties: false - type: object properties: name: type: string enum: - glob type: type: string enum: - glob enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedAgentsPermissionPolicy' required: - name - type - enabled - permission_policy additionalProperties: false - type: object properties: name: type: string enum: - grep type: type: string enum: - grep enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedAgentsPermissionPolicy' required: - name - type - enabled - permission_policy additionalProperties: false - type: object properties: name: type: string enum: - read type: type: string enum: - read enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedAgentsPermissionPolicy' required: - name - type - enabled - permission_policy additionalProperties: false - type: object properties: name: type: string enum: - web_fetch type: type: string enum: - web_fetch enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedAgentsPermissionPolicy' allowed_domains: $ref: '#/components/schemas/Arrays_6' blocked_domains: $ref: '#/components/schemas/Arrays_6' max_content_tokens: anyOf: - type: integer exclusiveMinimum: 0 - type: 'null' required: - name - type - enabled - permission_policy additionalProperties: false - type: object properties: name: type: string enum: - web_search type: type: string enum: - web_search enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedAgentsPermissionPolicy' allowed_domains: $ref: '#/components/schemas/Arrays_6' blocked_domains: $ref: '#/components/schemas/Arrays_6' user_location: anyOf: - $ref: '#/components/schemas/Objects_11' - type: 'null' required: - name - type - enabled - permission_policy additionalProperties: false - type: object properties: name: type: string enum: - write type: type: string enum: - write enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedAgentsPermissionPolicy' required: - name - type - enabled - permission_policy additionalProperties: false default_config: $ref: '#/components/schemas/Objects_15' required: - type - configs - default_config additionalProperties: false - $ref: '#/components/schemas/ManagedAgentsComputerToolset' - type: object properties: type: type: string enum: - mcp_toolset mcp_server_name: type: string allOf: - minLength: 1 - maxLength: 255 configs: type: array items: type: object properties: name: type: string enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedAgentsPermissionPolicy' required: - name - enabled - permission_policy additionalProperties: false default_config: $ref: '#/components/schemas/Objects_15' required: - type - mcp_server_name - configs - default_config additionalProperties: false - $ref: '#/components/schemas/Objects_13' - $ref: '#/components/schemas/ManagedAgentsManagedTool' EnvironmentConfig: anyOf: - $ref: '#/components/schemas/CloudConfig' - $ref: '#/components/schemas/SelfHostedConfig' ResourceMetadata: type: object additionalProperties: type: string allOf: - maxLength: 512 allOf: - propertyNames: type: string allOf: - minLength: 1 - maxLength: 64 - maxProperties: 16 description: at most 16 correlation pairs with keys of 1 to 64 characters EnvironmentScope: type: string enum: - organization - account Objects_16: type: object properties: kind: type: string enum: - native_sdk managed_adapter_release: type: object properties: engine: type: string enum: - cloudflare-agents-native-v1 harness_id: type: string enum: - pi-durable-v1 integration_descriptor_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - engine - harness_id - integration_descriptor_digest additionalProperties: false default_configuration: $ref: '#/components/schemas/HarnessConfiguration' required: - kind - managed_adapter_release - default_configuration additionalProperties: false HarnessLaunchRole: type: string enum: - primary - alternative - local_fixture description: >- Operator-owned launch intent: product primary, explicit alternative, or local-only fixture Union_41: type: string enum: - certified - beta - experimental HarnessReleaseId: type: string pattern: ^hrel_[0-9a-f]{32}$ Objects_19: type: object properties: id: type: string allOf: - minLength: 1 revision: type: integer exclusiveMinimum: 0 scaffold_command: anyOf: - type: string allOf: - minLength: 1 - type: 'null' required: - id - revision - scaffold_command additionalProperties: false Union_44: anyOf: - type: object properties: argv: false prompt_transport: false output_mode: false resume_flag: false output_schema_flag: false output_schema_transport: false protocol: type: string enum: - acp-v1 entrypoint: type: string allOf: - maxLength: 4096 - pattern: >- ^\/(?!\.{1,2}(?:\/|$))[A-Za-z0-9._-]+(?:\/(?!\.{1,2}(?:\/|$))[A-Za-z0-9._-]+)*$ arguments: $ref: '#/components/schemas/HarnessProcessArgumentVectorUtf8Bytes' mcp_delivery: type: string enum: - session_http - none working_directory: type: string allOf: - maxLength: 4096 - pattern: >- ^\/(?!\.{1,2}(?:\/|$))[A-Za-z0-9._-]+(?:\/(?!\.{1,2}(?:\/|$))[A-Za-z0-9._-]+)*$ platforms: $ref: '#/components/schemas/Arrays_11' model_plane: type: string enum: - workspace model_wire_dialects: $ref: '#/components/schemas/Arrays_12' run_as_user: type: string enum: - '65532:65532' read_only_root: type: boolean enum: - true writable_paths: $ref: '#/components/schemas/Arrays_13' required: - protocol - entrypoint - arguments - mcp_delivery - working_directory - platforms - model_plane - run_as_user - read_only_root - writable_paths additionalProperties: false - $ref: '#/components/schemas/OneShotImageContractPromptPath' HarnessConfiguration: type: object additionalProperties: description: >- A value in the JSON data model: null, boolean, finite number, string, array, or object. allOf: - x-checkfu-json-budget: maximumBytes: 65536 maximumDepth: 32 maximumNodes: 4000 maximumInspectionWork: 4000 x-checkfu-unicode-scalar-values: true allOf: - x-checkfu-json-budget: maximumBytes: 65536 maximumDepth: 32 maximumNodes: 4000 maximumInspectionWork: 4000 x-checkfu-unicode-scalar-values: true - maxProperties: 4000 description: harness configuration of at most 64 KiB, depth 32, and 4,000 nodes Union_42: anyOf: - type: boolean - $ref: '#/components/schemas/HarnessConfigurationSchemaObject' OciImageReference: type: string HarnessNativeCapabilityAdmissionNonEmpty: type: object properties: harness_id: type: string allOf: - minLength: 1 - maxLength: 256 target: $ref: '#/components/schemas/Objects_37' conformance_report_id: $ref: '#/components/schemas/ConformanceReportId' evidence_manifest_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ evidence_signature: type: object properties: algorithm: type: string enum: - hmac-sha256 key_id: type: string allOf: - minLength: 1 - maxLength: 64 digest: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - algorithm - key_id - digest additionalProperties: false expires_at: $ref: '#/components/schemas/HarnessNativeCapabilityAdmissionExpiry' checkpoint: type: string enum: - conformance_earned approval: type: string enum: - conformance_earned required: - harness_id - target - conformance_report_id - evidence_manifest_hash - evidence_signature - expires_at additionalProperties: false Union_40: anyOf: - type: object properties: name: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ display_name: type: string allOf: - minLength: 1 description: type: string allOf: - minLength: 1 launch_role: $ref: '#/components/schemas/HarnessLaunchRole' tier: $ref: '#/components/schemas/Union_41' mode: type: string enum: - native availability: type: string enum: - blocked missing_evidence: type: string enum: - native_customer_qualification adoption: $ref: '#/components/schemas/Objects_16' capability_ceiling: $ref: '#/components/schemas/Objects_17' required: - name - display_name - description - launch_role - tier - mode - availability - missing_evidence - adoption - capability_ceiling additionalProperties: false - type: object properties: name: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ display_name: type: string allOf: - minLength: 1 description: type: string allOf: - minLength: 1 launch_role: $ref: '#/components/schemas/HarnessLaunchRole' tier: $ref: '#/components/schemas/Union_41' mode: type: string enum: - managed availability: type: string enum: - ready adoption: type: object properties: kind: type: string enum: - managed artifact: $ref: '#/components/schemas/Objects_18' driver_version: type: string allOf: - minLength: 1 default_configuration: $ref: '#/components/schemas/HarnessConfiguration' configuration_schema: $ref: '#/components/schemas/Union_42' required: - kind - artifact - driver_version - default_configuration - configuration_schema additionalProperties: false capability_ceiling: $ref: '#/components/schemas/Objects_17' required: - name - display_name - description - launch_role - tier - mode - availability - adoption - capability_ceiling additionalProperties: false - type: object properties: name: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ display_name: type: string allOf: - minLength: 1 description: type: string allOf: - minLength: 1 launch_role: $ref: '#/components/schemas/HarnessLaunchRole' tier: $ref: '#/components/schemas/Union_41' mode: $ref: '#/components/schemas/Union_43' capability_ceiling: $ref: '#/components/schemas/Objects_17' availability: type: string enum: - image_required adoption: type: object properties: kind: type: string enum: - oci_recipe upstream_project: type: string allOf: - minLength: 1 upstream_revision: type: string allOf: - minLength: 1 recipe: $ref: '#/components/schemas/Objects_19' image_contract: $ref: '#/components/schemas/Union_44' driver_version: type: string allOf: - minLength: 1 default_configuration: $ref: '#/components/schemas/HarnessConfiguration' configuration_schema: $ref: '#/components/schemas/Union_42' default_image: type: 'null' required: - kind - upstream_project - upstream_revision - recipe - image_contract - driver_version - default_configuration - configuration_schema - default_image additionalProperties: false required: - name - display_name - description - launch_role - tier - mode - capability_ceiling - availability - adoption additionalProperties: false - $ref: '#/components/schemas/HarnessCatalogReadinessReceiptCoordinates' - type: object properties: name: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ display_name: type: string allOf: - minLength: 1 description: type: string allOf: - minLength: 1 launch_role: $ref: '#/components/schemas/HarnessLaunchRole' tier: $ref: '#/components/schemas/Union_41' mode: $ref: '#/components/schemas/Union_43' capability_ceiling: $ref: '#/components/schemas/Objects_17' availability: type: string enum: - blocked missing_evidence: type: string allOf: - minLength: 1 adoption: type: object properties: kind: type: string enum: - oci_recipe upstream_project: type: string allOf: - minLength: 1 upstream_revision: type: string allOf: - minLength: 1 recipe: $ref: '#/components/schemas/Objects_19' image_contract: $ref: '#/components/schemas/Union_44' driver_version: type: string allOf: - minLength: 1 default_configuration: $ref: '#/components/schemas/HarnessConfiguration' configuration_schema: $ref: '#/components/schemas/Union_42' default_image: $ref: '#/components/schemas/OciImageReference' required: - kind - upstream_project - upstream_revision - recipe - image_contract - driver_version - default_configuration - configuration_schema - default_image additionalProperties: false required: - name - display_name - description - launch_role - tier - mode - capability_ceiling - availability - missing_evidence - adoption additionalProperties: false - type: object properties: name: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ display_name: type: string allOf: - minLength: 1 description: type: string allOf: - minLength: 1 launch_role: $ref: '#/components/schemas/HarnessLaunchRole' tier: $ref: '#/components/schemas/Union_41' mode: type: string enum: - connected adoption: $ref: '#/components/schemas/Objects_21' capability_ceiling: $ref: '#/components/schemas/Objects_17' availability: type: string enum: - ready required: - name - display_name - description - launch_role - tier - mode - adoption - capability_ceiling - availability additionalProperties: false - type: object properties: name: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ display_name: type: string allOf: - minLength: 1 description: type: string allOf: - minLength: 1 launch_role: $ref: '#/components/schemas/HarnessLaunchRole' tier: $ref: '#/components/schemas/Union_41' mode: type: string enum: - connected adoption: $ref: '#/components/schemas/Objects_21' capability_ceiling: $ref: '#/components/schemas/Objects_17' availability: type: string enum: - blocked missing_plane: type: string allOf: - minLength: 1 required: - name - display_name - description - launch_role - tier - mode - adoption - capability_ceiling - availability - missing_plane additionalProperties: false Union_36: anyOf: - type: object properties: value: $ref: '#/components/schemas/WorkloadTrust' recorded_at: $ref: '#/components/schemas/CurrentTimestamp' required: - value - recorded_at additionalProperties: false - type: 'null' WorkloadTrustFacts: type: object properties: authorship: type: string enum: - organization_engineer - end_user - third_party - unknown source_review: type: string enum: - workspace_controlled - unreviewed - unknown execution_plane: type: string enum: - organization_local - organization_single_tenant - shared_or_third_party - unknown input_exposure: type: object properties: source_build: $ref: '#/components/schemas/WorkloadInputControl' ingress: $ref: '#/components/schemas/WorkloadInputControl' resources: $ref: '#/components/schemas/WorkloadInputControl' installations: $ref: '#/components/schemas/WorkloadInputControl' content_capabilities: $ref: '#/components/schemas/WorkloadInputControl' required: - source_build - ingress - resources - installations - content_capabilities additionalProperties: false required: - authorship - source_review - execution_plane - input_exposure additionalProperties: false WorkloadTrust: type: string enum: - trusted - adversarial ModelRoutingProfileVersionId: type: string pattern: ^mrprev_[0-9a-f]{32}$ Objects_222: type: object properties: tier: type: string enum: - default provider: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ model: type: string allOf: - minLength: 1 context_window_tokens: type: integer exclusiveMinimum: 0 effort: type: string enum: - low - medium - high - xhigh - max speed: type: string enum: - standard - fast inference_geo: $ref: '#/components/schemas/Union_11' openrouter_max_price: $ref: '#/components/schemas/OpenRouterMaxPrice' native_capabilities: anyOf: - type: object properties: version: type: number enum: - 1 wire_format: type: string enum: - openai_chat max_output_tokens: type: integer exclusiveMinimum: 0 input_modalities: type: array prefixItems: - type: string enum: - text - image minItems: 1 items: type: string enum: - text - image reasoning: type: boolean thinking_levels: $ref: '#/components/schemas/Objects_64' compatibility: type: object properties: supportsStore: type: boolean supportsDeveloperRole: type: boolean supportsReasoningEffort: type: boolean supportsUsageInStreaming: type: boolean supportsFinishReason: type: boolean maxTokensField: type: string enum: - max_tokens - max_completion_tokens requiresToolResultName: type: boolean requiresAssistantAfterToolResult: type: boolean requiresThinkingAsText: type: boolean requiresReasoningContentOnAssistantMessages: type: boolean thinkingFormat: type: string enum: - openai - openrouter - deepseek - together - zai - qwen - string-thinking - ant-ling zaiToolStream: type: boolean supportsStrictMode: type: boolean supportsOpenAIGrammarTools: type: boolean supportsMidConvoSystemMessages: type: boolean supportsMidConvoToolAdditions: type: boolean supportsThinkingTokenBudget: type: boolean thinkingTokenBudgetField: type: string enum: - thinking_token_budget - thinking_budget - thinking_budget_tokens required: - supportsStore - supportsDeveloperRole - supportsReasoningEffort - supportsUsageInStreaming - supportsFinishReason - maxTokensField - requiresToolResultName - requiresAssistantAfterToolResult - requiresThinkingAsText - requiresReasoningContentOnAssistantMessages - thinkingFormat - zaiToolStream - supportsStrictMode - supportsOpenAIGrammarTools - supportsMidConvoSystemMessages - supportsMidConvoToolAdditions - supportsThinkingTokenBudget additionalProperties: false required: - version - wire_format - max_output_tokens - input_modalities - reasoning - thinking_levels - compatibility additionalProperties: false - type: object properties: version: type: number enum: - 1 wire_format: type: string enum: - openai_responses max_output_tokens: type: integer exclusiveMinimum: 0 input_modalities: type: array prefixItems: - type: string enum: - text - image minItems: 1 items: type: string enum: - text - image reasoning: type: boolean thinking_levels: $ref: '#/components/schemas/Objects_64' compatibility: type: object properties: supportsDeveloperRole: type: boolean supportsMidConvoSystemMessages: type: boolean supportsStrictMode: type: boolean supportsOpenAIGrammarTools: type: boolean supportsAdditionalTools: type: boolean supportsToolSearch: type: boolean supportsExplicitPromptCacheMode: type: boolean supportsMaxOutputTokens: type: boolean required: - supportsDeveloperRole - supportsMidConvoSystemMessages - supportsStrictMode - supportsOpenAIGrammarTools - supportsAdditionalTools - supportsToolSearch - supportsExplicitPromptCacheMode - supportsMaxOutputTokens additionalProperties: false required: - version - wire_format - max_output_tokens - input_modalities - reasoning - thinking_levels - compatibility additionalProperties: false - type: object properties: version: type: number enum: - 1 wire_format: type: string enum: - anthropic_messages max_output_tokens: type: integer exclusiveMinimum: 0 input_modalities: type: array prefixItems: - type: string enum: - text - image minItems: 1 items: type: string enum: - text - image reasoning: type: boolean thinking_levels: $ref: '#/components/schemas/Objects_64' compatibility: type: object properties: supportsEagerToolInputStreaming: type: boolean supportsCacheControlOnTools: type: boolean supportsTemperature: type: boolean forceAdaptiveThinking: type: boolean allowEmptySignature: type: boolean supportsStrictTools: type: boolean supportsMidConvoEffort: type: boolean supportsMidConvoSystemMessages: type: boolean supportsMidConvoToolChanges: type: boolean required: - supportsEagerToolInputStreaming - supportsCacheControlOnTools - supportsTemperature - forceAdaptiveThinking - allowEmptySignature - supportsStrictTools - supportsMidConvoEffort - supportsMidConvoSystemMessages - supportsMidConvoToolChanges additionalProperties: false required: - version - wire_format - max_output_tokens - input_modalities - reasoning - thinking_levels - compatibility additionalProperties: false native_sdk_estimation: $ref: '#/components/schemas/Objects_65' required: - tier - provider - model additionalProperties: false Union_337: anyOf: - type: object properties: kind: type: string enum: - platform_supply provider: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ required: - kind - provider additionalProperties: false - type: object properties: kind: type: string enum: - workspace_credential provider: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ model_credential_id: $ref: '#/components/schemas/ModelCredentialId' model_credential_generation_id: $ref: '#/components/schemas/ModelCredentialGenerationId' api_format: $ref: '#/components/schemas/ModelApiFormat' base_url: anyOf: - $ref: '#/components/schemas/PublicModelBaseUrl' - type: 'null' credential_resource_version: type: integer exclusiveMinimum: 0 required: - kind - provider - model_credential_id - model_credential_generation_id additionalProperties: false WorkEnvironmentCompositionInput: type: object properties: input_type: type: string enum: - composition execution: $ref: '#/components/schemas/WorkEnvironmentInput' computer: type: object properties: requirements: $ref: '#/components/schemas/WorkEnvironmentInput' affinity: anyOf: - type: object properties: type: type: string enum: - same_execution_environment required_shared: type: array items: type: string enum: - display - filesystem - network - process_namespace allOf: - maxItems: 4 required: - type - required_shared additionalProperties: false - type: object properties: type: type: string enum: - remote_permitted required: - type additionalProperties: false existing_computer: anyOf: - $ref: '#/components/schemas/ComputerId' - type: 'null' required: - requirements additionalProperties: false ownership: $ref: '#/components/schemas/Objects_223' remote: $ref: '#/components/schemas/Objects_224' required: - input_type - execution - computer additionalProperties: false description: >- Explicit execution requirements plus a requested Computer overlay, with affinity, ownership, and remote-authorization policy for one joint admission. WorkEnvironmentCompositionResolution: type: object properties: execution: $ref: '#/components/schemas/WorkEnvironmentResolution' composition: $ref: '#/components/schemas/WorkEnvironmentCompositionOutcome' required: - execution - composition additionalProperties: false description: >- The singular execution-side resolution plus the joint composition outcome for a requested Computer overlay. ComputerId: type: string pattern: ^comp_[0-9a-f]{32}$ ComputerLeaseId: type: string pattern: ^clease_[0-9a-f]{32}$ SandboxExecutionQualificationStatement: type: object properties: schema_revision: type: string enum: - checkfu:sandbox-execution-qualification@3 scope: type: string enum: - platform - workspace workspace_id: $ref: '#/components/schemas/WorkspaceId' owner: $ref: '#/components/schemas/Union_354' target: $ref: '#/components/schemas/SandboxExecutionQualificationTarget' environment: $ref: '#/components/schemas/Objects_169' offering: $ref: '#/components/schemas/SandboxExecutionOffering' identity: $ref: '#/components/schemas/SandboxExecutionQualificationIdentity' candidate: $ref: '#/components/schemas/WorkEnvironmentProviderCandidate' required_capabilities: $ref: '#/components/schemas/Arrays_52' candidate_capabilities: $ref: '#/components/schemas/Arrays_52' required_capabilities_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ candidate_capabilities_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ conformance: type: object properties: suite_revision: type: string enum: - checkfu:execution-probes@1 report_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - suite_revision - report_digest additionalProperties: false nonce: type: string allOf: - minLength: 1 - maxLength: 255 - pattern: ^[A-Za-z0-9][A-Za-z0-9._:@+-]*$ issued_at: $ref: '#/components/schemas/CurrentTimestamp' expires_at: $ref: '#/components/schemas/CurrentTimestamp' required: - schema_revision - owner - target - identity - candidate - required_capabilities - candidate_capabilities - required_capabilities_digest - candidate_capabilities_digest - conformance - nonce - issued_at - expires_at additionalProperties: false SandboxPlacementOfferingStatement: type: object properties: schema_revision: type: string enum: - checkfu:sandbox-placement-conformance@3 scope: type: string enum: - platform target: $ref: '#/components/schemas/SandboxPlacementTarget' runner_pool: $ref: '#/components/schemas/RunnerPoolId' execution_plane: type: string enum: - shared_or_third_party identity: $ref: '#/components/schemas/SandboxPlacementOfferingIdentity' offering: $ref: '#/components/schemas/SandboxPlacementOffering' enforcement: type: object properties: sandbox_isolation: $ref: '#/components/schemas/Union_358' root_read_only: $ref: '#/components/schemas/Union_358' non_root: $ref: '#/components/schemas/Union_358' no_new_privileges: $ref: '#/components/schemas/Union_358' capabilities_dropped: $ref: '#/components/schemas/Union_358' mounts_sealed: $ref: '#/components/schemas/Union_358' disk_limit: $ref: '#/components/schemas/Union_358' network_policy: $ref: '#/components/schemas/Union_358' resource_limits: $ref: '#/components/schemas/Union_358' required: - sandbox_isolation - root_read_only - non_root - no_new_privileges - capabilities_dropped - mounts_sealed - disk_limit - network_policy - resource_limits additionalProperties: false conformance: type: object properties: suite_revision: type: string allOf: - minLength: 1 - maxLength: 128 - pattern: ^[A-Za-z0-9][A-Za-z0-9._:@+-]*$ report_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - suite_revision - report_digest additionalProperties: false egress_authority: type: object properties: guard_revision: type: string allOf: - minLength: 1 - maxLength: 128 - pattern: ^[A-Za-z0-9][A-Za-z0-9._:@+-]*$ attestation: $ref: '#/components/schemas/AttestedSandboxEgressConformanceReceipt' required: - guard_revision - attestation additionalProperties: false issued_at: $ref: '#/components/schemas/CurrentTimestamp' expires_at: $ref: '#/components/schemas/CurrentTimestamp' required: - schema_revision - scope - target - runner_pool - execution_plane - identity - offering - enforcement - conformance - issued_at - expires_at additionalProperties: false Union_360: type: string enum: - none - digests - content Union_361: type: string enum: - manifests - selected_content - checkpoints SessionLearningGrantRetentionWindow: type: object properties: disposition: type: string enum: - allowed purposes: type: array items: $ref: '#/components/schemas/Union_362' allOf: - maxItems: 6 - minItems: 1 granted_by_api_key_id: $ref: '#/components/schemas/ApiKeyId' granted_by_role: type: string enum: - root - admin granted_at: $ref: '#/components/schemas/CurrentTimestamp' authorized_until: $ref: '#/components/schemas/CurrentTimestamp' required: - disposition - purposes - granted_by_api_key_id - granted_by_role - granted_at - authorized_until additionalProperties: false SessionPrincipalSelfActor: type: object properties: kind: type: string enum: - principal_access credential_id: $ref: '#/components/schemas/PrincipalAccessCredentialId' principal_id: $ref: '#/components/schemas/PrincipalId' organization_id: $ref: '#/components/schemas/OrganizationId' workspace_id: $ref: '#/components/schemas/WorkspaceId' acted_as: $ref: '#/components/schemas/PrincipalId' required: - kind - credential_id - principal_id - organization_id - workspace_id - acted_as additionalProperties: false Objects_228: type: object properties: agent: $ref: '#/components/schemas/ManagedAgentsSessionAgent' environment: $ref: '#/components/schemas/Environment' harness: $ref: '#/components/schemas/Union_335' workload_trust: $ref: '#/components/schemas/PublicWorkloadTrustAdmission' plane_admission: $ref: '#/components/schemas/CustomerPlaneAdmission' required: - agent - environment - harness - workload_trust additionalProperties: false EffectiveWebRetrievalPolicyHasList: type: object properties: allowed_domains: $ref: '#/components/schemas/EffectiveWebRetrievalAllowedDomainsUnique' blocked_domains: $ref: '#/components/schemas/EffectiveWebRetrievalBlockedDomainsUnique' additionalProperties: false ManagedToolId: type: string pattern: ^mtl_[0-9a-f]{32}$ ManagedToolReleaseId: type: string pattern: ^mtrel_[0-9a-f]{32}$ FlowReviewCriterionDescription: type: string allOf: - minLength: 1 - maxLength: 1024 Union_135: anyOf: - type: string allOf: - minLength: 1 - maxLength: 255 - type: 'null' UsageEntryId: type: string pattern: ^use_[0-9a-f]{32}$ PlatformSupplyId: type: string pattern: ^sup_[0-9a-f]{32}$ SupplyCredentialGenerationId: type: string pattern: ^sgen_[0-9a-f]{32}$ BillingRateCardId: type: string pattern: ^rate_[0-9a-f]{32}$ PlatformModelRatedAt: type: string allOf: - maxLength: 24 - pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$ x-checkfu-current-timestamp: true description: >- A canonical UTC ISO-8601 model-rating instant with millisecond precision. Union_334: type: string enum: - message - thinking - tool_arguments - tool_result - artifact - checkpoint - file_body - memory_document - sandbox_state - wire_frame ConnectionRevisionId: type: string pattern: ^crev_[0-9a-f]{32}$ CapabilitySnapshotId: type: string pattern: ^csnap_[0-9a-f]{32}$ ManagedAgentsConnectionMcpServerParams: type: object properties: type: type: string enum: - connection name: type: string allOf: - minLength: 1 - maxLength: 255 connection_id: $ref: '#/components/schemas/ConnectionId' required: - type - name - connection_id additionalProperties: false description: >- An explicit governed Connection account exposed under a named MCP toolset. ManagedAgentsPermissionPolicy: anyOf: - type: object properties: type: type: string enum: - always_allow required: - type additionalProperties: false - type: object properties: type: type: string enum: - always_ask required: - type additionalProperties: false Arrays_6: type: array items: type: string allOf: - minLength: 1 - maxLength: 255 allOf: - minItems: 1 - maxItems: 64 Objects_11: type: object properties: type: type: string enum: - approximate city: anyOf: - type: string - type: 'null' country: anyOf: - $ref: '#/components/schemas/ManagedAgentsIsoCountryCode' - type: 'null' region: anyOf: - type: string - type: 'null' timezone: anyOf: - $ref: '#/components/schemas/ManagedAgentsIanaTimeZone' - type: 'null' required: - type additionalProperties: false Objects_15: type: object properties: enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedAgentsPermissionPolicy' required: - enabled - permission_policy additionalProperties: false ManagedAgentsComputerToolset: type: object properties: type: type: string enum: - computer_toolset_20260801 required: - type additionalProperties: false Objects_13: type: object properties: type: type: string enum: - custom name: type: string allOf: - minLength: 1 - maxLength: 128 - pattern: ^[A-Za-z0-9_-]+$ description: type: string allOf: - minLength: 1 input_schema: $ref: '#/components/schemas/ManagedAgentsCustomToolInputSchema' required: - type - name - description - input_schema additionalProperties: false ManagedAgentsManagedTool: type: object properties: type: type: string enum: - managed_tool managed_tool_id: $ref: '#/components/schemas/ManagedToolId' managed_tool_release_id: $ref: '#/components/schemas/ManagedToolReleaseId' maximum_charge_microusd: type: integer allOf: - minimum: 0 - maximum: 9007199254740991 required: - type - managed_tool_id - managed_tool_release_id - maximum_charge_microusd additionalProperties: false CloudConfig: type: object properties: type: type: string enum: - cloud networking: anyOf: - $ref: '#/components/schemas/UnrestrictedNetwork' - $ref: '#/components/schemas/LimitedNetwork' packages: $ref: '#/components/schemas/Packages' required: - type - networking - packages additionalProperties: false SelfHostedConfig: type: object properties: type: type: string enum: - self_hosted networking: anyOf: - $ref: '#/components/schemas/UnrestrictedNetwork' - $ref: '#/components/schemas/LimitedNetwork' required: - type additionalProperties: false HarnessProcessArgumentVectorUtf8Bytes: type: array items: $ref: '#/components/schemas/HarnessProcessArgumentUtf8Bytes' allOf: - maxItems: 256 description: >- At most 256 exact process arguments and 131072 aggregate UTF-8 bytes including one terminator per argument Arrays_11: type: array items: $ref: '#/components/schemas/Objects_7' allOf: - minItems: 1 Arrays_12: type: array items: type: string enum: - anthropic_messages - openai_chat - openai_responses - fal_queue allOf: - minItems: 1 - maxItems: 4 - uniqueItems: true Arrays_13: type: array items: type: string allOf: - maxLength: 4096 - pattern: >- ^\/(?!\.{1,2}(?:\/|$))[A-Za-z0-9._-]+(?:\/(?!\.{1,2}(?:\/|$))[A-Za-z0-9._-]+)*$ allOf: - minItems: 1 OneShotImageContractPromptPath: type: object properties: protocol: type: string enum: - oneshot-v1 arguments: false mcp_delivery: false entrypoint: type: string allOf: - maxLength: 4096 - pattern: >- ^\/(?!\.{1,2}(?:\/|$))[A-Za-z0-9._-]+(?:\/(?!\.{1,2}(?:\/|$))[A-Za-z0-9._-]+)*$ argv: $ref: '#/components/schemas/OneShotArgvPlaceholders' prompt_transport: $ref: '#/components/schemas/Union_47' output_mode: $ref: '#/components/schemas/Union_48' resume_flag: type: string allOf: - maxLength: 65536 - pattern: ^[^\u0000]*$ description: >- Exact process argument text, preserving whitespace; U+0000 is forbidden and UTF-8 encoding is limited to 65536 bytes - minLength: 1 output_schema_flag: type: string allOf: - maxLength: 65536 - pattern: ^[^\u0000]*$ description: >- Exact process argument text, preserving whitespace; U+0000 is forbidden and UTF-8 encoding is limited to 65536 bytes - minLength: 1 output_schema_transport: type: string enum: - argv_json - argv_path working_directory: type: string allOf: - maxLength: 4096 - pattern: >- ^\/(?!\.{1,2}(?:\/|$))[A-Za-z0-9._-]+(?:\/(?!\.{1,2}(?:\/|$))[A-Za-z0-9._-]+)*$ platforms: $ref: '#/components/schemas/Arrays_11' model_plane: type: string enum: - workspace model_wire_dialects: $ref: '#/components/schemas/Arrays_12' run_as_user: type: string enum: - '65532:65532' read_only_root: type: boolean enum: - true writable_paths: $ref: '#/components/schemas/Arrays_13' required: - protocol - entrypoint - argv - prompt_transport - output_mode - working_directory - platforms - model_plane - run_as_user - read_only_root - writable_paths additionalProperties: false HarnessConfigurationSchemaObject: type: object additionalProperties: description: >- A value in the JSON data model: null, boolean, finite number, string, array, or object. allOf: - x-checkfu-json-budget: maximumBytes: 65536 maximumDepth: 32 maximumNodes: 4000 maximumInspectionWork: 4000 x-checkfu-unicode-scalar-values: true allOf: - x-checkfu-json-budget: maximumBytes: 65536 maximumDepth: 32 maximumNodes: 4000 maximumInspectionWork: 4000 x-checkfu-unicode-scalar-values: true - maxProperties: 4000 description: >- harness configuration schema of at most 64 KiB, depth 32, and 4,000 nodes Objects_37: type: object properties: provider_id: type: string allOf: - minLength: 1 - maxLength: 255 provider_revision: type: string allOf: - minLength: 1 - maxLength: 255 materialization_revision: type: string allOf: - minLength: 1 - maxLength: 255 placement: $ref: '#/components/schemas/Union_18' runtime_assurances: $ref: '#/components/schemas/Objects_8' required: - provider_id - provider_revision - materialization_revision - placement additionalProperties: false ConformanceReportId: type: string pattern: ^conf_[0-9a-f]{32}$ HarnessNativeCapabilityAdmissionExpiry: type: string allOf: - maxLength: 24 - pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$ x-checkfu-current-timestamp: true description: The expiry of the verified report used to admit native capabilities. Objects_18: type: object properties: kind: type: string enum: - managed protocol: type: string enum: - mock preset: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ adapter_version: type: string allOf: - minLength: 1 recipe_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - kind - protocol - preset - adapter_version - recipe_digest additionalProperties: false Union_43: type: string enum: - packaged - custom HarnessCatalogReadinessReceiptCoordinates: type: object properties: name: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ display_name: type: string allOf: - minLength: 1 description: type: string allOf: - minLength: 1 launch_role: $ref: '#/components/schemas/HarnessLaunchRole' tier: $ref: '#/components/schemas/Union_41' mode: $ref: '#/components/schemas/Union_43' capability_ceiling: $ref: '#/components/schemas/Objects_17' availability: type: string enum: - ready readiness_receipt: $ref: '#/components/schemas/Objects_20' adoption: type: object properties: kind: type: string enum: - oci_recipe upstream_project: type: string allOf: - minLength: 1 upstream_revision: type: string allOf: - minLength: 1 recipe: $ref: '#/components/schemas/Objects_19' image_contract: $ref: '#/components/schemas/Union_44' driver_version: type: string allOf: - minLength: 1 default_configuration: $ref: '#/components/schemas/HarnessConfiguration' configuration_schema: $ref: '#/components/schemas/Union_42' default_image: $ref: '#/components/schemas/OciImageReference' required: - kind - upstream_project - upstream_revision - recipe - image_contract - driver_version - default_configuration - configuration_schema - default_image additionalProperties: false required: - name - display_name - description - launch_role - tier - mode - capability_ceiling - availability - readiness_receipt - adoption additionalProperties: false Objects_21: type: object properties: kind: type: string enum: - connected upstream_project: type: string allOf: - minLength: 1 upstream_revision: type: string allOf: - minLength: 1 command: type: string allOf: - maxLength: 65536 - pattern: ^[^\u0000]*$ description: >- Exact process argument text, preserving whitespace; U+0000 is forbidden and UTF-8 encoding is limited to 65536 bytes - minLength: 1 arguments: $ref: '#/components/schemas/HarnessProcessArgumentVectorUtf8Bytes' required: - kind - upstream_project - upstream_revision - command - arguments additionalProperties: false WorkloadInputControl: type: string enum: - controlled - third_party - unknown ModelApiFormat: type: string enum: - openai_chat - openai_responses - anthropic_messages description: >- the request format a model endpoint serves: OpenAI Chat Completions, OpenAI Responses, or Anthropic Messages PublicModelBaseUrl: type: string allOf: - maxLength: 2048 WorkEnvironmentInput: anyOf: - type: object properties: input_type: type: string enum: - preset preset: type: string enum: - conversation_only - sandbox_ephemeral - sandbox_durable - browser_isolated - browser_shared_profile - desktop_isolated - desktop_shared_filesystem - connected_computer overrides: type: object properties: execution: $ref: '#/components/schemas/Arrays_47' computer_capabilities: $ref: '#/components/schemas/WorkEnvironmentComputerCapabilities' placement: $ref: '#/components/schemas/Arrays_48' locality: type: object properties: regions: $ref: '#/components/schemas/Arrays_49' residency_required: type: boolean required: - regions - residency_required additionalProperties: false resources: type: object properties: minimum_vcpu: anyOf: - type: integer allOf: - exclusiveMinimum: 0 - maximum: 1024 - type: 'null' minimum_memory_mib: anyOf: - type: integer allOf: - exclusiveMinimum: 0 - maximum: 4194304 - type: 'null' minimum_disk_mib: anyOf: - type: integer allOf: - exclusiveMinimum: 0 - maximum: 1073741824 - type: 'null' gpu: $ref: '#/components/schemas/Union_343' required: - minimum_vcpu - minimum_memory_mib - minimum_disk_mib - gpu additionalProperties: false additionalProperties: false required: - input_type - preset additionalProperties: false - type: object properties: input_type: type: string enum: - requirements requirements: $ref: '#/components/schemas/WorkEnvironmentRequirements' required: - input_type - requirements additionalProperties: false description: >- Explicit requirements or a versioned convenience preset with safe overrides. Objects_223: type: object properties: execution: $ref: '#/components/schemas/Arrays_51' computer: $ref: '#/components/schemas/Arrays_51' required: - execution - computer additionalProperties: false Objects_224: type: object properties: spend_authorized: type: boolean data_egress_authorized: type: boolean required: - spend_authorized - data_egress_authorized additionalProperties: false WorkEnvironmentResolution: type: object properties: disposition: type: string enum: - resolved - refused resolver_version: type: string enum: - work-environment-resolver/v1 preset_catalog_version: type: number enum: - 1 normalized_requirements: $ref: '#/components/schemas/WorkEnvironmentRequirements' resolved_kind: type: string enum: - none - session_sandbox - computer requires_screen: type: boolean forced_by: type: array items: type: string allOf: - minLength: 1 - maxLength: 128 - pattern: ^[a-z_]+(?:\.[a-z_]+)*$ allOf: - maxItems: 16 selected_provider: anyOf: - type: object properties: provider: type: string allOf: - minLength: 1 - maxLength: 128 - pattern: ^[a-z0-9][a-z0-9._-]*$ tuple_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ evidence_grade: type: string enum: - double - live_qualified required: - provider - tuple_digest - evidence_grade additionalProperties: false - type: 'null' considered: type: array items: $ref: '#/components/schemas/Objects_225' allOf: - maxItems: 64 warnings: type: array items: type: object properties: code: anyOf: - type: string enum: - shared_profile_credentials message: type: string allOf: - minLength: 1 - maxLength: 512 acknowledgement_required: type: boolean required: - code - message - acknowledgement_required additionalProperties: false allOf: - maxItems: 16 estimated_usage_dimensions: type: array items: $ref: '#/components/schemas/Union_355' allOf: - maxItems: 3 refusal: anyOf: - $ref: '#/components/schemas/WorkEnvironmentRefusal' - type: 'null' portability: type: string enum: - not_applicable - unproved - single_live_provider - portable candidate_set_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ resolution_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - disposition - resolver_version - preset_catalog_version - normalized_requirements - resolved_kind - requires_screen - forced_by - selected_provider - considered - warnings - estimated_usage_dimensions - refusal - portability - candidate_set_digest - resolution_digest additionalProperties: false description: >- A deterministic allocation-free explanation of work-environment admission. WorkEnvironmentCompositionOutcome: type: object properties: disposition: type: string enum: - refused - resolved resolver_version: type: string enum: - work-environment-composition-resolver/v1 effective_affinity: $ref: '#/components/schemas/Union_353' affinity_source: type: string enum: - conservative_default - explicit - recipe_normalized normalized_computer_requirements: $ref: '#/components/schemas/WorkEnvironmentRequirements' requires_screen: type: boolean permitted_owners: $ref: '#/components/schemas/Objects_223' remote: $ref: '#/components/schemas/Objects_224' considered_computer: type: array items: $ref: '#/components/schemas/Objects_225' allOf: - maxItems: 64 selected: anyOf: - $ref: '#/components/schemas/WorkEnvironmentCompositionSelection' - type: 'null' estimated_usage_dimensions: type: array items: $ref: '#/components/schemas/Union_355' allOf: - maxItems: 3 refusal: anyOf: - $ref: '#/components/schemas/WorkEnvironmentCompositionRefusal' - type: 'null' execution_candidate_set_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ computer_candidate_set_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ colocation_set_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ composition_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - disposition - resolver_version - effective_affinity - affinity_source - normalized_computer_requirements - requires_screen - permitted_owners - remote - considered_computer - selected - estimated_usage_dimensions - refusal - execution_candidate_set_digest - computer_candidate_set_digest - colocation_set_digest - composition_digest additionalProperties: false description: >- A deterministic allocation-free explanation of one execution/Computer composition admission. Union_354: type: string enum: - customer - managed SandboxExecutionQualificationTarget: type: object properties: provider_id: type: string allOf: - minLength: 1 - maxLength: 255 provider_revision: type: string allOf: - minLength: 1 - maxLength: 255 materialization_revision: type: string allOf: - minLength: 1 - maxLength: 255 placement: $ref: '#/components/schemas/Union_18' runner_pool: $ref: '#/components/schemas/RunnerPoolId' required: - provider_id - provider_revision - materialization_revision - placement - runner_pool additionalProperties: false description: Private exact execution target and RunnerPool binding. Objects_169: type: object properties: environment_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ harness_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - environment_hash - harness_hash additionalProperties: false SandboxExecutionOffering: type: object properties: harness_artifact_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ network_modes: type: array items: type: string enum: - allowlist - none allOf: - minItems: 1 - maxItems: 2 maximum_resources: $ref: '#/components/schemas/Objects_9' required: - harness_artifact_digest - network_modes - maximum_resources additionalProperties: false description: >- The harness artifact, network modes, and maximum resources one managed execution offering serves. SandboxExecutionQualificationIdentity: type: object properties: image_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ image_reference: $ref: '#/components/schemas/OciImageReference' image_platform: $ref: '#/components/schemas/Objects_7' image_build: type: object properties: base_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ recipe: type: string allOf: - minLength: 1 - maxLength: 255 - pattern: ^[A-Za-z0-9][A-Za-z0-9._/-]*$ required: - base_digest - recipe additionalProperties: false driver_id: type: string allOf: - minLength: 1 - maxLength: 255 - pattern: ^[A-Za-z0-9][A-Za-z0-9._:@+-]*$ driver_revision: type: string allOf: - minLength: 1 - maxLength: 255 - pattern: ^[A-Za-z0-9][A-Za-z0-9._:@+-]*$ required: - image_digest - image_reference - image_platform - image_build - driver_id - driver_revision additionalProperties: false WorkEnvironmentProviderCandidate: type: object properties: provider: type: string allOf: - minLength: 1 - maxLength: 128 - pattern: ^[a-z0-9][a-z0-9._-]*$ tuple_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ evidence_grade: type: string enum: - double - live_qualified execution: type: array items: $ref: '#/components/schemas/Union_339' allOf: - maxItems: 6 lifetimes: type: array items: $ref: '#/components/schemas/Union_344' allOf: - maxItems: 3 presentations: type: array items: $ref: '#/components/schemas/Union_345' allOf: - maxItems: 3 human_access: type: array items: $ref: '#/components/schemas/Union_346' allOf: - maxItems: 3 observation_transport: type: string enum: - none - sanitized_proxy - interactive_provider_url browser_observation: $ref: '#/components/schemas/BrowserProviderObservationCapabilities' desktop_observation: $ref: '#/components/schemas/DesktopProviderObservationCapabilities' browser_actions: type: array items: type: string enum: - navigate - click - type_text - keypress - scroll - switch_target - close_target allOf: - maxItems: 7 exclusive_control_epoch_fenced: type: boolean placements: type: array items: $ref: '#/components/schemas/Union_342' allOf: - maxItems: 3 recovery: type: array items: $ref: '#/components/schemas/Union_349' allOf: - maxItems: 4 retention_modes: type: array items: $ref: '#/components/schemas/Union_350' allOf: - maxItems: 3 network_modes: type: array items: $ref: '#/components/schemas/Union_351' allOf: - maxItems: 3 network_policy: anyOf: - type: object properties: mode: type: string enum: - none allowed_hosts: $ref: '#/components/schemas/Arrays_50' required: - mode - allowed_hosts additionalProperties: false - type: object properties: mode: type: string enum: - unrestricted allowed_hosts: $ref: '#/components/schemas/Arrays_50' required: - mode - allowed_hosts additionalProperties: false - $ref: '#/components/schemas/SandboxAllowlistWithinHostLimit' egress_certification: type: string enum: - advisory_filter - security_boundary network_enforcement_grade: type: string enum: - unsupported - declared - live_qualified regions: type: array items: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[a-z0-9][a-z0-9-]*$ allOf: - maxItems: 32 maximum_vcpu: anyOf: - type: integer allOf: - exclusiveMinimum: 0 - maximum: 1024 - type: 'null' maximum_memory_mib: anyOf: - type: integer allOf: - exclusiveMinimum: 0 - maximum: 4194304 - type: 'null' maximum_disk_mib: anyOf: - type: integer allOf: - exclusiveMinimum: 0 - maximum: 1073741824 - type: 'null' gpu_available: type: boolean isolation: type: object properties: filesystem: type: array items: $ref: '#/components/schemas/Union_347' allOf: - maxItems: 3 browser_profile: type: array items: $ref: '#/components/schemas/Union_347' allOf: - maxItems: 3 process_namespace: type: array items: $ref: '#/components/schemas/Union_347' allOf: - maxItems: 3 credentials: type: array items: type: string enum: - grant_bound - profile_shared allOf: - maxItems: 2 clipboard: type: array items: $ref: '#/components/schemas/Union_348' allOf: - maxItems: 3 downloads: type: array items: $ref: '#/components/schemas/Union_347' allOf: - maxItems: 3 required: - filesystem - browser_profile - process_namespace - credentials - clipboard - downloads additionalProperties: false evidence_reference: anyOf: - type: string allOf: - minLength: 1 - maxLength: 512 - type: 'null' required: - provider - tuple_digest - evidence_grade - execution - lifetimes - presentations - human_access - observation_transport - exclusive_control_epoch_fenced - placements - recovery - retention_modes - network_modes - network_enforcement_grade - regions - maximum_vcpu - maximum_memory_mib - maximum_disk_mib - gpu_available - isolation - evidence_reference additionalProperties: false description: Structural capability evidence considered by a work-environment dry-run. Arrays_52: type: array items: type: string enum: - shell - filesystem - process_namespace - network_server - browser_dom - browser_visual - desktop_gui allOf: - minItems: 1 - maxItems: 7 SandboxPlacementTarget: type: object properties: provider_id: type: string allOf: - minLength: 1 - maxLength: 255 provider_revision: type: string allOf: - minLength: 1 - maxLength: 255 materialization_revision: type: string allOf: - minLength: 1 - maxLength: 255 placement: $ref: '#/components/schemas/Union_18' required: - provider_id - provider_revision - materialization_revision - placement additionalProperties: false SandboxPlacementOfferingIdentity: type: object properties: image_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ driver_id: type: string allOf: - minLength: 1 - maxLength: 255 - pattern: ^[A-Za-z0-9][A-Za-z0-9._:@+-]*$ driver_revision: type: string allOf: - minLength: 1 - maxLength: 255 - pattern: ^[A-Za-z0-9][A-Za-z0-9._:@+-]*$ required: - image_digest - driver_id - driver_revision additionalProperties: false SandboxPlacementOffering: type: object properties: network_modes: type: array items: type: string enum: - allowlist - none allOf: - minItems: 1 - maxItems: 2 maximum_resources: type: object properties: cpu_millis: type: integer exclusiveMinimum: 0 memory_mib: type: integer exclusiveMinimum: 0 disk_mib: type: integer exclusiveMinimum: 0 max_duration_seconds: type: integer exclusiveMinimum: 0 required: - cpu_millis - memory_mib - disk_mib - max_duration_seconds additionalProperties: false retention_modes: type: array items: $ref: '#/components/schemas/Union_20' allOf: - minItems: 1 - maxItems: 2 required: - network_modes - maximum_resources - retention_modes additionalProperties: false Union_358: type: string enum: - provider_attested - runner_enforced - guest_launcher_enforced - guest_observed - not_enforced AttestedSandboxEgressConformanceReceipt: type: object properties: statement: $ref: '#/components/schemas/SandboxEgressConformanceReceipt' signature: type: object properties: algorithm: type: string enum: - ed25519 key_id: type: string allOf: - minLength: 1 - maxLength: 128 - pattern: ^[A-Za-z0-9][A-Za-z0-9._-]*$ statement_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ signature: type: string pattern: ^[A-Za-z0-9_-]{86}$ required: - algorithm - key_id - statement_digest - signature additionalProperties: false required: - statement - signature additionalProperties: false Union_362: type: string enum: - memory_curation - sft - preference - offline_rl - evaluation - self_improvement PrincipalAccessCredentialId: type: string pattern: ^pcred_[0-9a-f]{32}$ ManagedAgentsSessionAgent: type: object properties: id: $ref: '#/components/schemas/AgentId' connection_bindings: $ref: '#/components/schemas/Arrays_7' description: $ref: '#/components/schemas/Union_31' harness: $ref: '#/components/schemas/ManagedAgentsHarnessReference' mcp_servers: $ref: '#/components/schemas/Arrays_8' model: $ref: '#/components/schemas/ManagedAgentsModelConfig' name: type: string allOf: - minLength: 1 - maxLength: 255 skills: $ref: '#/components/schemas/Arrays_9' system: $ref: '#/components/schemas/Union_33' tools: $ref: '#/components/schemas/Arrays_10' browser: anyOf: - $ref: '#/components/schemas/Objects_14' - type: 'null' skill_selection: $ref: '#/components/schemas/ManagedAgentsAgentSkillSelection' type: type: string enum: - agent version: type: integer exclusiveMinimum: 0 required: - id - connection_bindings - description - harness - mcp_servers - model - name - skills - system - tools - type - version additionalProperties: false EffectiveWebRetrievalAllowedDomainsUnique: type: array items: $ref: '#/components/schemas/WebRetrievalDomainEntry' allOf: - maxItems: 64 EffectiveWebRetrievalBlockedDomainsUnique: type: array items: $ref: '#/components/schemas/WebRetrievalDomainEntry' allOf: - maxItems: 128 ManagedAgentsIsoCountryCode: type: string pattern: ^[A-Z]{2}$ ManagedAgentsIanaTimeZone: type: string allOf: - minLength: 1 - maxLength: 255 ManagedAgentsCustomToolInputSchema: type: object properties: type: type: string enum: - object properties: anyOf: - type: object additionalProperties: $ref: '#/components/schemas/JsonValue' - type: 'null' required: anyOf: - type: array items: type: string - type: 'null' required: - type additionalProperties: $ref: '#/components/schemas/JsonValue' description: JSON Schema for custom tool input parameters. UnrestrictedNetwork: type: object properties: type: type: string enum: - unrestricted required: - type additionalProperties: false LimitedNetwork: type: object properties: type: type: string enum: - limited allow_mcp_servers: type: boolean allow_package_managers: type: boolean allowed_hosts: type: array items: type: string required: - type - allow_mcp_servers - allow_package_managers - allowed_hosts additionalProperties: false Packages: type: object properties: type: type: string enum: - packages apt: $ref: '#/components/schemas/Arrays_46' cargo: $ref: '#/components/schemas/Arrays_46' gem: $ref: '#/components/schemas/Arrays_46' go: $ref: '#/components/schemas/Arrays_46' npm: $ref: '#/components/schemas/Arrays_46' pip: $ref: '#/components/schemas/Arrays_46' required: - apt - cargo - gem - go - npm - pip additionalProperties: false HarnessProcessArgumentUtf8Bytes: type: string allOf: - maxLength: 65536 - pattern: ^[^\u0000]*$ description: >- Exact process argument text, preserving whitespace; U+0000 is forbidden and UTF-8 encoding is limited to 65536 bytes Objects_7: type: object properties: os: type: string enum: - linux architecture: type: string enum: - amd64 - arm64 required: - os - architecture additionalProperties: false OneShotArgvPlaceholders: type: array items: $ref: '#/components/schemas/HarnessProcessArgumentUtf8Bytes' allOf: - maxItems: 256 description: >- At most 256 exact process arguments and 131072 aggregate UTF-8 bytes including one terminator per argument Union_47: type: string enum: - stdin - argv_path Union_48: type: string enum: - stream_json - text Objects_20: type: object properties: schema_version: type: number enum: - 1 harness_name: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ image: $ref: '#/components/schemas/OciImageReference' recipe_revision: type: integer exclusiveMinimum: 0 image_contract_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ local_prompt_evidence_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ hosted_prompt_evidence_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ conformance_report_id: $ref: '#/components/schemas/ConformanceReportId' conformance_report_fingerprint: type: string pattern: ^sha256:[0-9a-f]{64}$ integration_descriptor_digest: anyOf: - type: string pattern: ^sha256:[0-9a-f]{64}$ - type: 'null' statement_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ attestation_type: type: string enum: - https://checkfu.dev/attestations/harness-readiness/v1 qualified_at: $ref: '#/components/schemas/HarnessReadinessInstant' required: - schema_version - harness_name - image - recipe_revision - image_contract_digest - local_prompt_evidence_digest - hosted_prompt_evidence_digest - conformance_report_id - conformance_report_fingerprint - statement_digest - attestation_type - qualified_at additionalProperties: false Arrays_47: type: array items: $ref: '#/components/schemas/Union_339' allOf: - maxItems: 6 WorkEnvironmentComputerCapabilities: type: object properties: observation: $ref: '#/components/schemas/WorkEnvironmentComputerObservationNeeds' actions: $ref: '#/components/schemas/WorkEnvironmentComputerActionNeeds' additionalProperties: false allOf: - minProperties: 1 Arrays_48: type: array items: $ref: '#/components/schemas/Union_342' allOf: - maxItems: 3 Arrays_49: type: array items: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[a-z0-9][a-z0-9-]*$ allOf: - maxItems: 32 Union_343: type: string enum: - forbidden - optional - required WorkEnvironmentRequirements: type: object properties: schema_version: type: number enum: - 1 execution: $ref: '#/components/schemas/Arrays_47' lifetime: $ref: '#/components/schemas/Union_344' presentation: $ref: '#/components/schemas/Union_345' human_access: $ref: '#/components/schemas/Union_346' computer_capabilities: $ref: '#/components/schemas/WorkEnvironmentComputerCapabilities' placement: $ref: '#/components/schemas/Arrays_48' isolation: type: object properties: filesystem: $ref: '#/components/schemas/Union_347' browser_profile: $ref: '#/components/schemas/Union_347' process_namespace: $ref: '#/components/schemas/Union_347' credentials: type: string enum: - grant_bound - profile_shared clipboard: $ref: '#/components/schemas/Union_348' downloads: $ref: '#/components/schemas/Union_347' required: - filesystem - browser_profile - process_namespace - credentials - clipboard - downloads additionalProperties: false recovery: $ref: '#/components/schemas/Union_349' retention: $ref: '#/components/schemas/WorkEnvironmentRetention' network: $ref: '#/components/schemas/WorkEnvironmentNetwork' locality: $ref: '#/components/schemas/WorkEnvironmentLocality' resources: $ref: '#/components/schemas/WorkEnvironmentResources' required: - schema_version - execution - lifetime - presentation - human_access - placement - isolation - recovery - retention - network - locality - resources additionalProperties: false Arrays_51: type: array items: $ref: '#/components/schemas/Union_354' allOf: - maxItems: 2 Objects_225: type: object properties: provider: type: string allOf: - minLength: 1 - maxLength: 128 - pattern: ^[a-z0-9][a-z0-9._-]*$ tuple_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ qualified: type: boolean reasons: type: array items: type: object properties: code: type: string enum: - live_qualification_missing - execution_unsupported - lifetime_unsupported - presentation_unsupported - human_access_unsupported - observation_transport_unsafe - observation_unsupported - action_unsupported - exclusive_control_unfenced - placement_unsupported - recovery_unsupported - retention_unsupported - network_unsupported - network_enforcement_unsupported - network_policy_unqualified - region_unsupported - resource_insufficient - gpu_unsupported - isolation_unsupported requirement_path: type: string allOf: - minLength: 1 - maxLength: 128 - pattern: ^[a-z_]+(?:\.[a-z_]+)*$ expected: type: string allOf: - minLength: 1 - maxLength: 512 observed: type: string allOf: - minLength: 1 - maxLength: 512 evidence_reference: anyOf: - type: string allOf: - minLength: 1 - maxLength: 512 - type: 'null' required: - code - requirement_path - expected - observed - evidence_reference additionalProperties: false allOf: - maxItems: 64 required: - provider - tuple_digest - qualified - reasons additionalProperties: false Union_355: type: string enum: - compute_seconds - screen_seconds - storage_mib_seconds WorkEnvironmentRefusal: type: object properties: code: type: string enum: - human_access_requires_presentation - browser_presentation_requires_browser_visual - desktop_presentation_requires_desktop_gui - computer_capabilities_target_mismatch - browser_recovery_requires_browser - recovery_requires_durable_lifetime - zdr_forbids_shared_credentials - zdr_forbids_export - bounded_retention_requires_maximum - unbounded_retention_forbids_maximum - allowlist_requires_policy_revision - network_policy_revision_not_applicable - network_policy_unresolved - residency_requires_region - compute_requires_placement - durable_lifetime_requires_execution - resources_require_execution - shared_isolation_requires_durable_lifetime - override_weakens_preset - provider_candidate_limit_exceeded - duplicate_provider_candidate - no_qualified_provider - authorization_denied - budget_denied requirement_path: type: string allOf: - minLength: 1 - maxLength: 128 - pattern: ^[a-z_]+(?:\.[a-z_]+)*$ message: type: string allOf: - minLength: 1 - maxLength: 512 required: - code - requirement_path - message additionalProperties: false description: A stable, provider-neutral reason a work environment cannot be admitted. Union_353: anyOf: - type: object properties: type: type: string enum: - same_execution_environment required_shared: type: array items: type: string enum: - display - filesystem - network - process_namespace allOf: - maxItems: 4 required: - type - required_shared additionalProperties: false - type: object properties: type: type: string enum: - remote_permitted required: - type additionalProperties: false WorkEnvironmentCompositionSelection: type: object properties: topology: type: string enum: - colocated - detached execution: $ref: '#/components/schemas/Objects_226' computer: $ref: '#/components/schemas/Objects_226' colocation: anyOf: - type: object properties: allocation_identity: type: string allOf: - minLength: 1 - maxLength: 128 - pattern: ^[a-z0-9][a-z0-9._-]*$ provider_account: type: string allOf: - minLength: 1 - maxLength: 128 - pattern: ^[a-z0-9][a-z0-9._-]*$ shared_display: type: boolean shared_filesystem: type: boolean shared_network: type: boolean shared_process_namespace: type: boolean required: - allocation_identity - provider_account - shared_display - shared_filesystem - shared_network - shared_process_namespace additionalProperties: false - type: 'null' required: - topology - execution - computer - colocation additionalProperties: false description: >- The deterministically selected execution/Computer pair with its proved topology, ownership, and colocation facts. WorkEnvironmentCompositionRefusal: type: object properties: code: type: string enum: - human_access_requires_presentation - browser_presentation_requires_browser_visual - desktop_presentation_requires_desktop_gui - computer_capabilities_target_mismatch - browser_recovery_requires_browser - recovery_requires_durable_lifetime - zdr_forbids_shared_credentials - zdr_forbids_export - bounded_retention_requires_maximum - unbounded_retention_forbids_maximum - allowlist_requires_policy_revision - network_policy_revision_not_applicable - network_policy_unresolved - residency_requires_region - compute_requires_placement - durable_lifetime_requires_execution - resources_require_execution - shared_isolation_requires_durable_lifetime - override_weakens_preset - provider_candidate_limit_exceeded - duplicate_provider_candidate - no_qualified_provider - authorization_denied - budget_denied - composition_requires_execution - composition_overlay_requires_computer - composition_candidate_limit_exceeded - duplicate_composition_candidate - duplicate_colocation_binding - prohibited_owner - explicit_target_unavailable - same_environment_mismatch - detached_access_not_authorized - no_qualified_composition requirement_path: type: string allOf: - minLength: 1 - maxLength: 128 - pattern: ^[a-z_]+(?:\.[a-z_]+)*$ message: type: string allOf: - minLength: 1 - maxLength: 512 required: - code - requirement_path - message additionalProperties: false description: >- A stable, provider-neutral reason a work-environment composition cannot be admitted. Objects_9: type: object properties: cpu_millis: type: integer exclusiveMinimum: 0 memory_mib: type: integer exclusiveMinimum: 0 disk_mib: type: integer exclusiveMinimum: 0 max_duration_seconds: type: integer exclusiveMinimum: 0 required: - cpu_millis - memory_mib - disk_mib - max_duration_seconds additionalProperties: false Union_339: type: string enum: - shell - filesystem - network_server - browser_dom - browser_visual - desktop_gui Union_344: type: string enum: - run - session - durable Union_345: type: string enum: - none - browser - desktop Union_346: type: string enum: - none - observe - exclusive_takeover BrowserProviderObservationCapabilities: type: object properties: accessibility_tree: type: boolean screenshot: type: boolean required: - accessibility_tree - screenshot additionalProperties: false DesktopProviderObservationCapabilities: type: object properties: accessibility_tree: type: boolean screenshot: type: boolean window_inventory: type: boolean required: - accessibility_tree - screenshot - window_inventory additionalProperties: false Union_342: type: string enum: - managed - local - connected Union_349: type: string enum: - none - filesystem - browser_profile - full_instance Union_350: type: string enum: - ephemeral_zdr - bounded - durable Union_351: type: string enum: - none - allowlist - unrestricted Arrays_50: type: array items: $ref: '#/components/schemas/SandboxAllowedHost' allOf: - maxItems: 0 SandboxAllowlistWithinHostLimit: type: object properties: mode: type: string enum: - allowlist allowed_hosts: type: array items: $ref: '#/components/schemas/SandboxAllowedHost' allOf: - maxItems: 256 required_egress_certification: type: string enum: - advisory_filter - security_boundary allow_package_managers: type: boolean allow_mcp_servers: type: boolean required: - mode - allowed_hosts additionalProperties: false Union_347: type: string enum: - attachment - application - scope_shared Union_348: type: string enum: - disabled - attachment - scope_shared Union_20: type: string enum: - durable - ephemeral_zdr SandboxEgressConformanceReceipt: type: object properties: provider: type: string allOf: - minLength: 1 - maxLength: 64 provider_revision: type: string allOf: - minLength: 1 - maxLength: 1024 - pattern: ^\S+$ guard_revision: type: string allOf: - minLength: 1 - maxLength: 1024 - pattern: ^\S+$ facts: $ref: '#/components/schemas/UniqueSandboxEgressConformanceFacts' proved_at: $ref: '#/components/schemas/SandboxEgressConformanceInstant' expires_at: $ref: '#/components/schemas/SandboxEgressConformanceInstant' required: - provider - provider_revision - guard_revision - facts - proved_at - expires_at additionalProperties: false WebRetrievalDomainEntry: type: string allOf: - minLength: 1 - maxLength: 255 Arrays_46: type: array items: type: string HarnessReadinessInstant: type: string allOf: - maxLength: 24 - pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$ x-checkfu-current-timestamp: true description: >- A canonical UTC ISO-8601 harness-readiness instant with millisecond precision. WorkEnvironmentComputerObservationNeeds: type: object properties: accessibility_tree: type: string enum: - required - optional screenshot: type: string enum: - required - optional window_inventory: type: string enum: - required - optional additionalProperties: false allOf: - minProperties: 1 WorkEnvironmentComputerActionNeeds: type: object properties: navigate: type: string enum: - required - optional click: type: string enum: - required - optional type_text: type: string enum: - required - optional keypress: type: string enum: - required - optional scroll: type: string enum: - required - optional switch_target: type: string enum: - required - optional close_target: type: string enum: - required - optional drag: type: string enum: - required - optional accessible_node: type: string enum: - required - optional additionalProperties: false allOf: - minProperties: 1 WorkEnvironmentRetention: type: object properties: mode: $ref: '#/components/schemas/Union_350' maximum_seconds: anyOf: - type: integer allOf: - exclusiveMinimum: 0 - maximum: 315360000 - type: 'null' export: type: string enum: - forbidden - allowed required: - mode - maximum_seconds - export additionalProperties: false description: >- Retention duration, durability mode, and export policy for a work environment. WorkEnvironmentNetwork: anyOf: - type: object properties: mode: $ref: '#/components/schemas/Union_351' policy: anyOf: - type: object properties: action_policy_id: $ref: '#/components/schemas/ActionPolicyId' action_policy_version: type: integer exclusiveMinimum: 0 required: - action_policy_id - action_policy_version additionalProperties: false - type: 'null' required: - mode - policy additionalProperties: false - $ref: '#/components/schemas/Union_352' description: >- Concrete network destinations and enforcement requirements, or a retained action-policy reference that cannot authorize network egress. WorkEnvironmentLocality: type: object properties: regions: $ref: '#/components/schemas/Arrays_49' residency_required: type: boolean required: - regions - residency_required additionalProperties: false description: >- Ordered eligible regions and residency requirement for a work environment. WorkEnvironmentResources: type: object properties: minimum_vcpu: anyOf: - type: integer allOf: - exclusiveMinimum: 0 - maximum: 1024 - type: 'null' minimum_memory_mib: anyOf: - type: integer allOf: - exclusiveMinimum: 0 - maximum: 4194304 - type: 'null' minimum_disk_mib: anyOf: - type: integer allOf: - exclusiveMinimum: 0 - maximum: 1073741824 - type: 'null' gpu: $ref: '#/components/schemas/Union_343' required: - minimum_vcpu - minimum_memory_mib - minimum_disk_mib - gpu additionalProperties: false description: >- Minimum compute, memory, disk, and GPU requirements for a work environment. Objects_226: type: object properties: provider: type: string allOf: - minLength: 1 - maxLength: 128 - pattern: ^[a-z0-9][a-z0-9._-]*$ tuple_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ evidence_grade: type: string enum: - double - live_qualified owner: $ref: '#/components/schemas/Union_354' computer_id: anyOf: - $ref: '#/components/schemas/ComputerId' - type: 'null' required: - provider - tuple_digest - evidence_grade - owner - computer_id additionalProperties: false SandboxAllowedHost: type: string description: >- A lower-case public DNS hostname, never localhost or an IP literal, with an optional leading wildcard and TCP port from 1 through 65535. allOf: - maxLength: 261 - pattern: >- ^(?:\*\.)?[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)+(?::[1-9][0-9]{0,4})?$ UniqueSandboxEgressConformanceFacts: type: array items: type: string enum: - exact_destination_match - connect_time_public_address - redirect_recheck - authority_separation - default_deny allOf: - minItems: 1 - maxItems: 5 SandboxEgressConformanceInstant: type: string allOf: - maxLength: 24 - pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$ x-checkfu-current-timestamp: true description: >- A canonical UTC ISO-8601 Sandbox egress conformance instant with millisecond precision. ActionPolicyId: type: string pattern: ^apol_[0-9a-f]{32}$ Union_352: anyOf: - type: object properties: mode: type: string enum: - none allowed_hosts: $ref: '#/components/schemas/Arrays_50' required: - mode - allowed_hosts additionalProperties: false - type: object properties: mode: type: string enum: - unrestricted allowed_hosts: $ref: '#/components/schemas/Arrays_50' required: - mode - allowed_hosts additionalProperties: false - $ref: '#/components/schemas/SandboxAllowlistWithinHostLimit' securitySchemes: bearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.